Ü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, none
export OTEL_LOGS_EXPORTER=otlp          # Optionen: otlp, console, none

# 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

​

mTLS-Authentifizierung

​

Metriken-Kardinalitätskontrolle

​

Traces (Beta)

​

Span-Hierarchie

claude_code.interaction
├── claude_code.llm_request
├── claude_code.hook                    (erfordert detailliertes Beta-Tracing)
└── claude_code.tool
    ├── claude_code.tool.blocked_on_user
    ├── claude_code.tool.execution
    └── (Agent-Tool) Subagent claude_code.llm_request / claude_code.tool Spans

​

Span-Attribute

​

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)\"}"

• /status Ausgabe
• Das Debug-Log, wenn Sie mit --debug ausführen oder nach dem Ausführen von /debug in der Sitzung
• stderr, in nicht-interaktiven Sitzungen, die mit -p gestartet werden

​

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

export OTEL_RESOURCE_ATTRIBUTES="org.name=Johns_Organization"
export OTEL_RESOURCE_ATTRIBUTES="org.name=JohnsOrganization"

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
• workflow.run_id: Lauf-Kennung mit dem Präfix wf_ auf der API und Tool-Ereignisse, die von Agents ausgegeben werden, die zu einem Workflow Tool-Lauf gehören. Das Filtern von Ereignissen nach einer workflow.run_id rekonstruiert die API-Anfragen und Tool-Ergebnisse dieses Laufs. Die Kennung umfasst die Agents, die das Workflow-Skript erzeugt, und alle Agents, die diese wiederum erzeugen, z. B. Skill-Aufrufe. Sie entspricht der Lauf-Kennung, die im Workflow-Tool-Ergebnis gemeldet wird. Nicht vorhanden bei allen anderen Ereignissen. Erfordert Claude Code v2.1.202 oder später
• workflow.name: Name des Workflows, das meta.name des Skripts, ausgegeben zusammen mit workflow.run_id. Integrierte Workflow-Namen erscheinen wörtlich, wenn der Lauf das unmodifizierte integrierte Skript ausführt. Benutzerdefinierte Namen, einschließlich bearbeiteter Kopien integrierter Skripte, werden durch custom ersetzt, es sei denn, OTEL_LOG_TOOL_DETAILS=1 ist gesetzt. Erfordert Claude Code v2.1.202 oder später

​

Metriken

​

Metrik-Details

​

Sitzungszähler

• Alle Standardattribute
• start_type: Wie die Sitzung gestartet wurde. Einer von "fresh", "resume", "continue" oder "agents_view". Der Wert "agents_view" identifiziert den claude agents Dashboard-Prozess, eine von Benutzern gestartete lokale Benutzeroberfläche statt einer Konversationssitzung. Filtern Sie nach diesem Wert, um UI-Prozessstart von Konversationssitzungen in Ihren Dashboards zu trennen.

​

Codezeilen-Zähler

• Alle Standardattribute
• type: ("added", "removed")
• model: Modellkennung für das Modell, das die Änderung vorgenommen hat (z. B. “claude-sonnet-5”)

​

Pull-Request-Zähler

• Alle Standardattribute

​

Commit-Zähler

• Alle Standardattribute

​

Kostenzähler

• Alle Standardattribute
• model: Modellkennung (z. B. “claude-sonnet-5”)
• query_source: Kategorie des Subsystems, das die Anfrage gestellt hat. Einer von "main", "subagent" oder "auxiliary"
• speed: "fast", wenn die Anfrage den schnellen Modus verwendet hat. Andernfalls nicht vorhanden
• effort: Anstrengungsstufe, die auf die Anfrage angewendet wird: "low", "medium", "high", "xhigh" oder "max". Nicht vorhanden, wenn das Modell Anstrengung nicht unterstützt.
• agent.name: Subagent-Typ, der die Anfrage gestellt hat. Integrierte Agent-Namen und Agents aus offiziellen Marketplace-Plugins werden wörtlich angezeigt. Andere benutzerdefinierte Agent-Namen werden durch "custom" ersetzt. Nicht vorhanden, wenn die Anfrage nicht von einem benannten Subagent-Typ gestellt wurde.
• skill.name: Skill, der für die Anfrage aktiv ist, gesetzt durch das Skill-Tool, einen / Befehl oder geerbt von einem erzeugten Subagent. Integrierte, gebündelte, benutzerdefinierte und offizielle Marketplace-Plugin-Skill-Namen werden wörtlich angezeigt. Drittanbieter-Plugin-Skill-Namen werden durch "third-party" ersetzt. Nicht vorhanden, wenn kein Skill aktiv ist.
• plugin.name: Besitzendes Plugin, wenn der aktive Skill oder Subagent von einem Plugin bereitgestellt wird. Offizielle Marketplace-Plugin-Namen werden wörtlich angezeigt. Drittanbieter-Plugin-Namen werden durch "third-party" ersetzt. Nicht vorhanden, wenn weder der Skill noch der Subagent ein besitzendes Plugin hat.
• marketplace.name: Marketplace, von dem das besitzende Plugin installiert wurde. Nur für offizielle Marketplace-Plugins ausgegeben. Andernfalls nicht vorhanden.
• mcp_server.name: MCP-Server, dessen Tool in der Runde ausgeführt wurde, die diese Anfrage erzeugt hat. Integrierte, claude.ai-proxied und offizielle Registry-Server-Namen werden wörtlich angezeigt. Benutzerkonfigurierte Server-Namen werden durch "custom" ersetzt. Nicht vorhanden, wenn kein MCP-Tool ausgeführt wurde.
• mcp_tool.name: MCP-Tool, das in der Runde ausgeführt wurde, die diese Anfrage erzeugt hat, mit der gleichen Schwärzung wie mcp_server.name. Nicht vorhanden, wenn kein MCP-Tool ausgeführt wurde.

