위키득계정 ↗
기술

StatsD Exporter

StatsD Exporter기술
입력 형식
StatsD 방식 메트릭
출력 형식
Prometheus 메트릭
변환 기준
이름과 레이블 매핑 규칙
대표 활용
기존 계측의 단계적 전환
StatsD Exporter는 StatsD 형식으로 받은 메트릭을 Prometheus 형식으로 바꾸는 도구다. 매핑 규칙으로 메트릭 이름과 레이블을 구성해 기존 계측을 Prometheus 수집 흐름에 연결한다.

서로 다른 계측 형식 연결

이미 StatsD로 메트릭을 보내는 애플리케이션을 Prometheus와 연결하려면 두 형식 사이의 변환이 필요하다. StatsD Exporter는 받은 메트릭을 설정한 규칙으로 바꿔 수집 가능한 형태로 제공한다. 애플리케이션의 계측 코드를 한 번에 모두 변경하지 않고 관측 체계를 연결하는 중간 단계로 활용할 수 있다.

이름과 태그의 변환

StatsD의 계층적인 메트릭 이름을 Prometheus 이름과 레이블로 대응시킬 수 있다. 일부 StatsD 확장의 태그도 레이블로 변환하며 glob과 정규식 매칭을 지원한다. 규칙의 우선순위와 태그 형식에 따라 결과가 달라질 수 있으므로 변환된 메트릭의 의미를 확인해야 한다.

기존 경로와 함께 운영

릴레이 기능은 수신한 정보를 기존 StatsD 대상으로 전달해 단계적인 전환을 돕는다. 공식 안내는 애플리케이션 옆의 사이드카 형태를 설명하며 장기적으로는 직접적인 Prometheus 계측을 권한다. 형식 변환과 수집 위치에 따라 인스턴스별 정보가 어떻게 구분되는지도 함께 검토해야 한다.

관련 문서

Pushgateway / Node Exporter / Kube-state-metrics