MOPL Grafana 대시보드 소개 및 운영 가이드

1. 문서 목적

이 문서는 팀원이 로컬 환경에서 MOPL Grafana 대시보드를 실행하고, 각 Row와 Panel이 무엇을 의미하는지 이해할 수 있도록 정리한 화면 중심의 소개 문서다. 대시보드 구성과 설명은 2026-07-23 기준 grafana/dashboards/mopl-observability.json을 따른다.

현재 대시보드는 다음 영역을 다룬다.

전체 Batch
Notification/SSE
Notification Redis Pub/Sub
WebSocket/STOMP
Watching Session
DM/Content Chat
DM·대화방·팔로우 Redis 동기화

최종 구성은 7개 Row와 26개 Panel이다.

이 문서에 포함된 화면의 수치는 테스트 과정에서 발생한 예시 값이다. 운영 환경의 정상 기준이나 성능 목표를 의미하지 않는다.

2. 모니터링 구성

Grafana는 Spring 애플리케이션을 직접 조회하지 않는다. 각 App 인스턴스가 Micrometer와 Actuator로 메트릭을 노출하고, Prometheus가 이를 주기적으로 수집·저장한 뒤 Grafana가 PromQL로 조회한다.

App / App-2
  -> /actuator/prometheus
  -> Prometheus 수집 및 저장
  -> Grafana 조회 및 시각화

구성 요소	역할
Spring Actuator/Micrometer	애플리케이션의 커스텀 메트릭 노출
Prometheus	각 App 인스턴스의 메트릭 수집 및 시계열 저장
Grafana	Prometheus 데이터를 Panel로 시각화
대시보드 JSON	Row, Panel, PromQL, 색상 및 배치를 코드로 보관