​

Token-Zähler

• Alle Standardattribute
• type: ("input", "output", "cacheRead", "cacheCreation")
• model: Modellkennung (z. B. “claude-sonnet-5”)
• query_source: Kategorie des Subsystems, das die Anfrage gestellt hat. Einer von "main", "subagent" oder "auxiliary"
• speed: "fast", wenn die Anfrage den schnellen Modus verwendet hat. Andernfalls nicht vorhanden
• effort: Anstrengungsstufe, die auf die Anfrage angewendet wird. Siehe Kostenzähler für Details.
• agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name: Skill-, Plugin-, Agent- und MCP-Zuordnung für die Anfrage. Siehe Kostenzähler für Definitionen und Schwärzungsverhalten.

​

Code-Edit-Tool-Entscheidungszähler

• Alle Standardattribute
• tool_name: Tool-Name ("Edit", "Write", "NotebookEdit")
• decision: Benutzerentscheidung ("accept", "reject")
• source: Entscheidungsquelle. Einer von "config", "hook", "user_permanent", "user_temporary", "user_abort" oder "user_reject". Siehe das Tool-Entscheidungs-Ereignis für die Bedeutung jedes Wertes.
• language: Programmiersprache der bearbeiteten Datei, z. B. "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. Setzen Sie OTEL_LOG_USER_PROMPTS=1, um ihn einzubeziehen
• command_name: Befehlsname, wenn der Prompt einen aufruft. Integrierte und gebündelte Befehlsnamen wie compact oder debug werden wie geschrieben ausgegeben; Aliase wie reset werden wie eingegeben ausgegeben, nicht der kanonische Name. Benutzerdefinierte, Plugin- und MCP-Befehlsnamen werden zu custom oder mcp zusammengefasst, es sei denn, OTEL_LOG_TOOL_DETAILS=1 ist gesetzt
• command_source: Ursprung des Befehls, wenn vorhanden: builtin, custom oder mcp. Von Plugins bereitgestellte Befehle werden als custom gemeldet

​

Assistent-Antwort-Ereignis

• Alle Standardattribute
• event.name: "assistant_response"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• response_length: Länge des Antworttexts in Zeichen
• response: Antworttext, gekürzt bei 60 KB. Standardmäßig auf <REDACTED> geschwärzt. Setzen Sie OTEL_LOG_ASSISTANT_RESPONSES=1, um ihn einzubeziehen. Wenn OTEL_LOG_ASSISTANT_RESPONSES nicht gesetzt ist, steuert OTEL_LOG_USER_PROMPTS es stattdessen, also setzen Sie OTEL_LOG_ASSISTANT_RESPONSES=0, um Antworten geschwärzt zu halten, während Prompt-Protokollierung aktiv ist
• model: Modellkennung (z. B. “claude-sonnet-5”)
• request_id: Anthropic API-Anfrage-ID aus dem Response-Header request-id. Nur vorhanden, wenn die API eine zurückgibt
• query_source: Subsystem, das die Anfrage gestellt hat, z. B. "repl_main_thread", "compact" oder ein Subagent-Name

​

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
• tool_use_id: Eindeutige Kennung für diese Tool-Invokation. Entspricht der tool_use_id, die an Hooks übergeben wird, und ermöglicht die Korrelation zwischen OTel-Ereignissen und Hook-erfassten Daten.
• success: "true" oder "false"
• duration_ms: Ausführungszeit in Millisekunden
• error_type: Fehler-Kategoriezeichenkette, wenn das Tool fehlgeschlagen ist, z. B. "Error:ENOENT" oder "ShellError"
• error (wenn OTEL_LOG_TOOL_DETAILS=1): Vollständige Fehlermeldung, wenn das Tool fehlgeschlagen ist
• decision_type: Immer "accept", da dieses Ereignis nur ausgegeben wird, nachdem das Tool ausgeführt wurde. Abgelehnte Aufrufe erzeugen kein Tool-Ergebnis
• decision_source: Entscheidungsquelle. Einer von "config", "hook", "user_permanent" oder "user_temporary". Siehe das Tool-Entscheidungs-Ereignis für die Bedeutung jedes Wertes. Die nur-Ablehnung-Quellen "user_abort" und "user_reject" erscheinen niemals auf diesem Ereignis.
• tool_input_size_bytes: Größe der JSON-serialisierten Tool-Eingabe in Bytes
• tool_result_size_bytes: Größe des Tool-Ergebnisses in Bytes
• mcp_server_scope: MCP-Server-Scope-Kennung (für MCP-Tools)
• tool_parameters (wenn OTEL_LOG_TOOL_DETAILS=1): JSON-Zeichenkette mit Tool-spezifischen Parametern:
  • 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 WorkspaceBash-Tool: enthält bash_command, full_command, timeout
  • Für MCP-Tools: enthält mcp_server_name, mcp_tool_name
  • Für Skill-Tool: enthält skill_name
  • Für Agent-Tool oder Legacy-Task-Tool: enthält subagent_type
