Surveillance

​

Démarrage rapide

# 1. Activer la télémétrie
export CLAUDE_CODE_ENABLE_TELEMETRY=1

# 2. Choisir les exportateurs (les deux sont facultatifs - configurez uniquement ce dont vous avez besoin)
export OTEL_METRICS_EXPORTER=otlp       # Options : otlp, prometheus, console, none
export OTEL_LOGS_EXPORTER=otlp          # Options : otlp, console, none

# 3. Configurer le point de terminaison OTLP (pour l'exportateur OTLP)
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

# 4. Définir l'authentification (si nécessaire)
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer your-token"

# 5. Pour le débogage : réduire les intervalles d'export, et les réinitialiser pour une utilisation en production
export OTEL_METRIC_EXPORT_INTERVAL=10000  # 10 secondes (par défaut : 60000ms)
export OTEL_LOGS_EXPORT_INTERVAL=5000     # 5 secondes (par défaut : 5000ms)

# 6. Exécuter Claude Code
claude

​

Configuration de l’administrateur

{
  "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"
  }
}

​

Comment les paramètres gérés verrouillent la destination OTLP

• Points de terminaison : lorsque vous définissez OTEL_EXPORTER_OTLP_ENDPOINT, Claude Code supprime tous les points de terminaison par signal définis par les développeurs. Les développeurs ne peuvent pas pointer un signal vers un collecteur différent, donc vous n’avez pas besoin de définir également les variables de point de terminaison par signal dans les paramètres gérés.
• Protocoles : lorsque vous définissez OTEL_EXPORTER_OTLP_PROTOCOL, Claude Code supprime tous les protocoles par signal définis par les développeurs.
• Identifiants : lorsque vous définissez OTEL_EXPORTER_OTLP_HEADERS, OTEL_EXPORTER_OTLP_CLIENT_KEY ou OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE, Claude Code supprime les versions par signal de cette variable définies par les développeurs, plus toutes les variables de point de terminaison définies par les développeurs, génériques ou par signal, car ces identifiants atteindraient autrement un collecteur que les paramètres gérés n’ont pas choisi.
• Sélecteurs d’exportateur : OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER et le OTEL_TRACES_EXPORTER bêta suivent la précédence normale par clé. Un paramètre de développeur peut toujours désactiver un signal ou le basculer vers l’exportateur de console, donc définissez également les sélecteurs dans les paramètres gérés si vous avez besoin qu’ils soient verrouillés. Parmi les sources d’administrateur, OTEL_LOGS_EXPORTER suit l’unité de télémétrie tandis que les deux autres sélecteurs fusionnent par clé. Nécessite Claude Code v2.1.223 ou version ultérieure.
• Points de terminaison de traçage bêta : avec le traçage bêta détaillé actif, Claude Code exporte les journaux et les traces vers BETA_TRACING_ENDPOINT au lieu de passer par les exportateurs de journaux et de traces. Claude Code supprime donc un BETA_TRACING_ENDPOINT défini par le développeur chaque fois que l’un de ces paramètres gérés décide de la destination de l’un ou l’autre signal :
  • Un point de terminaison ou un identifiant générique ou de journaux/traces
  • Un otelHeadersHelper
  • Un sélecteur d’exportateur de journaux ou de traces défini sur none, console ou vide, des valeurs qui maintiennent le signal hors d’un collecteur
  • CLAUDE_CODE_ENABLE_TELEMETRY désactivé
  Un point de terminaison ou un identifiant réservé aux métriques ne le supprime pas. Avant v2.1.251, un BETA_TRACING_ENDPOINT défini par le développeur redirigait les journaux et les traces que le traçage bêta détaillé exporte même lorsque les paramètres gérés épinglaient le collecteur.

​

Détails de configuration

​

Variables de configuration communes

​

Authentification mTLS

​

Contrôle de la cardinalité des métriques

​

Traces (bêta)

​

Hiérarchie des spans

