Observability stack for collecting and visualizing Claude Code telemetry.
- Docker and Docker Compose
-
Copy and configure environment variables:
cp .env.example .env
-
Start the stack:
docker compose up -d
-
Configure Claude Code to send telemetry:
export CLAUDE_CODE_ENABLE_TELEMETRY=1 export OTEL_METRICS_EXPORTER=otlp export OTEL_LOGS_EXPORTER=otlp export OTEL_EXPORTER_OTLP_PROTOCOL=grpc export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
-
Access Grafana at http://localhost:3500 (credentials from .env)
| Service | Port | Description |
|---|---|---|
| Grafana | 3500 | Dashboards |
| Prometheus | 9090 | Metrics storage |
| OTEL Collector | 4317 | OTLP gRPC endpoint |
| OTEL Collector | 4318 | OTLP HTTP endpoint |
docker compose down