• 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 (z. B. “claude-sonnet-5”)
• 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
• request_id: Anthropic API-Anfrage-ID aus dem Response-Header request-id, z. B. "req_011...". Nur vorhanden, wenn die API eine zurückgibt.
• speed: "fast" oder "normal", was angibt, ob der schnelle Modus aktiv war
• query_source: Subsystem, das die Anfrage gestellt hat, z. B. "repl_main_thread", "compact" oder ein Subagent-Name
• effort: Anstrengungsstufe, die auf die Anfrage angewendet wird: "low", "medium", "high", "xhigh" oder "max". Nicht vorhanden, wenn das Modell Anstrengung nicht unterstützt.
• agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name: Skill-, Plugin-, Agent- und MCP-Zuordnung für die Anfrage. Siehe Kostenzähler für Definitionen und Schwärzungsverhalten.

​

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 (z. B. “claude-sonnet-5”)
• error: Fehlermeldung
• status_code: HTTP-Statuscode als Zahl. Nicht vorhanden für Nicht-HTTP-Fehler wie Verbindungsfehler.
• duration_ms: Anfragedauer in Millisekunden
• attempt: Gesamtzahl der Versuche, einschließlich der ursprünglichen Anfrage (1 bedeutet, dass keine Wiederholungen aufgetreten sind)
• request_id: Anthropic API-Anfrage-ID aus dem Response-Header request-id, z. B. "req_011...". Nur vorhanden, wenn die API eine zurückgibt.
• speed: "fast" oder "normal", was angibt, ob der schnelle Modus aktiv war
• query_source: Subsystem, das die Anfrage gestellt hat, z. B. "repl_main_thread", "compact" oder ein Subagent-Name
• effort: Anstrengungsstufe, die auf die Anfrage angewendet wird. Nicht vorhanden, wenn das Modell Anstrengung nicht unterstützt.
• agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name: Skill-, Plugin-, Agent- und MCP-Zuordnung für die Anfrage. Siehe Kostenzähler für Definitionen und Schwärzungsverhalten.

​

API-Verweigerung-Ereignis

• Alle Standardattribute
• event.name: "api_refusal"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• model: Modellkennung aus der Anfrage
• request_id: Anthropic API-Anfrage-ID aus dem Response-Header request-id, z. B. "req_011...". Nur vorhanden, wenn die API eine zurückgibt.
• query_source: Subsystem, das die Anfrage gestellt hat, z. B. "repl_main_thread", "compact" oder ein Subagent-Name. Siehe api_request für Definitionen.
• speed: Entweder "fast", wenn Schneller Modus aktiv ist, oder "normal"
• attempt: Wiederholungsversuch-Nummer. Der erste Versuch ist 1.
• effort: Anstrengungsstufe, die auf die Anfrage angewendet wird. Nicht vorhanden, wenn das Modell Anstrengung nicht unterstützt.
• server_fallback_hop: true, wenn das Server-seitige Modell-Fallback der API diesen Verweigerung bereits auf einem anderen Modell erneut versucht hat, sodass der Benutzer diese bestimmte Verweigerung nicht sah. false, wenn die Anfrage in einer Verweigerung endete. Eine einzelne Runde kann sowohl ein true Hop-Ereignis als auch ein späteres false Finales Ereignis ausgeben, wenn das Fallback-Modell auch verweigert.
• has_category: true, wenn die API-Antwort eine stop_details.category von "cyber", "bio", "frontier_llm" oder "reasoning_extraction" trug. false, wenn die Antwort keine Kategorie oder einen Wert außerhalb dieses Satzes trug. Nicht vorhanden, wenn server_fallback_hop true ist, da Hop-Blöcke keine stop_details tragen.
• has_explanation: true, wenn die API-Antwort eine stop_details.explanation trug, andernfalls false. Nicht vorhanden, wenn server_fallback_hop true ist.
• category: Der stop_details.category-Wert aus der API-Antwort. Einer von "cyber", "bio", "frontier_llm" oder "reasoning_extraction". Nur vorhanden, wenn OTEL_LOG_TOOL_DETAILS=1 gesetzt ist und has_category true ist.
• agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name: Skill-, Plugin-, Agent- und MCP-Zuordnung für die Anfrage. Siehe Kostenzähler für Definitionen und Schwärzungsverhalten.

​

API-Anfrage-Text-Ereignis

• Alle Standardattribute
• event.name: "api_request_body"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• body: JSON-serialisierte Messages API-Anfrageparameter (Systemprompt, Nachrichten, Tools usw.), gekürzt bei 60 KB. Extended-Thinking-Inhalte in vorherigen Assistent-Durchgängen werden geschwärzt. Nur im Inline-Modus ausgegeben (OTEL_LOG_RAW_API_BODIES=1).
• body_ref: Absoluter Pfad zu einer <dir>/<uuid>.request.json Datei, die den ungekürzte Text enthält. Nur im Datei-Modus ausgegeben (OTEL_LOG_RAW_API_BODIES=file:<dir>).
• body_length: Ungekürzte Text-Länge. UTF-8-Bytes, wenn OTEL_LOG_RAW_API_BODIES=file:<dir>, oder UTF-16-Code-Einheiten, wenn =1
• body_truncated: "true", wenn Inline-Kürzung aufgetreten ist. Nicht vorhanden im Datei-Modus und wenn keine Kürzung aufgetreten ist.
• model: Modellkennung aus den Anfrageparametern
• query_source: Subsystem, das die Anfrage gestellt hat (z. B. "compact")

