Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/pinpoint-apm/pinpoint

APM, (Application Performance Management) tool for large-scale distributed systems.
https://github.com/pinpoint-apm/pinpoint
agent apm distributed-tracing monitoring performance tracing
Last synced: 4 days ago
JSON representation
APM, (Application Performance Management) tool for large-scale distributed systems.
Host: GitHub
URL: https://github.com/pinpoint-apm/pinpoint
Owner: pinpoint-apm
License: apache-2.0
Created: 2014-10-20T09:27:22.000Z (about 10 years ago)
Default Branch: master
Last Pushed: 2024-10-29T09:35:16.000Z (about 1 month ago)
Last Synced: 2024-10-29T09:42:16.610Z (about 1 month ago)
Topics: agent, apm, distributed-tracing, monitoring, performance, tracing
Language: Java
Homepage: https://pinpoint-apm.gitbook.io/
Size: 249 MB
Stars: 13,412
Watchers: 737
Forks: 3,751
Open Issues: 455
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project

awesome - pinpoint-apm/pinpoint - APM, (Application Performance Management) tool for large-scale distributed systems. (Java)
awesome-ops - pinpoint-apm/pinpoint - 2.0|13394|2014-10-20|2024-10-04 | APM，（应用程序性能管理）大规模分布式系统的工具。 | (Monitor)
made-in-korea - pinpoint
awesome-list - pinpoint - scale distributed systems. | pinpoint-apm | 11624 | (Java)
StarryDivineSky - pinpoint-apm/pinpoint
README

        

![Pinpoint](web/psd/logo.png)

