pinpoint-apm/pinpoint

APM, (Application Performance Management) tool for large-scale distributed systems. https://pinpoint-apm.gitbook.io/

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.naver:pinpoint:2.3.1'
	}

	dependencies {
		implementation("com.github.naver:pinpoint:2.3.1")
	}

	<dependency>
	    <groupId>com.github.naver</groupId>
	    <artifactId>pinpoint</artifactId>
	    <version>2.3.1</version>
	</dependency>


                            
    libraryDependencies += "com.github.naver" % "pinpoint" % "2.3.1"


                            
    :dependencies [[com.github.naver/pinpoint "2.3.1"]]

Readme

Latest Release (2025/03/19)

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

The current stable version is v3.0.2.

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

understand your application topology at a glance
monitor your application in Real-Time
gain code-level visibility to every transaction
install APM Agents without changing a single line of code
have minimal impact on the performance (approximately 3% increase in resource usage)

Getting Started

Quick-start guide for simple test run of Pinpoint
Installation guide for further instructions.

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.<br/> For a more intimate guide, please check out our Introduction to Pinpoint video clip.

ServerMap - Understand the topology of any distributed systems by visualizing how their components are interconnected. Clicking on a node reveals details about the component, such as its current status, and transaction count.
Realtime Active Thread Chart - Monitor active threads inside applications in real-time.
Request/Response Scatter Chart - Visualize request count and response patterns over time to identify potential problems. Transactions can be selected for additional detail by dragging over the chart.
CallStack - Gain code-level visibility to every transaction in a distributed environment, identifying bottlenecks and points of failure in a single view.
Inspector - View additional details on the application such as CPU usage, Memory/Garbage Collection, TPS, and JVM arguments.
URI-metric
Infrastructure
Error-Analysis

Supported Modules

JDK 8+
Tomcat, Jetty, JBoss EAP, Resin, Websphere, Vertx, Weblogic, Undertow, Akka HTTP
Spring, Spring Boot (Embedded Tomcat, Jetty, Undertow, Reactor Netty), Spring WebFlux
Apache HttpClient 3 / 4 / 5, JDK HttpConnector, GoogleHttpClient, OkHttpClient, NingAsyncHttpClient
Thrift, DUBBO, GRPC, Apache CXF
ActiveMQ, RabbitMQ, Kafka, RocketMQ, Paho MQTT
MySQL, Oracle, MSSQL, JTDS, CUBRID, POSTGRESQL, MARIA, Informix, Spring Data R2DBC
Arcus, Memcached, Redis(Jedis, Lettuce, Redisson), CASSANDRA, MongoDB, Hbase, Elasticsearch
iBATIS, MyBatis
DBCP, DBCP2, HIKARICP, DRUID
Gson, Jackson, Json Lib, Fastjson
log4j, Logback, log4j2
OpenWhisk, Kotlin Coroutines

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-24 | 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 | |------------------|--------------|--------------|-------------|----------------------------------------------------------------------| | 2.5.x | yes | yes | yes | yes | | 3.0.x | no | no | yes | yes | | 3.1.x | no | no | no | yes |

Community

Github issues
Gitter

We have Chinese community now, welcome to join!

<details> <summary> 👆 click me </summary>

QQ Group1: 897594820 | QQ Group2: 812507584 | QQ Group3: 882020485| DING Group : 21981598 :----------------: |:----------------: | :-----------: | :-----------: | | |

</details>

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.