APM툴 Scouter

Scouter는 Open Source로 나와있는 APM툴이다.

Scouter Download
Scouter는 무료 오픈 소스로 아래의 github에서 다운 받을 수 있다.

https://github.com/scouter-project/scouter/releases/
Agent, Server: scouter-all-*.tar.gz
Client: scouter.client.product-win32.win32.x86_64.zip

Scouter의 동작 방식은 아래와 같이 Agent를 각 WAS에 심고, 각 WAS의 Metric정보를 Host서버가 수집한다.
Client는 Clinet툴을 이용하여 Host서버에 붙어 모니터링 정보를 확인 할 수 있다.
Client ↔︎ Collector(EC2) ↔︎ WAS(VM/Container)

Scouter의 동작을 확인하기 위해서는 즉, 3가지 설치가 필요하다. (Linux 환경을 기본으로 한다.)

Agent (scouter/agent.java)

scouter/agent.java의 구성은 confg, plugin, scouter.agent.jar로 구성이 되어있다.
conf파일을 WAS의 적당한 위치에 올리고, agent.jar 파일을 WAS에 심은 후 연동하면 된다.

scouter/agent.java/conf/scouter.conf 변경

### scouter java agent configuration sample
obj_name=WAS-01 #WAS_NAME으로 값 변경 후 sed처리 (Container)
net_collector_ip=127.0.0.1 #HOST_IP로 값 변경 후 sed처리 (Container)
net_collector_udp_port=6100
net_collector_tcp_port=6100
#hook_method_patterns=sample.mybiz.*Biz.*,sample.service.*Service.*
#trace_http_client_ip_header_key=X-Forwarded-For
#profile_spring_controller_method_parameter_enabled=false
#hook_exception_class_patterns=my.exception.TypedException
#profile_fullstack_hooked_exception_enabled=true
#hook_exception_handler_method_patterns=my.AbstractAPIController.fallbackHandler,my.ApiExceptionLoggingFilter.handleNotFoundErrorResponse
#hook_exception_hanlder_exclude_class_patterns=exception.BizException

WAS 설정 (WAS와 Agent연동)

SCOUTER_AGENT_DIR=/usr/local/appServer/scouter/agent.java
JAVA_OPTS=" ${JAVA_OPTS} -javaagent:${SCOUTER_AGENT_DIR}/scouter.agent.jar"
JAVA_OPTS=" ${JAVA_OPTS} -Dscouter.config=${SCOUTER_AGENT_DIR}/conf/scouter.conf"
JAVA_OPTS=" ${JAVA_OPTS} -Dobj_name=WAS-NAME1"

Dockerfile (Container 사용 시)

COPY scouter.agent.java /usr/local/appServer/scouter/agent.java
RUN sed -i -e "s#WAS-01#WAS_NAME#g" /usr/local/appServer/scouter/agent.java/conf/scouter.conf 
RUN sed -i -e "s#HOST_IP#HOST_IP#g" /usr/local/appServer/scouter/agent.java/conf/scouter.conf 

Host (scouter/server)

scouter/server의 구성은 scouter-server-boot.jar, startup.sh, stop.sh 로 구성이 되어있다.
Collector 서버로 사용 할 서버에서 startup.sh 을 기동시켜주기만 하면 된다.

#!/usr/bin/env bash
nohup java -Xmx1024m -classpath ./scouter-server-boot.jar scouter.boot.Boot ./lib > nohup.out &
sleep 1
tail -100 nohup.out

Clinet

scouter.client.product-win32.win32.x86_64.zip
해당 ZIP파일을 다운로드 후 scouter.exe 파일을 실행 시키면 아래와 같다.

Host서버의 IP주소를 입력한다.
초기 계정 및 패스워드는 admin / admin으로 로그인 한다.
물론 Clinet PC와 Host 간 6100 TCP 통신은 허용이 되어 있어야 정상 접근이 가능할 것이다.