Scouter - 설치

도움이 되셨다면 공감(♡) 부탁드립니다. 감사합니다.

 

◈ Scouter 란?
Scouter는 오픈 소스 APM (Application Performance Management) tool

 

◈ Scouter Architecture

Server, Agent, Client 3개 모듈로 구성

 

Server(Collector) : Agent가 보내오는 데이터를 수집 처리

Agent : 성능 데이터를 데이터 수집하여 Server로 데이터를 보낸다

       agent.host - CPU, 메모리, 디스크 등 서버의 성능 데이터 수집

       agent.java - Java 프로그램의 성능 데이터 수집

Client(Viewer) : Server에 수집된 데이터를 확인하는 Client 프로그램

 

Scouter Architecture

 

◈ 설치 정보 및 설치 파일 다운로드

Server(Collector) 및 Agent는 Linux(CentOS 7)에 설치, Client는 Windows 10에 설치

 

https://github.com/scouter-project/scouter/releases/tag/v2.10.2

- 작성일 기준 최신 버전 다운로드

scouter-all-2.10.2.tar.gz : Server, Agent 설치 파일

scouter.client.product-win32.win32.x86_64.zip : Client Windows용 설치 파일

 

◈ Server(Collector) 또는 Agent 설치

1) 다운로드 한 scouter-all-2.10.2.tar.gz 파일 압축 해제하면 scouter 디렉터리가 생성되고 Server 및 Agent 모듈들이 하위 디렉터리로 설치됨

2) 여기서는 "/scouter" 디렉토리로 가정

3) /scouter/server : 서버 모듈

4) /scouter/agent.host : host 모니터링 모듈

5) /scouter/agent.java : tomcat(java) 모니터링 모듈

6) Server는 JDK 1.8 이상, Agent는 JDK 1.6이상

 

◈ Server(Collector) 설정 및 실행

1) /scouter/server/conf/scouter.conf - 서버 설정 파일

defalult 설정으로 작동되므로 수정하지 않고 바로 실행해도 된다

 

- 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

 

2) /scouter/server 디렉터리에서 실행

./startup.sh 실행

./stop.sh 중지

 

 

◈ agent.host 설정 및 실행

1) scouter/agent.host/conf/scouter.conf 파일 설정

 

net_collector_ip=Server(Collector) IP
net_collector_udp_port=6100
net_collector_tcp_port=6100
cpu_warning_pct=80
cpu_fatal_pct=85
cpu_check_period_ms=60000
cpu_fatal_history=3
cpu_alert_interval_ms=300000
disk_warning_pct=88
disk_fatal_pct=92

 

default 값으로 실행하려면 주석만 해제하면 되고 net_collector_ip를 "Server IP'로 설정한다.

 

2) /scouter/agent.host 디렉터리에서 실행

./host.sh 실행

./stop.sh 중지

 

 

◈ agent.java 설정 - tomcat 모니터링

1) Tomcat 실행될 때 scouter agent 라이브러리(scouter.agent.jar)가 로드되어 실행 됨. tomcat 실행 환경 설정 추가 필요

 

2) ${TOMCAT_DIR}/bin/catalina.sh 파일에 scouter 설정 추가

 

SCOUTER_AGENT_DIR="/scouter/agent.java"
JAVA_OPTS=" ${JAVA_OPTS} -javaagent:${SCOUTER_AGENT_DIR}/scouter.agent.jar"
JAVA_OPTS=" ${JAVA_OPTS} -Dscouter.config=${SCOUTER_AGENT_DIR}/conf/scouter1.conf"

 

- ${SCOUTER_AGENT_DIR} : scouter.agent.jar 가 있는 디렉터리. 여기서는 "/scouter/agent.java"

- /scouter/agent.java/conf/scouter1.conf 설정 : obj_name, net_collector_ip를 맞게 설정하고, 나머지는 defalult 값으로 실행 가능

obj_name=object 이름 설정
net_collector_ip=Server(Collector) IP

 

 

◈ Client 설치 및 실행

1) 사용 PC OS 환경에 맞게 다운로드, Windows용인 scouter.client.product-win32.win32.x86_64.zip 다운로드

2) 다운로드 받은 파일 압축 해제

3) scouter.exe 실행

4) Server(Collector) IP 입력, 초기 admin 설정은 admin/admin

 

 

◈ 확인할 것

- JDK가 설치되어 있어야 한다

- 6100 포트를 사용하므로 방화벽에서 open되어 있어야 한다

 

◈ 2021. 10. 1 v2.15.0 배포됨 (Java 17 지원 등)

https://github.com/scouter-project/scouter/releases/tag/v2.15.0

 

 

※ 참고

- Scouter Project

https://github.com/scouter-project/scouter

 

- Scouter Setup

https://github.com/scouter-project/scouter/blob/master/scouter.document/main/Setup.md

 

- download

https://github.com/scouter-project/scouter/releases/tag/v2.10.2

 

- openJDK

https://github.com/ojdkbuild/ojdkbuild