claude_code.interaction
├── claude_code.llm_request
├── claude_code.hook                    (requires detailed 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

​

Attributs des spans

• Un appel à tout outil autre que Read, Edit, Write, Bash, WebFetch, WebSearch et les outils MCP
• Un Read qui retourne autre chose que du texte de fichier, comme une image, un PDF ou une relecture d’un fichier dont le contenu n’a pas changé
• Un appel Edit ou Write, sauf si vous définissez également OTEL_LOG_TOOL_DETAILS=1
• Un appel WebFetch ou WebSearch que Claude Code a déplacé en arrière-plan parce que vous avez interrompu le tour pour envoyer vos messages en attente immédiatement pendant que l’appel s’exécutait. Claude reçoit ce résultat plus tard, après la fin du span d’outil

​

En-têtes dynamiques

​

Configuration des paramètres

{
  "otelHeadersHelper": "/path/to/generate-otel-headers.sh"
}

​

Exigences du script

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

• Une notification d’avertissement dans les sessions interactives, otelHeadersHelper failed; telemetry is not being exported, affichée une fois par session lorsque l’assistant échoue pour la première fois
• Sortie /status
• Le journal de débogage, lors de l’exécution avec --debug ou après l’exécution de /debug dans la session
• stderr, dans les sessions non interactives démarrées avec -p

​

Comportement d’actualisation

​

Support des organisations multi-équipes

# Add custom attributes for team identification
export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"

• Filtrer les métriques par équipe ou département
• Suivre les coûts par centre de coûts
• Créer des tableaux de bord spécifiques à l’équipe
• Configurer des alertes pour des équipes spécifiques

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

export OTEL_RESOURCE_ATTRIBUTES="org.name=John%27s%20Organization"

​

Exemples de configurations

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=console
export OTEL_METRIC_EXPORT_INTERVAL=1000

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

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=prometheus

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

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

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

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

​

Télémétrie des sessions cloud et Claude Tag

• Paramètres gérés par le serveur : ajoutez-les au bloc env des paramètres gérés par le serveur de votre organisation. Claude Code récupère ces paramètres au démarrage partout où les paramètres gérés par le serveur s’appliquent, ce qui inclut les machines de vos utilisateurs et les sessions cloud autres que les sessions du canal Claude Tag. Les sessions Claude Tag ne reçoivent pas vos paramètres gérés par le serveur, donc cette route ne les configure pas.
• Les variables de l’environnement : ajoutez-les aux variables d’environnement d’un environnement cloud pour configurer uniquement les sessions qui s’exécutent dans cet environnement. C’est la route qui atteint les sessions Claude Tag.

• Laissez les sessions atteindre le collecteur : Claude Code envoie l’export via le réseau de la session, donc si elle atteint l’hôte dans votre OTEL_EXPORTER_OTLP_ENDPOINT dépend du niveau d’accès réseau de l’environnement. Si les sessions ne peuvent pas atteindre le domaine du collecteur au niveau que vous avez choisi, ajoutez le domaine à la liste d’autorisation de l’environnement, car aucun paramètre géré par le serveur n’ajoute de domaines à la liste d’autorisation réseau d’un environnement.
• Les canaux Claude Tag utilisent des environnements au niveau de l’organisation : les sessions de canal s’exécutent dans des environnements au niveau de l’organisation plutôt que dans les environnements personnels des membres, donc effectuez les modifications de la liste d’autorisation et des variables d’environnement sur l’environnement partagé défini comme défaut de votre organisation ou épinglé au canal.
• Cowork est configuré séparément : les sessions Cowork ne reçoivent pas les paramètres gérés par le serveur, comme le montre le tableau de couverture de surface, donc le bloc env géré par le serveur ne configure pas leur télémétrie.

​

Attribuer la télémétrie aux sessions cloud

• Identifier les sessions Claude Tag : définissez OTEL_METRICS_INCLUDE_ENTRYPOINT=true, comme décrit sous Contrôle de la cardinalité des métriques. Les métriques portent alors app.entrypoint, dont la valeur est claude-in-slack pour les sessions Claude Tag.
• Ajouter des attributs personnalisés : définissez OTEL_RESOURCE_ATTRIBUTES au même endroit où vous définissez les autres variables OTEL_* pour ces sessions. Si vous l’export dans le script de configuration de l’environnement à la place, la valeur n’atteint pas Claude Code : le script de configuration est un script Bash séparé qui s’exécute avant le lancement de Claude Code, et les variables qu’il exporte se terminent avec lui.

​

Métriques et événements disponibles

​

Attributs standard

• prompt.id : UUID corrélant une invite utilisateur avec tous les événements suivants jusqu’à l’invite suivante. Voir Attributs de corrélation d’événements.
• workspace.host_paths : répertoires d’espace de travail hôte sélectionnés dans l’application de bureau, sous forme de tableau de chaînes
• workflow.run_id : identifiant d’exécution, préfixé wf_, sur les événements API et d’outils émis par les agents qui appartiennent à une exécution d’outil Workflow. Le filtrage des événements par un workflow.run_id reconstruit les demandes API et les résultats d’outils de cette exécution. L’identifiant couvre les agents que le script de flux de travail génère et tous les agents que ceux-ci génèrent à leur tour, par exemple les invocations de compétences. Il correspond à l’identifiant d’exécution signalé dans le résultat de l’outil Workflow. Absent sur tous les autres événements. Nécessite Claude Code v2.1.202 ou ultérieur
• workflow.name : nom du flux de travail, le meta.name de son script, émis aux côtés de workflow.run_id. Les noms de flux de travail intégrés apparaissent textuellement lorsque l’exécution exécute le script intégré non modifié. Les noms créés par l’utilisateur, y compris les copies modifiées de scripts intégrés, sont remplacés par custom sauf si OTEL_LOG_TOOL_DETAILS=1 est défini. Nécessite Claude Code v2.1.202 ou ultérieur

​

Attributs du référentiel

​

Métriques

​

Détails des métriques

​

Compteur de sessions

• Tous les attributs standard
• start_type : Comment la session a été démarrée. L’une de "fresh", "resume", "continue", ou "agents_view". La valeur "agents_view" identifie le processus du tableau de bord claude agents, une interface utilisateur locale lancée par l’utilisateur plutôt qu’une session conversationnelle. Filtrez sur cette valeur pour séparer les lancements de processus UI des sessions conversationnelles dans vos tableaux de bord.

​

Compteur de lignes de code

• Tous les attributs standard
• type : ("added", "removed")
• model : Identifiant du modèle pour le modèle qui a effectué la modification (par exemple, « claude-sonnet-5 »)

​

Compteur de demandes de tirage

• Tous les attributs standard

​

Compteur de commits

• Tous les attributs standard

​

Compteur de coûts

• Tous les attributs standard
• model : Identifiant du modèle (par exemple, « claude-sonnet-5 »)
• query_source : Catégorie du sous-système qui a émis la demande. L’une de "main", "subagent", ou "auxiliary"
• speed : "fast" lorsque la demande a utilisé le mode rapide. Absent sinon
• effort : Niveau d’effort appliqué à la demande : "low", "medium", "high", "xhigh", ou "max". Absent lorsque Claude Code n’envoie aucun niveau d’effort, par exemple sur un modèle qui ne supporte pas l’effort.
• agent.name : Type de sous-agent qui a émis la demande. Les noms d’agents intégrés et les agents des plugins de la place de marché officielle apparaissent textuellement. Les autres noms d’agents définis par l’utilisateur sont remplacés par "custom". Absent lorsque la demande n’a pas été émise par un type de sous-agent nommé.
• skill.name : Compétence active pour la demande, définie par l’outil Skill ou une commande /, ou héritée par un sous-agent généré. Les noms de compétences intégrés, groupés, définis par l’utilisateur et de la place de marché officielle des plugins apparaissent textuellement. Les noms de compétences des plugins tiers sont remplacés par "third-party". Absent lorsqu’aucune compétence n’est active.
• plugin.name : Plugin propriétaire lorsque la compétence active ou le sous-agent est fourni par un plugin. Les noms des plugins de la place de marché officielle apparaissent textuellement. Les noms des plugins tiers sont remplacés par "third-party". Absent lorsque ni la compétence ni le sous-agent n’a de plugin propriétaire.
• marketplace.name : Place de marché à partir de laquelle le plugin propriétaire a été installé. Émis uniquement pour les plugins de la place de marché officielle, même avec OTEL_LOG_TOOL_DETAILS=1 défini. Absent sinon.
• mcp_server.name : Serveur MCP dont le résultat d’outil cette demande a consommé. Les noms des serveurs intégrés, proxifiés par claude.ai et du registre officiel apparaissent textuellement. Les noms des serveurs configurés par l’utilisateur sont remplacés par "custom". Absent lorsque la demande n’a consommé aucun résultat d’outil MCP. Avant v2.1.222, Claude Code définissait cet attribut sur chaque demande après un appel d’outil MCP, pas seulement sur les demandes qui ont consommé un résultat d’outil, donc les tableaux de bord qui l’agrègent montrent une baisse après la mise à niveau.
• mcp_tool.name : Outil MCP dont le résultat cette demande a consommé, avec le même comportement de rédaction et de version que mcp_server.name. Absent lorsque la demande n’a consommé aucun résultat d’outil MCP.

​

Compteur de jetons

• Tous les attributs standard
• type : ("input", "output", "cacheRead", "cacheCreation")
• model : Identifiant du modèle (par exemple, « claude-sonnet-5 »)
• query_source : Catégorie du sous-système qui a émis la demande. L’une de "main", "subagent", ou "auxiliary"
• speed : "fast" lorsque la demande a utilisé le mode rapide. Absent sinon
• effort : Niveau d’effort appliqué à la demande. Voir Compteur de coûts pour les détails.
• agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name : Attribution de compétence, plugin, agent et MCP pour la demande. Voir Compteur de coûts pour les définitions et le comportement de rédaction.

​

Compteur de décisions de l’outil d’édition de code

• Tous les attributs standard
• tool_name : Nom de l’outil ("Edit", "Write", "NotebookEdit")
• decision : Décision de l’utilisateur ("accept", "reject")
• source : D’où provient la décision. L’une de "config", "hook", "user_permanent", "user_temporary", "user_abort", ou "user_reject". Voir l’événement de décision d’outil pour ce que signifie chaque valeur.
• language : Langage de programmation du fichier édité, par exemple "TypeScript", "Python", "JavaScript", ou "Markdown". Retourne "unknown" pour les extensions de fichier non reconnues.

​

Compteur de temps actif

• Tous les attributs standard
• type : "user" pour les interactions au clavier, "cli" pour l’exécution d’outils et les réponses IA

​

Événements

​

Attributs de corrélation d’événements

• message.uuid sur user_prompt, assistant_response, et api_response_body
• request_id sur les événements API, persisté comme requestId sur les entrées d’assistant de la transcription
• tool_use_id sur les événements tool_result et tool_decision

​

Événement d’invite utilisateur

• Tous les attributs standard
• event.name : "user_prompt"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• prompt_length : Longueur de l’invite
• prompt : Contenu de l’invite. Rédacté par défaut. Définissez OTEL_LOG_USER_PROMPTS=1 pour l’inclure
• message.uuid : UUID du message utilisateur résultant, correspondant à l’entrée de transcription persistée. Absent sur les dispatches de commandes, qui peuvent produire zéro ou plusieurs messages. Nécessite Claude Code v2.1.214 ou ultérieur
• command_name : Nom de la commande lorsque l’invite en invoque une. Les noms de commandes intégrés et groupés tels que compact ou debug sont émis tels quels ; les alias tels que reset émettent tels que tapés plutôt que le nom canonique. Les noms de commandes personnalisés, de plugins et MCP s’effondrent à custom ou mcp sauf si OTEL_LOG_TOOL_DETAILS=1 est défini
• command_source : Origine de la commande lorsqu’elle est présente : builtin, custom, ou mcp. Les commandes fournies par les plugins signalent comme custom

​

Événement de réponse d’assistant

• Tous les attributs standard
• event.name : "assistant_response"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• response_length : Longueur du texte de réponse en caractères
• response : Texte de réponse, tronqué à la limite de contenu (60 KB par défaut). Rédacté à <REDACTED> par défaut. Définissez OTEL_LOG_ASSISTANT_RESPONSES=1 pour l’inclure. Lorsque OTEL_LOG_ASSISTANT_RESPONSES n’est pas défini, OTEL_LOG_USER_PROMPTS le contrôle à la place, donc définissez OTEL_LOG_ASSISTANT_RESPONSES=0 pour garder les réponses rédactées tandis que la journalisation des invites est activée
• model : Identifiant du modèle (par exemple, « claude-sonnet-5 »)
• request_id : ID de demande API, décrit sous Attributs de corrélation d’événements
• message.uuid : UUID de l’entrée de transcription finale de la réponse. Une réponse API est persistée comme une entrée de transcription par bloc de contenu ; c’est la dernière, à partir de laquelle le parentUuid du tour suivant s’enchaîne. Nécessite Claude Code v2.1.214 ou ultérieur
• query_source : Sous-système qui a émis la demande, par exemple "repl_main_thread", "compact", ou un nom de sous-agent

​

Événement de résultat d’outil

• Tous les attributs standard
• event.name : "tool_result"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• tool_name : Nom de l’outil
• tool_use_id : Identifiant unique pour cette invocation d’outil. Correspond au tool_use_id passé aux hooks, permettant la corrélation entre les événements OTel et les données capturées par les hooks.
• success : "true" ou "false"
• duration_ms : Temps d’exécution en millisecondes
• error_type : Chaîne de catégorie d’erreur lorsque l’outil a échoué, par exemple "Error:ENOENT" ou "ShellError"
• error (lorsque OTEL_LOG_TOOL_DETAILS=1) : Message d’erreur complet lorsque l’outil a échoué
• decision_type : Toujours "accept", puisque cet événement n’est émis qu’après l’exécution de l’outil. Les appels rejetés ne produisent pas de résultat d’outil
• decision_source : D’où provient la décision de permission. L’une de "config", "hook", "user_permanent", ou "user_temporary". Voir l’événement de décision d’outil pour ce que signifie chaque valeur. Les sources réservées au rejet "user_abort" et "user_reject" n’apparaissent jamais sur cet événement.
• tool_input_size_bytes : Taille de l’entrée d’outil sérialisée en JSON en octets
• tool_result_size_bytes : Taille du résultat d’outil en octets
• mcp_server_scope : Identifiant de portée du serveur MCP (pour les outils MCP)
• vcs.ref.head.revision, vcs.ref.head.name, vcs.ref.head.type (lorsque OTEL_LOG_TOOL_DETAILS=1) : l’identité de commit d’une exécution git commit réussie par l’outil Bash ou PowerShell. vcs.ref.head.revision est le SHA du commit, vcs.ref.head.name est la branche sur laquelle il a été commité, et vcs.ref.head.type est branch. Le nom et le type sont omis lorsque le commit a été effectué sur un HEAD détaché. Nécessite Claude Code v2.1.269 ou ultérieur
• tool_parameters (lorsque OTEL_LOG_TOOL_DETAILS=1) : Chaîne JSON contenant les paramètres spécifiques à l’outil. Pour les serveurs intégrés du Claude Desktop, dans les sessions que Claude Desktop possède, la paire mcp_server_name/mcp_tool_name est incluse même avec le drapeau désactivé, la même exception créée par l’hôte que l’événement de décision d’outil, nécessitant Claude Code v2.1.214 ou ultérieur. Les paramètres varient selon l’outil :
  • Pour l’outil Bash : inclut bash_command, full_command, timeout, description, et dangerouslyDisableSandbox, plus git_commit_id et git_branch lorsqu’une commande git commit réussit. git_commit_id est le SHA complet du commit lorsque le commit est le HEAD du répertoire de travail de la session, et le SHA abrégé de git sinon. git_branch est la branche sur laquelle il a été commité, omis sur un HEAD détaché
  • Pour l’outil Bash d’espace de travail de l’application de bureau, qui signale également tool_name comme Bash : inclut uniquement bash_command, full_command, et timeout
  • Pour les outils MCP : inclut mcp_server_name, mcp_tool_name
  • Pour l’outil Skill : inclut skill_name
  • Pour l’outil Agent ou l’outil Task hérité : inclut subagent_type
• tool_input (lorsque OTEL_LOG_TOOL_DETAILS=1) : Arguments d’outil sérialisés en JSON. Les valeurs individuelles supérieures à 512 caractères sont tronquées, et la charge utile complète est limitée à environ 4 K caractères. S’applique à tous les outils, y compris les outils MCP.

​

Événement de demande API

• Tous les attributs standard
• event.name : "api_request"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• model : Modèle utilisé (par exemple, « claude-sonnet-5 »)
• cost_usd : Coût estimé en USD
• cost_usd_micros : Coût estimé en millionièmes de dollar américain, émis sous forme d’entier
• duration_ms : Durée de la demande en millisecondes
• input_tokens : Nombre de jetons d’entrée
• output_tokens : Nombre de jetons de sortie
• cache_read_tokens : Nombre de jetons lus du cache
• cache_creation_tokens : Nombre de jetons utilisés pour la création du cache
• request_id : ID de demande API, par exemple "req_011...", décrit sous Attributs de corrélation d’événements.
• client_request_id : UUID généré par le client envoyé comme en-tête de demande x-client-request-id ; voir le tableau attributs de corrélation d’événements pour savoir quand il est présent. Nécessite Claude Code v2.1.214 ou ultérieur
• speed : "fast" ou "normal", indiquant si le mode rapide était actif
• query_source : Sous-système qui a émis la demande, par exemple "repl_main_thread", "compact", ou un nom de sous-agent
• effort : Niveau d’effort appliqué à la demande : "low", "medium", "high", "xhigh", ou "max". Absent lorsque Claude Code n’envoie aucun niveau d’effort, par exemple sur un modèle qui ne supporte pas l’effort.
• agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name : Attribution de compétence, plugin, agent et MCP pour la demande. Voir Compteur de coûts pour les définitions et le comportement de rédaction.

​

Événement d’erreur API

• Tous les attributs standard
• event.name : "api_error"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• model : Modèle utilisé (par exemple, « claude-sonnet-5 »)
• error : Message d’erreur
• status_code : Code de statut HTTP sous forme de nombre. Absent pour les erreurs non-HTTP telles que les défaillances de connexion.
• duration_ms : Durée de la demande en millisecondes
• attempt : Nombre total de tentatives effectuées, y compris la demande initiale (1 signifie qu’aucune nouvelle tentative n’a eu lieu)
• request_id : ID de demande API, par exemple "req_011...", décrit sous Attributs de corrélation d’événements.
• client_request_id : UUID généré par le client envoyé comme en-tête de demande x-client-request-id. Disponible même lorsqu’une défaillance telle qu’un délai d’expiration ou une erreur de connexion n’a jamais produit de request_id serveur ; voir le tableau attributs de corrélation d’événements pour savoir quand il est présent. Nécessite Claude Code v2.1.214 ou ultérieur
• speed : "fast" ou "normal", indiquant si le mode rapide était actif
• query_source : Sous-système qui a émis la demande, par exemple "repl_main_thread", "compact", ou un nom de sous-agent
• effort : Niveau d’effort appliqué à la demande. Absent lorsque Claude Code n’envoie aucun niveau d’effort, par exemple sur un modèle qui ne supporte pas l’effort.
• agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name : Attribution de compétence, plugin, agent et MCP pour la demande. Voir Compteur de coûts pour les définitions et le comportement de rédaction.

​

Événement de refus API

• Tous les attributs standard
• event.name : "api_refusal"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• model : Identifiant du modèle de la demande
• request_id : ID de demande API, par exemple "req_011...", décrit sous Attributs de corrélation d’événements.
• query_source : Sous-système qui a émis la demande, par exemple "repl_main_thread", "compact", ou un nom de sous-agent. Voir api_request pour les définitions.
• speed : Soit "fast" lorsque le Mode rapide est actif, soit "normal"
• attempt : Numéro de tentative de nouvelle tentative. La première tentative est 1.
• effort : Niveau d’effort appliqué à la demande. Absent lorsque Claude Code n’envoie aucun niveau d’effort, par exemple sur un modèle qui ne supporte pas l’effort.
• server_fallback_hop : true lorsque le secours du modèle côté serveur de l’API a déjà retesté ce refus sur un modèle différent, donc l’utilisateur n’a pas vu ce refus particulier. false lorsque la demande s’est terminée par un refus. Un seul tour peut émettre à la fois un événement true hop et un événement false final ultérieur lorsque le modèle de secours refuse également.
• has_category : true lorsque la réponse API portait une stop_details.category de "cyber", "bio", "frontier_llm", ou "reasoning_extraction". false lorsque la réponse ne portait aucune catégorie ou une valeur en dehors de cet ensemble. Absent lorsque server_fallback_hop est true, car les blocs hop ne portent pas stop_details.
• has_explanation : true lorsque la réponse API portait une stop_details.explanation, sinon false. Absent lorsque server_fallback_hop est true.
• category : La valeur stop_details.category de la réponse API. L’une de "cyber", "bio", "frontier_llm", ou "reasoning_extraction". Présent uniquement lorsque OTEL_LOG_TOOL_DETAILS=1 est défini et has_category est true.
• agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name : Attribution de compétence, plugin, agent et MCP pour la demande. Voir Compteur de coûts pour les définitions et le comportement de rédaction.

​

Événement de corps de demande API

• Tous les attributs standard
• event.name : "api_request_body"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• body : Paramètres de demande API Messages sérialisés en JSON, tels que l’invite système, les messages et les outils, tronqués à la limite de contenu (60 KB par défaut). Le contenu de réflexion étendue dans les tours d’assistant antérieurs est rédacté. Émis uniquement en mode en ligne (OTEL_LOG_RAW_API_BODIES=1).
• body_ref : Chemin absolu vers un fichier <dir>/<uuid>.request.json contenant le corps non tronqué. Émis uniquement en mode fichier (OTEL_LOG_RAW_API_BODIES=file:<dir>).
• body_length : Longueur du corps non tronqué. Octets UTF-8 lorsque OTEL_LOG_RAW_API_BODIES=file:<dir>, ou unités de code UTF-16 lorsque =1
• body_truncated : "true" lorsque la troncature en ligne s’est produite. Absent en mode fichier et lorsqu’aucune troncature ne s’est produite.
• model : Identifiant du modèle à partir des paramètres de demande
• query_source : Sous-système qui a émis la demande (par exemple, "compact")
• request_body_id : UUID qui identifie le corps de demande de cette tentative. L’événement api_response_body pour la tentative qui réussit porte la même valeur, afin que vous puissiez appairer une réponse avec la demande exacte qui l’a produite. Nécessite Claude Code v2.1.274 ou ultérieur

​

Événement de corps de réponse API

• Tous les attributs standard
• event.name : "api_response_body"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• body : Réponse API Messages sérialisée en JSON, y compris l’id, les blocs de contenu, l’utilisation et la raison d’arrêt, tronquée à la limite de contenu (60 KB par défaut). Le contenu de réflexion étendue est rédacté. Émis uniquement en mode en ligne (OTEL_LOG_RAW_API_BODIES=1).
• body_ref : Chemin absolu vers un fichier <dir>/<request_id>.response.json contenant le corps non tronqué. Émis uniquement en mode fichier (OTEL_LOG_RAW_API_BODIES=file:<dir>).
• body_length : Longueur du corps non tronqué. Octets UTF-8 lorsque OTEL_LOG_RAW_API_BODIES=file:<dir>, ou unités de code UTF-16 lorsque =1
• body_truncated : "true" lorsque la troncature en ligne s’est produite. Absent en mode fichier et lorsqu’aucune troncature ne s’est produite.
• model : Identifiant du modèle
• query_source : Sous-système qui a émis la demande
• request_id : ID de demande API, par exemple "req_011...", décrit sous Attributs de corrélation d’événements.
• request_body_id : Le request_body_id de l’événement api_request_body auquel cette réponse répond. Nécessite Claude Code v2.1.274 ou ultérieur
• message.id : ID de message que l’API a assigné à la réponse, le champ id du corps de réponse. Nécessite Claude Code v2.1.274 ou ultérieur
• message.uuid : UUID de l’entrée de transcription finale de la réponse. Avec request_body_id, il lie un message de transcription aux corps de demande et de réponse derrière lui. Nécessite Claude Code v2.1.274 ou ultérieur

​

Événement de décision d’outil

• Tous les attributs standard
• event.name : "tool_decision"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• tool_name : Nom de l’outil (par exemple, « Read », « Edit », « Write », « NotebookEdit »)
• tool_use_id : Identifiant unique pour cette invocation d’outil. Correspond au tool_use_id passé aux hooks, permettant la corrélation entre les événements OTel et les données capturées par les hooks.
• decision : Soit "accept" soit "reject"
• tool_source : Toujours présent. La provenance de l’outil, comme un ensemble fermé de valeurs créées par la CLI. Nécessite Claude Code v2.1.214 ou ultérieur
  • "builtin" : les outils propres de la CLI
  • "mcp" : serveurs MCP en général
  • "sdk_host_builtin_mcp" : un serveur en processus intégré à Claude Desktop lui-même, dans une session que Claude Desktop possède. Claude Desktop possède une session qu’il a lancée à partir de l’un de ses propres points d’entrée, claude-desktop, claude-desktop-3p, ou local-agent, lorsque cette session n’est pas un enfant imbriqué ; les sessions imbriquées, y compris les sessions que Claude Code lui-même génère, signalent ces serveurs comme "mcp"
• source : D’où provient la décision :
  • "config" : Décidé automatiquement sans invite, basé sur les paramètres du projet, les règles d’autorisation ou de refus dans les paramètres personnels de l’utilisateur, la politique gérée par l’entreprise, les drapeaux --allowedTools ou --disallowedTools, le mode de permission actif, une subvention à portée de session d’une invite antérieure dans la même session CLI interactive, ou parce que l’outil est intrinsèquement sûr. L’événement n’indique pas laquelle de ces sources a correspondu. Claude Code signale également "config" lorsque la demande d’invite de permission elle-même échoue, par exemple lorsque le rappel canUseTool du SDK Agent ou l’outil --permission-prompt-tool retourne un résultat invalide, ou lorsque le flux d’entrée se ferme pendant que la demande est en attente. Avant v2.1.216, Claude Code signalait ces défaillances comme "user_reject".
  • "hook" : Un hook PreToolUse ou PermissionRequest a retourné la décision.
  • "user_permanent" : Émis lorsque l’utilisateur a choisi « Oui, et ne me demande plus pour … » à une invite de permission, ce qui enregistre une règle d’autorisation dans ses paramètres personnels. Dans la CLI interactive, ceci n’est émis que pour ce choix lui-même ; les appels ultérieurs qui correspondent à la règle enregistrée émettent "config" à la place. Dans les sessions SDK Agent ou non-interactive -p, à la fois le choix initial et les correspondances de règles ultérieures émettent "user_permanent". Traité comme une acceptation.
  • "user_temporary" : Émis lorsque l’utilisateur a choisi « Oui » à une invite de permission pour une approbation unique, ou a choisi une option qui accorde l’accès pour le reste de la session sur une invite d’édition ou de lecture de fichier. Dans la CLI interactive, ceci n’est émis que pour le choix lui-même ; les appels ultérieurs autorisés par cette subvention à portée de session émettent "config" à la place. Dans les sessions SDK Agent ou non-interactive -p, à la fois le choix et les correspondances ultérieures émettent "user_temporary". Traité comme une acceptation.
  • "user_abort" : Émis lorsque l’utilisateur a fermé l’invite de permission sans répondre. Dans les sessions SDK Agent et non-interactive -p, cela inclut l’interruption du tour pendant qu’une demande de permission canUseTool ou --permission-prompt-tool est en attente ; avant v2.1.216, Claude Code signalait cette interruption comme "user_reject". Traité comme un rejet.
  • "user_reject" : Émis lorsque l’utilisateur a choisi « Non » lorsqu’on lui a demandé. Dans la CLI interactive, ceci n’est émis que pour ce choix lui-même ; les appels qui correspondent à une règle de refus dans les paramètres personnels de l’utilisateur émettent "config" à la place. Dans les sessions SDK Agent ou non-interactive -p, les appels qui correspondent à une règle de refus dans les paramètres personnels émettent "user_reject". Traité comme un rejet.
• tool_parameters (lorsque OTEL_LOG_TOOL_DETAILS=1) : Chaîne JSON contenant les paramètres spécifiques à l’outil. Même forme que l’événement de résultat d’outil, moins les champs post-exécution tels que git_commit_id. Les valeurs peuvent différer de tool_result pour un appel accepté si la décision de permission réécrit l’entrée d’outil via updatedInput. Utilisez cet attribut pour voir quelle commande a été rejetée lorsque decision est "reject".
  • Pour les outils "sdk_host_builtin_mcp" : mcp_server_name et mcp_tool_name sont inclus même lorsque OTEL_LOG_TOOL_DETAILS est désactivé, car l’application hôte définit ces noms ; sans eux, un appel rejeté à l’un de ces serveurs intégrés serait non attribuable sur le flux par défaut. Pour les serveurs MCP configurés par l’utilisateur, le tool_name de l’événement est toujours le littéral "mcp_tool", et les noms du serveur et de l’outil apparaissent uniquement dans tool_parameters avec le drapeau activé ; le contenu des arguments nécessite le drapeau partout. Nécessite Claude Code v2.1.214 ou ultérieur
  • Pour l’outil Bash : inclut bash_command, full_command, timeout, description, dangerouslyDisableSandbox. L’outil bash d’espace de travail de l’application de bureau signale également tool_name comme Bash, mais inclut uniquement bash_command, full_command, et timeout
  • Pour les outils MCP : inclut mcp_server_name, mcp_tool_name
  • Pour l’outil Skill : inclut skill_name
  • Pour l’outil Agent ou l’outil Task hérité : inclut subagent_type

​

Événement de changement de mode de permission

• Tous les attributs standard
• event.name : "permission_mode_changed"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• from_mode : Le mode de permission précédent, par exemple "default", "plan", "acceptEdits", "auto", ou "bypassPermissions"
• to_mode : Le nouveau mode de permission
• trigger : Ce qui a causé le changement. L’une de "shift_tab", "exit_plan_mode", "auto_gate_denied", ou "auto_opt_in". Absent lorsque la transition provient du SDK ou du pont

​

Événement d’authentification

• Tous les attributs standard
• event.name : "auth"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• action : "login" ou "logout"
• success : "true" ou "false"
• auth_method : Méthode d’authentification, par exemple "oauth"
• error_category : Type d’erreur catégorique lorsque l’action a échoué. Le message d’erreur brut n’est jamais inclus
• status_code : Code de statut HTTP sous forme de chaîne lorsque l’action a échoué avec une erreur HTTP

​

Événement de connexion du serveur MCP

• Tous les attributs standard
• event.name : "mcp_server_connection"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• status : "connected", "failed", ou "disconnected"
• transport_type : Transport du serveur, par exemple "stdio", "sse", ou "http"
• server_scope : Portée à laquelle le serveur est configuré, par exemple "user", "project", ou "local"
• duration_ms : Durée de la tentative de connexion en millisecondes
• error_code : Code d’erreur lorsque la connexion a échoué
• is_plugin : true lorsque le serveur est fourni par un plugin, false sinon
• plugin_id_hash (lorsque is_plugin est true) : Hash stable du nom du plugin et de la place de marché, pour regrouper les événements par plugin sans exposer le nom. Claude Code le calcule comme décrit sous l’événement de plugin chargé
• plugin.name (lorsque is_plugin est true) : Nom du plugin qui fournit le serveur. Pour les plugins tiers, c’est la chaîne littérale "third-party" sauf si OTEL_LOG_TOOL_DETAILS=1 ; cela protège les noms des plugins tiers d’apparaître dans les journaux par défaut. Les plugins provenant de sources Anthropic officielles sont toujours identifiés par nom. Les attributs plugin_id_hash et plugin.name circulent vers votre propre backend de surveillance et ne sont pas envoyés à Anthropic
• server_name (lorsque OTEL_LOG_TOOL_DETAILS=1) : Nom du serveur configuré
• error (lorsque OTEL_LOG_TOOL_DETAILS=1) : Message d’erreur complet lorsque la connexion a échoué

​

Événement d’erreur interne

• Tous les attributs standard
• event.name : "internal_error"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• error_name : Nom de la classe d’erreur, par exemple "TypeError" ou "SyntaxError"
• error_code : Code errno Node.js tel que "ENOENT" lorsqu’il est présent sur l’erreur

​

Événement de plugin installé

• Tous les attributs standard
• event.name : "plugin_installed"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• marketplace.is_official : "true" si la place de marché est une place de marché Anthropic officielle, "false" sinon
• install.trigger : "cli" ou "ui"
• plugin.name : Nom du plugin installé. Pour les places de marché tiers, ceci n’est inclus que lorsque OTEL_LOG_TOOL_DETAILS=1
• plugin.version : Version du plugin lorsqu’elle est déclarée dans l’entrée de la place de marché. Pour les places de marché tiers, ceci n’est inclus que lorsque OTEL_LOG_TOOL_DETAILS=1
• marketplace.name : Place de marché à partir de laquelle le plugin a été installé. Pour les places de marché tiers, ceci n’est inclus que lorsque OTEL_LOG_TOOL_DETAILS=1

​

Événement de plugin chargé

• Tous les attributs standard
• event.name : "plugin_loaded"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• plugin.name : nom du plugin. Pour les plugins en dehors de la place de marché officielle et du bundle intégré, la valeur est "third-party" sauf si OTEL_LOG_TOOL_DETAILS=1
• marketplace.name : place de marché à partir de laquelle le plugin a été installé, lorsqu’elle est connue. Rédactée à "third-party" sous la même condition que plugin.name
• plugin.version : version du manifeste du plugin. Inclus uniquement lorsque le nom n’est pas rédacté et que le manifeste déclare une version
• plugin.scope : catégorie de provenance du plugin : "official", "community", "org", "user-local", ou "default-bundle"
• enabled_via : comment le plugin en est venu à être activé : "default-enable", "org-policy", "admin-install", "seed-mount", ou "user-install". La valeur "admin-install" signifie que le plugin est défini comme obligatoire ou auto-installation pour votre organisation dans Paramètres d’organisation > Plugins et compétences. Avant v2.1.246, Claude Code signalait ces plugins comme "user-install" ou "seed-mount"
• plugin_id_hash : hash déterministe du nom du plugin et de la place de marché, envoyé uniquement à votre exportateur configuré. Vous permet de compter les plugins tiers distincts chargés dans votre flotte sans enregistrer leurs noms. Pour les plugins synchronisés à partir de claude.ai, Claude Code hache le nom du plugin avec le nom de la place de marché que claude.ai signale pour le plugin, ou avec synced sinon. Avant v2.1.246, Claude Code n’utilisait pas le nom de la place de marché que claude.ai signale dans le hash
• has_hooks : si le plugin contribue des hooks
• has_mcp : si le plugin contribue des serveurs MCP
• host_owned_mcp : true lorsque l’hôte SDK gère les connexions MCP de ce plugin et Claude Code a ignoré la lecture de la configuration du serveur MCP du plugin, false sinon. Nécessite Claude Code v2.1.172 ou ultérieur
• skill_path_count : nombre de répertoires de compétences que le plugin déclare
• command_path_count : nombre de répertoires de commandes que le plugin déclare
• agent_path_count : nombre de répertoires d’agents que le plugin déclare
• safe_mode : "true" lorsque la session a été démarrée avec --safe-mode, "false" sinon. En mode sûr, cet événement signale uniquement l’inventaire configuré ; les commandes, compétences, hooks et serveurs MCP du plugin ne se chargent pas. Nécessite Claude Code v2.1.169 ou ultérieur

​

Événement de compétence activée

• Tous les attributs standard
• event.name : "skill_activated"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• skill.name : Nom de la compétence. Pour les compétences définies par l’utilisateur et les plugins tiers, la valeur est l’espace réservé "custom_skill" sauf si OTEL_LOG_TOOL_DETAILS=1
• invocation_trigger : Comment la compétence a été déclenchée ("user-slash", "claude-proactive", ou "nested-skill")
• skill.source : D’où la compétence a été chargée (par exemple, "bundled", "userSettings", "projectSettings", "plugin")
• skill.kind : "workflow" lorsque la compétence est une compétence de flux de travail. Absent sinon
• plugin.name (lorsque OTEL_LOG_TOOL_DETAILS=1 ou le plugin provient d’une place de marché officielle) : Nom du plugin propriétaire lorsque la compétence est fournie par un plugin
• marketplace.name (lorsque OTEL_LOG_TOOL_DETAILS=1 ou le plugin provient d’une place de marché officielle) : Place de marché à partir de laquelle le plugin propriétaire a été installé, lorsque la compétence est fournie par un plugin

​

Événement de mention @

• Tous les attributs standard
• event.name : "at_mention"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• mention_type : Type de mention ("file", "directory", "agent", "mcp_resource", "peer"). La valeur "peer" signifie que vous avez mentionné l’une de vos autres sessions Claude Code. Nécessite Claude Code v2.1.232 ou ultérieur
• success : Si la mention a été résolue avec succès ("true" ou "false")

​

Événement de tentatives API épuisées

• Tous les attributs standard
• event.name : "api_retries_exhausted"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• model : Modèle utilisé
• error : Message d’erreur final
• status_code : Code de statut HTTP sous forme de nombre. Absent pour les erreurs non-HTTP.
• total_attempts : Nombre total de tentatives effectuées
• total_retry_duration_ms : Temps mural total sur toutes les tentatives
• speed : "fast" ou "normal"

​

Événement de hook enregistré

• Tous les attributs standard
• event.name : "hook_registered"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• hook_event : type d’événement hook, par exemple "PreToolUse" ou "PostToolUse"
• hook_type : type d’implémentation du hook : "command", "prompt", "mcp_tool", "http", ou "agent"
• hook_source : où le hook est défini : "userSettings", "projectSettings", "localSettings", "flagSettings", "policySettings", ou "pluginHook"
• safe_mode : "true" lorsque la session a été démarrée avec --safe-mode, "false" sinon. Nécessite Claude Code v2.1.169 ou ultérieur
• hook_matcher (lorsque OTEL_LOG_TOOL_DETAILS=1) : la chaîne de correspondance de la configuration du hook, lorsqu’une est définie
• plugin.name (lorsque hook_source est "pluginHook") : nom du plugin contributeur. Pour les plugins en dehors de la place de marché officielle et du bundle intégré, la valeur est "third-party" sauf si OTEL_LOG_TOOL_DETAILS=1
• plugin_id_hash (lorsque hook_source est "pluginHook") : hash déterministe du nom du plugin et de la place de marché, envoyé uniquement à votre exportateur configuré. Vous permet de compter les plugins contributeurs distincts sans enregistrer leurs noms. Claude Code le calcule comme décrit sous l’événement de plugin chargé

​

Événement de début d’exécution de hook

• Tous les attributs standard
• event.name : "hook_execution_start"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• hook_event : Type d’événement hook, par exemple "PreToolUse" ou "PostToolUse"
• hook_name : Nom complet du hook incluant le correspondant, par exemple "PreToolUse:Write"
• num_hooks : Nombre de commandes hook correspondantes
• managed_only : "true" lorsque seuls les hooks de politique gérée sont autorisés
• hook_source : "policySettings" ou "merged"
• safe_mode : "true" lorsque la session a été démarrée avec --safe-mode, "false" sinon. Nécessite Claude Code v2.1.169 ou ultérieur
• hook_definitions : Configuration du hook sérialisée en JSON. Inclus uniquement lorsque le traçage bêta détaillé et OTEL_LOG_TOOL_DETAILS=1 sont tous deux activés

​

Événement de fin d’exécution de hook

• Tous les attributs standard
• event.name : "hook_execution_complete"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• hook_event : Type d’événement hook
• hook_name : Nom complet du hook incluant le correspondant
• num_hooks : Nombre de commandes hook correspondantes
• num_success : Nombre qui ont réussi
• num_blocking : Nombre qui ont retourné une décision de blocage
• num_non_blocking_error : Nombre qui ont échoué sans bloquer
• num_cancelled : Nombre annulé avant la fin
• total_duration_ms : Durée mural de tous les hooks correspondants
• stdout_chars : Nombre total de caractères de stdout sur les hooks correspondants qui ont réussi. Nécessite Claude Code v2.1.280 ou ultérieur
• additional_context_chars : Nombre total de caractères de additionalContext retournés par les hooks correspondants. Nécessite Claude Code v2.1.280 ou ultérieur
• system_message_chars : Nombre total de caractères de systemMessage retournés par les hooks correspondants. Nécessite Claude Code v2.1.280 ou ultérieur
• initial_user_message_chars : Nombre total de caractères de initialUserMessage retournés par les hooks correspondants. Nécessite Claude Code v2.1.280 ou ultérieur
• num_outputs_persisted : Nombre de sorties de hook au-delà de la limite de 10 000 caractères que Claude Code a enregistrées dans un fichier. Nécessite Claude Code v2.1.280 ou ultérieur
• managed_only : "true" lorsque seuls les hooks de politique gérée sont autorisés
• hook_source : "policySettings" ou "merged"
• safe_mode : "true" lorsque la session a été démarrée avec --safe-mode, "false" sinon. Nécessite Claude Code v2.1.169 ou ultérieur
• hook_definitions : Configuration du hook sérialisée en JSON. Inclus uniquement lorsque le traçage bêta détaillé et OTEL_LOG_TOOL_DETAILS=1 sont tous deux activés

​

Événement de métriques de plugin de hook

• Tous les attributs standard
• event.name : "hook_plugin_metrics"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• plugin_id : identifiant du plugin sous la forme <name>@<marketplace>
• hook_event : type d’événement hook qui a émis les métriques
• Jusqu’à 20 clés de métriques émises par le plugin. Les noms correspondent à ^[a-z][a-z0-9_]{0,39}$. Les valeurs sont booléennes ou numériques.

​

Événement de compaction

• Tous les attributs standard
• event.name : "compaction"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• trigger : "auto" ou "manual"
• success : "true" ou "false"
• duration_ms : Durée de compaction
• pre_tokens : Nombre approximatif de jetons avant compaction
• post_tokens : Nombre approximatif de jetons après compaction
• error : Message d’erreur lorsque la compaction a échoué
• precompute_reuse : Défini uniquement lorsque trigger est "manual". La compaction automatique peut préparer un résumé en arrière-plan avant que la fenêtre de contexte ne se remplisse, et cet attribut enregistre si /compact a réutilisé ce résumé préparé. "hit" signifie qu’il a été réutilisé ; "miss_custom_instructions", "miss_hook", et "miss_not_ready" donnent la raison pour laquelle un résumé frais a été calculé à la place. Nécessite Claude Code v2.1.153 ou ultérieur

​

Événement de fin de sous-agent

• Tous les attributs standard
• event.name : "subagent_completed"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• agent_type : Le type de sous-agent. Les noms d’agents intégrés et les agents des plugins de la place de marché officielle apparaissent textuellement ; les autres noms d’agents sont remplacés par "custom" sauf si OTEL_LOG_TOOL_DETAILS=1 est défini
• agent.source : D’où la définition d’agent provient : built-in, plugin, ou la source de paramètres qui a défini un agent personnalisé, par exemple userSettings ou projectSettings
• is_built_in : Si le sous-agent est un type d’agent intégré
• is_async : Si le sous-agent s’exécutait en arrière-plan
• total_tokens : L’empreinte de jetons de la demande API finale du sous-agent : les jetons d’entrée, de création de cache, de lecture de cache et de sortie de cette seule demande, à peu près la taille du contexte du sous-agent à la fin. Pas une somme sur l’exécution
• total_tool_uses : Nombre d’appels d’outils que le sous-agent a effectués sur toute l’exécution
• duration_ms : Temps d’exécution en millisecondes
• model : Le modèle auquel le sous-agent a été résolu pour s’exécuter
• final_model : Le modèle qui a produit la réponse finale du sous-agent, qui diffère de model après un changement en cours d’exécution tel qu’un secours. Nécessite Claude Code v2.1.212 ou ultérieur
• model_swapped : Si plus d’un modèle a servi les demandes du sous-agent. Nécessite Claude Code v2.1.212 ou ultérieur
• plugin_id_hash, plugin.name : Présent pour les agents fournis par les plugins. Les noms des plugins de la place de marché officielle apparaissent textuellement ; les autres noms de plugins sont remplacés par "third-party" sauf si OTEL_LOG_TOOL_DETAILS=1 est défini

​

Événement d’enquête de rétroaction

• Tous les attributs standard
• event.name : "feedback_survey"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• event_type : Événement du cycle de vie de l’enquête, par exemple "appeared", "responded", ou "transcript_prompt_appeared"
• appearance_id : ID unique reliant les événements émis pour une instance d’enquête
• survey_type : Quelle enquête a produit l’événement. "session" est l’invite d’évaluation « Comment Claude se débrouille-t-il ? »
• response : La sélection de l’utilisateur sur les événements responded
• enabled_via_override : true lorsque CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL est défini. Émis sous forme de booléen, pas de chaîne. Présent sur les événements d’enquête session. Filtrez sur cet attribut pour confirmer que le remplacement est appliqué dans une flotte

​

Événement de balayage de rétention

• Tous les attributs standard
• event.name : "retention_sweep"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• result : "complete" lorsque le balayage s’est exécuté, "skipped" lorsque Claude Code l’a mis en pause
• period_days : La valeur cleanupPeriodDays à partir des paramètres fusionnés, en jours, ou 30 lorsqu’aucune source ne la définit. Sur les événements ignorés, la valeur que le balayage aurait utilisée, calculée à partir des sources de paramètres que Claude Code pouvait lire
• used_default : "true" lorsqu’aucune source de paramètres lisible ne définit cleanupPeriodDays, "false" sinon. Sur les événements complets, "true" signifie que la valeur par défaut de 30 jours s’appliquait
• skip_reason : Pourquoi Claude Code a mis en pause le balayage. Présent uniquement lorsque result est "skipped" :
  • "user_source_disabled" : Les paramètres utilisateur sont exclus, par exemple par le drapeau --setting-sources ou l’option settingSources du SDK, et aucune source activée ne fournit cleanupPeriodDays
  • "settings_unknowable" : Un fichier de paramètres n’a pas pu être lu ou analysé, donc cleanupPeriodDays ou desktopSessionCleanupPeriodDays peut être défini à une valeur que Claude Code ne peut pas voir
  • "settings_invalid_key_set" : Les paramètres ont des erreurs de validation et cleanupPeriodDays ou desktopSessionCleanupPeriodDays est explicitement défini, donc revenir à la valeur par défaut pourrait supprimer ou conserver des fichiers contre ce paramètre
• transcripts_deleted : Nombre de transcriptions de session, les fichiers ~/.claude/projects/*/*.jsonl de niveau supérieur, que le balayage a supprimés
• transcripts_exempted_desktop : Nombre de transcriptions au-delà de la période de rétention que le balayage a conservées selon la règle Claude Desktop et Cowork. Celles-ci ne comptent pas vers files_past_cutoff. Nécessite Claude Code v2.1.248 ou ultérieur
• session_files_deleted : Nombre d’artefacts que le balayage des fichiers de session a supprimés : transcriptions plus fichiers compagnons par session tels que les barres latérales, les enregistrements et les résultats d’outils
• artifacts_deleted : Nombre total d’éléments que le balayage a supprimés dans les répertoires de données qu’il couvre, y compris les fichiers de session. Certains balayages comptent un arbre de répertoires supprimé entier comme un élément et quelques passes de nettoyage ne contribuent pas au compteur, donc traitez la valeur comme un plancher plutôt qu’un nombre exact de fichiers
• files_retained_fresh : Fichiers inspectés et laissés en place car ils sont toujours dans la période de rétention. Seuls les balayages par fichier comptent ceux-ci, donc la valeur est un plancher ; une valeur non nulle est l’état stable normal
• files_past_cutoff : Fichiers plus anciens que la période de rétention que le balayage n’a pas pu supprimer, par exemple en raison d’une erreur de permission ou d’un fichier maintenu ouvert. Une valeur supérieure à zéro signifie que les fichiers ont dépassé la période de rétention configurée ; zéro n’est pas la preuve qu’aucun ne l’a fait, car une suppression échouée d’un répertoire entier compte vers error_count à la place
• error_count : Nombre d’erreurs que le balayage a rencontrées lors de la liste ou de la suppression de fichiers

​

Événement de paramètres gérés résolus

• Définissez-le dans le bloc env des paramètres gérés, des paramètres utilisateur, ou --settings, ou dans l’environnement avec lequel vous lancez Claude Code. Une valeur dans les paramètres du projet ou locaux ne l’active pas, car un référentiel cloné peut les écrire.
• Les paramètres gérés par le serveur peuvent le définir sans afficher la boîte de dialogue d’approbation de sécurité, car la variable ajoute uniquement votre propre politique rédactée de l’organisation à un événement que votre organisation reçoit déjà.

• Tous les attributs standard
• event.name : "managed_settings_resolved"
• event.timestamp : Timestamp ISO 8601
• event.sequence : compteur par processus pour ordonner les événements, décrit sous Attributs de corrélation d’événements
• managed_settings.trigger : "startup" pour l’événement de démarrage de session, "change" lorsque les paramètres gérés ou l’état de l’assistant de politique ont changé plus tard dans la session, ou "refused" lorsqu’une politique de paramètres gérés a arrêté la session. Claude Code envoie un événement change uniquement lorsqu’un attribut diffère du dernier événement qu’il a envoyé, et une valeur de paramètre modifiée compte même lorsque OTEL_LOG_MANAGED_SETTINGS est désactivé
• error.type : pourquoi Claude Code a arrêté la session. Présent uniquement sur les événements refused :
  • "helper_failed" : une exécution d’assistant de politique a échoué
  • "policy_invalid" : les paramètres gérés contiennent une erreur qui arrête Claude Code de démarrer, ou une source d’administration n’a pas pu se charger, donc Claude Code ne peut pas vérifier l’application de la connexion à l’organisation
  • "consent_rejected" : l’utilisateur a rejeté la boîte de dialogue d’approbation de sécurité pour les paramètres gérés par le serveur
  • "force_refresh_failed" : la récupération de paramètres que forceRemoteSettingsRefresh nécessite a échoué
  • "gateway_rejected" : une passerelle d’applications Claude a répondu au chargement des paramètres gérés avec HTTP 403
  • "version_below_minimum" : cette version de Claude Code est inférieure à requiredMinimumVersion ou supérieure à requiredMaximumVersion
  • "_OTHER" : le chargement des paramètres gérés de la passerelle d’applications Claude a échoué pour une autre raison
• managed_settings.sources : chaque source gérée qui fournit au moins une clé de politique, priorité la plus élevée en premier, y compris les sources dont les clés ne prennent pas effet sous first-wins. Les valeurs sont "remote", "plist" ou "hklm" pour la politique MDM ou au niveau du système d’exploitation, "file" pour les fichiers de paramètres gérés et les suppressions, "parent" lorsqu’un hôte d’intégration fournit des paramètres, et "hkcu" pour la valeur du registre Windows HKCU lorsque Claude Code la lit. Une source qui porte uniquement des clés de contrôle, ou que Claude Code n’a pas pu lire, n’est pas listée. Émis sous forme de tableau de chaînes, vide lorsqu’aucune source gérée ne fournit une clé de politique
• managed_settings.source_behavior : la valeur managedSourcesBehavior que Claude Code a lue, "first-wins" ou "merge". "first-wins" lorsqu’aucune source ne définit la clé
• managed_settings.helper.state : état de l’assistant de politique que la source MDM ou fichier sélectionnée configure :
  • "ok" : la sortie de l’assistant sert de paramètres gérés
  • "bad_path", "not_a_file", "exit_nonzero", "timed_out", "oversize", "parse_failed", "envelope_invalid", ou "schema_rejected" : la dernière exécution de l’assistant a échoué. Les défaillances d’assistant décrivent les cas
  • "none" : aucun assistant n’est configuré, ou la source qui le configure n’est pas une politique MDM ou un fichier de paramètres gérés
• managed_settings.helper.applied : "output" tandis que la sortie propre de l’assistant sert de paramètres gérés, "none" lorsqu’elle ne le fait pas
• managed_settings.helper.entry : "policyHelper" lorsque Claude Code a sélectionné un policyHelper. Absent lorsqu’il n’a sélectionné aucun assistant
• managed_settings.helper.path : le path configuré de l’assistant. Présent chaque fois que Claude Code a sélectionné un assistant, qu’il ait réussi ou non
• managed_settings.resolved_sha256 (lorsque OTEL_LOG_MANAGED_SETTINGS=1) : SHA-256 des paramètres gérés résolus avant rédaction, sérialisés en JSON avec les clés triées récursivement et sans espace blanc. Les machines avec le même digest exécutent la même politique. Claude Code envoie le digest uniquement avec l’opt-in car une politique courte peut être récupérée en hachant des suppositions. Absent lorsqu’aucun paramètre géré n’a été résolu, et sur les événements refused
• managed_settings.settings (lorsque OTEL_LOG_MANAGED_SETTINGS=1) : les noms et la forme des paramètres gérés résolus sous forme de chaîne JSON, avec les valeurs rédactées. Absent sur les événements refused. Claude Code le construit à partir de son schéma de paramètres :
  • Un nom de paramètre que le schéma déclare est exporté, et une clé qu’il ne déclare pas est laissée de côté
  • Les booléens, les nombres et les valeurs de chaîne que le schéma restreint à un ensemble fixe d’options, par exemple permissions.defaultMode, sont exportés tels quels. sandbox.network.httpProxyPort et sandbox.network.socksProxyPort sont exportés comme "[REDACTED]"
  • Chaque autre chaîne, par exemple model, apiKeyHelper, chaque valeur env, chaque URL et chaque commande, est exportée comme "[REDACTED]"
  • Les noms d’entrée des cartes, par exemple les noms de variables env et les ID de plugins, sont exportés tels quels. Un paramètre dont les entrées le schéma ne tape pas, par exemple vimInsertModeRemaps, est exporté comme un seul "[REDACTED]", et sandbox.ignoreViolations est exporté comme une liste de ses listes de chemins sans les modèles de commande
  • Une liste conserve sa longueur, avec chaque entrée rédactée par les mêmes règles
  • Une règle permissions.allow, permissions.deny, ou permissions.ask est exportée comme son nom d’outil avec le contenu rédacté, par exemple Read([REDACTED]), lorsque l’outil est intégré à cette version de Claude Code ou est une référence mcp__ telle que mcp__jira__create_issue. Toute autre règle est exportée comme "[REDACTED]"
  • Les hooks suivent les mêmes règles, donc les champs à option fixe et numériques tels que type et timeout s’affichent, tandis que chaque commande, URL, matcher et condition if est exportée comme "[REDACTED]"
  Par exemple, les paramètres gérés avec apiKeyHelper, deux variables env et une règle de refus sont exportés comme {"apiKeyHelper":"[REDACTED]","env":{"HTTPS_PROXY":"[REDACTED]","CLAUDE_CODE_ENABLE_TELEMETRY":"[REDACTED]"},"permissions":{"deny":["Read([REDACTED])"]}}. Claude Code coupe la valeur à 8 KB d’UTF-8, et la valeur coupée n’est pas un JSON valide
• managed_settings.settings_truncated (lorsque managed_settings.settings est présent) : true lorsque Claude Code a coupé managed_settings.settings à 8 KB, false sinon. Émis sous forme de booléen, pas de chaîne

​

Interpréter les données de métriques et d’événements

​

Surveillance de l’utilisation

​

Surveillance des coûts

• Suivre les tendances d’utilisation entre les équipes ou les individus
• Identifier les sessions à utilisation élevée pour l’optimisation
• Attribuer les dépenses à des compétences, des plugins ou des types de sous-agents spécifiques via les attributs skill.name, plugin.name, et agent.name

​

Alertes et segmentation

• Pics de coûts
• Consommation de jetons inhabituelle
• Volume de session élevé d’utilisateurs spécifiques

​

Détecter l’épuisement des tentatives

​

Analyse des événements

• Les outils les plus fréquemment utilisés
• Les taux de réussite des outils
• Les temps d’exécution moyens des outils
• Les modèles d’erreur par type d’outil

​

Audit des événements de sécurité

​

Attribuer les actions aux utilisateurs

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

​

Audit de l’activité MCP

• tool_result : conserve mcp_server_scope et un tool_name redacté au littéral "mcp_tool" pour les serveurs configurés par l’utilisateur, omet le contenu des arguments. Pour les serveurs intégrés de Claude Desktop, dans les sessions que Claude Desktop possède, il conserve également la paire mcp_server_name/mcp_tool_name à l’intérieur de tool_parameters, la même exception créée par l’hôte que tool_decision, nécessitant Claude Code v2.1.214 ou ultérieur
• tool_decision : conserve tool_source et un tool_name redacté au littéral "mcp_tool" pour les serveurs configurés par l’utilisateur, omet le contenu des arguments. Pour les serveurs intégrés de Claude Desktop, dans les sessions que Claude Desktop possède, il conserve également la paire mcp_server_name/mcp_tool_name à l’intérieur de tool_parameters ; tool_source et la paire de noms nécessitent tous deux Claude Code v2.1.214 ou ultérieur
• mcp_server_connection : omet server_name et le message d’erreur, mais conserve is_plugin, plugin_id_hash, et plugin.name, avec les noms de plugins non-Anthropic redactés au littéral "third-party", de sorte que les serveurs fournis par les plugins restent distinguables sans journalisation détaillée

​

Mapper les questions de sécurité aux événements

​

Envoyer les événements à un SIEM

{
  "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"
  }
}

​

Considérations relatives aux backends

​

Pour les métriques

• Bases de données de séries chronologiques : Calculs de taux, métriques agrégées
• Magasins colonnaires : Requêtes complexes, analyse d’utilisateurs uniques
• Plates-formes d’observabilité complètes : Requêtes avancées, visualisation, alertes

​

Pour les événements/journaux

• Systèmes d’agrégation de journaux : Recherche en texte intégral, analyse de journaux
• Magasins colonnaires : Analyse d’événements structurés
• Plates-formes d’observabilité complètes : Corrélation entre les métriques et les événements

​

Pour les traces

• Systèmes de traçage distribué : Visualisation d’intervalles, cascades de demandes, analyse de latence
• Plates-formes d’observabilité complètes : Recherche de traces et corrélation avec les métriques et les journaux

​

Informations sur le service

• service.name : claude-code pour les sessions de terminal, claude-code-desktop pour les sessions démarrées à partir de l’onglet Code dans l’application Claude Desktop
• service.version : Version actuelle de Claude Code, ou la version de l’application Desktop pour les sessions de l’onglet Code
• os.type : Type de système d’exploitation (par exemple, linux, darwin, windows)
• os.version : Chaîne de version du système d’exploitation
• host.arch : Architecture de l’hôte (par exemple, amd64, arm64)
• wsl.version : Numéro de version WSL (présent uniquement lors de l’exécution sur Windows Subsystem for Linux)
• Nom du compteur : com.anthropic.claude_code

​

Ressources de mesure du ROI

​

Sécurité et confidentialité

• L’export OpenTelemetry vers votre backend est opt-in et nécessite une configuration explicite. Pour la télémétrie opérationnelle distincte d’Anthropic et comment la désactiver, consultez Utilisation des données
• Les contenus de fichiers bruts et les extraits de code ne sont pas inclus dans les métriques ou les événements. Les intervalles de trace constituent un chemin de données distinct : voir la puce OTEL_LOG_TOOL_CONTENT ci-dessous
• Lorsqu’authentifié via OAuth, user.email est inclus dans les attributs de télémétrie, envoyé uniquement au point de terminaison OTel que vous configurez, jamais à Anthropic. Si cela pose un problème pour votre organisation, travaillez avec votre backend de télémétrie pour filtrer ou masquer ce champ
• Le contenu des invites utilisateur n’est pas collecté par défaut. Seule la longueur de l’invite est enregistrée. Pour inclure le contenu de l’invite, définissez OTEL_LOG_USER_PROMPTS=1. Sous le traçage bêta détaillé, cette variable s’étend au-delà du texte d’invite : elle contrôle également l’attribut d’intervalle new_context, qui porte les résultats d’outil sur l’intervalle claude_code.llm_request
• Le texte de réponse de l’assistant n’est pas collecté par défaut. Seule la longueur de la réponse est enregistrée. Pour inclure le texte de réponse, définissez OTEL_LOG_ASSISTANT_RESPONSES=1. Comme toutes les données OpenTelemetry de Claude Code, le texte de réponse est envoyé uniquement au point de terminaison OTel que vous configurez, jamais à Anthropic. Lorsque cette variable n’est pas définie, OTEL_LOG_USER_PROMPTS est utilisé comme solution de secours, donc définissez OTEL_LOG_ASSISTANT_RESPONSES=0 si vous souhaitez le contenu de l’invite sans contenu de réponse
• Les arguments d’entrée d’outil et les paramètres ne sont pas enregistrés par défaut. Pour les inclure, définissez OTEL_LOG_TOOL_DETAILS=1. Pour les serveurs intégrés de Claude Desktop, dans les sessions que Claude Desktop possède, tool_decision et tool_result portent la paire mcp_server_name/mcp_tool_name, des noms créés par l’hôte plutôt que du contenu d’argument, même avec le drapeau désactivé. L’exception nécessite Claude Code v2.1.214 ou version ultérieure. Ces données sont envoyées uniquement au point de terminaison OTEL que vous configurez, jamais à Anthropic. Les arguments peuvent toujours contenir des valeurs sensibles, donc configurez votre backend de télémétrie pour filtrer ou masquer ces attributs selon les besoins. Lorsqu’activé :
  • Les événements tool_result et tool_decision incluent un attribut tool_parameters avec les commandes Bash, les noms de serveur MCP et d’outil, et les noms de compétences. Les champs tels que full_command sont émis sans troncature
  • Les événements tool_result incluent également un attribut tool_input avec les chemins de fichiers, les URL, les modèles de recherche et d’autres arguments. Les valeurs individuelles dépassant 512 caractères sont tronquées et le total est limité à environ 4 K caractères
  • Les événements user_prompt incluent le command_name verbatim pour les commandes personnalisées, de plugin et MCP
  • Les compteurs de coût et de jeton et les événements api_request, api_error et api_refusal portent les noms réels d’agent, de compétence, de plugin et de serveur MCP et d’outil dans leurs attributs d’attribution
  • Les intervalles de trace incluent le même attribut tool_input et les attributs dérivés de l’entrée tels que file_path, avec la même troncature que tool_input
• Le contenu d’outil n’est pas enregistré dans les intervalles de trace par défaut. Pour l’inclure, définissez OTEL_LOG_TOOL_CONTENT=1. L’intervalle claude_code.tool porte alors un événement d’intervalle tool.output avec les contenus de fichiers bruts, la sortie de commande Bash, et ce que les outils MCP, WebFetch et WebSearch retournent, tronqués à la limite de contenu (60 Ko par défaut) par attribut. Les résultats des outils MCP, WebFetch et WebSearch nécessitent Claude Code v2.1.283 ou version ultérieure. Le contenu d’outil atteint également les intervalles via new_context, dont la porte diffère par intervalle. Configurez votre backend de télémétrie pour filtrer ou masquer ces attributs selon les besoins
• Les corps bruts de la demande et de la réponse de l’API Messages d’Anthropic ne sont pas enregistrés par défaut. Pour les inclure, définissez OTEL_LOG_RAW_API_BODIES dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Il est ignoré dans les paramètres de projet et locaux. Les corps contiennent l’historique complet de la conversation, y compris l’invite système, chaque tour d’utilisateur et d’assistant antérieur, et les résultats d’outils, donc l’activation de cette option implique le consentement à tout ce que les autres drapeaux de contenu OTEL_LOG_* révèleraient. Claude Code masque toujours le contenu de réflexion étendue de Claude de ces corps, indépendamment des autres paramètres. La valeur que vous définissez détermine comment Claude Code livre les corps :
  • Avec =1, Claude Code émet des événements de journaux api_request_body et api_response_body pour chaque appel d’API. L’attribut body des événements porte la charge utile sérialisée en JSON, tronquée à la limite de contenu (60 Ko par défaut)
  • Avec =file:<dir>, Claude Code écrit les corps non tronqués dans les fichiers .request.json et .response.json sous ce répertoire, et les événements portent un chemin body_ref à la place du corps en ligne. Livrez le répertoire avec un collecteur de journaux ou un sidecar plutôt que via le flux de télémétrie. Pour chaque réponse réussie, Claude Code ajoute également une ligne à index.jsonl dans ce répertoire, reliant le fichier de réponse au fichier de demande qui l’a produit et au message de transcription qu’il est devenu. Chaque ligne ne contient aucun contenu de message, et la section événement du corps de réponse API énumère ses champs. Le fichier d’index nécessite Claude Code v2.1.274 ou version ultérieure

​

Surveiller Claude Code sur Amazon Bedrock