Pinpoint is an APM (Application Performance Management) tool for large-scale distributed systems written in Java. Modelled after 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.
- Install agents without changing a single line of code
- Minimal impact on performance (approximately 3% increase in resource usage)
We've been lucky enough to hold a Birds of a Feather (BoF) session on May 18th 7pm. Come join us to discuss everything and anything about Pinpoint and distributed tracing.
If anyone's headed to Austin for OSCON and wishes to meet up, let us know by sending us a mail or leaving a note here.
We're happy to announce the release of Pinpoint v1.5.2.
Please check the release note at (https://github.com/naver/pinpoint/releases/tag/1.5.2)
We're now focusing on developing v1.6.0.
Special shout out to dawidmalina, majinkai, jart and many others for your contribution and feedback.
Without your help, we would not have been able to reach our current level of product maturity. We are extremely grateful for all your help and will continue to try our very best to provide you with the best possible experience using Pinpoint.
We look forward to working with you as we enter the next chapter in development.
Thank you.
We now have a plugin development guide. Yay!
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.
-
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.
- JDK 6+
- Tomcat 6/7/8, Jetty 8/9
- Spring, Spring Boot
- Apache HTTP Client 3.x/4.x, JDK HttpConnector, GoogleHttpClient, OkHttpClient, NingAsyncHttpClient
- Thrift Client, Thrift Service, DUBBO PROVIDER, DUBBO CONSUMER
- MySQL, Oracle, MSSQL, CUBRID, DBCP, POSTGRESQL, MARIA
- Arcus, Memcached, Redis, CASSANDRA
- iBATIS, MyBatis
- gson, Jackson, Json Lib
- log4j, Logback
You may run a sample Pinpoint instance in your own machine by running four simple scripts for each components: Collector, Web, Sample TestApp, HBase.
Once the components are running, you should be able to visit http://localhost:28080 to view the Pinpoint Web UI, and http://localhost:28081 to generate transactions on the Sample TestApp.
For details, please refer to the quick-start guide.
Build Requirements
- JDK 6 installed (jdk1.6_45)
- JDK 8 installed
- Maven 3.2.x+ installed
- JAVA_6_HOME environment variable set to JDK 6 home directory.
- JAVA_7_HOME environment variable set to JDK 7+ home directory.
- JAVA_8_HOME environment variable set to JDK 8+ home directory.
Prerequisites
Java version required to run Pinpoint:
| Pinpoint Version | Agent | Collector | Web |
|---|---|---|---|
| 1.0.x | 6+ | 6+ | 6+ |
| 1.1.x | 6+ | 7+ | 7+ |
| 1.5.x | 6+ | 7+ | 7+ |
| 1.6.x | 6+ | 8+ | 8+ |
HBase compatibility table:
| Pinpoint Version | HBase 0.94.x | HBase 0.98.x | HBase 1.0.x | HBase 1.1.x | HBase 1.2.x |
|---|---|---|---|---|---|
| 1.0.x | yes | no | no | no | no |
| 1.1.x | no | not tested | yes | not tested | not tested |
| 1.5.x | no | not tested | yes | not tested | not tested |
| 1.6.x | no | not tested | not tested | not tested | yes |
Agent compatibility table:
| Agent Version | Collector 1.0.x | Collector 1.1.x | Collector 1.5.x | Collector 1.6.x |
|---|---|---|---|---|
| 1.0.x | yes | yes | yes | yes |
| 1.1.x | not tested | yes | yes | yes |
| 1.5.x | no | no | yes | Yes |
| 1.6.x | no | no | not tested | Yes |
Installation
To set up your very own Pinpoint instance you can either download the build results from our latest release, or manually build from your Git clone. Take a look at our installation guide for further instructions.
For feature requests and bug reports, feel free to post them here.
For Q/A and discussion here.
We have a wiki page for roadmap, user guide, and some documentation. We welcome any documentation contribution.
We welcome any and all suggestions.
For plugin development, take a look at our plugin development guide, along with plugin samples project to get an idea of how we do instrumentation. The samples will provide you with example codes to help you get started.
Please follow our guideline when making pull-requests for new plugins.
For everything else, please make a pull-request against our master branch.
Please note that you will have to complete a CLA for your first pull-request.
We would love to see additional tracing support for libraries such as Storm, HBase, as well as profiler support for additional languages (.NET, C++).
Pinpoint is licensed under the Apache License, Version 2.0. See LICENSE for full license text.
Copyright 2015 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.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent