📘 [MinIO & Cilium 기반 오브젝트 스토리지 연동 시리즈 #16] Prometheus + MinIO Exporter 설치 및 /metrics 확인

✅ 목표: MinIO의 성능 지표를 Prometheus로 수집하고,
Prometheus와 MinIO Exporter를 연동하여 /metrics 엔드포인트에서 성능 지표를 확인하는 방법을 실습합니다.

---

🔎 이번 글에서 수행할 작업 요약

1. MinIO Exporter 설치 및 설정
2. Prometheus와 MinIO Exporter 연동
3. MinIO /metrics 엔드포인트 확인
4. Prometheus 대시보드에서 지표 확인

---

🧠 1단계: MinIO Exporter 설치

이 단계의 목적: MinIO Exporter를 설치하여, Prometheus에서 MinIO의 성능 지표를 수집할 수 있도록 설정합니다.

# MinIO Exporter 설치 (Helm 사용)
helm install minio-exporter \
  --namespace monitoring \
  --set minio.url=http://minio.minio.svc.cluster.local:9000 \
  --set prometheus.scrape.interval=30s \
  bitnami/minio-exporter

✅ minio-exporter는 MinIO의 /metrics 엔드포인트에서 성능 지표를 수집하는 역할을 합니다.
Prometheus는 이 지표를 주기적으로 수집하여 모니터링에 활용합니다.

---

⚙️ 2단계: Prometheus와 MinIO Exporter 연동

이 단계의 목적: Prometheus의 scrape_configs에 MinIO Exporter를 추가하여,
Prometheus가 MinIO의 메트릭스를 수집할 수 있도록 설정합니다.

# prometheus.yml의 scrape_configs에 MinIO Exporter 추가
scrape_configs:
  - job_name: 'minio'
    static_configs:
      - targets: ['minio-exporter.monitoring.svc.cluster.local:9000']

# Prometheus 설정 파일 적용
kubectl apply -f prometheus.yml

✅ Prometheus가 MinIO Exporter의 /metrics 엔드포인트를 주기적으로 스크랩하여 데이터를 수집합니다.

---

🔍 3단계: /metrics 엔드포인트에서 지표 확인

이 단계의 목적: MinIO의 /metrics 엔드포인트에서 실제로 성능 지표가 잘 수집되고 있는지 확인합니다.

# MinIO Exporter에 직접 접근하여 metrics 확인
kubectl port-forward svc/minio-exporter 9100:9000 -n monitoring
curl http://localhost:9100/metrics

✅ /metrics 엔드포인트에서 다양한 MinIO의 성능 지표 (예: 요청 수, 오류 수, 처리 시간 등)을 확인할 수 있습니다.

---

📊 4단계: Prometheus 대시보드에서 MinIO 지표 시각화

이 단계의 목적: Prometheus와 Grafana를 연동하여 MinIO의 성능 지표를 대시보드에서 시각화합니다.

1. Grafana 설치 및 연동: Prometheus와 Grafana를 연동하여,
   MinIO의 성능 지표를 대시보드로 시각화합니다.
2. Grafana에서 MinIO 대시보드 가져오기:
   Grafana에서 Prometheus 데이터 소스를 설정하고, MinIO 관련 대시보드를 가져옵니다.

# Grafana 대시보드 추가
# Grafana UI에 접속 후, 데이터 소스로 Prometheus 추가
# 그 후, MinIO 관련 대시보드를 추가하여 모니터링

✅ 이제 Grafana 대시보드에서 MinIO의 성능 지표를 실시간으로 모니터링할 수 있습니다.
지표 예시: MinIO 요청 수, S3 요청 성공률, 에러율 등.

---

📎 요약 및 핵심 정리

• MinIO Exporter와 Prometheus를 연동하여 MinIO의 성능 지표를 수집하고 모니터링할 수 있음
• /metrics 엔드포인트에서 MinIO의 다양한 메트릭스를 확인하고, Prometheus 대시보드를 통해 시각화 가능
• Grafana 대시보드를 활용하면 실시간으로 MinIO의 상태를 모니터링할 수 있어, 장애나 성능 문제를 빠르게 감지할 수 있음