Grafana

Grafana는 메트릭, 로그, 트레이스 데이터를 시각화하는 오픈소스 플랫폼입니다. 2014년 Torkel Odegaard가 시작한 프로젝트로, 현재 전 세계적으로 가장 인기 있는 모니터링 시각화 도구입니다. 다양한 데이터 소스를 지원하며, 특히 Prometheus와 함께 클라우드 네이티브 모니터링 스택의 핵심을 이룹니다.

핵심 기능

• 대시보드: 드래그앤드롭으로 패널 구성, JSON으로 내보내기/가져오기
• 다중 데이터 소스: Prometheus, Loki, InfluxDB, Elasticsearch, CloudWatch 등 지원
• 알림(Alerting): 임계값 기반 알림, Slack/PagerDuty/이메일 연동
• Explore: 즉석 쿼리로 데이터 탐색
• 플러그인: 패널, 데이터 소스, 앱 확장
• 팀/권한: 조직, 팀, 폴더 기반 접근 제어

Grafana 스택

• Grafana: 시각화 및 대시보드
• Prometheus: 메트릭 수집 및 저장
• Loki: 로그 집계 시스템
• Tempo: 분산 트레이싱 백엔드
• Mimir: 장기 메트릭 저장소

Dashboard JSON 예제

{
  "dashboard": {
    "id": null,
    "uid": "api-dashboard",
    "title": "API Service Dashboard",
    "tags": ["api", "production"],
    "timezone": "browser",
    "refresh": "30s",
    "time": {
      "from": "now-1h",
      "to": "now"
    },
    "panels": [
      {
        "id": 1,
        "title": "Request Rate",
        "type": "timeseries",
        "gridPos": { "x": 0, "y": 0, "w": 12, "h": 8 },
        "datasource": { "type": "prometheus", "uid": "prometheus" },
        "targets": [
          {
            "expr": "sum(rate(http_requests_total{job=\"api\"}[5m])) by (status_code)",
            "legendFormat": "{{status_code}}"
          }
        ],
        "fieldConfig": {
          "defaults": {
            "unit": "reqps",
            "custom": {
              "drawStyle": "line",
              "lineWidth": 2,
              "fillOpacity": 10
            }
          }
        }
      },
      {
        "id": 2,
        "title": "Response Time (p95)",
        "type": "stat",
        "gridPos": { "x": 12, "y": 0, "w": 6, "h": 4 },
        "datasource": { "type": "prometheus", "uid": "prometheus" },
        "targets": [
          {
            "expr": "histogram_quantile(0.95, sum(rate(http_request_duration_seconds_bucket{job=\"api\"}[5m])) by (le))",
            "legendFormat": "p95"
          }
        ],
        "fieldConfig": {
          "defaults": {
            "unit": "s",
            "thresholds": {
              "mode": "absolute",
              "steps": [
                { "value": 0, "color": "green" },
                { "value": 0.5, "color": "yellow" },
                { "value": 1, "color": "red" }
              ]
            }
          }
        }
      },
      {
        "id": 3,
        "title": "Error Rate",
        "type": "gauge",
        "gridPos": { "x": 18, "y": 0, "w": 6, "h": 4 },
        "targets": [
          {
            "expr": "sum(rate(http_requests_total{job=\"api\",status_code=~\"5..\"}[5m])) / sum(rate(http_requests_total{job=\"api\"}[5m])) * 100",
            "legendFormat": "Error %"
          }
        ],
        "fieldConfig": {
          "defaults": {
            "unit": "percent",
            "min": 0,
            "max": 100,
            "thresholds": {
              "steps": [
                { "value": 0, "color": "green" },
                { "value": 1, "color": "yellow" },
                { "value": 5, "color": "red" }
              ]
            }
          }
        }
      }
    ]
  }
}

Grafana Provisioning 설정

# /etc/grafana/provisioning/datasources/prometheus.yaml
apiVersion: 1

datasources:
  - name: Prometheus
    type: prometheus
    access: proxy
    url: http://prometheus:9090
    isDefault: true
    editable: false
    jsonData:
      timeInterval: "15s"

  - name: Loki
    type: loki
    access: proxy
    url: http://loki:3100
    editable: false
    jsonData:
      derivedFields:
        - datasourceUid: tempo
          matcherRegex: "traceID=(\\w+)"
          name: TraceID
          url: "$${__value.raw}"

  - name: Tempo
    type: tempo
    access: proxy
    url: http://tempo:3200
    editable: false
---
# /etc/grafana/provisioning/dashboards/dashboards.yaml
apiVersion: 1

providers:
  - name: 'default'
    orgId: 1
    folder: 'Production'
    type: file
    disableDeletion: false
    editable: true
    options:
      path: /var/lib/grafana/dashboards

Kubernetes에서 Grafana 배포

# grafana-values.yaml (Helm)
replicas: 1

persistence:
  enabled: true
  size: 10Gi

adminUser: admin
adminPassword: ${GRAFANA_ADMIN_PASSWORD}

datasources:
  datasources.yaml:
    apiVersion: 1
    datasources:
      - name: Prometheus
        type: prometheus
        url: http://prometheus-server.monitoring.svc:9090
        isDefault: true

dashboardProviders:
  dashboardproviders.yaml:
    apiVersion: 1
    providers:
      - name: 'default'
        orgId: 1
        folder: ''
        type: file
        options:
          path: /var/lib/grafana/dashboards

dashboards:
  default:
    kubernetes-cluster:
      gnetId: 6417
      revision: 1
      datasource: Prometheus
    node-exporter:
      gnetId: 1860
      revision: 31
      datasource: Prometheus

ingress:
  enabled: true
  annotations:
    kubernetes.io/ingress.class: nginx
    cert-manager.io/cluster-issuer: letsencrypt
  hosts:
    - grafana.example.com
  tls:
    - secretName: grafana-tls
      hosts:
        - grafana.example.com

• Grafana 공식 문서 - 전체 기능 가이드
• Grafana Dashboard 라이브러리 - 커뮤니티 대시보드
• Grafana Play - 브라우저에서 체험
• Grafana GitHub - 소스 코드