Micrometer 입문에서 운영까지 9편 완주 가이드. 추천 읽기 순서와 전체 목차.
Micrometer 입문에서 운영까지
앱이 메트릭을 내보내는 계측(instrumentation) 계층의 벤더 중립 facade. Counter·Gauge·Timer·DistributionSummary Meter 타입부터 Prometheus·Datadog·Wavefront Registry 백엔드, Spring Boot Actuator 통합, percentile·SLO, 태그·카디널리티, IaC·OpenTelemetry, 운영 함정까지 9편으로 풀어쓴 학습 자료입니다.
어떤 분이 읽으면 좋아요
이 시리즈는 Spring 백엔드 개발자로서 메트릭을 Prometheus·Grafana로 보내고 싶은 분, 또는 Actuator /metrics 엔드포인트가 어디서 오는지 궁금했던 분을 염두에 두고 썼어요. Micrometer는 앱 코드에서 메트릭을 측정하는 계층이고, Grafana 시리즈는 그 메트릭을 시각화하는 계층이에요. 두 시리즈는 자연스럽게 짝을 이룹니다.
처음 들어오신 분은 1편(큰 그림) → 2편(Meter 타입) → 5편(Actuator 통합) 세 편이면 Spring 앱에 Micrometer를 붙여 Prometheus로 메트릭을 보내는 흐름이 잡혀요. percentile·SLO가 급하면 3편, 태그 설계가 고민이면 4편, 운영 함정 체크리스트는 8편을 먼저 챙기세요.
추천 읽기 순서
- 처음 시작하는 분 → 1편(큰 그림·facade) → 2편(Meter 타입) → 5편(Actuator 통합)
- percentile·SLO가 급한 분 → 1편 → 3편(Timer·percentile·SLO) → 4편(태그·카디널리티)
- Prometheus·Datadog 백엔드 연결 → 1편 → 5편 → 6편(Registry·push vs pull)
- IaC·OpenTelemetry 연동 → 6편 → 7편(운영 자동화·IaC·OTel)
- 운영 함정 체크 → 8편(운영 함정·사고 케이스) → 9편(마무리·체크리스트)
전체 목차
| 편 | 제목 | 핵심 |
|---|---|---|
| 1편 | 메트릭의 벤더 중립 facade·큰 그림 | MeterRegistry·SPI·Prometheus·Spring Boot 연결 |
| 2편 | Meter 타입 깊이 (Counter·Gauge·Timer·DistributionSummary) | 4가지 Meter·용도·실전 코드 |
| 3편 | Timer·percentile·histogram·SLO 깊이 | p99·p999·histogram·SLO 측정 |
| 4편 | 태그·차원·카디널리티 깊이 | 태그 설계 원칙·카디널리티 폭발 방지 |
| 5편 | Spring Boot Actuator 통합 깊이 | /actuator/metrics·Prometheus 엔드포인트·자동 계측 |
| 6편 | Registry·백엔드·push vs pull 깊이 | Prometheus·Datadog·Wavefront·push/pull 비교 |
| 7편 | 운영 자동화·IaC·OpenTelemetry 연동 | OTel SDK 연동·Helm·Terraform·자동화 |
| 8편 | 운영 함정 + 사고 케이스 깊이 | 카디널리티 폭발·메모리 누수·레지스트리 장애 패턴 |
| 9편 | 시리즈 마무리·체크리스트·다음 학습 | 9편 압축 요약·운영 체크리스트·다음 단계 |
다음 단계
메트릭을 내보내는 계측 계층(Micrometer)이 끝났다면, 그 메트릭을 시각화하고 알림을 거는 자리가 Grafana입니다. 전체 시리즈 로드맵은 series 페이지에서 확인하세요.
- Grafana 입문에서 운영까지 — 9편 완주 가이드 (시각화·알림·SLO)
- 전체 시리즈 로드맵