Installing the Pinpoint Agent

What is Pinpoint?

An open source APM (Application Performance Management) tool developed by Naver.
A platform created for performance analysis and problem diagnosis, specialized for large-scale distributed systems.

Installing pinpoint-agent

Install the agent

$ wget https://github.com/pinpoint-apm/pinpoint/releases/download/v2.2.0/pinpoint-agent-2.2.0.tar.gz

For the latest version, refer to this page.

Extract the archive

$ tar xvfz pinpoint-agent-2.2.0.tar.gz

Configure properties

$ vim ./pinpoint-agent-2.2.0/profiles/release/pinpoint.config

profiler.transport.grpc.collector.ip=[server ip setting]
profiler.collector.ip=[server ip setting]

Running pinpoint-agent

When the WAS is packaged as a jar

Add the following options when running Java.

-javaagent:${pinpointPath}/pinpoint-bootstrap-1.8.4.jar
-Dpinpoint.applicationName=[unique value]
-Dpinpoint.agentId=[name shown in Pinpoint]

The following is an example with the options added.

java -jar
-javaagent:/home/ec2-user/pinpoint/pinpoint-agent/pinpoint-bootstrap-1.8.4.jar
-Dpinpoint.agentId=hello
-Dpinpoint.applicationName=helloWeb
-Dspring.profiles.active=real
/home/ec2-user/hello-0.0.1-SNAPSHOT.jar

When the WAS is Tomcat

Add the following content near the top of the ./tomcat/bin/catalina.sh file.

AGENT_PATH="/usr/local/pinpoint-agent-2.2.0"
CATALINA_OPTS="$CATALINA_OPTS -javaagent:$AGENT_PATH/pinpoint-bootstrap.jar"
CATALINA_OPTS="$CATALINA_OPTS -Dpinpoint.agentId=hello" # unique ID
CATALINA_OPTS="$CATALINA_OPTS -Dpinpoint.applicationName=helloWeb" # group ID

After adding the content, restart Tomcat.

$ ./shutdown.sh
$ ./startup.sh