[APM 툴] scouter 설치 가이드

안녕하세요. 초보 개발자 입니다.

오늘은 스카우터라는 오픈소스 APM 툴 설치하는 방법을 가이드 하려고 합니다.

1. APM (Application Perpermance Monitoring) 이란?

   말 그대로 어플리케이션 성능을 모니터링 할 수 있는 툴 입니다.

   주로 개발시기에는 에러검출용(?) 운영시기에는 성능 모니터링 용도로 많이 사용됩니다.

   공공/금융 기업은 주로 제니퍼라는 APM(상용)을 많이 씁니다.

   스카우터는 이 중 톰캣 또는 JBoss 같은 톰캣 계열 어플리케이션 서버에 한정되어 사용할 수 있는 APM 모니터링 툴 입니다.

2. 환경 정의

- 스카우터 버전 1.7.3.1 버전 기준으로 합니다.

- 스카우터는 윈도우 클라이언트(로컬환경), 서버 수집서버, 서버 에이전트로 구분 되어 설치 됩니다.

- 우분투 서버에서 스카우터 수집서버 설치 위치는 /engn001/scouter로 지정합니다.

- 모니터링 대상 어플리케이션 서버는 tomcat 8.x 버전 입니다.

3. 스카우터 간단 아키텍처

 

4. 스카우터 설치 방법

a. sudo mkdir /engn001 (p 옵션은 필요 없음)

b. cd /engn001/

c. sudo wget https://github.com/scouter-project/scouter/releases/download/v1.7.3.1/scouter-all-1.7.3.1.tar.gz

d. sudo tar xvf ./scouter-all-1.7.3.1.tar.gz

e. sudo vi /engn001/scouter/agent.java/conf/scouter.conf #agent.java 설정 파일을 수정한다.

   해당 파일을 보면 3가지의 옵션이 있습니다.

   - net_collector_ip : 수집서버 IP ( 실제 정보를 수집함=collector, 저는 로컬에서 띄워서 확인할 예정이므로 127.0.0.1로 하겠습니다. )

   - net_collector_udp_port = 6100 (collector와 agent는 6100 포트를 이용해서 통신, 기재하지 않으면 default 6100)

   - net_collector_tcp_port = 6100 (collector와 agent는 6100 포트를 이용해서 통신, 기재하지 않으면 default 6100)

   

f. sudo vi /engn001/scouter/agent.host/conf/scouter.conf

   - agent.host는 리눅스 서버의 자원 정보를 모니터링 합니다. (cpu 사용률, 메모리 등)

   - 위와 동일한 3가지 정보를 적습니다. ( e 와 동일 )

   

5. 톰캣 설정

  - 톰캣 catalina.sh 파일 또는 startup.sh 파일에 아래 내용을 추가 합니다.

  

export SCOUTER_DIR=/engn001/scouter # 해당 경로는 scouter가 설치된 경로로 수정

JAVA_OPTS="${JAVA_OPTS} -javaagent:${SCOUTER_DIR}/agent.java/scouter.agent.jar"

JAVA_OPTS="${JAVA_OPTS} -Dscouter.config=${SCOUTER_DIIR}/agent.host/conf/scouter.conf"

  JAVA_OPTS="${JAVA_OPTS} -Dobj_name=${INST_NAME}" # obj_name은 식별할 수 있는 이름을 입력해야 합니다. (client 프로그램에서 obj_name으로 보여집니다.)

 export JAVA_OPTS

6. collector 서버 가동

   sh /scouter/server/startup.sh

7. agnet.host 가동

   sh /engn001/scouter/agent.host/host.sh

8. 톰캣 기동

9. 스카우터 클라이언트 다운로드

   https://github.com/scouter-project/scouter/releases/download/v1.7.3.1/scouter.client.product-win32.win32.x86_64.zip

10. 적당한 경로에 압축 풀고 설치

  scouter.exe파일 실행

 

11. 서버 접속

 - Server Address: 127.0.0.1:6100 (collector IP:PORT)

 - ID: admin

 - Password: admiin

12. 내용 확인