Scouter APM

 

Scouter APM은 Java 기반의 오픈소스 애플리케이션 성능 모니터링 도구입니다. 실시간으로 애플리케이션의 성능, 리소스 사용량, 트랜잭션 흐름 등을 모니터링할 수 있어, 서버 상태를 빠르게 파악하고 문제를 해결할 수 있도록 도와줍니다.

Scouter APM 구성은 보통 아래과 같이 이루어집니다.

 

• Agent: 모니터링 대상 시스템(JVM 등)에 설치됨.
• Collector: Agent에서 수집한 데이터를 받아 저장하고 가공함.
• Server (Scouter Server): 데이터를 관리하고 클라이언트에게 제공.
• Client (UI): Windows, Mac 등 에서 실행되는 GUI 클라이언트 프로그램으로 실시간 모니터링 가능.

---

1. 전체 구성 요약 (서버 + 클라이언트)

* 서버 -> Scouter Collector (서버 + 저장소 역할) - Agent (필요 시 설치)
* Windows 클라이언트 -> Scouter Client (GUI 프로그램)

 

---

2. Scouter 서버 구축 과정

2.1. Java 설치

Scouter는 Java 기반이므로 먼저 JDK를 설치합니다.

sudo apt update sudo apt install openjdk-11-jdk -y

java -version

 

 

---

2.2. Scouter 다운로드

공식 GitHub 또는 릴리즈 페이지에서 다운로드:
https://github.com/scouter-project/scouter/releases

 

cd /opt sudo wget https://github.com/scouter-project/scouter/releases/download/v2.20.0/scouter-all-2.20.0.tar.gz 

sudo tar -xzvf scouter-all-2.20.0.tar.gz sudo mv scouter /opt/scouter

---

2.3. Collector 설정

Scouter Collector는 /opt/scouter/server에 위치합니다.

cd /opt/scouter/server

 

환경 설정 파일은 다음 경로에 있습니다:

vi conf/scouter.conf

 

기본 설정 예:

# 수집 서버 포트 
net_collector_ip=127.0.0.1
net_udp_listen_port=6100 
net_tcp_listen_port=6100 

# 로그 및 저장소 위치 설정 
log_dir=./logs obj_name=ubuntu-server 

# 데이터 저장 주기 설정 (선택) 
# db_dir=./database

---

2.4. Collector 실행

 

#실행 로그는 logs 디렉터리에서 확인할 수 있습니다.
./startup.sh

#Collector는 기본적으로 TCP 6100 포트를 사용합니다. 해당 포트를 방화벽에서 허용해야 합니다.
sudo ufw allow 6100

 

---

2.5. Agent 설치 (Java 애플리케이션 모니터링 시)

만약 Tomcat, Spring 등의 Java 앱을 모니터링하려면 Agent도 설치해야 합니다.

# 서버 주소 net_collector_ip=127.0.0.1 
# 또는 서버 IP 
# 모니터링 대상 이름 obj_name=webapp01

cd /opt/scouter cp -r agent.java /opt/scouter-agent cd /opt/scouter-agent vi conf/scouter.conf

#애플리케이션 실행 시 다음 옵션을 추가:
-javaagent:/opt/scouter-agent/scouter.agent.jar

#예: Tomcat에 적용 시
export JAVA_OPTS="$JAVA_OPTS -javaagent:/opt/scouter-agent/scouter.agent.jar"

---

3. Windows 클라이언트 설치 및 설정

3.1. Scouter Client 다운로드

Scouter GitHub Releases에서 scouter-client 다운로드.

 

scouter-client.product-win32.win32.x86_64.zip 압축 해제 후 scouter-client.exe 실행.

 

-> 실행 오류 시 클라이언트 pc에 java 설치 및 시스템 환경 변수 설정 확인 (java 11 이상 필요)

---

3.2. 서버 연결

1. 실행 후 Server Address (6100포트 포함) 입력
2. ID / Password 입력 후 접속 (admin/admin)
3. 접속 확인
4. 접속 후 좌측 트리에서 obj_name으로 등록한 서버와 애플리케이션이 보이면 성공.

---

4. 구성 확인

정상 연결되었다면 아래와 같은 항목을 확인할 수 있습니다:

• CPU 사용률
• 메모리 사용량
• TPS (Transaction per second)
• Active Service
• SQL 및 API 호출 시간
• WAS Thread 상태
• 로그 추적

---

5. 추가 팁

• 데이터 보존 기간 설정: scouter.conf에서 db_retention_days로 설정 가능
• 웹 대시보드: Scouter에는 기본 Web UI는 없지만, 커뮤니티에서 만든 대시보드 도구들도 존재 (예: scouter-paper 등)
• 보안 고려: Collector 포트에 인증 없음 → 방화벽/IP 필터링 등 설정 필요

---

6. 마무리

요약

항목위치/도구

Collector 설치	Ubuntu (/opt/scouter/server)
Agent 설정	Ubuntu Java App (/opt/scouter-agent)
Client 설치	Windows (scouter-client)
연결 포트	기본 6100 TCP/UDP

설치 경로 등은 사용자 환경에 맞게 변경하여 사용해도 무방합니다.

 

감사합니다.