📊 Prometheus + Grafana

1. Prometheus + Grafana란?

Prometheus는 오픈소스 메트릭 수집 및 경고 시스템이며, Grafana는 메트릭 시각화 대시보드 플랫폼입니다. 두 도구는 함께 사용되어 인프라, 애플리케이션, AI/ML 파이프라인까지 실시간 모니터링을 제공합니다.

2. 왜 써야 하는가?

기존 모니터링 대안 (Nagios, Zabbix, CloudWatch)과 비교한 핵심 차이점:

3. 핵심 개념

Prometheus 아키텍처는 아래와 같이 단순하면서도 강력합니다.

• Exporter: Node Exporter, Blackbox Exporter 등 타 시스템 메트릭을 Prometheus 형식으로 노출.
• PromQL: rate(http_requests_total[5m]) 같은 강력한 시계열 질의.
• Alertmanager: 알림 그룹화, 억제, 전송 (Slack, Email 등).

4. 퀵스타트

로컬 환경에서 Prometheus + Grafana를 빠르게 시작합니다. (Python 예제 포함)

4.1 설치 (Docker Compose)

# docker-compose.yml (최신 버전)
$ cat <<EOF > docker-compose.yml
version: '3.8'
services:
  prometheus:
    image: prom/prometheus:latest
    ports:
      - "9090:9090"
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml
  grafana:
    image: grafana/grafana:latest
    ports:
      - "3000:3000"
    environment:
      - GF_SECURITY_ADMIN_PASSWORD=admin
EOF
$ docker compose up -d

4.2 Prometheus 설정 (prometheus.yml)

# prometheus.yml
global:
  scrape_interval: 15s
scrape_configs:
  - job_name: 'prometheus'
    static_configs:
      - targets: ['localhost:9090']
  - job_name: 'python-app'
    static_configs:
      - targets: ['host.docker.internal:8000']

4.3 Python 예제: 메트릭 노출

# app.py (pip install prometheus-client)
from prometheus_client import start_http_server, Counter, Histogram
import time, random

REQUEST_COUNT = Counter('app_requests_total', 'Total requests')
REQUEST_DURATION = Histogram('app_request_duration_seconds', 'Request duration')

def process():
    with REQUEST_DURATION.time():
        time.sleep(random.uniform(0.1, 0.5))
        REQUEST_COUNT.inc()

if __name__ == '__main__':
    start_http_server(8000)
    while True:
        process()
        time.sleep(1)

$ python app.py &

4.4 Grafana에서 데이터소스 연결

# 1. http://localhost:3000 (admin/admin)
# 2. Configuration → Data Sources → Add → Prometheus
# 3. URL: http://prometheus:9090 (docker network) 또는 http://localhost:9090
# 4. Save & Test → 대시보드 생성

5. 핵심 설정 레퍼런스

Grafana에서는 Datasource 설정과 Dashboard provisioning (YAML)을 통해 자동화 가능.

6. 실무 팁 & 트러블슈팅

7. 참고 자료

• 📘 Prometheus 공식 문서
• 📘 Grafana 공식 문서
• 📘 Alertmanager 구성 가이드
• 📘 Grafana 대시보드 마켓플레이스
• 📘 PromQL 기초