pinpoint README

The project's README from github.com/pinpoint-apm/pinpoint. As one markdown file: README.md.

Pinpoint

Maven codecov

Latest Release (2026/05/21)

We're happy to announce the release of Pinpoint v3.1.0. Please check the release note at (https://github.com/pinpoint-apm/pinpoint/releases/tag/v3.1.0).

The current stable version is v3.1.0.

Live Demo

Take a quick look at Pinpoint with our demo!

PHP, PYTHON

Pinpoint also supports application written in PHP, Python. Check-out our agent repository.

About Pinpoint

Pinpoint is an APM (Application Performance Management) tool for large-scale distributed systems written in Java / PHP/PYTHON. Inspired by Dapper, Pinpoint provides a solution to help analyze the overall structure of the system and how components within them are interconnected by tracing transactions across distributed applications.

You should definitely check Pinpoint out If you want to

Getting Started

Deploying Pinpoint to Kubernetes

Overview

Services nowadays often consist of many different components, communicating amongst themselves as well as making API calls to external services. How each and every transaction gets executed is often left as a blackbox. Pinpoint traces transaction flows between these components and provides a clear view to identify problem areas and potential bottlenecks.
For a more intimate guide, please check out our Introduction to Pinpoint video clip.

Supported Modules

The supported version range of each module is listed in Agent Plugins.

Compatibility

Java version required to run Pinpoint:

Pinpoint Version Agent Collector Web Batch
2.0.x 6-13 8 8 8
2.1.x 6-14 8 8 8
2.2.x 7-14 8 8 8
2.3.x 7-17 8 8 8
2.4.x 7-18 11 11 11
2.5.x 8-19 11 11 11
3.0.x 8-21 17 17 17
3.1.x 8-25 17 17 17

HBase compatibility table:

Pinpoint Version HBase 1.x HBase 2.x
2.0.x - 2.2.x yes optional
2.3.x - 2.5.x yes hbase2-module
3.0.x no yes
3.1.x no yes

Agent - Collector compatibility table:

Agent Version Collector 2.x.x Collector 3.0.x Collector 3.1.x
2.x.x yes yes yes
3.0.x no yes yes
3.1.x no no yes

Pinot compatibility table:

Pinpoint Version Pinot 0.11.0 Pinot 0.12.0 Pinot 1.0.0 Pinot 1.2.0 Pinot 1.3.0
2.5.x yes yes yes yes yes
3.0.x no no yes yes yes
3.1.x no no no no yes

Community

Github issues
Gitter

We have Chinese community now, welcome to join!

👆 click me
QQ Group1: 897594820 QQ Group2: 812507584 QQ Group3: 882020485 DING Group : 21981598
QQ Group1 QQ Group2 QQ Group3 DING Group

License

Pinpoint is licensed under the Apache License, Version 2.0. See LICENSE for full license text.

Copyright 2018 NAVER Corp.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

pinpoint (pinpoint-apm/pinpoint)

Searching Database…

13.9K ·GitHub
这是什么?Pinpoint 是一款面向大规模分布式系统的 APM(应用性能管理)工具,主要用 Java 编写(同时支持 PHP 和 Python 的 Agent),设计灵感来自 Google 的 Dapper 论文。
它只是一个 Agent,还是包含服务端的完整平台?它是一个完整的平台,包括接收追踪数据的 Collector、用于可视化展示的 Web UI,以及安装在每个应用上、把追踪数据发送到 Collector 的 Agent。
我该怎么让它运行起来?可以按照快速入门指南进行简单的测试运行,也可以参考完整的安装指南进行生产环境部署;Pinpoint 还可以借助单独的 pinpoint-kubernetes 项目部署到 Kubernetes。
我需要什么版本的 Java 和什么数据库?Agent 需要 JDK 8+;较新的 collector、web 和 batch 组件则需要 JDK 11 或 17(取决于版本)。存储后端需要 HBase,v3.0.x 及之后的版本要求 HBase 2.x。
装上 Pinpoint 会让我的应用变慢吗?据项目官方说明,Pinpoint 的设计目标是将性能影响降到最低,资源占用大约增加 3%。
它只能用于 Java 应用吗?不是。虽然核心 Agent 和服务端基于 Java,但 Pinpoint 也提供了面向 PHP 和 Python 应用的独立 Agent。
ServerMap 功能到底会给我展示什么?它会直观展示分布式系统的拓扑结构,点击某个节点即可查看其当前状态和事务数量。
我能现在就看到应用内部正在发生什么,而不只是历史数据吗?可以。实时活动线程图表会实时监控应用内的活动线程,请求/响应散点图则允许你框选实时流量模式,查看单个事务的详细信息。
Pinpoint 开箱即用支持对哪些框架和库进行插桩?支持的模块非常丰富,包括 Tomcat/Jetty/Spring/Spring Boot、Apache HttpClient/OkHttp、Thrift/gRPC/Dubbo、Kafka/RabbitMQ/RocketMQ、MySQL/Oracle/PostgreSQL/MongoDB/Redis,以及 HikariCP、Druid 等连接池。
有没有不用安装就能试用 Pinpoint 的办法?有。项目提供了在线演示,你可以在进行任何设置之前先体验一下 UI。
What are similar projects?zipkin, cat, skywalking, emqx, signoz, conductor, jaeger, GoNavi
Size
271.7 MB
Stars
13.9K
Age
11y
Commits · 90 Days