꼬반 Blog

네이버에서 얼마전 공개한 오픈소스 APM인 PINPOINT 1.5 버전을 설치하여 테스트 하고 있는 중이다.

설치에 대한 블로그와 동영상을 참고하였고, 결국 결론은 Quick Start Guide 가 짱이다....

설치 순서는 다음과 같다.

1. yum update -y

2. 사전 요구사항

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

  2.1. 각각의 항목은 오라클 자바에서 다운받아 특정 폴더에 설치한다.

  2.2. /usr/local/src 경로에 설치하였다고 할때 환경변수 설치는 아래와 같다.

  2.3. 1.0 대 버전에는 JAVA_8 미지원하였으나 1.5로 업데이트 되면서 JAVA_8 이 추가 되었다.

  2.4. 메이븐은 3.3.3 버전을 사용

# vim~/.bash_profile


export JAVA_HOME=/usr/local/src/jdk1.7.0_80
export JAVA_6_HOME=/usr/local/src/jdk1.6.0_45
export JAVA_7_HOME=/usr/local/src/jdk1.7.0_80
export JAVA_8_HOME=/usr/local/src/jdk1.8.0_60
PATH=$PATH:$HOME/bin
PATH=$PATH:$JAVA_HOME/bin
PATH=$PATH:/usr/local/src/maven/bin


# source ~/.bash_profile

3. pinpoint 설치

  3.1. git 으로 pinpoint download 해준다.

  # git clone https://github.com/naver/pinpoint.git

  3.2. 해당 폴더로 이동하여 빌드하여 준다.

  # cd pinpoint

  # mvn install -Dmaven.test.skip=true

  3.3. hbase 설치하기

  빌드한 pinpoint 폴더에 들어가보면 quickstart/bin 폴더가 있고 해당 폴더내에 hbase를 설치하는 스크립트가 있다.

  설치후에는 init-hbase 로 초기 db와 table 을 설정하여 준다.

  # ./quickstart/bin/start-hbase.sh

  # ./quickstart/bin/init-hbase.sh

4. pinpoint 실행

  4.1. Collector - # ./quickstart/bin/start-collector.sh

  4.2. Web UI - # ./quickstart/bin/start-web.sh

  4.3. TestApp - # ./quickstart/bin/start-testapp.sh

5. 확인

  5.1. Web UI - http://localhost:28080

  5.2. TestApp - http://localhost:28081

6. 정지

  6.1. Hbase - # ./quickstart/bin/stop-hbase.sh

  6.2. Collector - # ./quickstart/bin/stop-collector.sh

  6.3. Web UI - # ./quickstart/bin/stop-web.sh

  6.4. TestApp - # ./quickstart/bin/stop-testapp.sh

7. 참고

  7.1. 공식 quick start guide - https://github.com/naver/pinpoint/blob/master/quickstart/README.md

  7.2. 허광남 님의 유투브 동영상 - 1편 https://www.youtube.com/watch?v=xipAXrm4vEI

                                       2편 https://www.youtube.com/watch?v=_IZkQG2kaTI

                                       3편 https://www.youtube.com/watch?v=lGiOCHwr4os

8. agent 설정

  리눅스 환경에서 Tomcat의 실행스크립트에 다음과 깉이 셋팅합니다.

  export AGENT_PATH={Pinpoint Agent 경로}
  export CATALINA_OPTS="$CATALINA_OPTS -javaagent:$AGENT_PATH/pinpoint-bootstrap-1.5.0-SNAPSHOT.jar"
  export CATALINA_OPTS="$CATALINA_OPTS -Dpinpoint.agentId=agentId_01"
  export CATALINA_OPTS="$CATALINA_OPTS -Dpinpoint.applicationName=agentId_01_Name"

agentID 와 applicationName 은 유일한 값입니다. 그리고 해당 경로에 pinpoint.config 파일에 collector Server ip를 수정합니다. 추가로 포트 번호가 default 는 9994 / 9995 / 9996 으로 되어 있는데 1.5.0 버전엔 29994 / 29995 / 29996 이므로 해당 포트 번호로 수정하고 톰캣을 실행시켜주면 설정은 끝입니다.