​

API-Antwort-Text-Ereignis

• Alle Standardattribute
• event.name: "api_response_body"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• body: JSON-serialisierte Messages API-Antwort (id, Inhaltsblöcke, Nutzung, Stoppgrund), gekürzt bei 60 KB. Extended-Thinking-Inhalte werden geschwärzt. Nur im Inline-Modus ausgegeben (OTEL_LOG_RAW_API_BODIES=1).
• body_ref: Absoluter Pfad zu einer <dir>/<request_id>.response.json Datei, die den ungekürzte Text enthält. Nur im Datei-Modus ausgegeben (OTEL_LOG_RAW_API_BODIES=file:<dir>).
• body_length: Ungekürzte Text-Länge. UTF-8-Bytes, wenn OTEL_LOG_RAW_API_BODIES=file:<dir>, oder UTF-16-Code-Einheiten, wenn =1
• body_truncated: "true", wenn Inline-Kürzung aufgetreten ist. Nicht vorhanden im Datei-Modus und wenn keine Kürzung aufgetreten ist.
• model: Modellkennung
• query_source: Subsystem, das die Anfrage gestellt hat
• request_id: Anthropic API-Anfrage-ID aus dem Response-Header request-id, z. B. "req_011...". Nur vorhanden, wenn die API eine zurückgibt.

​

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 (z. B. “Read”, “Edit”, “Write”, “NotebookEdit”)
• tool_use_id: Eindeutige Kennung für diese Tool-Invokation. Entspricht der tool_use_id, die an Hooks übergeben wird, und ermöglicht die Korrelation zwischen OTel-Ereignissen und Hook-erfassten Daten.
• decision: Entweder "accept" oder "reject"
• source: Entscheidungsquelle:
  • "config": Automatisch entschieden, ohne Aufforderung, basierend auf Projekteinstellungen, Zulassungsregeln in den persönlichen Einstellungen des Benutzers, verwalteter Unternehmensrichtlinie, --allowedTools oder --disallowedTools Flags, dem aktiven Berechtigungsmodus, einer sitzungsbegrenzten Zulassung aus einem früheren Prompt in der gleichen interaktiven CLI-Sitzung oder weil das Tool inhärent sicher ist. Das Ereignis gibt nicht an, welche dieser Quellen übereinstimmte.
  • "hook": Ein PreToolUse oder PermissionRequest Hook hat die Entscheidung zurückgegeben.
  • "user_permanent": Wird ausgegeben, wenn der Benutzer “Ja, und nicht mehr fragen für …” bei einer Berechtigungsaufforderung wählte, was eine Zulassungsregel in seinen persönlichen Einstellungen speichert. In der interaktiven CLI wird dies nur für diese Wahl selbst ausgegeben; spätere Aufrufe, die der gespeicherten Regel entsprechen, geben stattdessen "config" aus. In Agent SDK oder nicht-interaktiven -p Sitzungen geben sowohl die ursprüngliche Wahl als auch spätere Regelübereinstimmungen "user_permanent" aus. Wird als Akzeptanz behandelt.
  • "user_temporary": Wird ausgegeben, wenn der Benutzer “Ja” bei einer Berechtigungsaufforderung wählte, oder eine der Optionen ”… während dieser Sitzung” bei einer Dateibearbeitungs- oder Leseanforderung wählte. In der interaktiven CLI wird dies nur für die Wahl selbst ausgegeben; spätere Aufrufe, die durch diese sitzungsbegrenzte Zulassung zulässig sind, geben stattdessen "config" aus. In Agent SDK oder nicht-interaktiven -p Sitzungen geben sowohl die Wahl als auch spätere Übereinstimmungen "user_temporary" aus. Wird als Akzeptanz behandelt.
  • "user_abort": Wird ausgegeben, wenn der Benutzer die Berechtigungsaufforderung geschlossen hat, ohne zu antworten. Wird als Ablehnung behandelt.
  • "user_reject": Wird ausgegeben, wenn der Benutzer “Nein” wählte, wenn aufgefordert. In der interaktiven CLI wird dies nur für diese Wahl selbst ausgegeben; Aufrufe, die einer Ablehnungsregel in den persönlichen Einstellungen des Benutzers entsprechen, geben stattdessen "config" aus. In Agent SDK oder nicht-interaktiven -p Sitzungen geben Aufrufe, die einer Ablehnungsregel in persönlichen Einstellungen entsprechen, "user_reject" aus. Wird als Ablehnung behandelt.
