본 문서는 Scouter APM의 InfluxDB에 대한 세팅 및 정보를 볼 수 있도록 구성하는 가이드 문서입니다. 스카우터에 플러그인 제작으로 참여하시고 계시는 박상천 부장님의 컨트리뷰션 문서입니다.

1. 1
Scouter 와 InfluxDB – Grafana 연동 가이드
본 문서에서는 Scouter 의 모니터링 데이터를 오픈소스 시계열 DB 인 InfluxDB 에 적재하고
Grafana 를 이용하여 시각화 하는 방법에 대해서 가이드 한다. 사전에 Scouter 가 설치되어
있어야 하며, Scouter 의 설치가 되어 있지 않다면 Quick Start Guide 를 참고하여 환경을 구
성한다.
1. InfluxDB 설치
본 문서에서는 RPM Based Linux 를 기반으로 설명하며, 타 OS Architecture 에 대한 설
치는 InfluxDB 홈페이지를 참고한다.
1.1. 저장소 등록
1.2. 패키지 설치
1.3. 서비스 등록 및 실행
1.4. 설치 확인
http://${SERVER_IP_OR_HOSTNAME}:8083 에 정상적으로 접속되는지 확인한다.
* InfluxDB 는 8083, 8086 두 개의 포트를 사용하여, 방화벽이 동작할 경우 해당 포트
를 추가해야 한다. 또한 UDP 를 사용한 데이터 적재 기능을 사용할 경우
/etc/influxdb/influxdb.conf 파일에서 해당 기능을 활성화 시키고 influxdb 서비스를 재
구동한다.
2. Grafana 설치
본 문서에서는 RPM Based Linux 를 기반으로 설명하며, 타 OS Architecture 에 대한 설
cat <<EOF | sudo tee /etc/yum.repos.d/influxdb.repo
[influxdb]
name = InfluxDB Repository - RHEL $releasever
baseurl = https://repos.influxdata.com/rhel/$releasever/$basearch/stable
enabled = 1
gpgcheck = 1
gpgkey = https://repos.influxdata.com/influxdb.key
EOF
sudo yum install influxdb
sudo systemctl enable influxdb
sudo systemctl start influxdb

2. 2
치는 Grafana 홈페이지를 참고한다
2.1. 패키지 설치
2.2. 서비스 등록 및 실행
2.3. 설치 확인
http://${SERVER_IP_OR_HOSTNAME}:3000 에 정상적으로 접속되는지 확인한다.
2.4. Data Source 설정
상기 콘솔에서 admin / admin 으로 로그인 후 Data Sources -> Add new 를 선택하고
그림과 같이 influxDB 접속 정보를 입력한다.
sudo yum install https://grafanarel.s3.amazonaws.com/builds/grafana-3.0.1-1.x86_64.rpm
sudo systemctl enable grafana-server
sudo systemctl start grafana-server

3. 3
3. Scouter Plugin 설치
3.1. https://github.com/scouter-project/scouter-plugin-server-influxdb/releases 에 접속하여
최신 버전의 라이브러리(*.jar) 파일을 다운로드 하여 Scouter 서버 설치 경로 하위의
lib 폴더에 저장한다.
3.2. Scouter 설치 경로 하위의 conf/scouter.conf 파일에 influxDB 관련 설정을 추가한다.
# influxDB 적재여부
ext_plugin_influxdb_enabled=true

4. 4
3.3. Scouter 서버를 시작하고 influxDB 의 관리 콘솔
(http://${SERVER_IP_OR_HOSTNAME}:8083)에 접속하여 datasource 및 measuremet 가
정상적으로 생성되었는지 확인한다.
# influxDB measurement 명
ext_plugin_influxdb_measurement=counter
# influxDB 연동 방식(true : udp, false : http)
ext_plugin_influxdb_udp=false
# influxDB 의 호스트 IP 및 UDP 포트
ext_plugin_influxdb_udp_target_ip=192.168.0.2
ext_plugin_influxdb_udp_target_port=8089
# influxDB 의 호스트 IP 및 HTTP 포트
ext_plugin_influxdb_http_target_ip=192.168.0.2
ext_plugin_influxdb_http_target_port=8086
ext_plugin_influxdb_http_retention_policy=default
# influxDB 의 계정 정보
ext_plugin_influxdb_id=root
ext_plugin_influxdb_password=root
# Scouter 데이터가 저장될 influxDB 의 datasource 명
ext_plugin_influxdb_dbName=scouter

5. 5
4. Grafana Dashboard 구성
4.1. Dashboard 추가
을 클릭하고 하단의 버튼을 클릭한다.

6. 6
4.2. 를 클릭하고 Add Panel -> Graph 를 선택한다.
- Graph : http://docs.grafana.org/reference/graph/
- Table : http://docs.grafana.org/reference/table_panel/
- Single stat : http://docs.grafana.org/reference/singlestat/
- Dashboard list : http://docs.grafana.org/reference/dashlist/

7. 7
4.3. General 탭에서 Title 을 입력한다.
4.4. Metrics 탭에서 Measurement 를 선택하고 표시할 필드들을 선택한다.
* value 가 숫자가 아닌 경우는 GROUP BY 를 수행할 수 없으며, 이 경우 성능에 영향

8. 8
을 줄 수 있으므로 GROUP BY 절과 Aggregation function 을 사용할 수 있도록 한다.
4.5. Y 축 단위 설정 및 표시 옵션을 설정한다.
4.6. Add series specific option 을 사용하여 추가 옵션을 설정한다.
4.7. 다음과 같은 화면이 정상적으로 표시되는지 확인한다.
4.8. 표시하고자 하는 항목을 Graph, Single stat 또는 Table 형태로 구성한다.