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

치는 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. 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

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

4. Grafana Dashboard 구성

4.1. Dashboard 추가

을 클릭하고 하단의 버튼을 클릭한다.

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

4.3. General 탭에서 Title을 입력한다.

4.4. Metrics 탭에서 Measurement를 선택하고 표시할 필드들을 선택한다.

* value 가 숫자가 아닌 경우는 GROUP BY 를 수행할 수 없으며, 이 경우 성능에 영향

8

을 줄 수 있으므로 GROUP BY 절과 Aggregation function을 사용할 수 있도록 한다.

4.5. Y축 단위 설정 및 표시 옵션을 설정한다.

4.6. Add series specific option 을 사용하여 추가 옵션을 설정한다.

4.7. 다음과 같은 화면이 정상적으로 표시되는지 확인한다.

4.8. 표시하고자 하는 항목을 Graph, Single stat 또는 Table 형태로 구성한다.