Überwachung

​

Schnellstart

# 1. Telemetrie aktivieren
export CLAUDE_CODE_ENABLE_TELEMETRY=1

# 2. Exporter auswählen (beide sind optional - konfigurieren Sie nur das, was Sie benötigen)
export OTEL_METRICS_EXPORTER=otlp       # Optionen: otlp, prometheus, console
export OTEL_LOGS_EXPORTER=otlp          # Optionen: otlp, console

# 3. OTLP-Endpunkt konfigurieren (für OTLP-Exporter)
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

# 4. Authentifizierung festlegen (falls erforderlich)
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer your-token"

# 5. Zum Debuggen: Exportintervalle reduzieren
export OTEL_METRIC_EXPORT_INTERVAL=10000  # 10 Sekunden (Standard: 60000ms)
export OTEL_LOGS_EXPORT_INTERVAL=5000     # 5 Sekunden (Standard: 5000ms)

# 6. Claude Code ausführen
claude

​

Administratorkonfiguration

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_LOGS_EXPORTER": "otlp",
    "OTEL_EXPORTER_OTLP_PROTOCOL": "grpc",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "http://collector.example.com:4317",
    "OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Bearer example-token"
  }
}

​

Konfigurationsdetails

​

Allgemeine Konfigurationsvariablen

​

Metriken-Kardinalitätskontrolle

​

Dynamische Header

​

Einstellungskonfiguration

{
  "otelHeadersHelper": "/bin/generate_opentelemetry_headers.sh"
}

​

Skriptanforderungen

#!/bin/bash
# Beispiel: Mehrere Header
echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"

​

Aktualisierungsverhalten

​

Unterstützung für Multi-Team-Organisationen

# Benutzerdefinierte Attribute für Team-Identifikation hinzufügen
export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"

• Metriken nach Team oder Abteilung filtern können
• Kosten pro Kostenstelle verfolgen können
• Team-spezifische Dashboards erstellen können
• Warnungen für bestimmte Teams einrichten können

# ❌ Ungültig - enthält Leerzeichen
export OTEL_RESOURCE_ATTRIBUTES="org.name=John's Organization"

# ✅ Gültig - verwenden Sie stattdessen Unterstriche oder camelCase
export OTEL_RESOURCE_ATTRIBUTES="org.name=Johns_Organization"
export OTEL_RESOURCE_ATTRIBUTES="org.name=JohnsOrganization"

# ✅ Gültig - prozentcodieren Sie Sonderzeichen, falls erforderlich
export OTEL_RESOURCE_ATTRIBUTES="org.name=John%27s%20Organization"

​

Beispielkonfigurationen

# Console-Debugging (1-Sekunden-Intervalle)
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=console
export OTEL_METRIC_EXPORT_INTERVAL=1000

# OTLP/gRPC
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

# Prometheus
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=prometheus

# Mehrere Exporter
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=console,otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=http/json

# Unterschiedliche Endpunkte/Backends für Metriken und Logs
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_METRICS_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT=http://metrics.example.com:4318
export OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=http://logs.example.com:4317

# Nur Metriken (keine Ereignisse/Logs)
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

# Nur Ereignisse/Logs (keine Metriken)
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

​

Verfügbare Metriken und Ereignisse

​

Standardattribute

• prompt.id: UUID, die einen Benutzer-Prompt mit allen nachfolgenden Ereignissen bis zum nächsten Prompt korreliert. Siehe Ereigniskorrelationsattribute.
• workspace.host_paths: Host-Workspace-Verzeichnisse, die in der Desktop-App ausgewählt wurden, als String-Array

​

Metriken

​

Metrik-Details

​

Sitzungszähler

• Alle Standardattribute

​

Codezeilen-Zähler

• Alle Standardattribute
• type: ("added", "removed")

​

Pull-Request-Zähler

• Alle Standardattribute

​

Commit-Zähler

• Alle Standardattribute

​

Kostenzähler

• Alle Standardattribute
• model: Modellkennung (zum Beispiel “claude-sonnet-4-6”)

​

Token-Zähler

• Alle Standardattribute
• type: ("input", "output", "cacheRead", "cacheCreation")
• model: Modellkennung (zum Beispiel “claude-sonnet-4-6”)