• tool_parameters (wenn OTEL_LOG_TOOL_DETAILS=1): JSON-Zeichenkette mit Tool-spezifischen Parametern. Gleiche Form wie das Tool-Ergebnis-Ereignis, minus Post-Ausführungs-Felder wie git_commit_id. Werte können sich von tool_result für einen akzeptierten Aufruf unterscheiden, wenn die Berechtigungsentscheidung die Tool-Eingabe über updatedInput umschreibt. Verwenden Sie dieses Attribut, um zu sehen, welcher Befehl abgelehnt wurde, wenn decision "reject" ist.
  • Für Bash-Tool: enthält bash_command, full_command, timeout, description, dangerouslyDisableSandbox
  • Für WorkspaceBash-Tool: enthält bash_command, full_command, timeout
  • Für MCP-Tools: enthält mcp_server_name, mcp_tool_name
  • Für Skill-Tool: enthält skill_name
  • Für Agent-Tool oder Legacy-Task-Tool: enthält subagent_type

​

Berechtigungsmodus-Änderungs-Ereignis

• Alle Standardattribute
• event.name: "permission_mode_changed"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• from_mode: Der vorherige Berechtigungsmodus, z. B. "default", "plan", "acceptEdits", "auto" oder "bypassPermissions"
• to_mode: Der neue Berechtigungsmodus
• trigger: Was die Änderung verursacht hat. Einer von "shift_tab", "exit_plan_mode", "auto_gate_denied" oder "auto_opt_in". Nicht vorhanden, wenn der Übergang vom SDK oder Bridge stammt

​

Auth-Ereignis

• Alle Standardattribute
• event.name: "auth"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• action: "login" oder "logout"
• success: "true" oder "false"
• auth_method: Authentifizierungsmethode, z. B. "oauth"
• error_category: Kategorische Fehlerart, wenn die Aktion fehlgeschlagen ist. Die rohe Fehlermeldung ist nie enthalten
• status_code: HTTP-Statuscode als Zeichenkette, wenn die Aktion mit einem HTTP-Fehler fehlgeschlagen ist

​

MCP-Server-Verbindungs-Ereignis

• Alle Standardattribute
• event.name: "mcp_server_connection"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• status: "connected", "failed" oder "disconnected"
• transport_type: Server-Transport, z. B. "stdio", "sse" oder "http"
• server_scope: Bereich, in dem der Server konfiguriert ist, z. B. "user", "project" oder "local"
• duration_ms: Verbindungsversuch-Dauer in Millisekunden
• error_code: Fehlercode, wenn die Verbindung fehlgeschlagen ist
• is_plugin: true, wenn der Server von einem Plugin bereitgestellt wird, false andernfalls
• plugin_id_hash (wenn is_plugin true ist): Stabiler Hash des Plugin-Namens und des Marketplace, zum Gruppieren von Ereignissen nach Plugin, ohne den Namen offenzulegen
• plugin.name (wenn is_plugin true ist): Name des Plugins, das den Server bereitstellt. Für Drittanbieter-Plugins ist dies die Zeichenkette "third-party", es sei denn, OTEL_LOG_TOOL_DETAILS=1; dies schützt Drittanbieter-Plugin-Namen davor, standardmäßig in Protokollen zu erscheinen. Plugins aus offiziellen Anthropic-Quellen werden immer anhand des Namens identifiziert. Die Attribute plugin_id_hash und plugin.name fließen zu Ihrem eigenen Monitoring-Backend und werden nicht an Anthropic gesendet
• server_name (wenn OTEL_LOG_TOOL_DETAILS=1): Konfigurierter Server-Name
• error (wenn OTEL_LOG_TOOL_DETAILS=1): Vollständige Fehlermeldung, wenn die Verbindung fehlgeschlagen ist

​

Interner Fehler-Ereignis

• Alle Standardattribute
• event.name: "internal_error"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• error_name: Fehlerklassenname, z. B. "TypeError" oder "SyntaxError"
• error_code: Node.js errno-Code wie "ENOENT", wenn auf dem Fehler vorhanden

​

Plugin-Installiert-Ereignis

• Alle Standardattribute
• event.name: "plugin_installed"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• marketplace.is_official: "true", wenn der Marketplace ein offizieller Anthropic-Marketplace ist, "false" andernfalls
• install.trigger: "cli" oder "ui"
• plugin.name: Name des installierten Plugins. Für Drittanbieter-Marketplaces ist dies nur enthalten, wenn OTEL_LOG_TOOL_DETAILS=1
• plugin.version: Plugin-Version, wenn in der Marketplace-Eintrag deklariert. Für Drittanbieter-Marketplaces ist dies nur enthalten, wenn OTEL_LOG_TOOL_DETAILS=1
• marketplace.name: Marketplace, von dem das Plugin installiert wurde. Für Drittanbieter-Marketplaces ist dies nur enthalten, wenn OTEL_LOG_TOOL_DETAILS=1

​

Plugin-Geladen-Ereignis

