위키득계정 ↗
기술

Graphite Exporter

Graphite Exporter기술
입력 형식
Graphite 텍스트 프로토콜
수신 통신
TCP와 UDP
출력 형식
Prometheus 메트릭
변환 설정
YAML 매핑 규칙
Graphite Exporter는 Graphite 텍스트 프로토콜로 받은 메트릭을 Prometheus 형식으로 제공하는 도구다. TCP와 UDP로 값을 받고 이름과 태그를 메트릭 및 레이블로 변환한다.

기존 메트릭의 연결 경로

Graphite 형식으로 값을 전송하는 시스템을 Prometheus와 연결할 때 사용할 수 있다. Graphite Exporter는 들어온 값을 변환해 수집 가능한 HTTP 메트릭으로 노출한다. 전송된 정보를 받아 제공하는 역할이며 애플리케이션의 내부 상태를 직접 조사하는 exporter와는 데이터의 출발점이 다르다.

이름과 레이블의 매핑

점으로 구분된 메트릭 이름을 설정 규칙에 따라 Prometheus 이름과 레이블로 바꿀 수 있다. Graphite 태그도 지원하지만 잘못된 태그가 있으면 해당 태그를 버리고 파싱 실패를 기록한다. 이름 변환이 가능하더라도 원래 지표의 의미와 레이블 구성이 적절한지 검토해야 한다.

메트릭의 수명과 변환 한계

마지막 전송 후 일정 시간이 지난 메트릭을 정리하며 만료 시간을 설정할 수 있다. 또한 Prometheus 클라이언트의 Graphite 브리지를 거쳐 다시 변환하는 방식은 정보 손실과 메트릭 충돌 때문에 호환되지 않는다. 기존 전송 경로와 필요한 형식을 확인해 불필요한 왕복 변환을 피해야 한다.

관련 문서

StatsD Exporter / Pushgateway / JSON Exporter