​

Code-Edit-Tool-Entscheidungszähler

• Alle Standardattribute
• tool_name: Tool-Name ("Edit", "Write", "NotebookEdit")
• decision: Benutzerentscheidung ("accept", "reject")
• source: Entscheidungsquelle - "config", "hook", "user_permanent", "user_temporary", "user_abort" oder "user_reject"
• language: Programmiersprache der bearbeiteten Datei, wie "TypeScript", "Python", "JavaScript" oder "Markdown". Gibt "unknown" für nicht erkannte Dateierweiterungen zurück.

​

Aktive-Zeit-Zähler

• Alle Standardattribute
• type: "user" für Tastaturinteraktionen, "cli" für Tool-Ausführung und KI-Antworten

​

Ereignisse

​

Ereigniskorrelationsattribute

​

Benutzer-Prompt-Ereignis

• Alle Standardattribute
• event.name: "user_prompt"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• prompt_length: Länge des Prompts
• prompt: Prompt-Inhalt (standardmäßig geschwärzt, aktivieren Sie mit OTEL_LOG_USER_PROMPTS=1)

​

Tool-Ergebnis-Ereignis

• Alle Standardattribute
• event.name: "tool_result"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• tool_name: Name des Tools
• success: "true" oder "false"
• duration_ms: Ausführungszeit in Millisekunden
• error: Fehlermeldung (falls fehlgeschlagen)
• decision_type: Entweder "accept" oder "reject"
• decision_source: Entscheidungsquelle - "config", "hook", "user_permanent", "user_temporary", "user_abort" oder "user_reject"
• tool_result_size_bytes: Größe des Tool-Ergebnisses in Bytes
• mcp_server_scope: MCP-Server-Scope-Kennung (für MCP-Tools)
• tool_parameters: JSON-Zeichenkette mit Tool-spezifischen Parametern (falls verfügbar)
  • Für Bash-Tool: enthält bash_command, full_command, timeout, description, dangerouslyDisableSandbox und git_commit_id (der Commit-SHA, wenn ein git commit-Befehl erfolgreich ist)
  • Für MCP-Tools (wenn OTEL_LOG_TOOL_DETAILS=1): enthält mcp_server_name, mcp_tool_name
  • Für Skill-Tool (wenn OTEL_LOG_TOOL_DETAILS=1): enthält skill_name
• tool_input (wenn OTEL_LOG_TOOL_DETAILS=1): JSON-serialisierte Tool-Argumente. Einzelne Werte über 512 Zeichen werden gekürzt, und die gesamte Nutzlast ist auf etwa 4 K Zeichen begrenzt. Gilt für alle Tools einschließlich MCP-Tools.

​

API-Anfrage-Ereignis

• Alle Standardattribute
• event.name: "api_request"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• model: Verwendetes Modell (zum Beispiel “claude-sonnet-4-6”)
• cost_usd: Geschätzte Kosten in USD
• duration_ms: Anfragedauer in Millisekunden
• input_tokens: Anzahl der Eingabe-Token
• output_tokens: Anzahl der Ausgabe-Token
• cache_read_tokens: Anzahl der aus dem Cache gelesenen Token
• cache_creation_tokens: Anzahl der Token, die für die Cache-Erstellung verwendet werden
• speed: "fast" oder "normal", was angibt, ob der schnelle Modus aktiv war

​

API-Fehler-Ereignis

• Alle Standardattribute
• event.name: "api_error"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• model: Verwendetes Modell (zum Beispiel “claude-sonnet-4-6”)
• error: Fehlermeldung
• status_code: HTTP-Statuscode als Zeichenkette oder "undefined" für Nicht-HTTP-Fehler
• duration_ms: Anfragedauer in Millisekunden
• attempt: Versuchsnummer (für wiederholte Anfragen)
• speed: "fast" oder "normal", was angibt, ob der schnelle Modus aktiv war

​

Tool-Entscheidungs-Ereignis

• Alle Standardattribute
• event.name: "tool_decision"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• tool_name: Name des Tools (zum Beispiel “Read”, “Edit”, “Write”, “NotebookEdit”)
• decision: Entweder "accept" oder "reject"
• source: Entscheidungsquelle - "config", "hook", "user_permanent", "user_temporary", "user_abort" oder "user_reject"

