Docker Compose와 오픈소스 도구를 활용하여 PostgreSQL 데이터베이스의 메트릭 수집과 로그 집계를 통합하는 모니터링 스택을 구축하는 튜토리얼입니다.

Context

프로덕션 환경에서 PostgreSQL 데이터베이스를 운영할 때 느린 쿼리, 잠금 경합, vacuum 문제가 애플리케이션 성능을 저하시키며 별도의 모니터링 시스템이 필요합니다. 기존 방식은 메트릭 수집과 로그 관리를 각각 다른 도구로 구성해야 했습니다.

Technical Solution

• Docker Compose로 PostgreSQL, Grafana Alloy, Prometheus, Loki, Grafana 컨테이너를 통합 관리합니다
• PostgreSQL에 pg_stat_statements 확장 설치 후 exporter 사용자에게 pg_monitor 및 쿼리 통계 접근 권한을 부여합니다
• Grafana Alloy가 Prometheus 메트릭 스크레이핑과 Loki 로그 전송을 단일 에이전트로 처리합니다
• Prometheus가 15초 간격으로 데이터베이스, 잠금, 백그라이터, 쿼리 성능, 자동vacuum 메트릭을 수집합니다
• Loki가 구조화된 로그를 저장하여 Grafana에서 메트릭과 로그를 상관관계 분석할 수 있게 합니다

Impact

별도 시스템 패키지 설치 없이 Docker 환경에서 모니터링 스택을 즉시 가동하고 폐기할 수 있습니다

Key Takeaway

Grafana Alloy 하나가 메트릭 수집과 로그 전송 역할을 동시에 수행하여 에이전트 관리 부담을 줄입니다