직접 만든 오픈소스입니다. 코딩 에이전트를 여러 개 같이 쓰다 보니 /usage 같은 에이전트별 화면으로는 셋을 나란히, 기간별로 보기 어려워서 만들었습니다. /usage를 대체하려는 것은 아니고, 에이전트를 여러 개 쓰는 개인이나 팀을 위한 도구입니다.
로컬에서 docker compose up
한 번으로 OpenTelemetry Collector, Prometheus, Loki, Tempo와 Grafana·Perses 대시보드 3개가 뜹니다. 작은 Go CLI(agent-otel-kit setup claude|codex|gemini|all
)가 각 에이전트 설정을 collector로 향하게 하고(원본 백업, --undo
지원), doctor
가 데이터가 들어오는지 확인합니다.
볼 수 있는 것
- 세 에이전트를 나란히, 기간별 추이
- 세션별 비용·토큰 (비용은 Claude Code만. Codex·Gemini CLI는 비용 메트릭을 내보내지 않습니다)
- 도구별 호출 수, 실패, p95 소요 시간, 권한 결정
- 프롬프트·모델 요청·도구 호출 단위 트레이스 워터폴(Tempo)
- OTel 표준이라 Prometheus 알림을 붙이거나,
--endpoint
로 팀 공용 collector에 모을 수 있음
프롬프트 내용, 도구 인자·출력, user.email
은 에이전트 쪽 스위치를 실수로 켜도 collector에서 기본으로 지웁니다. 스택이 외부로 보내는 데이터는 없습니다.
에이전트마다 delta temporality 카운터를 보내서 Prometheus에 그대로 넣으면 값이 틀어지는 문제가 있었고, collector의 delta_to_cumulative
로 풀었습니다. Claude Code 2.1.325, Codex 0.169.0, Gemini CLI 0.68.0으로 실제 세션을 돌려 확인했고, 확인 못 한 부분(Codex 세션별 표 누락 등)은 README에 적어 두었습니다. 코드 상당 부분은 AI 코딩 에이전트와 함께 작성했습니다.
다른 에이전트 지원이나 대시보드에 더 있었으면 하는 지표 의견 주시면 반영하겠습니다.
설치: brew install s3onghyun/tap/agent-otel-kit
또는 릴리스 바이너리(v0.1.0, macOS·Linux) https://github.com/s3onghyun/agent-otel-kit/releases/tag/v0.1.0