​

Interpretation von Metriken- und Ereignisdaten

​

Nutzungsüberwachung

​

Kostenüberwachung

• Verfolgung von Nutzungstrends über Teams oder Einzelpersonen hinweg
• Identifikation von Sitzungen mit hoher Nutzung zur Optimierung

​

Warnungen und Segmentierung

• Kostensteigerungen
• Ungewöhnlicher Token-Verbrauch
• Hohes Sitzungsvolumen von bestimmten Benutzern

​

Ereignisanalyse

• Am häufigsten verwendete Tools
• Tool-Erfolgsquoten
• Durchschnittliche Tool-Ausführungszeiten
• Fehlermuster nach Tool-Typ

​

Backend-Überlegungen

​

Für Metriken

• Zeitreihendatenbanken (zum Beispiel Prometheus): Ratenberechnungen, aggregierte Metriken
• Spaltenorientierte Speicher (zum Beispiel ClickHouse): Komplexe Abfragen, eindeutige Benutzeranalyse
• Vollständige Observability-Plattformen (zum Beispiel Honeycomb, Datadog): Erweiterte Abfragen, Visualisierung, Warnungen

​

Für Ereignisse/Logs

• Log-Aggregationssysteme (zum Beispiel Elasticsearch, Loki): Volltextsuche, Log-Analyse
• Spaltenorientierte Speicher (zum Beispiel ClickHouse): Strukturierte Ereignisanalyse
• Vollständige Observability-Plattformen (zum Beispiel Honeycomb, Datadog): Korrelation zwischen Metriken und Ereignissen

​

Dienstinformationen

• service.name: claude-code
• service.version: Aktuelle Claude Code-Version
• os.type: Betriebssystemtyp (zum Beispiel linux, darwin, windows)
• os.version: Betriebssystem-Versionsnummer
• host.arch: Host-Architektur (zum Beispiel amd64, arm64)
• wsl.version: WSL-Versionsnummer (nur vorhanden, wenn auf Windows Subsystem for Linux ausgeführt)
• Meter-Name: com.anthropic.claude_code

​

ROI-Messung-Ressourcen

​

Sicherheit und Datenschutz

• Telemetrie ist opt-in und erfordert explizite Konfiguration
• Rohe Dateiinhalte und Code-Snippets sind nicht in Metriken oder Ereignissen enthalten. Tool-Ausführungsereignisse enthalten Bash-Befehle und Dateipfade im Feld tool_parameters, das möglicherweise vertrauliche Werte enthält. Wenn Ihre Befehle möglicherweise Geheimnisse enthalten, konfigurieren Sie Ihr Telemetrie-Backend, um tool_parameters zu filtern oder zu schwärzen
• Wenn über OAuth authentifiziert, ist user.email in Telemetrie-Attributen enthalten. Wenn dies ein Problem für Ihre Organisation darstellt, arbeiten Sie mit Ihrem Telemetrie-Backend zusammen, um dieses Feld zu filtern oder zu schwärzen
• Benutzer-Prompt-Inhalte werden standardmäßig nicht erfasst. Nur die Prompt-Länge wird aufgezeichnet. Um Benutzer-Prompt-Inhalte einzubeziehen, setzen Sie OTEL_LOG_USER_PROMPTS=1
• Tool-Eingabeargumente werden standardmäßig nicht protokolliert. Um sie einzubeziehen, setzen Sie OTEL_LOG_TOOL_DETAILS=1. Wenn aktiviert, enthalten tool_result-Ereignisse MCP-Server-/Tool-Namen und Skill-Namen sowie ein tool_input-Attribut mit Dateipfaden, URLs, Suchmustern und anderen Argumenten. Einzelne Werte über 512 Zeichen werden gekürzt und die Gesamtmenge ist auf etwa 4 K Zeichen begrenzt, aber die Argumente können immer noch vertrauliche Werte enthalten. Konfigurieren Sie Ihr Telemetrie-Backend, um tool_input nach Bedarf zu filtern oder zu schwärzen

​

Überwachung von Claude Code auf Amazon Bedrock