Grafana 포탈 접속 방법 (with Docker)

들어가며

• 제품에서 기본적으로 제공되는 Grafana image 를 통해 포탈을 생성할 수 있습니다. 
  • hub.sparklingsoda.io:80/grafana/grafana:7.3.5

내용

docker image 를 container 로 생성하기 위해서는 docker 에 대한 기본 지식이 필요합니다. 

Create Docker container

grafana image 를 이용하여 container 를 생성합니다. 

grafana image 가 존재하지 않는다면 hub.docker.com 에서 pull 할 수 있습니다. 

1. 이미지 확인 

docker images | grep grafana
REPOSITORY                                                                       TAG                    IMAGE ID       CREATED         SIZE
hub.sparklingsoda.io:80/grafana/grafana                                          7.3.5                  71716d95fc52   2 years ago     187MB

# 제품 서버에서 pull
docker pull hub.sparklingsoda.io:80/grafana/grafana:7.3.5

# docker.com 에서 pull
docker pull grafana/grafana:7.3.5

docker run -it -d \
--name <container name> \
--net=host \
<docker image>:<docker image tag> \
/bin/bash

docker run -it -d \
--name grafana-container \
--net=host \
 hub.sparklingsoda.io:80/grafana/grafana:7.3.5 \
/bin/bash
2948113b4cc182b3bd403a65c97d99c3008d6a4d662351ba3a6fa27f7a6f5bd6

docker ps | grep garafana-container
c4ec43dbcb01   hub.sparklingsoda.io:80/grafana/grafana:7.3.5   "/run.sh bash"           7 seconds ago   Up 6 seconds             grafana-container

Enter Grafana

container 가 정상적으로 동작하고 있다면 포탈에서 접속이 가능합니다. 

Cluster IP 로 생성하였기 때문에 ip 로 접속해야합니다. 

container 를 생성한 서버의 ip 와 grafana 기본 포트인 3000 으로 접속합니다. 

초기 Grafana 계정 

• Email or username : admin
• Password : admin

Create Data Sources

Grafana 를 이용해 모니터링 시스템을 만들기 위해서는 데이터가 필요합니다. 

기본적으로 제품에서 제공하는 Prometheus 를 이용하여 데이터를 수집할 수 있습니다. 

이 Prometheus 데이터를 사용하기 위해서는 Data Sources 등록이 필요합니다. 

1. Create Data Sources Tab

2. Add Data Sources

3. Select Prometheus

검색 창에 Prometheus 를 검색하고 Prometheus 를 클릭합니다. 

4. Enter Prometheus info

- Name :지정할 Data sources 이름을 입력합니다. Default 설정은 선택사항입니다.

- URL : prometheus 가 작동하는 서버의 IP 와 기본 Port 30990 을 이용하여 입력합니다. (<IP>:30990)

- Save & Test : 설정한 정보를 저장하고 정상적으로 Prometheus 와 연결되는지 확인하는 작업입니다. 

정상 적동 시 다음과 같이 alert 창을 확인할 수 있습니다. 

정상작동을 하지않는다면 Server IP 혹은 Node Port를 확인하세요

hostname -i
192.168.50.199
kubectl get svc -A | grep kube-prometheus-stack-prometheus
monitoring    kube-prometheus-stack-prometheus                 NodePort    6.5.143.163   <none>           9090:30990/TCP                 24h
monitoring    kube-prometheus-stack-prometheus-node-exporter   ClusterIP   6.5.213.183   <none>           9100/TCP                       24h

prometheus 로 Data Sources 를 등록했다면 이제 원하는대로 모니터링 툴을 생성할 수 있습니다. 

원하는 Databoard 를 import 할 수 있고, 새로운 Databoard 를 생성할 수도 있습니다.

ETC

Grafana 의 Databoard 는 다양한 예시가 존재합니다. 

다음 사이트에서 원하는 Board 를 선택해 import 할 수 있습니다. 

참고 : https://grafana.com/grafana/dashboards/

마무리

• 대쉬보드를 생성할 때 사용되는 Query 는 Prometheus 포탈 사용방법을 참고하세요.