본문으로 건너뛰기

Grafana

GenD 모니터링 대시보드 구성 및 관리 방법입니다.

개요

Grafana는 kube-prometheus-stack의 일부로 배포되며, Prometheus 메트릭과 Loki 로그를 시각화합니다. GenD 전용 대시보드가 사전 구성되어 있습니다.

접속 정보

항목
URLhttp://localhost:31300
기본 계정admin
기본 비밀번호gend-grafana (개발 전용)
NodePort31300

프로덕션에서는 반드시 비밀번호를 변경하세요.

데이터 소스

데이터 소스유형URL
Prometheusprometheushttp://prometheus-server:9090
Lokilokihttp://loki.monitoring.svc:3100

Loki 데이터 소스는 Promtail 설치 후 자동 연결됩니다 (additionalDataSources 설정).

사전 구성 대시보드

Grafana sidecar가 grafana_dashboard 라벨이 있는 ConfigMap을 자동으로 로드합니다.

대시보드경로내용
Trino Autoscalerinfra/grafana/dashboards/Trino 쿼리/워커 메트릭
GenD APIinfra/monitoring/grafana-dashboards/HTTP/비즈니스 메트릭

주요 패널

GenD API 대시보드

  • 요청률: rate(gend_http_requests_total[5m]) — 초당 요청 수
  • 응답 시간: gend_http_request_duration_seconds — P50/P95/P99 레이턴시
  • 에러율: 4xx/5xx 응답 비율
  • 동시 요청: gend_http_requests_in_progress — 현재 처리 중

인프라 대시보드

  • 노드 CPU/메모리 사용률
  • Pod 리소스 사용량
  • PVC 디스크 사용량

Helm 설정

infra/monitoring/kube-prometheus-stack-values.yaml에서 Grafana를 구성합니다.

설정
메모리 요청/제한128Mi / 256Mi
CPU 요청/제한50m / 250m
Dashboard sidecar전체 네임스페이스 탐색

알림 설정

Alertmanager와 연동하여 Grafana에서 알림 규칙을 정의할 수 있습니다.

관련 문서