• Alle Standardattribute
• event.name: "plugin_loaded"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• plugin.name: Name des Plugins. Für Plugins außerhalb des offiziellen Marketplace und des integrierten Bundles ist der Wert "third-party", es sei denn, OTEL_LOG_TOOL_DETAILS=1
• marketplace.name: Marketplace, von dem das Plugin installiert wurde, wenn bekannt. Auf "third-party" unter der gleichen Bedingung wie plugin.name geschwärzt
• plugin.version: Version aus dem Plugin-Manifest. Nur enthalten, wenn der Name nicht geschwärzt ist und das Manifest eine Version deklariert
• plugin.scope: Herkunftskategorie für das Plugin: "official", "org", "user-local" oder "default-bundle"
• enabled_via: Wie das Plugin aktiviert wurde: "default-enable", "org-policy", "seed-mount" oder "user-install"
• plugin_id_hash: Deterministische Hash des Plugin-Namens und des Marketplace, nur an Ihren konfigurierten Exporter gesendet. Ermöglicht es Ihnen, zu zählen, wie viele unterschiedliche Drittanbieter-Plugins über Ihre gesamte Flotte hinweg geladen sind, ohne ihre Namen aufzuzeichnen
• has_hooks: Ob das Plugin Hooks beiträgt
• has_mcp: Ob das Plugin MCP-Server beiträgt
• host_owned_mcp: true, wenn der SDK-Host die MCP-Verbindungen dieses Plugins verwaltet und Claude Code das Lesen der MCP-Server-Konfiguration des Plugins übersprungen hat, false andernfalls. Erfordert Claude Code v2.1.172 oder später
• skill_path_count: Anzahl der Skill-Verzeichnisse, die das Plugin deklariert
• command_path_count: Anzahl der Befehlsverzeichnisse, die das Plugin deklariert
• agent_path_count: Anzahl der Agent-Verzeichnisse, die das Plugin deklariert
• safe_mode: "true", wenn die Sitzung mit --safe-mode gestartet wurde, "false" andernfalls. Im sicheren Modus meldet dieses Ereignis nur die konfigurierte Inventur; die Befehle, Skills, Hooks und MCP-Server des Plugins werden nicht geladen. Erfordert Claude Code v2.1.169 oder später

​

Skill-Aktiviert-Ereignis

• Alle Standardattribute
• event.name: "skill_activated"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• skill.name: Name des Skills. Für benutzerdefinierte und Drittanbieter-Plugin-Skills ist der Wert der Platzhalter "custom_skill", es sei denn, OTEL_LOG_TOOL_DETAILS=1
• invocation_trigger: Wie der Skill ausgelöst wurde ("user-slash", "claude-proactive" oder "nested-skill")
• skill.source: Wo der Skill geladen wurde (z. B. "bundled", "userSettings", "projectSettings", "plugin")
• skill.kind: "workflow", wenn der Skill ein Workflow-Skill ist. Andernfalls nicht vorhanden
• plugin.name (wenn OTEL_LOG_TOOL_DETAILS=1 oder das Plugin ist von einem offiziellen Marketplace): Name des besitzenden Plugins, wenn der Skill von einem Plugin bereitgestellt wird
• marketplace.name (wenn OTEL_LOG_TOOL_DETAILS=1 oder das Plugin ist von einem offiziellen Marketplace): Marketplace des besitzenden Plugins, wenn der Skill von einem Plugin bereitgestellt wird

​

At-Mention-Ereignis

• Alle Standardattribute
• event.name: "at_mention"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• mention_type: Typ des Mentions ("file", "directory", "agent", "mcp_resource")
• success: Ob das Mention erfolgreich aufgelöst wurde ("true" oder "false")

​

API-Wiederholungen-Erschöpft-Ereignis

• Alle Standardattribute
• event.name: "api_retries_exhausted"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• model: Verwendetes Modell
• error: Letzte Fehlermeldung
• status_code: HTTP-Statuscode als Zahl. Nicht vorhanden für Nicht-HTTP-Fehler.
• total_attempts: Gesamtzahl der Versuche
• total_retry_duration_ms: Gesamte Wanduhr-Zeit über alle Versuche
• speed: "fast" oder "normal"

​

Hook-Registriert-Ereignis

• Alle Standardattribute
• event.name: "hook_registered"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• hook_event: Hook-Ereignistyp, z. B. "PreToolUse" oder "PostToolUse"
• hook_type: Hook-Implementierungstyp: "command", "prompt", "mcp_tool", "http" oder "agent"
• hook_source: Wo der Hook definiert ist: "userSettings", "projectSettings", "localSettings", "flagSettings", "policySettings" oder "pluginHook"
• safe_mode: "true", wenn die Sitzung mit --safe-mode gestartet wurde, "false" andernfalls. Erfordert Claude Code v2.1.169 oder später
• hook_matcher (wenn OTEL_LOG_TOOL_DETAILS=1): Die Matcher-Zeichenkette aus der Hook-Konfiguration, wenn eine gesetzt ist
• plugin.name (wenn hook_source "pluginHook" ist): Name des beitragenden Plugins. Für Plugins außerhalb des offiziellen Marketplace und des integrierten Bundles ist der Wert "third-party", es sei denn, OTEL_LOG_TOOL_DETAILS=1
• plugin_id_hash (wenn hook_source "pluginHook" ist): Deterministische Hash des Plugin-Namens und des Marketplace, nur an Ihren konfigurierten Exporter gesendet. Ermöglicht es Ihnen, unterschiedliche beitragende Plugins zu zählen, ohne ihre Namen aufzuzeichnen

​

Hook-Ausführungs-Start-Ereignis

• Alle Standardattribute
• event.name: "hook_execution_start"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• hook_event: Hook-Ereignistyp, z. B. "PreToolUse" oder "PostToolUse"
• hook_name: Vollständiger Hook-Name einschließlich Matcher, z. B. "PreToolUse:Write"
• num_hooks: Anzahl der übereinstimmenden Hook-Befehle
• managed_only: "true", wenn nur verwaltete Richtlinien-Hooks zulässig sind
• hook_source: "policySettings" oder "merged"
• safe_mode: "true", wenn die Sitzung mit --safe-mode gestartet wurde, "false" andernfalls. Erfordert Claude Code v2.1.169 oder später
• hook_definitions: JSON-serialisierte Hook-Konfiguration. Nur enthalten, wenn sowohl detailliertes Beta-Tracing als auch OTEL_LOG_TOOL_DETAILS=1 aktiviert sind

