Pinpoint is an open source APM (Application Performance Management) tool for large-scale distributed systems written in Java.
Java JavaScript HTML CSS Shell Makefile Other
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 4061 commits behind naver:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
agent
bootstrap-core
bootstrap
collector
commons
doc
plugins
profiler-optional
profiler
quickstart
rpc
scripts
test
thrift
web
.gitignore
.travis.yml
LICENSE
NOTICE
README.md
checkstyle-UTF8(ver0.6).xml
checkstyle-suppressions.xml
clover.license
filefilter.txt
findbugs-exclude.xml
pom.xml

README.md

Pinpoint

Pinpoint is an APM (Application Performance Management) tool for large-scale distributed systems written in Java. Modelled after Google's Dapper paper, 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)

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.

  • 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.

  • 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

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

    Call Stack

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

    Inspector

Architecture

Pinpoint Architecture

Supported Modules

  • JDK 6+
  • Tomcat 6/7
  • Spring
  • Apache HTTP Client 3.x/4.x, JDK HttpConnector
  • MySQL, Oracle, MSSQL, CUBRID, DBCP
  • iBATIS, MyBatis
  • Arcus, Memcached, Redis

Quick Start

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.

Installation

Requirements

  • JDK 6 installed
  • JDK 7+ 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.

Installation

To set up your very own Pinpoint instance, take a look at our installation guide.

Issues

For feature requests and bug reports, feel free to post them here.

User Group

For Q/A and discussion here.

Wiki

For roadmap, user guide, documentation. We welcome any documentation contribution. here.

Contribution

We welcome any and all suggestions. Our development guide is currently WIP so check back often for any updates.

For contributions, please make a pull-request against our master branch.

We would love to see additional tracing support for libraries such as Storm, HBase, as well as profiler support for additional languages (.NET, C++).

License

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

Copyright 2014 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.