오픈소스 APM Scouter 설치 및 사용법

1.  스카우터(Scouter)란?

• LG CNS에서 개발한 오픈소스 APM(Application Performance Monitoring)
• APM : 애플리케이션의 성능을 모니터링하고 통제할 수 있는 툴
• Windows, Linux, Mac 등의 다양한 OS의 성능 및 Java 애플리케이션 성능 데이터 수집

• Server(Collector)
  데이터를 수집하고 저장하며, 이 데이터를 연결되어 있는 클라이언트에 전달
• Host agent
  호스트의 CPU, 메모리, 디스크 등의 데이터를 수집하여 server에 전달
• Java agent
  Java 애플리케이션 Heap, TPS, GC Time 등의 데이터를 수집하여 server에 전달

 

 

---

 

2.  설치파일 다운로드

다운로드 링크

• scouter-all-x.xx.tar.gz : 서버와 에이전트 파일이 모두 포함되어 있음
• scouter.client.product-os.x86_64.tar.gz : OS에 맞는 클라이언트 다운로드

 

 

 

---

 

3.  사전 작업

• 방화벽 오픈
  • 에이전트 --> 서버 : TCP/UDP 6100 포트 오픈 필요
  • 서버 --> 클라이언트 : TCP 6100 포트 오픈 필요

 

 

---

 

4.  서버 설정 및 실행

• scouter/server/conf/scouter.conf 수정 (기본 설정)

# 스카우터 서버 ID, 수집 서버가 여러 대 있을 경우 ID 지정 필요
server_id=

# 서버 리스닝 TCP/UDP 포트, 디폴트 6100
net_tcp_listen_port=
net_udp_listen_port=

# 저장되는 데이터 경로 (디렉토리명 : database)
db_dir=

# 로그 경로 (디렉토리명 : logs)
log_dir=

• 실행
  scouter/server/startup.sh
  scouter/server/startup.bat
• 중지
  scouter/server/stop.sh
  scouter/server/stop.bat

 

 

---

 

5.  호스트 에이전트 설정 및 실행

• scouter/agent.host/conf/scouter.conf 수정 (기본 설정)

# 수집 서버 IP 및 리스닝 포트
net_collector_ip=
net_collector_udp_port=
net_collector_tcp_port=

# 오프젝트명 (클라이언트에 표시될 이름)
obj_name=

# 호스트명
# 이 호스트에서 자바 에이전트도 실행한다면, 자바 에이전트 설정 파일에 obj_host_name 동일하게 설정  
host_name=

• 실행
  /scouter/agent.host/host.sh
  /scouter/agent.host/host.bat
• 중지
  /scouter/agent.host/stop.sh
  /scouter/agent.host/stop.bat

 

 

---

 

6.  자바 에이전트 설정 및 실행 (Tomcat App)

• scouter/agent.java/conf/scouter.conf 수정 (기본 설정)

# 수집 서버 IP 및 리스닝 포트
net_collector_ip=
net_collector_udp_port=
net_collector_tcp_port=

# 오프젝트명 (클라이언트에 표시될 이름)
obj_name=

# 호스트 에이전트 설정 파일에서 기재한 host_name과 동일하게 작성
obj_host_name=

• $TOMCAT_HOME/bin/catalina.sh 수정

# ${SCOUTER_AGENT_DIR} : agent.java 경로
export JAVA_OPTS="$JAVA_OPTS -javaagent:${SCOUTER_AGENT_DIR}/scouter.agent.jar"
export JAVA_OPTS="$JAVA_OPTS -Dscouter.config=${SCOUTER_AGENT_DIR}/conf/scouter.conf"
export JAVA_OPTS="$JAVA_OPTS -Dnet_collector_ip=수집 서버 IP"

• 톰캣 재기동 (JVM 실행시에 같이 기동됨)

 

😂 이슈 사항

• 운영되고 있는 Tomcat 서비스에 적용했는데, 현시점 최신 버전인 2.17.1 자바 에이전트는 실행시에 오류가 발생 했음
• 자바 에이전트만 조금 이전의 버전으로 다운그레이드 했는데, 정상적으로 동작함
• 정확한 오류 원인은 아직 밝히지 못함

 

 

---

 

7.  클라이언트 프로그램 실행

• scouter.client/scouter.exe 실행

• Server Address : 수집 서버 IP:Port
• ID : admin
• Password : admin

• 분석하고 싶은 성능 지표로 커스터마이징해서 대시보드를 만들 수 있음
• 보통 기본적으로 분석하는 지표
  • 호스트 에이전트
    • CPU
    • Memory
    • Network TX Bytes/RX Bytes
    • Swap
  • 자바 에이전트
    • GC Count/Time
    • Heap Used/Memory
    • TPS
    • Active Service EQ
    • Active Speed
    • XLog : 스카우터의 꽃! 핵심 지표라 할 수 있음