[Scouter] 대-충 설치 및 설명

1 ) Scouter Server 설치

Scouter 홈페이지에 접속하여 적절한 위치에 scouter-all-[version].tar.gz 의 압축을 풀어준다.

 

[Scouter 홈페이지] https://github.com/scouter-project/scouter/releases

Releases · scouter-project/scouter

2 ) Scouter Server 실행

/server에서 startup.sh 또는 startup.bat 실행

 

% pwd 
/scouter/server

% sh startup.sh
  ____                  _            
 / ___|  ___ ___  _   _| |_ ___ _ __ 
 \___ \ / __/   \| | | | __/ _ \ '__|
  ___) | (_| (+) | |_| | ||  __/ |   
 |____/ \___\___/ \__,_|\__\___|_|                                      
 Open Source S/W Performance Monitoring  
 Scouter version 2.8.1

…

 12:27:36.279 [scouter.server.http.HttpServer]  INFO  org.eclipse.jetty.server.Server[444] - Started @879ms

 

3 ) Scouter Client 설치

scouter.client.product-[os].tar.gz의 압축을 풀고 실행한다.
접속할 Scouter Serve의 IP나 도메인을 입력 후 ID/PWD 를 입력해 로그인한다.

 

Default ID: admin / PWD: admin

4 ) Host Agent 실행

• Host Agent 실행 전에 먼저 Collector 접속 설정이 필요하다.
• 설정 파일에 Collector의 IP와 Port 정보를 설정한다.
  설정 파일(default) : [scouter-dir]/agent.host/conf/scouter.conf

### scouter host configruation sample
#net_collector_ip=127.0.0.1
#net_collector_udp_port=6100
#net_collector_tcp_port=6100

 

net_collector_ip에는 Collector 접속 IP나 도메인, 포트를 기입한다.

► 기본값 : 127.0.0.1 (6100)

 

Host Agent를 시작한다.

 

% pwd
/scouter/agent.host

% sh host.sh
  ____                  _            
 / ___|  ___ ___  _   _| |_ ___ _ __ 
 \___ \ / __/   \| | | | __/ _ \ '__|
  ___) | (_| (+) | |_| | ||  __/ |   
 |____/ \___\___/ \__,_|\__\___|_|                                      
 Open Source S/W Performance Monitoring  
 Scouter version 2.8.1
 
Configure -Dscouter.config=./conf/scouter.conf
Scouter Host Agent Version 2.8.1 2020-05-14 23:36 GMT
System JRE version : 1.8.0_261

 

- 시작: ./host.sh(또는 host.bat)

- 정지: ./stop.sh (또는 stop.bat)

 

Host Agent가 잘 실행되었다면, 앞에서 실행한 Scouter Client에서 아래와 같이 확인 가능하다.

 

 

• 이쯤에서 Default Object Type을 맞춰주는 것이 편한데요, Client의 메뉴중 환경설정(Preferences) 메뉴로 들어간다.
• 이 내용은 Mac에서 진행하는 중이므로, 저는 default Host를 OSX 그리고 default JavaEE를 tomcat으로 맞췄다.

 

 

 (추가) Java Agent 실행 

Java Agent는 단독으로 실행되는 것이 아니라, 모니터링할 Java Program이 실행될때 attach되어 모니터링을 수행한다.

따라서 실행하는 Java Program에서 scouter agent를 인식할 수 있도록 명령행 옵션을 설정해야 한다.

 

(/scouter/agent.java 하위 폴더에 있음)

-javaagent:/[somewhere]/scouter.agent.jar

혹은

-javaagent:/[somewhere]/scouter-agent-java-2.8.1

 

그리고 하나의 VM에 여러개의 java 프로그램을 실행한다면 보통 scouter agent의 환경설정 파일경로와 이름을 지정해주게 됩니다.

 

설정 파일 경로 지정

• -Dscouter.config=/[somewhere]/sampleConfig.conf
• 설정 파일 경로를 지정하지 않은 경우 기본값 : [directory of scouter.agent.jar]/conf/scouter.conf

모니터링 대상(object) 이름 지정

• -Dobj_name=scouterWebDemo1
• 모니터링 대상을 지정하지 않은 경우 기본값 : java1 또는 tomcat1

 

---

[참고]  

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

scouter-project/scouter

 

http://gunsdevlog.blogspot.com/2017/07/scouter-apm-1.html

Scouter APM 소소한 시리즈 #1 - 설치하기