Grafana

핵심 개념

Data Source

Grafana가 데이터를 가져올 외부 저장소를 의미합니다. Prometheus, MySQL, CloudWatch 등 50가지 이상의 데이터 소스를 지원하며, 하나의 대시보드에서 여러 소스를 함께 조회할 수 있습니다.

Dashboard

여러 개의 패널을 배치하여 구성한 시각화 화면입니다. JSON 형식으로 저장되어 버전 관리가 가능하고, 다른 환경으로 쉽게 이동하거나 공유할 수 있습니다.

Panel

대시보드를 구성하는 개별 차트나 그래프 단위입니다. 시계열 그래프, 게이지, 테이블, 히트맵 등 다양한 시각화 타입을 선택할 수 있으며, 각각 쿼리와 표시 옵션을 독립적으로 설정합니다.

Query

데이터 소스에 전달할 질의문입니다. 각 데이터 소스의 고유 쿼리 언어를 사용하며, Grafana는 이를 변환 없이 그대로 전달합니다.

Alert

특정 메트릭이 임계값을 초과하거나 조건을 만족할 때 알림을 발생시키는 규칙입니다. 이메일, Slack, PagerDuty 등 여러 채널로 통지할 수 있습니다.

Variable

대시보드 내에서 동적으로 값을 변경할 수 있는 파라미터입니다. 서버 이름, 환경, 시간 범위 등을 드롭다운으로 선택하면 모든 패널의 쿼리에 자동 반영됩니다.

Prometheus 데이터 소스와 간단한 대시보드 설정

Prometheus를 데이터 소스로 등록하고, Grafana를 컨테이너로 실행하는 기본 설정입니다. 3000번 포트로 접속하면 웹 UI에서 대시보드를 구성할 수 있습니다.

# provisioning/datasources/prometheus.yml
apiVersion: 1
datasources:
  - name: Prometheus
    type: prometheus
    access: proxy
    url: http://localhost:9090
    isDefault: true

# provisioning/dashboards/dashboard.yml
apiVersion: 1
providers:
  - name: 'default'
    folder: ''
    type: file
    options:
      path: /etc/grafana/dashboards

# docker-compose.yml에서 Grafana 실행
services:
  grafana:
    image: grafana/grafana
    ports:
      - "3000:3000"
    volumes:
      - ./provisioning:/etc/grafana/provisioning