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 (Application Performance Management) для крупномасштабных распределённых систем, в основном написанный для Java (с поддержкой агентов для PHP и Python), вдохновлённый статьёй Google о Dapper.
Это один агент или полноценная платформа с сервером?Это полноценная платформа: Collector, который принимает данные трассировки, веб-интерфейс (Web UI) для их визуализации и Agents, которые устанавливаются на каждое приложение и отправляют трассировки в Collector.
Как его запустить?Следуйте руководству Quick-start для простого тестового запуска или полному руководству Installation для продакшен-развёртывания; Pinpoint также можно развернуть в Kubernetes с помощью отдельного проекта pinpoint-kubernetes.
Какая версия Java и какая база данных нужны?Для агента нужен JDK 8+ (более новые компоненты collector/web/batch требуют JDK 11 или 17 в зависимости от версии), а также HBase в качестве хранилища (HBase 2.x обязателен начиная с v3.0.x).
Pinpoint замедляет работу моего приложения?Pinpoint разработан так, чтобы минимально влиять на производительность: по данным проекта, он добавляет примерно 3% к потреблению ресурсов.
Он работает только с Java-приложениями?Нет: хотя основные агент и сервер написаны на Java, Pinpoint также предоставляет отдельные агенты для приложений на PHP и Python.
Что именно показывает функция ServerMap?Она визуализирует топологию вашей распределённой системы и позволяет кликнуть по узлу, чтобы увидеть его текущее состояние и количество транзакций.
Могу ли я увидеть, что происходит внутри моего приложения прямо сейчас, а не только исторические данные?Да: Realtime Active Thread Chart отслеживает активные потоки внутри приложений в реальном времени, а Request/Response Scatter Chart позволяет выделить мышью участок живого трафика, чтобы изучить отдельные транзакции.
Какие фреймворки и библиотеки Pinpoint инструментирует из коробки?Поддерживается большое количество модулей, включая Tomcat/Jetty/Spring/Spring Boot, Apache HttpClient/OkHttp, Thrift/gRPC/Dubbo, Kafka/RabbitMQ/RocketMQ, MySQL/Oracle/PostgreSQL/MongoDB/Redis, а также пулы соединений, такие как HikariCP и Druid.
Можно ли попробовать Pinpoint без установки?Да, у проекта есть живая демо-версия, чтобы изучить интерфейс до какой-либо настройки.
What are similar projects?zipkin, cat, skywalking, emqx, signoz, conductor, jaeger, GoNavi
Size
271.7 MB
Stars
13.9K
Age
11y
Commits · 90 Days