​

Hook-Ausführungs-Abschluss-Ereignis

• Alle Standardattribute
• event.name: "hook_execution_complete"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• hook_event: Hook-Ereignistyp
• hook_name: Vollständiger Hook-Name einschließlich Matcher
• num_hooks: Anzahl der übereinstimmenden Hook-Befehle
• num_success: Anzahl, die erfolgreich abgeschlossen wurde
• num_blocking: Anzahl, die eine Blockierungsentscheidung zurückgegeben hat
• num_non_blocking_error: Anzahl, die ohne Blockierung fehlgeschlagen ist
• num_cancelled: Anzahl, die vor Abschluss abgebrochen wurde
• total_duration_ms: Wanduhr-Dauer aller übereinstimmenden Hooks
• managed_only: "true", wenn nur verwaltete Richtlinien-Hooks zulässig sind
• hook_source: "policySettings" oder "merged"
• safe_mode: "true", wenn die Sitzung mit --safe-mode gestartet wurde, "false" andernfalls. Erfordert Claude Code v2.1.169 oder später
• hook_definitions: JSON-serialisierte Hook-Konfiguration. Nur enthalten, wenn sowohl detailliertes Beta-Tracing als auch OTEL_LOG_TOOL_DETAILS=1 aktiviert sind

​

Hook-Plugin-Metriken-Ereignis

• Alle Standardattribute
• event.name: "hook_plugin_metrics"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• plugin_id: Plugin-Kennung in <name>@<marketplace> Form
• hook_event: Hook-Ereignistyp, der die Metriken ausgegeben hat
• Bis zu 20 Plugin-ausgegebene Metrik-Schlüssel. Namen entsprechen ^[a-z][a-z0-9_]{0,39}$. Werte sind boolescher Wert oder Zahl.

​

Kompaktierungs-Ereignis

• Alle Standardattribute
• event.name: "compaction"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• trigger: "auto" oder "manual"
• success: "true" oder "false"
• duration_ms: Kompaktierungs-Dauer
• pre_tokens: Ungefähre Token-Anzahl vor Kompaktierung
• post_tokens: Ungefähre Token-Anzahl nach Kompaktierung
• error: Fehlermeldung, wenn Kompaktierung fehlgeschlagen ist
• precompute_reuse: Nur gesetzt, wenn trigger "manual" ist. Auto-Kompaktierung kann eine Zusammenfassung im Hintergrund vorbereiten, bevor das Kontextfenster voll wird, und dieses Attribut zeichnet auf, ob /compact diese vorbereitete Zusammenfassung wiederverwendet hat. "hit" bedeutet, dass sie wiederverwendet wurde; "miss_custom_instructions", "miss_hook" und "miss_not_ready" geben den Grund an, warum stattdessen eine neue Zusammenfassung berechnet wurde. Erfordert Claude Code v2.1.153 oder später

​

Feedback-Umfrage-Ereignis

• Alle Standardattribute
• event.name: "feedback_survey"
• event.timestamp: ISO 8601-Zeitstempel
• event.sequence: monoton steigende Zähler zur Sortierung von Ereignissen innerhalb einer Sitzung
• event_type: Umfrage-Lebenszyklusereignis, z. B. "appeared", "responded" oder "transcript_prompt_appeared"
• appearance_id: Eindeutige ID, die die Ereignisse verknüpft, die für eine Umfrage-Instanz ausgegeben werden
• survey_type: Welche Umfrage das Ereignis erzeugt hat. "session" ist die Aufforderung “Wie macht sich Claude?” Bewertung
• response: Die Auswahl des Benutzers bei responded Ereignissen
• enabled_via_override: true, wenn CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL gesetzt ist. Wird als boolescher Wert ausgegeben, nicht als Zeichenkette. Vorhanden bei session Umfrage-Ereignissen. Filtern Sie nach diesem Attribut, um zu bestätigen, dass die Überschreibung über eine Flotte angewendet wird

​

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
• Zuordnung von Ausgaben zu spezifischen Skills, Plugins oder Subagent-Typen über die Attribute skill.name, plugin.name und agent.name

​

Warnungen und Segmentierung

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

​

Wiederholungserschöpfung erkennen

​

Ereignisanalyse

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

​

Audit-Sicherheitsereignisse

​

Attribut-Aktionen an Benutzer

export OTEL_RESOURCE_ATTRIBUTES="enduser.id=jdoe@example.com,enduser.directory_id=S-1-5-21-..."

​

Audit MCP-Aktivität

• tool_result: behält tool_name und mcp_server_scope, lässt mcp_server_name, mcp_tool_name und Argumente weg
• tool_decision: behält tool_name, lässt tool_parameters weg
• mcp_server_connection: lässt server_name und die Fehlermeldung weg, behält aber is_plugin, plugin_id_hash und plugin.name, wobei Namen von Nicht-Anthropic-Plugins auf das Literal "third-party" redigiert werden, sodass von Plugins bereitgestellte Server ohne detaillierte Protokollierung unterscheidbar bleiben

