cutting edge
Official website: http://naver.github.io/pinpoint/
four-piece pinpoint set:
- HBase (for storage)
- Pinpoint Collector (deployed on a web container)
- Pinpoint Web (deployed on a web container)
- Pinpoint Agent (attached to a java application for profiling)
List of installation dependencies
JAVA dependency of HBASE
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 |
1.7.x | no | not tested | not tested | not tested | yes |
JAVA dependencies of PinPoint
Pinpoint Version | Agent | Collector | Web |
---|---|---|---|
1.0.x | 6-8 | 6+ | 6+ |
1.1.x | 6-8 | 7+ | 7+ |
1.5.x | 6-8 | 7+ | 7+ |
1.6.x | 6-8 | 7+ | 7+ |
1.7.x | 6-8 | 8+ | 8+ |
Dependency between Agent and Collector
Agent Version | Collector 1.0.x | Collector 1.1.x | Collector 1.5.x | Collector 1.6.x | Collector 1.7.x |
---|---|---|---|---|---|
1.0.x | yes | yes | yes | yes | yes |
1.1.x | not tested | yes | yes | yes | yes |
1.5.x | no | no | yes | yes | yes |
1.6.x | no | no | not tested | yes | yes |
1.7.x | no | no | no | no | yes |
Install
Install JAVA
slightly
HBase installation
First download hbase: http://www.apache.org/dyn/closer.cgi/hbase/
Start installing hbase: http://hbase.apache.org/book.html#_introduction
After decompression, execute ``bin/start-hbase.sh`` directly.
Initialize ``./bin/hbase shell /scripts/hbase-create.hbase``. Scripts can be downloaded here: https://github.com/naver/pinpoint/tree/1.6.x/hbase/scripts. Note the version number in the link.
Here you can also initialize ``hbase-create-snappy.hbase`` with compression.
PinPoint installation
> Use the release method to install here, which is also the officially recommended method.
Download: https://github.com/naver/pinpoint/releases/tag/1.7.2
Install Collector
Deploy the downloaded pinpoint-collector-$VERSION.war into a web container such as tomcat.
Collector provides two configuration files: ``pinpoint-collector.properties`` and ``hbase.properties``. The configuration files are located in WEB-INF/classes in the deployment directory.
Basic configuration in pinpoint-collector.properties:
collector.tcpListenPort
(agent’s profiler.collector.tcp.port - default: 9994)collector.udpStatListenPort
(agent’s profiler.collector.stat.port - default: 9995)collector.udpSpanListenPort
(agent’s profiler.collector.span.port - default: 9996)
Basic configuration in hbase.properties:
hbase.client.host
(default: localhost)hbase.client.port
(default: 2181)
install web
Deploy the downloaded pinpoint-collector-$VERSION.war into a web container such as tomcat.
Web provides two configuration files ``pinpoint-web.properties`` and ``hbase.properties``. Configuration files are located in WEB_INF/classes in the deployment directory.
Basic configuration of hbase.properties:
hbase.client.host
(default: localhost)hbase.client.port
(default: 2181)
Install Agent
Pinpoint Agent runs as a java agent attached to an application to be profiled (such as Tomcat).
Unzip pinpoint-agent-1.7.2-SNAPSHOT.tar.gz. (The idea needs to be made into a directory, otherwise it may be scattered. Recommended name: pinpoint-agent).
If you want to change the log level of the output, you can modify the ``pinpoint-agent/lib/log4j.xml`` file.
Application burying method:
```
CATALINA_OPTS="$CATALINA_OPTS -javaagent:$AGENT_PATH/pinpoint-bootstrap-$VERSION.jar"
CATALINA_OPTS="$CATALINA_OPTS -Dpinpoint.agentId=$AGENT_ID"
CATALINA_OPTS="$CATALINA_OPTS -Dpinpoint.applicationName=$APPLICATION_NAME"
```
Agent provides a configuration file: $AGENT_PATH/pinpoint.config.
Basic configuration to check:
profiler.collector.ip
(default: 127.0.0.1)profiler.collector.tcp.port
(collector’s collector.tcpListenPort - default: 9994)profiler.collector.stat.port
(collector’s collector.udpStatListenPort - default: 9995)profiler.collector.span.port
(collector’s collector.udpSpanListenPort - default: 9996)
Summarize
At this point, the simple pinpoint environment is completed. You can visit the web service to see the effect.
We will share clustering, tuning, notification and other functions later.