오픈소스 APM Scouter 설치 #3

Scouter 설치 세번째입니다.

 

Windows Server와 CenOS에 Scouter Agent를 설치하는 부분입니다.

제가 이용하는 부분이 host와 java라서 그 부분만 설명하도록 하겠습니다.

 

일단 Scouter 파일을 다운로드 받은 후 압축을 풀면 agent.host와 agent.java 폴더를 Windows Server와 CentOS에 업로드합니다. 해당 폴더에는 Windows용과 Linux용 agent용 실행 파일들이 같이 있습니다.

 

Windows Server내 Scouter Agent 설치

1. JRE 설치

   다운받은 JRE 설치 파일을 Server에 설치합니다.

 

2. Scouter Agent 업로드

   다운받은 Scouter 파일에서 agent.host 폴더와 agent.java Windows Server에 업로드합니다.

 

3. Scouter agent.host의  conf 파일 수정

   \agent.host\conf 폴더내 scouter.conf 파일을 현재 구성에 맞도록 수정합니다.

### scouter host configruation sample net_collector_ip=192.168.31.131 <-- Scouter Server의 주소, 전 CentOS로 설정하도록 하겠습니다. net_collector_udp_port=6200 <-- Scouter Server의 udp 포트 net_collector_tcp_port=6200 <-- Scouter Server의 tcp 포트 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

 

  CPU, Memory, Disk 등의 알람은 필요에 따라 수정하면 됩니다.

  이렇제 진행하던 중에 문제가 발생했습니다.

  제가 다운로드 받은 JRE 버전이 1.8.0_271이었는데, 해당버전이 scouter 2.10.2 버전에서 오류가 발생합니다.

  일단 제가 가지고 있던 JRE 1.8.0_144 버전으로 설치해서 실행시 문제가 안되었습니다.

 

 

  정상적으로 실행이 되면 위와 같은 화면이 나타납니다.

  서버와 마찬가지로 bat파일이라서 commnad 창에서 실행이 됩니다.

 

4. Scouter agent.java의  conf 파일 수정

   Tomcat 모니터링을 위하여 \agent.java\conf 폴더내 scouter.conf 파일을 현재 구성에 맞도록 수정합니다.

 

### scouter java agent configuration sample obj_name=WinTomcat net_collector_ip=192.168.31.131 net_collector_udp_port=6200 net_collector_tcp_port=6200 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

   

   그리고, Tomcat내 서비스 등록 파일인 \tomcat\bin 폴더내 service.bat 파일에 다음과 같이 내용을 추가해줍니다.

--JvmOptions ".....;-javaagent:c:\scouter\agent.java\scouter.agent.jar;...."

 

   Scouter agent.java의 폴더명을 정확히 입력해줘야합니다.

   그리고 Tomcat을 서비스 등록해줍니다.

 

 

  service.bat install "서비스명"으로 등록후 윈도우즈 서비스 메뉴에서 tomcat을 가동시켜줍니다

 

 

   제대로 Tomcat이 실행됐다면 http://IP주소:8080 로 브라우저에서 접속해봅니다.

   설정이 건드린게 없기 때문에 기본적인 Tomcat 화면이 나타납니다.

 

 

Scouter Client 확인

이제 Agent 설정이 완료되었으니 Client에서 정상적으로 모니털이 되는지 확인해봅니다.

 

Scouter Server인 192.168.31.131로 Scouter Cient를 접속하면 아래와 같이 서버가 보입니다.

 

 

 

Object를 보면 Scouter Server명은 CentOS이고, 해당 서버에 데이터를 보내는 Agent에 대한 서버와 서비스들이 나타납니다. 모니터링 항목은 필요한 내용을 추가하면 되고, 실제 업무에서는 CPU, 메모리 사용량과 Tomcat xlog가 가장 유용하게 사용되는 편입니다.

 

여기까지가 Windows Server의 host와 java(tomcat) 모니터링 구성방법입니다.