​

Sicherheitsfragen zu Ereignissen zuordnen

​

Ereignisse an ein SIEM senden

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_LOGS_EXPORTER": "otlp",
    "OTEL_LOG_TOOL_DETAILS": "1",
    "OTEL_EXPORTER_OTLP_LOGS_PROTOCOL": "http/protobuf",
    "OTEL_EXPORTER_OTLP_LOGS_ENDPOINT": "https://siem.example.com:4318/v1/logs",
    "OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Bearer your-siem-token"
  }
}

​

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, Grafana Cloud): 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, Grafana Cloud): Korrelation zwischen Metriken und Ereignissen

​

Für Traces

• Verteilte Tracing-Systeme (zum Beispiel Jaeger, Zipkin, Grafana Tempo): Span-Visualisierung, Request-Waterfalls, Latenzanalyse
• Vollständige Observability-Plattformen (zum Beispiel Honeycomb, Datadog, Grafana Cloud): Trace-Suche und Korrelation mit Metriken und Logs

​

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

• OpenTelemetry-Export zu Ihrem Backend ist opt-in und erfordert explizite Konfiguration. Informationen zu Anthropics separater operativer Telemetrie und wie Sie diese deaktivieren, finden Sie unter Datennutzung
• Rohe Dateiinhalte und Code-Snippets sind nicht in Metriken oder Ereignissen enthalten. Trace-Spans sind ein separater Datenpfad: siehe die Aufzählung OTEL_LOG_TOOL_CONTENT unten
• 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
• Assistent-Antworttext wird standardmäßig nicht erfasst. Nur die Antwortlänge wird aufgezeichnet. Um Antworttext einzubeziehen, setzen Sie OTEL_LOG_ASSISTANT_RESPONSES=1. Wie alle OpenTelemetry-Daten von Claude Code wird der Antworttext nur an den OTel-Endpunkt gesendet, den Sie konfigurieren, niemals an Anthropic. Wenn diese Variable nicht gesetzt ist, wird OTEL_LOG_USER_PROMPTS als Fallback verwendet, daher setzen Sie OTEL_LOG_ASSISTANT_RESPONSES=0, wenn Sie Prompt-Inhalte ohne Antwortinhalte möchten
• Tool-Eingabeargumente und Parameter werden standardmäßig nicht protokolliert. Um sie einzubeziehen, setzen Sie OTEL_LOG_TOOL_DETAILS=1. Diese Daten werden nur an den OTEL-Endpunkt gesendet, den Sie konfigurieren, niemals an Anthropic. Argumente können immer noch vertrauliche Werte enthalten, daher konfigurieren Sie Ihr Telemetrie-Backend, um diese Attribute nach Bedarf zu filtern oder zu schwärzen. Wenn aktiviert:
  • tool_result- und tool_decision-Ereignisse enthalten ein tool_parameters-Attribut mit Bash-Befehlen, MCP-Server- und Tool-Namen sowie Skill-Namen. Felder wie full_command werden ungekürzt ausgegeben
  • tool_result-Ereignisse enthalten zusätzlich 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
  • user_prompt-Ereignisse enthalten den wörtlichen command_name für benutzerdefinierte, Plugin- und MCP-Befehle
  • Trace-Spans enthalten das gleiche tool_input-Attribut und eingabebezogene Attribute wie file_path, mit der gleichen Kürzung wie tool_input
• Tool-Eingabe- und Ausgabeinhalte werden in Trace-Spans standardmäßig nicht protokolliert. Um sie einzubeziehen, setzen Sie OTEL_LOG_TOOL_CONTENT=1. Wenn aktiviert, enthalten Span-Ereignisse vollständige Tool-Eingabe- und Ausgabeinhalte, gekürzt bei 60 KB pro Span. Dies kann rohe Dateiinhalte aus Read-Tool-Ergebnissen und Bash-Befehlsausgabe enthalten. Konfigurieren Sie Ihr Telemetrie-Backend, um diese Attribute nach Bedarf zu filtern oder zu schwärzen
• Rohe Anthropic Messages API-Anfrage- und Antwort-Texte werden standardmäßig nicht protokolliert. Um sie einzubeziehen, setzen Sie OTEL_LOG_RAW_API_BODIES. Mit =1 gibt jeder API-Aufruf api_request_body- und api_response_body-Log-Ereignisse aus, deren body-Attribut die JSON-serialisierte Nutzlast ist, gekürzt bei 60 KB. Mit =file:<dir> werden ungekürzte Texte unter diesem Verzeichnis in .request.json- und .response.json-Dateien geschrieben und die Ereignisse tragen einen body_ref-Pfad statt des Inline-Textes. Versenden Sie das Verzeichnis mit einem Log-Collector oder Sidecar statt über den Telemetrie-Stream. In beiden Modi enthalten Texte die gesamte Konversationshistorie (Systemprompt, jeder vorherige Benutzer- und Assistent-Durchgang, Tool-Ergebnisse), daher impliziert das Aktivieren dies Zustimmung zu allem, was die anderen OTEL_LOG_*-Content-Flags offenbaren würden. Claudes Extended-Thinking-Inhalte werden unabhängig von anderen Einstellungen immer aus diesen Texten geschwärzt

​

Überwachung von Claude Code auf Amazon Bedrock