오픈 소스 Grafana 대시보드, OpenTelemetry를 통해 Claude Code 비용 및 사용량 추적

Claude Code 비용 및 사용량을 추적하기 위한 Grafana 대시보드가 오픈소스로 공개되었습니다. Claude Code의 OpenTelemetry(OTel) 메트릭 기능이 조용히 출시된 것을 발견한 SRE가 제작한 이 대시보드는 OTel 메트릭을 Prometheus, VictoriaMetrics, Mimir, Thanos 등 모든 Prometheus 호환 백엔드로 가져옵니다.

제공하는 정보

• 모델, 프로젝트, 사용자별 비용 분석
• 시간에 따른 토큰 사용량
• 캐시 히트 비율 — 청구 예측 가능성에 가장 큰 영향을 미치는 요소
• 활성 시간, 수정된 코드 줄 수, 커밋 및 Claude가 연 PR
• 편집 결정 분석 (수락 vs. 거부)

그룹화를 위한 사용자 정의 레이블

OTEL_RESOURCE_ATTRIBUTES를 사용하여 사용자 정의 레이블을 추가하고 팀이나 프로젝트별로 데이터를 그룹화할 수 있습니다. 이를 통해 특정 팀이나 이니셔티브에 비용을 쉽게 귀속시킬 수 있습니다.

설치 방법

• 전체 설정 가이드가 포함된 문서: rockdarko.dev
• Grafana Labs에서 직접 다운로드: 대시보드 ID 25255
• 저장소 (MIT 라이선스): github.com/rockdarko/claude-code-metrics-prometheus

기존의 Claude Code용 Azure Application Insights 대시보드에서 영감을 받아, 이 구현은 오픈소스 관측 스택을 사용하는 팀을 대상으로 합니다. 대시보드는 MIT 라이선스로 제공되며 Grafana 인스턴스에 즉시 가져올 수 있습니다.