[Linux] Scouter 설치 및 구성

＠ 사전작업

- Linux에 Tomcat이 설치되어 있는 환경

- Server, Agent, Client 모두 JDK 8 이상 필요

- Selinux disable

 

 

 

 

 

# 지표 수신 서버(Collector) 작업

1. https://github.com/scouter-project/scouter/releases에서 scouter-all-2.10.0.tar.gz를 서버에서 wget으로 다운로드 후 압축 해제

 

 

2. /scouter/server/conf/scouter.conf 수정

# database directory
db_dir=/usr/local/src/scouter/server/database



# log directory
log_dir=/usr/local/src/scouter/server/logs



# udp port
net_udp_listen_port=6100



# tcp port
net_tcp_listen_port=6100

# 아래 설정은 서버에 쌓이는 Scouter 데이터를 저장하는 기간을 설정하여 
# 과하게 쌓인 데이터를 제거하기 위해 사용

# 디스크의 특정 용량을 초과하면 과거 데이터부터 삭제한다.
mgr_purge_disk_usage_pct=90
	
# 프로파일 데이터를 유지하는 기간(일반적으로 가장 큰 사이즈의 데이터이다.)
mgr_purge_profile_keep_days=30
	
# XLog를 유지하는 기간
mgr_purge_xlog_keep_days=30
	
# 성능 카운터 정보를 유지하는 기간
mgr_purge_counter_keep_days=30

데이터베이스 관련 구성 출처 : http://gunsdevlog.blogspot.com/2018/05/scouter-apm-xlog-howto.html 

 

 

3. Scouter Server(Collector) 실행

/scouter/server/startup.sh

 

 

# 서버 지표 송신 Agent 작업

1. https://github.com/scouter-project/scouter/releases에서 scouter-all-2.10.0.tar.gz를 서버에서 wget으로 다운로드 후 압축 해제

 

2. /scouter/agent.host/conf/scouter.conf 수정

### scouter host configruation sample 
#net_collector_ip=127.0.0.1 
#net_collector_udp_port=6100 
#net_collector_tcp_port=6100 
.

.

.

 

▲ 수정하지 않으면 기본값으로 구성
※ 위에 지표 수신 서버를 구성한 서버 정보를 입력해야 함

 

 

3. Host agent 실행

/scouter/agent.host/host.sh

 

 

# 자바 지표 송신 Agent 작업

1. /scouter/agent.java/conf/scouter.conf 수정

### scouter java agent configuration sample 

#obj_name=WAS-01 
#net_collector_ip=127.0.0.1 
#net_collector_udp_port=6100 
#net_collector_tcp_port=6100

.

.

.

 

▲ 수정하지 않으면 기본값으로 구성

※ 위에 지표 수신 서버를 구성한 서버 정보를 입력해야 함

 

2. Scouter와 연동 할 Tomcat의 catalina.sh에 아래의 내용 추가

 

JAVA_OPTS=" ${JAVA_OPTS} -javaagent:/usr/local/src/scouter/agent.java/scouter.agent.jar" // scouter.agent.jar 파일 위치

JAVA_OPTS=" ${JAVA_OPTS} -Dscouter.config=/usr/local/src/scouter/agent.java/conf/scouter.conf" // scouter.conf 파일 위치

JAVA_OPTS=" ${JAVA_OPTS} -Dobj_name=WAS-01" // agent.java/conf/scouter.conf에 설정한 obj_name

▲ 톰캣이 아닌 java -jar ~ 명령어를 사용하여 자바 애플리케이션을 실행 할 경우 위의 JAVA_OPTS를 추가하여 실행하면 됨

 

 

3. Tomcat or 자바 애플리케이션 실행

 

 

# Scouter Client 작업

1. https://github.com/scouter-project/scouter/releases에서 설치할 환경에 맞는 Scouter Client 다운로드 후 압축 해제

 

 

2. 폴더 안의 Scouter.exe 파일 실행 [ Window 기준 ]

 

• Server Address : < scouter Collector가 실행중인 서버 IP:port > ex) 192.168.10.93:6100
• ID : admin // (기본값)
• Password : admin // (기본값)

 

 

3. Scouter 설치 및 구성 완료