[Linux | Scouter | Tomcat] Linux에 Scouter APM 설치 및 설정 (TOmcat 대상)

0. 개요

-Scouter는 LG CNS에서 개발 및 배포한 무료 APM이다. 이 툴을 통해 WAS의 성능 모니터링이 가능하다(heap memory, session 수, SQL 조회 등)

-크게 세 가지의 프로그램 설치가 필요하다.

-Agent: WAS가 설치된 서버에 설치하며, 실시간 서비스 성능 정보, Heap Memory, Thread 등 Java 성능을 조사하여 정보를 획득함
-Server(Collector): WAS가 설치된 서버에 설치하며, Agent가 전송한 데이터 수집/처리
-Client(Viewer): 수집된 성능 정보를 확인하기 위한 Client 프로그램

 

 

1. 다운로드 및 설치

-Scouter 파일 다운로드(https://github.com/scouter-project/scouter/releases)
-v0.5.1 release
 .scouter.agent.tar.gz
 .scouter.server.tar.gz
 .scouter.client.product-win32.win32.x86.zip

 

(1)agent 설치

-서버 업로드 및 압축 풀기(적당한 폴더에)
-scouter.conf 설정

# Scouter Server IP Address (Default : 127.0.0.1)
net_collector_ip=10.80.1.234 수집서버 설정
# Scouter Server Port (Default : 6100)
net_collector_udp_port=6100
net_collector_tcp_port=6100
# Scouter Name(Default : tomcat1)
obj_name=sepcweb01
#JDBC Query(Default : True)
profile_sql_escape=false
profile_thread_cputime_enabled=true
trace_interservice_enabled=true

 

-catalina.sh 에 다음 입력

###### SCOUTER OPTIONS ####################################################################
if [ "$1" = "start" -o "$1" = "run" ]; then
  export JAVA_OPTS="$JAVA_OPTS -javaagent:$CATALINA_HOME/../scouter.agent/agent.java/scouter.agent.jar"
  export JAVA_OPTS="$JAVA_OPTS -Dscouter.config=$CATALINA_HOME/../scouter.agent/agent.host/conf/scouter.conf"
  export JAVA_OPTS=$JAVA_OPTS -Dnet_collector_ip=10.80.1.234 <- 같은 서버에 scouter.server/scouter.agnet 설치시 주석처리 해도 상관 없음
fi
###############################################################################################

-NT의 경우, 다음 입력

rem ###### SCOUTER OPTIONS ###########################################################
if "%1"=="stop" goto skip_agent
set JAVA_OPTS=%JAVA_OPTS% -javaagent:%CATALINA_HOME%\..\scouter\agent.java\scouter.agent.jar
set JAVA_OPTS=%JAVA_OPTS% -Dscouter.config=%CATALINA_HOME%\..\conf\myTomcat1.conf
rem set JAVA_OPTS=%JAVA_OPTS% -Dnet_collector_ip=127.0.0.1<- 같은 서버에 scouter.server/scouter.agnet 설치시 주석처리 해도 상관 없음
###############################################################################################



-적용 위해서 Tomcat 재시작 필요

 

(2)server 설치

-서버 업로드 및 압축 풀기
-scouter.conf 설정

# Agent Control and Service Port(Default : TCP 6100)
net_tcp_listen_port=6100
# UDP Receive Port(Default : 6100)
net_udp_listen_port=6100
# DB directory(Default : ./database)
db_dir=./database
# Log directory(default : ./logs)
log_dir=./logs

 

-startup.sh 실행

(3)Client 설치

-OS 별 클라이언트 다운로드

-java 1.8.x 이상 설치된 클라이언트에서만 사용 가능
-자바 1.8 다운로드 및 설치 후,
-scouter.ini에 다음 행 추가

 

-vm
C:\Program Files\Java\jdk1.8.0_102

 

클라이언트에서 서버 IP 입력 후, admin, admin 로그인