Grafana 대시보드

LinuxBeginner
지금 연습하기

소개

이 실습에서는 Grafana를 사용하여 모니터링 대시보드를 만드는 기초를 배웁니다. Grafana는 모니터링 및 관측 가능성을 위한 인기 있는 오픈 소스 플랫폼으로, 데이터 저장 위치와 관계없이 메트릭을 쿼리, 시각화, 알림 설정 및 탐색할 수 있게 해줍니다.

준비된 구성 파일로 모니터링 스택을 시작합니다. 다음 구성 요소가 포함됩니다.

  • Grafana: 대시보드를 구축할 시각화 도구입니다.
  • Prometheus: Grafana의 데이터 소스 역할을 하는 시계열 데이터베이스입니다.
  • Node Exporter: 호스트 머신에서 하드웨어 및 OS 메트릭을 수집하여 Prometheus가 스크랩할 수 있도록 노출하는 에이전트입니다.

여러분의 목표는 실습 환경의 실시간 CPU 사용량을 표시하는 간단한 대시보드를 처음부터 구축하는 것입니다.

모니터링 스택 시작 및 살펴보기

이 단계에서는 Grafana, Prometheus, Node Exporter 를 시작합니다. Node Exporter 는 시스템 메트릭을 노출하고 Prometheus 는 이를 수집하며 Grafana 는 표시합니다. 구성 파일과 데이터 소스 프로비저닝 파일은 준비되어 있습니다.

cd /home/labex/project

고정된 각 태그는 이 실습에서 사용하는 버전을 지정합니다. 다운로드에는 몇 분이 걸릴 수 있습니다. 각 명령이 프롬프트로 돌아올 때까지 기다리세요. 다운로드가 실패하면 같은 pull 명령을 다시 실행합니다. Docker 는 완료된 레이어를 재사용합니다. 다운로드가 끝나기 전에는 다음으로 진행하지 마세요.

docker pull prom/prometheus:v3.3.0
docker pull prom/node-exporter:v1.9.1
docker pull grafana/grafana:11.6.0

docker network create 는 컨테이너가 서로의 이름을 확인할 수 있는 네트워크를 만듭니다. docker run -d 는 컨테이너를 백그라운드에서 시작하고, --name 은 이름을 지정하며, --network 는 네트워크에 연결하고, -p 는 호스트 포트를 컨테이너 포트에 매핑합니다. -v 마운트는 준비된 구성 파일을 연결하며 :ro 접미사는 읽기 전용으로 만듭니다.

docker network create monitoring-net
docker run -d --name node-exporter --network monitoring-net -p 9100:9100 prom/node-exporter:v1.9.1
docker run -d --name prometheus --network monitoring-net -p 9090:9090 -v /home/labex/project/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro prom/prometheus:v3.3.0
docker run -d --name grafana --network monitoring-net -p 8080:3000 -v /home/labex/project/grafana/provisioning:/etc/grafana/provisioning:ro grafana/grafana:11.6.0

이 curl 옵션은 HTTP 실패를 보고하고 일시적인 시작 오류가 발생하면 2 초 간격으로 최대 30 회 재시도합니다. 실행 중인 컨테이너도 초기화 중일 수 있으므로 상태 확인에 성공한 후 진행하세요.

curl --fail --silent --show-error --retry 30 --retry-delay 2 --retry-connrefused --retry-all-errors http://localhost:9090/-/ready
curl --fail --silent --show-error --retry 30 --retry-delay 2 --retry-connrefused --retry-all-errors http://localhost:8080/api/health

Prometheus 는 준비 완료를 보고하고 Grafana 는 "database": "ok" 를 반환해야 합니다. 다음 명령으로 컨테이너를 확인합니다.

docker ps

이름이 지정된 세 컨테이너가 모두 Up 상태여야 합니다. 실습의 Grafana 탭을 선택합니다. 내장 로그인이 차단되면 브라우저에서 여는 컨트롤로 새 브라우저 탭을 엽니다. 사용자 이름 admin, 비밀번호 admin 으로 로그인하고 비밀번호 변경 화면에서 Skip 을 클릭합니다. 이 자격 증명은 임시 실습 전용입니다.

Connections → Data sources 를 열고 Prometheus 가 있는지 확인합니다. 프로비저닝 파일은 공유 Docker 네트워크를 통해 http://prometheus:9090 에 연결합니다. CPU 쿼리를 작성하기 전에 Prometheus 가 여러 샘플을 수집할 수 있도록 스택을 실행한 상태로 두세요.

Grafana 에서 새 대시보드 만들기

이 단계에서는 빈 대시보드를 만들고 첫 번째 시각화를 추가합니다. 대시보드는 패널을 격자로 배치하며 각 패널은 데이터 쿼리의 결과를 보여줍니다.