[![Maven](https://img.shields.io/github/actions/workflow/status/pinpoint-apm/pinpoint/maven.yml?branch=master&label=build&logo=github)](https://github.com/pinpoint-apm/pinpoint/actions?query=workflow%3AMaven)

[![codecov](https://codecov.io/gh/pinpoint-apm/pinpoint/branch/master/graph/badge.svg)](https://codecov.io/gh/pinpoint-apm/pinpoint)

## Latest Release (2024/10/23)

We're happy to announce the release of Pinpoint v3.0.1.

Please check the release note at (https://github.com/pinpoint-apm/pinpoint/releases/tag/v3.0.1).

The current stable version is [v3.0.1](https://github.com/pinpoint-apm/pinpoint/releases/tag/v3.0.1).

## Live Demo

Take a quick look at Pinpoint with our [demo](http://223.130.142.103:8080/main/ApiGateway@SPRING_BOOT/5m?inbound=1&outbound=4&wasOnly=false&bidirectional=false)!

## PHP, PYTHON

Pinpoint also supports application written in PHP, Python. [Check-out our agent repository](https://github.com/pinpoint-apm/pinpoint-c-agent).

## About Pinpoint

**Pinpoint** is an APM (Application Performance Management) tool for large-scale distributed systems written in Java / [PHP](https://github.com/pinpoint-apm/pinpoint-c-agent)/[PYTHON]((https://github.com/pinpoint-apm/pinpoint-c-agent)).

Inspired by [Dapper](http://research.google.com/pubs/pub36356.html "Google 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](https://pinpoint-apm.gitbook.io/pinpoint/want-a-quick-tour/overview)* 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](https://pinpoint-apm.gitbook.io/pinpoint/getting-started/quickstart) for simple test run of Pinpoint

 * [Installation guide](https://pinpoint-apm.gitbook.io/pinpoint/getting-started/installation) 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.


For a more intimate guide, please check out our *[Introduction to Pinpoint](https://pinpoint-apm.gitbook.io/pinpoint/#want-a-quick-tour)* 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**.

  ![Server Map](doc/images/ss_server-map.png)

* **CallStack** - Gain code-level visibility to every transaction in a distributed environment, identifying bottlenecks and points of failure in a single view.

  ![Call Stack](doc/images/ss_call-stack.png)

* **Inspector** - View additional details on the application such as CPU usage, Memory/Garbage Collection, TPS, and JVM arguments.

  ![Inspector](doc/images/ss_inspector.png)

* **URI-metric**

  ![URI-Metric](doc/images/ss-uri-metric.png)

* **Infrastructure**

  ![Infrastructure](doc/images/ss-Infrastructure-metric.png)

* **Error-Analysis**

  ![Error-Analysis 1](doc/images/ss_error-analysis1.png)

  ![Error-Analysis 2](doc/images/ss_error-analysis3.gif)

## Supported Modules

* JDK 8+

* [Tomcat](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/tomcat), [Jetty](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/jetty), [JBoss EAP](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/jboss), [Resin](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/resin), [Websphere](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/websphere), [Vertx](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/vertx), [Weblogic](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/weblogic), [Undertow](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/undertow), [Akka HTTP](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/akka-http)

* [Spring](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/spring), [Spring Boot](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/spring-boot) ([Embedded Tomcat](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/tomcat), [Jetty](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/jetty), [Undertow](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/undertow), [Reactor Netty](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/reactor-netty)), [Spring WebFlux](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/spring-webflux)

* Apache HttpClient [3](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/httpclient3) / [4](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/httpclient4) / [5](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/httpclient5), [JDK HttpConnector](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/jdk-http), [GoogleHttpClient](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/google-httpclient), [OkHttpClient](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/okhttp), [NingAsyncHttpClient](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/ning-asynchttpclient)

* [Thrift](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/thrift), [DUBBO](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/dubbo), [GRPC](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/grpc), [Apache CXF](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/cxf)

* [ActiveMQ](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/activemq-client), [RabbitMQ](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/rabbitmq), [Kafka](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/kafka), [RocketMQ](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/rabbitmq), [Paho MQTT](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/paho-mqtt)

* [MySQL](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/mysql-jdbc), [Oracle](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/oracle-jdbc), [MSSQL](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/mssql-jdbc), [JTDS](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/jtds), [CUBRID](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/cubrid-jdbc), [POSTGRESQL](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/postgresql-jdbc), [MARIA](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/mariadb-jdbc), [Informix](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/informix-jdbc), [Spring Data R2DBC](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/spring-data-r2dbc)

* [Arcus](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/arcus), [Memcached](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/arcus), Redis([Jedis](https://github.com/pinpoint-apm/pinpoint/blob/master/agent-module/plugins/redis), [Lettuce](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/redis-lettuce), [Redisson](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/redis-redisson)), [CASSANDRA](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/cassandra), [MongoDB](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/mongodb), [Hbase](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/hbase), [Elasticsearch](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/elasticsearch)

* [iBATIS](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/ibatis), [MyBatis](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/mybatis)

* [DBCP](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/dbcp), [DBCP2](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/dbcp2), [HIKARICP](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/hikaricp), [DRUID](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/druid)

* [Gson](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/gson), [Jackson](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/jackson), [Json Lib](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/json-lib), [Fastjson](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/fastjson)

* [log4j](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/log4j), [Logback](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/logback), [log4j2](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/log4j2)

* [OpenWhisk](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/openwhisk), [Kotlin Coroutines](https://github.com/pinpoint-apm/pinpoint/tree/master/agent-module/plugins/kotlin-coroutines)

## Compatibility

Java version required to run Pinpoint:

| Pinpoint Version | Agent | Collector | Web | Batch | Flink |

|------------------|-------|-----------|-----|-------|-------|

| 2.0.x            | 6-13  | 8         | 8   | 8     | 8     |

| 2.1.x            | 6-14  | 8         | 8   | 8     | 8     |

| 2.2.x            | 7-14  | 8         | 8   | 8     | 8     |

| 2.3.x            | 7-17  | 8         | 8   | 8     | 8     |

| 2.4.x            | 7-18  | 11        | 11  | 11    | 11    |

| 2.5.x            | 8-19  | 11        | 11  | 11    | 11    |

| 3.0.x            | 8-21  | 17        | 17  | 17    | 17    |

| 3.1.x            | 8-21  | 17        | 17  | 17    | 17    |

HBase compatibility table:

| Pinpoint Version | HBase 1.x | HBase 2.x                                                                                                             |

|------------------|-----------|-----------------------------------------------------------------------------------------------------------------------|

| 2.0.x - 2.2.x    | yes       | [optional](https://pinpoint-apm.gitbook.io/pinpoint/documents/hbase-upgrade#do-you-like-to-use-hbase-2x-for-pinpoint) |

| 2.3.x - 2.5.x    | yes       | [hbase2-module](https://github.com/pinpoint-apm/pinpoint/tree/2.3.x/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             |

Flink compatibility table:

| Pinpoint Version | Flink 1.3.X - 1.7.X | Flink 1.14.X | Flink 1.18.X    |

|------------------|---------------------|--------------|-----------------|

| 2.0.x - 2.3.x    | yes                 | no           | no              |

| 2.4.x - 2.5.x    | yes                 | yes          | no              |

| 3.0.x            | no                  | no           | yes(deprecated) |

| 3.1.x            | no                  | no           | yes(deprecated) |

Pinot compatibility table:

| Pinpoint Version | Pinot 0.11.0 | Pinot 0.12.0 | Pinot 1.0.0 | [Pinot 1.2.0](https://github.com/pinpoint-apm/pinpoint/issues/11613) |

|------------------|--------------|--------------|-------------|----------------------------------------------------------------------|

| 2.5.x            | yes          | yes          | yes         | yes                                                                  |

| 3.0.x            | no           | no           | yes         | yes                                                                  |

| 3.1.x            | no           | no           | no          | yes                                                                  |

## Community

[Github issues](https://github.com/pinpoint-apm/pinpoint/issues)   

[Gitter](https://gitter.im/naver/pinpoint)  

We have Chinese community now, welcome to join!

   👆 click me

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

:----------------: |:----------------: | :-----------: | :-----------: 

![QQ Group1](doc/images/NAVERPinpoint.png) | ![QQ Group2](doc/images/NAVERPinpoint2.png)| ![QQ Group3](doc/images/NAVERPinpoint3.png)| ![DING Group](doc/images/NaverPinpoint交流群-DING.jpg)

## License

Pinpoint is licensed under the Apache License, Version 2.0.

See [LICENSE](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.

```