공개 APM 툴인 Scouter (스카우터) Installation

1. 참고사항

about Scouter : /index.php/java/333
APM 도구 종류 : Jennifer, Sysmaster, TunA, Scouter

2. 설치

스카우터를 설치하기 위한 핵심만 정리하였다. 설치 대상 애플리케이션 서버는 톰캣이다. 구성은 크게 애플리케이션 서버에 붙는 에이전트, 데이터를 수집·저장하는 서버, 화면에서 확인하는 클라이언트로 나뉜다.

다운로드 링크 : https://github.com/scouter-project/scouter/releases

2-1. 에이전트(scouter.agent.tar.gz)

애플리케이션 서버(톰캣 등)에 올리는 라이브러리이다.
scouter.agent.jar 파일을 톰캣의 lib 디렉터리에 넣는다.
conf/scouter.conf 설정

net_collector_ip=127.0.0.1
net_collector_tcp_port=6100
net_collector_udp_port=6100
obj_name=tomcat_1

net_collector_ip는 스카우터 서버가 실행되는 IP이다. 에이전트와 서버를 같은 장비에서 테스트한다면 127.0.0.1로 시작해도 되지만, 실제 서버가 분리되어 있다면 스카우터 서버의 IP로 변경해야 한다. obj_name은 클라이언트에서 구분할 톰캣 인스턴스 이름이므로, 여러 대를 붙일 때는 서로 다르게 지정한다.

bin/setenv.sh 설정

CATALINA_OPTS="$CATALINA_OPTS -javaagent:$CATALINA_BASE/lib/scouter.agent.jar"
CATALINA_OPTS="$CATALINA_OPTS -Dscouter.config=$CATALINA_BASE/conf/scouter.conf"

setenv.sh가 없다면 새로 만들 수 있다. 설정 후 톰캣을 재기동해야 에이전트가 로딩된다.

2-2. 서버(scouter.server.tar.gz)

conf/scouter.conf 설정

net_tcp_listen_port=6100
net_udp_listen_port=6100
db_dir=./database
log_dir=./logs

서버는 에이전트가 보내는 데이터를 수집한다. 위 설정에서는 TCP/UDP 모두 6100 포트를 사용하므로, 에이전트가 다른 장비에 있다면 방화벽에서 해당 포트가 열려 있는지 확인해야 한다.

2-3. 클라이언트(scouter.client.product-macosx.cocoa.x86_64.tar.gz 등)

운영체제에 맞는 클라이언트 패키지를 내려받아 실행한다.
클라이언트에서 스카우터 서버 IP와 포트를 지정해 접속한다.
접속 후 obj_name으로 지정한 톰캣 인스턴스가 보이는지 확인한다.

3. 확인 사항

톰캣 기동 로그에 scouter.agent.jar가 로딩되는지 확인한다.
스카우터 서버 로그 디렉터리에 오류가 없는지 확인한다.
클라이언트에서 대상 톰캣이 보이지 않으면 net_collector_ip, 포트, 방화벽, obj_name 중복 여부를 먼저 확인한다.