왼쪽 사이드바에서 Dashboards 를 엽니다. New 를 클릭하고 New dashboard 를 선택합니다.

빈 대시보드에서 Add visualization 을 클릭합니다. 데이터 소스 선택기에서 Prometheus 를 선택합니다. 이는 새 패널이 쿼리를 보낼 대상을 지정합니다.

이제 시각화 미리보기, 쿼리 편집기, 표시 옵션이 있는 패널 편집기가 보여야 합니다. 다음 단계에서 CPU 쿼리를 입력합니다.

CPU 사용량을 위한 PromQL 쿼리 패널 추가

이 단계에서는 대시보드에 패널을 추가하고 PromQL(Prometheus Query Language) 쿼리를 사용하여 CPU 사용량 데이터를 가져옵니다.

이전 단계에서 이어진 패널 편집기 화면에 있어야 합니다.

편집기 하단에서 쿼리 섹션을 찾습니다. Prometheus 데이터 소스가 기본적으로 선택되어 있어야 합니다. 쿼리 편집기를 Code 로 전환한 다음 아래 PromQL 쿼리를 입력합니다. 그대로 복사하여 붙여 넣을 수 있습니다.

100 - (avg by (instance) (rate(node_cpu_seconds_total{mode="idle"}[5m])) * 100)

쿼리에 대한 설명은 다음과 같습니다:

  • node_cpu_seconds_total{mode="idle"}: CPU가 "idle(유휴)" 상태였던 총 시간을 초 단위로 계산하는 Node Exporter의 메트릭입니다.
  • rate(...[5m]): 지난 5분 동안 유휴 시간의 초당 평균 증가율을 계산합니다. 결과값은 0에서 1 사이이며, CPU가 유휴 상태였던 시간의 비율을 나타냅니다.
  • avg by (instance): 여러 CPU나 머신이 있을 경우 유용한 결과 집계 방식입니다.
  • * 100: 비율 값을 백분율로 변환합니다(예: 0.95는 95%가 됨).
  • 100 - ...: 마지막으로 100에서 유휴 백분율을 빼서 활성 CPU 사용량 백분율을 구합니다.

Run queries 를 클릭합니다. rate 계산에는 최소 두 번의 수집이 필요합니다. 스택을 방금 시작했다면 약 30 초 기다린 후 쿼리를 다시 실행하세요. 상단 미리보기에 시간에 따른 CPU 사용량 그래프가 표시되어야 합니다.

이제 패널에 데이터가 표시되지만, 다음 단계에서 더 나은 레이블과 서식을 적용하여 개선해 보겠습니다.

대시보드 사용자 지정 및 저장

이 단계에서는 CPU 패널에 제목을 지정하고 값을 백분율로 표시한 뒤 대시보드를 저장합니다. 명확한 레이블은 결과를 이해하기 쉽게 합니다.

오른쪽 Panel options 에서 Title 을 정확히 CPU Usage % 로 설정합니다.

Standard options 아래에서 Unit 을 열고 percent 를 검색한 다음 Misc / Percent (0-100) 을 선택합니다. 쿼리는 이미 0 에서 100 사이의 값을 반환하므로 이 단위는 값을 다시 조정하지 않고 백분율 기호만 추가합니다.

Back to dashboard 를 클릭하여 패널을 유지하고 대시보드로 돌아갑니다. 대시보드는 아직 영구 저장되지 않았습니다.

Save dashboard 를 클릭합니다. 저장 대화 상자에 정확한 제목 My System Dashboard 를 입력하고 Save 를 클릭합니다. 실습은 이 제목으로 저장된 대시보드를 찾습니다.

저장된 대시보드에 CPU 그래프와 백분율 단위를 표시하는 CPU Usage % 패널이 있는지 확인합니다.

요약

이 실습에서는 Grafana 대시보드를 처음부터 구축했습니다. 준비된 구성 파일로 모니터링 스택을 시작하고 다음 작업을 수행했습니다.

  • Grafana, Prometheus, Node Exporter 컨테이너로 구성된 환경을 탐색했습니다.
  • Grafana UI를 탐색하여 비어 있는 새 대시보드를 생성했습니다.
  • 시각화 패널을 추가하고 PromQL 쿼리를 작성하여 Prometheus 데이터 소스로부터 CPU 사용량 데이터를 가져왔습니다.
  • 가독성을 높이기 위해 패널 제목과 단위 서식을 커스터마이징했습니다.
  • 완성된 대시보드를 향후 사용을 위해 저장했습니다.

이제 Grafana에서 시각화를 생성하는 기본적인 워크플로우를 익혔습니다. 이 지식을 바탕으로 메모리 사용량, 디스크 I/O, 네트워크 트래픽 등 다른 시스템 메트릭을 모니터링하기 위한 패널을 추가하여 대시보드를 확장해 보세요.