flysloughofdespond447/claude-code-opentelemetry-setup

Was macht claude-code-opentelemetry-setup?

🚀 Überwache die Nutzung von Claude Code mit OpenTelemetry, Prometheus, Loki und Grafana für Echtzeit-Einblicke in Kosten, Tokenverbrauch und Leistungsmetriken.

Überblick

Dieses Skill richtet eine vollständige Observability-Plattform für Claude Code ein. Es sammelt Telemetriedaten über OpenTelemetry, speichert Metriken in Prometheus, Protokolle in Loki und visualisiert alles in Grafana. So erhältst du detaillierte Einblicke in:

• Kosten pro Sitzung oder Anfrage
• Tokenverbrauch (Eingabe, Ausgabe, insgesamt)
• Antwortlatenz und Durchsatz
• Fehlerrate und Wiederholungsversuche
• Nutzungsstatistiken (häufigste Befehle, Modellpräferenzen)

Voraussetzungen

• Docker und Docker Compose installiert
• Node.js 18 oder höher
• Ein Claude Code-Projekt (installiert via npm install -g @anthropic-ai/claude-code)
• Grundkenntnisse in YAML und Docker

Installation

1. Repository klonen

   git clone https://github.com/flysloughofdespond447/claude-code-opentelemetry-setup.git
   cd claude-code-opentelemetry-setup
   

2. Umgebungsvariablen konfigurieren Kopiere die Datei .env.example nach .env und passe die Werte an:

   OTEL_SERVICE_NAME=claude-code
   OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
   PROMETHEUS_PORT=9090
   LOKI_PORT=3100
   GRAFANA_PORT=3000
   

3. Infrastruktur starten

   docker-compose up -d
   

   Dies startet Prometheus, Loki und Grafana als Docker-Container.

4. Claude Code konfigurieren Aktualisiere die claude_config.yaml (im Stammverzeichnis deines Claude-Projekts) um die OpenTelemetry-Integration:

   observability:
     enabled: true
     exporter: otlp
     endpoint: http://localhost:4318
     headers:
       "x-api-key": "dein-api-key"
   

5. Claude Code starten

   claude
   

   Nun werden Telemetriedaten an die OpenTelemetry-Collector-Instanz gesendet.

Dashboards

Nach dem Start findest du unter http://localhost:3000 (Standard-Login: admin/admin) folgende vorkonfigurierte Dashboards:

Dashboard	Beschreibung
Claude Code Kosten	Übersicht über die Gesamtkosten und Kosten pro Anfrage
Tokenverbrauch	Detaillierte Aufschlüsselung der Eingabe- und Ausgabetoken
Leistungsmetriken	Latenz, Durchsatz und Fehlerraten
Nutzungsstatistiken	Häufigste Befehle und Modellnutzung

Deinstallation

Um die Infrastruktur zu stoppen und zu entfernen:

docker-compose down -v

Entferne außerdem den observability-Abschnitt aus deiner claude_config.yaml.

Fehlerbehebung

• Keine Daten in Grafana? Prüfe, ob der OpenTelemetry-Collector läuft (docker ps). Stelle sicher, dass die Umgebungsvariablen korrekt gesetzt sind.
• Portkonflikte? Ändere die Ports in der .env-Datei und starte die Container neu (docker-compose restart).
• Logs anzeigen: docker-compose logs -f

Lizenz

MIT