Pinpoint agent 설치

핀포인트란?

  • 네이버에서 개발한 오픈소스 APM(Application Performance Management)
  • 대규모 분산시스템에 특화된 성능 분석 및 문제 진단을 위해 등장한 플랫폼

pinpoint-agent 설치

agent 설치

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

최신 버전은 여기를 참고하면 된다.

압축해제

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

properties 설정

$ vim ./pinpoint-agent-2.2.0/profiles/release/pinpoint.config
profiler.transport.grpc.collector.ip=[서버 ip 설정]
profiler.collector.ip=[서버 ip 설정]

pinpoint-agent 실행

WAS가 jar로 되어 있는 경우

자바 실행시에 아래 옵션을 추가한다.

-javaagent:${pinpointPath}/pinpoint-bootstrap-1.8.4.jar 
-Dpinpoint.applicationName=[고유값] 
-Dpinpoint.agentId=[핀포인트내에서 보여질 이름]

옵션츨 추가한 예이다

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 

WAS가 tomcat으로 되어 있는 경우

./tomcat/bin/catalina.sh 파일을 아래와 같은 내용을 위 부분에 추가한다.

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" # 고유 ID
CATALINA_OPTS="$CATALINA_OPTS -Dpinpoint.applicationName=helloWeb" # 그룹 ID

내용을 추가 후에 tomcat을 재기동한다.

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

참조




최종 수정 : 2021-06-22