Claude Code 모니터링 대시보드. 도움 될 사람 있을 듯. 난 도움 많이 받았음.
Claude Code Monitoring Dashboard. May help some folks. It helped me.
핵심 요약
Claude Code 환경의 성능과 토큰 사용량을 시각화할 수 있는 Grafana/Prometheus 기반 모니터링 대시보드 공유.
- 모니터링 도구 — Claude Code의 성능 및 토큰 사용량을 시각화함.
- 오픈 소스 — Grafana와 Prometheus를 활용해 직접 구축 가능함.
- 배포 옵션 — Docker Compose나 Kubernetes 환경에서 실행 가능함.
- 데이터 기반 — OTEL 메트릭과 로그를 분석하여 환경을 최적화함.
본업이 SRE(Site Reliability Engineer)라 지원하는 모든 앱과 인프라의 의사결정을 위해 관측 가능성(observability) 데이터에 크게 의존함.
Claude Code 환경에서도 똑같은 가시성을 확보하고 싶었음. 그래야 Claude Code가 어떻게 작동하는지, 성능과 토큰 사용량, 세션 사용량 같은 핵심 데이터에 어떤 영향을 주는지 이해할 수 있으니까.
그래서 Claude Code가 생성하는 오픈 텔레메트리(OTEL) 메트릭과 로그 관련 문서를 파고드는 데 꽤 많은 시간을 썼고, 처음에는 업무용으로 쓰는 Dynatrace 환경에 연동했음.
결과가 만족스럽고 얻은 인사이트도 좋아서, Grafana와 Prometheus를 사용한 오픈 소스 버전을 만들었고 필요한 사람들을 위해 공유함.
GitHub 리드미에 환경 구축 방법 다 적어놨음. Docker Compose로 띄우거나 k8s 환경에서 실행할 수 있게 옵션도 만들어둠.
Claude를 실행하는 머신과 같은 곳에서 돌릴 필요도 없음.
그리고 맞음... AI의 도움을 받아 만들긴 했지만, 그냥 대충 만든(vibe coded) 게 아님. 메트릭과 로그를 이해하려고 한 달 정도 연구해서 만든 거임.
도움 되면 좋고, 아니면 말고...
