Surveillance

Découvrez comment activer et configurer OpenTelemetry pour Claude Code.

Suivez l'utilisation de Claude Code, les coûts et l'activité des outils dans votre organisation en exportant les données de télémétrie via OpenTelemetry (OTel). Claude Code exporte les métriques sous forme de données de séries chronologiques via le protocole de métriques standard, les événements via le protocole de journaux/événements, et optionnellement les traces distribuées via le protocole de traces.

Démarrage rapide

Configurez OpenTelemetry à l'aide de variables d'environnement :

# 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

Pour vérifier une configuration qui exporte des métriques, vérifiez votre backend pour la métrique claude_code.session.count, que Claude Code émet au démarrage d'une session. Pour vérifier une configuration réservée aux journaux, soumettez une invite et vérifiez l'événement claude_code.user_prompt.

Si rien n'arrive, démarrez Claude Code avec claude --debug-file <path> et vérifiez le journal qu'il écrit dans ce chemin. Claude Code signale les défaillances des exportateurs que vous configurez en tant qu'erreurs [3P telemetry], où 3P signifie tiers. Les lignes préfixées par [Anthropic telemetry] décrivent la télémétrie opérationnelle distincte d'Anthropic et n'indiquent pas un problème avec votre configuration.

Pour les options de configuration complètes, consultez la spécification OpenTelemetry.

Configuration de l'administrateur

Les administrateurs peuvent configurer les paramètres OpenTelemetry pour tous les utilisateurs via le fichier de paramètres gérés. Consultez la précédence des paramètres pour plus d'informations sur la façon dont les paramètres sont appliqués.

Exemple de configuration des paramètres gérés :

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

Claude Code ignore les variables d'exportateur OpenTelemetry dans le .claude/settings.json et .claude/settings.local.json d'un référentiel, donc un référentiel ne peut pas les utiliser pour activer la télémétrie, choisir où elle va ou capturer du contenu. Définissez-les dans les paramètres gérés, ou laissez chaque développeur les définir dans son shell ou ~/.claude/settings.json. Un référentiel peut toujours désactiver un signal en définissant son sélecteur d'exportateur, tel que OTEL_LOGS_EXPORTER, sur none, sauf si les paramètres gérés, un fichier --settings ou l'environnement à partir duquel vous lancez Claude Code définit cette variable.

Claude Code ne transmet pas les variables d'environnement OTEL_* aux sous-processus qu'il génère, y compris l'outil Bash, les hooks, les serveurs MCP et les serveurs de langage. Une application instrumentée par OpenTelemetry que vous exécutez via l'outil Bash n'hérite pas du point de terminaison de l'exportateur ou des en-têtes de Claude Code, donc définissez ces variables directement dans la commande si cette application doit exporter sa propre télémétrie.

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

Lorsque vous définissez une variable OTEL_EXPORTER_OTLP_* dans les paramètres gérés, Claude Code supprime les variables conflictuelles définies par les développeurs au démarrage et enregistre un avertissement dans le journal de débogage. Ce qu'il supprime dépend de la variable que vous définissez :

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.

Claude Code ne supprime pas les variables par signal que vous définissez dans les paramètres gérés eux-mêmes, donc vous pouvez router un signal vers un collecteur différent en définissant sa variable là, comme le fait l'exemple SIEM. Si vous définissez un identifiant par signal là, Claude Code supprime le point de terminaison défini par le développeur pour ce signal.

Ce comportement de suppression change où la télémétrie est livrée, pas ce que Claude Code collecte.

Avant v2.1.217, chaque variable suivait la précédence des paramètres par clé indépendamment, donc un point de terminaison spécifique au signal défini dans les paramètres utilisateur ou le shell redirigait ce signal loin du collecteur géré.

Lorsque l'application de bureau ou un exécuteur d'environnement auto-hébergé lance Claude Code et nomme un point de terminaison OTLP dans l'environnement qu'il fournit, Claude Code épingle la destination de la même manière : les variables de télémétrie du lanceur suppriment les variables définies par les développeurs exactement comme le font les paramètres gérés. Claude Code ne supprime pas les variables que le lanceur lui-même a définies. Nécessite Claude Code v2.1.251 ou version ultérieure.

Détails de configuration

Variables de configuration communes

Ces variables configurent les exportateurs, les points de terminaison et le comportement d'export pour tous les déploiements.

Si vous définissez une variable de point de terminaison ou de protocole par signal, comme OTEL_EXPORTER_OTLP_METRICS_ENDPOINT, Claude Code l'utilise à la place de la variable générique pour ce signal. Si vous définissez une variable d'en-têtes par signal, comme OTEL_EXPORTER_OTLP_METRICS_HEADERS, Claude Code la fusionne avec l'en-tête générique OTEL_EXPORTER_OTLP_HEADERS pour ce signal.

Sur les machines avec des paramètres gérés, consultez Comment les paramètres gérés verrouillent la destination OTLP pour voir ce que Claude Code supprime.

Variable d'environnement	Description	Exemples de valeurs
`CLAUDE_CODE_ENABLE_TELEMETRY`	Active la collecte de télémétrie (obligatoire)	`1`
`OTEL_METRICS_EXPORTER`	Types d'exportateurs de métriques, séparés par des virgules. Utilisez `none` pour désactiver	`console`, `otlp`, `prometheus`, `none`
`OTEL_LOGS_EXPORTER`	Types d'exportateurs de journaux/événements, séparés par des virgules. Utilisez `none` pour désactiver	`console`, `otlp`, `none`
`OTEL_EXPORTER_OTLP_PROTOCOL`	Protocole pour l'exportateur OTLP, s'applique à tous les signaux. Claude Code n'a pas de protocole par défaut, donc définissez ceci ou la variable de protocole spécifique au signal pour chaque exportateur `otlp` que vous activez	`grpc`, `http/json`, `http/protobuf`
`OTEL_EXPORTER_OTLP_ENDPOINT`	Point de terminaison du collecteur OTLP pour tous les signaux	`http://localhost:4317`
`OTEL_EXPORTER_OTLP_METRICS_PROTOCOL`	Protocole pour les métriques, remplace le paramètre général	`grpc`, `http/json`, `http/protobuf`
`OTEL_EXPORTER_OTLP_METRICS_ENDPOINT`	Point de terminaison des métriques OTLP, remplace le paramètre général	`http://localhost:4318/v1/metrics`
`OTEL_EXPORTER_OTLP_LOGS_PROTOCOL`	Protocole pour les journaux, remplace le paramètre général	`grpc`, `http/json`, `http/protobuf`
`OTEL_EXPORTER_OTLP_LOGS_ENDPOINT`	Point de terminaison des journaux OTLP, remplace le paramètre général	`http://localhost:4318/v1/logs`
`OTEL_EXPORTER_OTLP_HEADERS`	En-têtes d'authentification pour OTLP	`Authorization=Bearer token`
`OTEL_EXPORTER_OTLP_METRICS_HEADERS`	En-têtes d'authentification pour les métriques, fusionnés avec les en-têtes généraux	`Authorization=Bearer token`
`OTEL_EXPORTER_OTLP_LOGS_HEADERS`	En-têtes d'authentification pour les journaux, fusionnés avec les en-têtes généraux	`Authorization=Bearer token`
`OTEL_METRIC_EXPORT_INTERVAL`	Intervalle d'export en millisecondes (par défaut : 60000)	`5000`, `60000`
`OTEL_LOGS_EXPORT_INTERVAL`	Intervalle d'export des journaux en millisecondes (par défaut : 5000)	`1000`, `10000`
`OTEL_LOG_USER_PROMPTS`	Activer la journalisation du contenu des invites utilisateur (par défaut : désactivé)	`1` pour activer
`OTEL_LOG_ASSISTANT_RESPONSES`	Activer la journalisation du texte de réponse de l'assistant sur les événements `assistant_response` (par défaut : désactivé). Lorsque non défini, revient à la valeur de `OTEL_LOG_USER_PROMPTS`. Nécessite Claude Code v2.1.193 ou ultérieur	`1` pour activer, `0` pour garder masqué
`OTEL_LOG_TOOL_DETAILS`	Activer la journalisation des paramètres d'outils et des arguments d'entrée dans les événements d'outils et les attributs de span de trace : commandes Bash, noms de serveur MCP et d'outils, noms de compétences, noms de flux de travail créés par l'utilisateur et entrée d'outils. Active également les noms de commandes personnalisées, de plugins et MCP sur les événements `user_prompt`, et les noms réels d'agent, de compétence, de plugin et de serveur MCP et d'outils sur les compteurs de coûts et de jetons (par défaut : désactivé). Pour les serveurs intégrés de Claude Desktop, dans les sessions que Claude Desktop possède, `mcp_server_name`/`mcp_tool_name` émettent sur `tool_decision`/`tool_result` même avec l'indicateur désactivé. L'exception nécessite Claude Code v2.1.214 ou ultérieur	`1` pour activer
`OTEL_LOG_TOOL_CONTENT`	Activer la journalisation du contenu des outils dans l'événement de span `tool.output` (par défaut : désactivé). Les attributs de span portent le contenu des outils sous leurs propres portes. Nécessite traçage. Le contenu est tronqué à la limite de contenu (60 Ko par défaut)	`1` pour activer
`OTEL_LOG_MANAGED_SETTINGS`	Ajouter les paramètres gérés masqués et un résumé SHA-256 des paramètres avant masquage aux événements paramètres gérés résolus (par défaut : désactivé). Une valeur dans les paramètres de projet ou locaux ne l'active pas. Nécessite Claude Code v2.1.274 ou ultérieur	`1` pour activer
`OTEL_LOG_RAW_API_BODIES`	Émettre la demande et la réponse JSON complètes de l'API Messages Anthropic en tant qu'événements de journal `api_request_body` / `api_response_body` (par défaut : désactivé). Les corps incluent l'historique complet de la conversation. L'activation de ceci implique le consentement à tout ce que `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS` et `OTEL_LOG_TOOL_CONTENT` révèleraient	`1` pour les corps en ligne tronqués à la limite de contenu (60 Ko par défaut), ou `file:<dir>` pour les corps non tronqués sur disque avec un pointeur `body_ref` dans l'événement
`CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`	Limite de contenu : la longueur maximale des attributs porteurs de contenu tels que les réponses du modèle, le contenu des outils, les invites système et les corps API bruts, marqueur de troncature inclus, en unités de code UTF-16 (par défaut : 61440, c.-à-d. 60 Ko). La valeur par défaut est dimensionnée pour les backends qui limitent les valeurs d'attribut à 64 Ko ; augmentez-la uniquement si votre backend accepte des valeurs plus grandes, ou diminuez-la pour réduire le volume de télémétrie. Lorsqu'une limite d'attribut du SDK OpenTelemetry, `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` ou l'une de ses variantes de journal et de span, est définie plus bas, Claude Code tronque à cette valeur plus petite afin que le marqueur `[TRUNCATED ...]` reste dans la limite du SDK. Nécessite Claude Code v2.1.214 ou ultérieur	`262144`
`OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE`	Préférence de temporalité des métriques (par défaut : `delta`). Définissez sur `cumulative` si votre backend s'attend à une temporalité cumulative	`delta`, `cumulative`
`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`	Intervalle d'actualisation des en-têtes dynamiques (par défaut : 1740000ms / 29 minutes)	`900000`

Pour les protocoles http/protobuf et http/json, Claude Code envoie chaque demande d'export avec un en-tête Content-Length. Avant v2.1.212, les versions de Claude Code à partir de v2.1.191 envoyaient ces demandes avec un codage de transfert fragmenté ; Azure Monitor et d'autres points de terminaison qui nécessitent une longueur déclarée les rejetaient avec des erreurs 411 Length Required ou 400.

Authentification mTLS

La façon dont vous configurez les certificats clients pour l'exportateur OTLP dépend du protocole OTLP utilisé pour ce signal, défini via OTEL_EXPORTER_OTLP_PROTOCOL ou le remplacement spécifique au signal. La même configuration s'applique aux métriques, journaux et traces.

Protocole	Variables de certificat client	Faire confiance au CA du collecteur avec
`http/protobuf`, `http/json`	`CLAUDE_CODE_CLIENT_CERT`, `CLAUDE_CODE_CLIENT_KEY` et optionnellement `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`. Voir Configuration réseau	`NODE_EXTRA_CA_CERTS`
`grpc`	`OTEL_EXPORTER_OTLP_CLIENT_KEY` et `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`, ou les variantes spécifiques au signal telles que `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY` pour utiliser un certificat différent par signal	`OTEL_EXPORTER_OTLP_CERTIFICATE`

Pour grpc, le SDK OpenTelemetry lit les variables OTLP standard directement, donc les configurations existantes qui définissent les variables de métriques spécifiques au signal continuent de fonctionner. Sur les machines avec des paramètres gérés, Claude Code peut supprimer les identifiants et points de terminaison spécifiques au signal définis par le développeur au démarrage.

Contrôle de la cardinalité des métriques

Les variables d'environnement suivantes contrôlent les attributs inclus dans les métriques pour gérer la cardinalité :

Variable d'environnement	Description	Valeur par défaut	Exemple pour désactiver
`OTEL_METRICS_INCLUDE_SESSION_ID`	Inclure les attributs session.id et, sur les sessions cloud, ccr.session.id dans les métriques	`true`	`false`
`OTEL_METRICS_INCLUDE_VERSION`	Inclure l'attribut app.version dans les métriques	`false`	`true`
`OTEL_METRICS_INCLUDE_ACCOUNT_UUID`	Inclure les attributs user.account_uuid et user.account_id dans les métriques	`true`	`false`
`OTEL_METRICS_INCLUDE_ENTRYPOINT`	Inclure l'attribut app.entrypoint dans les métriques	`false`	`true`
`OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES`	Inclure les clés de `OTEL_RESOURCE_ATTRIBUTES` comme attributs sur les points de données de métriques	`true`	`false`
`OTEL_METRICS_INCLUDE_REPOSITORY`	Inclure les attributs d'identité de référentiel `vcs.*` sur les métriques et événements. Nécessite Claude Code v2.1.269 ou ultérieur	`false`	`true`

Une cardinalité plus basse signifie généralement de meilleures performances et des coûts de stockage plus bas, mais des données moins granulaires pour l'analyse.

Traces (bêta)

Le traçage distribué exporte des spans qui lient chaque invite utilisateur aux demandes API et exécutions d'outils qu'elle déclenche, afin que vous puissiez afficher une demande complète sous forme d'une seule trace dans votre backend de traçage.

Le traçage est désactivé par défaut. Pour l'activer, définissez à la fois CLAUDE_CODE_ENABLE_TELEMETRY=1 et CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1, puis définissez OTEL_TRACES_EXPORTER pour choisir où les spans sont envoyés. Les traces réutilisent la configuration OTLP commune pour le point de terminaison, le protocole, les en-têtes et mTLS. Sur les machines avec des paramètres gérés, Claude Code peut supprimer les identifiants et points de terminaison spécifiques au signal définis par le développeur au démarrage.

Variable d'environnement	Description	Exemples de valeurs
`CLAUDE_CODE_ENHANCED_TELEMETRY_BETA`	Activer le traçage des spans (obligatoire). `ENABLE_ENHANCED_TELEMETRY_BETA` est également accepté	`1`
`OTEL_TRACES_EXPORTER`	Types d'exportateurs de traces, séparés par des virgules. Utilisez `none` pour désactiver	`console`, `otlp`, `none`
`OTEL_EXPORTER_OTLP_TRACES_PROTOCOL`	Protocole pour les traces, remplace `OTEL_EXPORTER_OTLP_PROTOCOL`	`grpc`, `http/json`, `http/protobuf`
`OTEL_EXPORTER_OTLP_TRACES_ENDPOINT`	Point de terminaison des traces OTLP, remplace `OTEL_EXPORTER_OTLP_ENDPOINT`	`http://localhost:4318/v1/traces`
`OTEL_EXPORTER_OTLP_TRACES_HEADERS`	En-têtes d'authentification pour les traces, fusionnés avec `OTEL_EXPORTER_OTLP_HEADERS`	`Authorization=Bearer token`
`OTEL_TRACES_EXPORT_INTERVAL`	Intervalle d'export de lot de spans en millisecondes (par défaut : 5000)	`1000`, `10000`

Les spans masquent le texte de l'invite utilisateur, les détails d'entrée des outils et le contenu des outils par défaut. Définissez OTEL_LOG_USER_PROMPTS=1, OTEL_LOG_TOOL_DETAILS=1 et OTEL_LOG_TOOL_CONTENT=1 pour les inclure.

Lorsque le traçage est actif, les sous-processus Bash et PowerShell héritent automatiquement d'une variable d'environnement TRACEPARENT contenant le contexte de trace W3C du span d'exécution d'outil actif. Cela permet à tout sous-processus qui lit TRACEPARENT de placer ses propres spans sous la même trace, permettant le traçage distribué de bout en bout à travers les scripts et commandes que Claude exécute.

Lorsque le traçage est actif et que Claude Code est connecté directement à l'API Anthropic, chaque demande de modèle porte un en-tête W3C traceparent défini sur le contexte du span claude_code.llm_request, et l'en-tête traceresponse de l'API est enregistré comme un lien de span. Ensemble, ceux-ci connectent les spans côté client de Claude Code à la trace côté serveur via tout intermédiaire conforme. Les demandes HTTP MCP sortantes portent traceparent de la même manière. L'en-tête n'est pas envoyé aux fournisseurs tiers.

Par défaut, l'en-tête traceparent sur les demandes de modèle et MCP HTTP n'est envoyé que lorsque ANTHROPIC_BASE_URL n'est pas défini ou pointe vers l'API Anthropic, car certains proxies rejettent les en-têtes non reconnus. La variable TRACEPARENT du sous-processus est contrôlée par le même commutateur pour la cohérence. Si vous exécutez Claude Code via un proxy ANTHROPIC_BASE_URL personnalisé et souhaitez que le contexte de trace soit propagé, définissez CLAUDE_CODE_PROPAGATE_TRACEPARENT=1.

Dans le SDK Agent et les sessions non interactives démarrées avec -p, Claude Code lit également TRACEPARENT et TRACESTATE de son propre environnement au démarrage de chaque span d'interaction. Cela permet à un processus d'intégration de transmettre son contexte de trace W3C actif au sous-processus afin que les spans de Claude Code apparaissent comme des enfants de la trace distribuée de l'appelant. Les sessions interactives ignorent TRACEPARENT entrant pour éviter d'hériter accidentellement de valeurs ambiantes de CI ou d'environnements de conteneur.

Le contexte de trace entrant s'applique également aux événements. Dans les sessions SDK Agent et -p avec TRACEPARENT défini, chaque enregistrement de journal d'événement OTLP porte les valeurs trace_id et span_id qui le joignent à la trace de votre application, même lorsque l'exportateur de traces n'est pas configuré, afin que votre backend de journalisation puisse corréler les événements avec le reste de la trace.

Un enregistrement émis pendant qu'une interaction est active porte les ID du span d'interaction, même lorsque Claude Code l'émet en dehors du contexte asynchrone du span, comme dans un rappel d'invite de permission ou pour un enregistrement mis en mémoire tampon au démarrage et exporté ultérieurement. Un enregistrement émis sans span d'interaction actif porte directement les ID TRACEPARENT entrants. Avant v2.1.214, les enregistrements émis en dehors du contexte asynchrone du span portaient les ID TRACEPARENT entrants à la place des ID du span. Avant v2.1.212, les enregistrements d'événements émis en dehors d'un span actif ne portaient pas trace_id ou span_id.

Hiérarchie des spans

Chaque invite utilisateur démarre un span racine claude_code.interaction. Les appels API, les appels d'outils et les exécutions de hooks sont enregistrés comme ses enfants. Les spans d'outils ont deux spans enfants : un pour le temps passé à attendre une décision de permission et un pour l'exécution elle-même. Lorsque l'outil Agent ou l'outil Task hérité génère un sous-agent, les spans API et d'outils du sous-agent s'imbriquent sous le span claude_code.tool du parent.

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

Dans les sessions SDK Agent et claude -p, claude_code.interaction lui-même devient un enfant du span de l'appelant lorsque TRACEPARENT est défini dans l'environnement.

Lorsqu'un hook PreToolUse reporte un appel d'outil, Claude Code enregistre le contexte de trace du tour qui l'a reporté. Lorsque vous reprenez la session et que l'outil s'exécute à nouveau, les spans de l'outil rejoignent la trace du tour antérieur en tant qu'enfants du span claude_code.interaction du tour.

Attributs des spans

Chaque span porte les attributs standard plus un attribut span.type correspondant à son nom. Les tableaux ci-dessous énumèrent les attributs supplémentaires définis sur chaque span. Les spans llm_request, tool.execution et hook définissent le statut OpenTelemetry ERROR lorsqu'ils enregistrent un échec ; les autres spans se terminent toujours avec le statut UNSET.

claude_code.interaction

Attribut	Description	Contrôlé par
`user_prompt`	Texte de l'invite. La valeur est `<REDACTED>` sauf si la porte est définie	`OTEL_LOG_USER_PROMPTS`
`user_prompt_length`	Longueur de l'invite en caractères
`interaction.sequence`	Compteur basé sur 1 des interactions, compté par processus Claude Code plutôt que par session, comme décrit pour `event.sequence`
`parent.source`	Comment le span a obtenu son parent de trace : `env` lorsqu'il a été parent sous un `TRACEPARENT` entrant, `none` lorsqu'il a démarré sa propre trace. Nécessite Claude Code v2.1.268 ou ultérieur
`interaction.duration_ms`	Durée murale du tour

claude_code.llm_request

Attribut	Description	Contrôlé par
`model`	Identifiant du modèle
`gen_ai.system`	Toujours `anthropic`. Convention sémantique OpenTelemetry GenAI
`gen_ai.request.model`	Même valeur que `model`. Convention sémantique OpenTelemetry GenAI
`query_source`	Sous-système qui a émis la demande, comme `repl_main_thread` ou un nom de sous-agent	`ENABLE_BETA_TRACING_DETAILED`
`query_source_safe`	Forme bornée de `query_source`, émise que le traçage bêta détaillé soit actif ou non, avec des valeurs telles que `repl_main_thread` ou `agent.builtin.general-purpose`. `:` devient `.` et les agents nommés par l'utilisateur apparaissent comme `agent.custom`. Nécessite Claude Code v2.1.268 ou ultérieur
`agent_id`	Identifiant du sous-agent ou du coéquipier qui a émis la demande. Absent sur la session principale
`parent_agent_id`	Identifiant de l'agent qui a généré celui-ci. Absent pour la session principale et pour les agents générés directement à partir de celle-ci
`workflow.run_id`	Identifiant d'exécution de l'exécution de l'outil Workflow qui a généré cet agent, préfixé `wf_`. Absent pour les agents non générés par un flux de travail
`workflow.name`	Nom du flux de travail qui a généré cet agent. Les noms créés par l'utilisateur sont remplacés par `custom` sauf si la porte est définie	`OTEL_LOG_TOOL_DETAILS`
`speed`	`fast` ou `normal`
`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 le supporte pas. Nécessite Claude Code v2.1.274 ou ultérieur
`llm_request.context`	`interaction`, `tool` ou `standalone` selon le span parent
`duration_ms`	Durée murale incluant les tentatives
`ttft_ms`	Temps jusqu'au premier jeton en millisecondes
`first_content_ms`	Temps du début de la demande au premier bloc de contenu de la tentative réussie, en millisecondes. Absent sur les demandes qui sont revenues au chemin non-streaming. Nécessite Claude Code v2.1.268 ou ultérieur
`input_tokens`	Nombre de jetons d'entrée du bloc d'utilisation de l'API
`output_tokens`	Nombre de jetons de sortie
`cache_read_tokens`	Jetons lus du cache d'invite
`cache_creation_tokens`	Jetons écrits dans le cache d'invite
`request_id`	ID de demande API. Même valeur que l'attribut de corrélation d'événement `request_id`
`gen_ai.response.id`	Même valeur que `request_id`. Convention sémantique OpenTelemetry GenAI
`client_request_id`	`x-client-request-id` généré par le client de la tentative finale
`attempt`	Nombre total de tentatives pour cette demande
`success`	`true` ou `false`
`status_code`	Code de statut HTTP lorsque la demande a échoué
`error`	Message d'erreur lorsque la demande a échoué
`error_class`	Jeton de classe d'erreur court lorsque la demande a échoué, comme `api_timeout` ou `server_overload`. Nécessite Claude Code v2.1.268 ou ultérieur
`response.has_tool_call`	`true` lorsque la réponse contenait des blocs d'utilisation d'outils
`stop_reason`	`stop_reason` de réponse API, comme `end_turn`, `tool_use`, `max_tokens`, `stop_sequence`, `pause_turn` ou `refusal`
`gen_ai.response.finish_reasons`	Même valeur que `stop_reason`, enveloppée dans un tableau de chaînes. Convention sémantique OpenTelemetry GenAI

Chaque tentative de nouvelle tentative est également enregistrée en tant qu'événement de span gen_ai.request.attempt avec les attributs attempt et client_request_id.

claude_code.tool

Attribut	Description	Contrôlé par
`tool_name`	Nom de l'outil
`tool_name_safe`	Forme de `tool_name` qui ne porte aucun nom choisi par l'utilisateur. Les noms d'outils intégrés passent verbatim. Les noms d'outils MCP apparaissent comme `mcp_other`, sauf les noms d'outils correspondant à quelques formes fixes, comme les outils `playwright` nommés `browser_*`, qui passent verbatim. Nécessite Claude Code v2.1.268 ou ultérieur
`bash_command_class`	Pour l'outil Bash : catégorie du premier programme de la commande à partir d'une liste fixe, comme `vcs` ou `package_manager`. `other` pour un programme en dehors de la liste, `unparsed` lorsque la ligne ne peut pas être analysée. Nécessite Claude Code v2.1.268 ou ultérieur
`bash_argv0`	Pour l'outil Bash : le premier programme de la commande lorsqu'il est sur la même liste fixe, comme `git` ou `npm`. `other` pour tout programme en dehors de la liste. Nécessite Claude Code v2.1.268 ou ultérieur
`duration_ms`	Durée murale incluant l'attente de permission et l'exécution
`result_tokens`	Taille approximative en jetons du résultat de l'outil
`agent_id`	Identifiant du sous-agent ou du coéquipier qui a exécuté l'outil. Absent sur la session principale
`parent_agent_id`	Identifiant de l'agent qui a généré celui-ci. Absent pour la session principale et pour les agents générés directement à partir de celle-ci
`workflow.run_id`	Identifiant d'exécution de l'exécution de l'outil Workflow qui a généré cet agent, préfixé `wf_`. Absent pour les agents non générés par un flux de travail
`workflow.name`	Nom du flux de travail qui a généré cet agent. Les noms créés par l'utilisateur sont remplacés par `custom` sauf si la porte est définie	`OTEL_LOG_TOOL_DETAILS`
`tool_use_id`	L'ID du bloc `tool_use` du modèle pour cet appel. Correspond au `tool_use_id` sur les événements tool_result et tool_decision et dans les charges utiles de hooks, afin que vous puissiez joindre le span à ces enregistrements
`gen_ai.tool.call.id`	Même valeur que `tool_use_id`. Convention sémantique OpenTelemetry GenAI
`file_path`	Chemin de fichier cible pour les outils Read, Edit et Write	`OTEL_LOG_TOOL_DETAILS`
`full_command`	Chaîne de commande pour l'outil Bash	`OTEL_LOG_TOOL_DETAILS`
`skill_name`	Nom de la compétence pour l'outil Skill	`OTEL_LOG_TOOL_DETAILS`
`subagent_type`	Type de sous-agent pour l'outil Agent ou l'outil Task hérité	`OTEL_LOG_TOOL_DETAILS`

Événement de span tool.output sur claude_code.tool

Si vous définissez OTEL_LOG_TOOL_CONTENT=1, les appels Read et Bash peuvent enregistrer un événement de span tool.output sur le span claude_code.tool. Les appels Edit et Write en enregistrent un uniquement lorsque vous définissez également OTEL_LOG_TOOL_DETAILS=1. Cette variable n'est pas limitée à ces deux outils, donc vérifiez sa ligne dans le tableau de configuration pour les arguments qu'elle ajoute ailleurs.

Les outils MCP, WebFetch et WebSearch enregistrent également cet événement, sur Claude Code v2.1.283 ou ultérieur.

Claude Code écrit cet événement à partir du retour réussi d'un appel d'outil, donc un appel qui lève une erreur n'enregistre rien, quel que soit l'outil. Parmi les appels qui retournent, il n'enregistre aucun événement tool.output pour :

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

L'événement porte ces attributs, chacun tronqué à la limite de contenu (60 Ko par défaut). Contrôlé par nomme la variable dont un attribut a besoin en plus de OTEL_LOG_TOOL_CONTENT=1, et pour Edit et Write cette variable contrôle l'événement lui-même plutôt que l'attribut.

Attribut	Description	Contrôlé par
`content`	Texte que l'outil Read a retourné, ou le texte qu'un appel Write a été demandé d'écrire	`OTEL_LOG_TOOL_DETAILS` pour l'outil Write
`output`	Pour l'outil Bash, la sortie combinée de la commande, avec stderr entrelacé dans stdout. Pour un outil MCP, WebFetch ou WebSearch, le résultat que l'outil a retourné : blocs de texte joints par des sauts de ligne, avec une image ou un document remplacé par un espace réservé comme `[image]`
`diff`	Correctif structuré que l'outil Edit a appliqué	`OTEL_LOG_TOOL_DETAILS`
`file_path`	Chemin de fichier cible pour les outils Read, Edit et Write, répétant l'attribut de span du même nom	`OTEL_LOG_TOOL_DETAILS`
`bash_command`	Chaîne de commande pour l'outil Bash	`OTEL_LOG_TOOL_DETAILS`

L'attribut tool_name du span parent vous indique quel outil un événement provient. Un attribut coupé à la limite de contenu est accompagné de <attribute>_truncated et <attribute>_original_length.

claude_code.tool.blocked_on_user

Attribut	Description	Contrôlé par
`duration_ms`	Temps passé à attendre la décision de permission
`decision`	`accept` ou `reject`
`source`	Source de décision, correspondant à l'événement de décision d'outil

claude_code.tool.execution

Attribut	Description	Contrôlé par
`duration_ms`	Temps passé à exécuter le corps de l'outil
`tool_use_id`	Même valeur que sur le span parent `claude_code.tool`
`gen_ai.tool.call.id`	Même valeur que `tool_use_id`. Convention sémantique OpenTelemetry GenAI
`success`	`true` ou `false`
`error`	Chaîne de catégorie d'erreur lorsque l'exécution a échoué, comme `Error:ENOENT` ou `ShellError`. Contient le message d'erreur complet à la place lorsque la porte est définie	`OTEL_LOG_TOOL_DETAILS`
`error_class`	La catégorie d'erreur sous forme d'identifiant, avec les caractères en dehors des lettres, chiffres et traits de soulignement remplacés par `_`, comme `Error_ENOENT` ou `ShellError`. Porte la catégorie même lorsque `error` porte le message complet. Nécessite Claude Code v2.1.268 ou ultérieur

claude_code.hook

Ce span n'apparaît que lorsque le traçage bêta détaillé est actif, ce qui nécessite ENABLE_BETA_TRACING_DETAILED=1 et BETA_TRACING_ENDPOINT, une paire qui change également où vos journaux et traces vont. Définissez la paire dans votre shell, vos paramètres utilisateur ou vos paramètres gérés ; les deux variables sont ignorées dans les paramètres de projet et locaux. CLAUDE_CODE_ENHANCED_TELEMETRY_BETA seul ne le produit pas.

Dans les sessions CLI interactives, le traçage bêta détaillé nécessite également que votre organisation soit sur la liste blanche pour la fonctionnalité. Les sessions SDK Agent et non interactives -p ne nécessitent pas de liste blanche.

Attribut	Description	Contrôlé par
`hook_event`	Type d'événement de hook, comme `PreToolUse`
`hook_name`	Nom complet du hook, comme `PreToolUse:Write`
`num_hooks`	Nombre de commandes de hook correspondantes exécutées
`hook_definitions`	Configuration de hook sérialisée en JSON	`OTEL_LOG_TOOL_DETAILS`
`duration_ms`	Durée murale de tous les hooks correspondants
`num_success`	Nombre de hooks qui se sont terminés avec succès
`num_blocking`	Nombre de hooks qui ont retourné une décision de blocage
`num_non_blocking_error`	Nombre de hooks qui ont échoué sans bloquer
`num_cancelled`	Nombre de hooks annulés avant la fin

Note

Les attributs supplémentaires porteurs de contenu tels que new_context, system_prompt_preview, user_system_prompt, tool_input et response.model_output ne sont émis que lorsque le traçage bêta détaillé est actif. Ils ne font pas partie du schéma de span stable.

La porte sur new_context dépend du span qui le porte, et chaque copie est tronquée à la limite de contenu (60 Ko par défaut). Sur le span claude_code.tool, il porte le résultat de cet appel d'outil, quel que soit l'outil, et nécessite OTEL_LOG_TOOL_CONTENT=1. Sur le span claude_code.interaction, il porte l'invite utilisateur, et sur le span claude_code.llm_request, les nouveaux messages utilisateur et résultats d'outils de cette demande. Les deux nécessitent OTEL_LOG_USER_PROMPTS=1.

user_system_prompt nécessite en outre OTEL_LOG_USER_PROMPTS=1. Il porte uniquement le texte d'invite système que vous fournissez via l'option SDK systemPrompt ou les drapeaux --system-prompt et --append-system-prompt, tronqué à la limite de contenu (60 Ko par défaut), et est émis une fois par session plutôt que par demande.

En-têtes dynamiques

Pour les environnements d'entreprise qui nécessitent une authentification dynamique, vous pouvez configurer un script pour générer des en-têtes dynamiquement. Les en-têtes dynamiques s'appliquent uniquement aux protocoles http/protobuf et http/json. Avec le protocole grpc, Claude Code utilise uniquement les variables d'en-têtes statiques, OTEL_EXPORTER_OTLP_HEADERS et ses variantes spécifiques au signal.

Configuration des paramètres

Ajoutez à votre .claude/settings.json, en remplaçant le chemin par votre propre script :

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

La valeur peut être le chemin d'un fichier exécutable, y compris un chemin contenant des espaces, ou une ligne de commande shell avec des arguments. Sur Windows, la valeur s'exécute toujours via le shell, donc mettez entre guillemets un chemin contenant des espaces à l'intérieur de la valeur JSON.

Exigences du script

Le script doit produire un JSON valide avec des paires clé-valeur de chaîne représentant les en-têtes HTTP :

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

Si l'assistant échoue ou imprime une sortie qui ne répond pas à ces exigences, les exports échouent et votre backend de télémétrie ne reçoit rien de la session jusqu'à ce que l'assistant fonctionne à nouveau. Claude Code signale l'échec dans :

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

Le script d'assistant d'en-têtes s'exécute au démarrage et périodiquement par la suite pour prendre en charge l'actualisation des jetons. Par défaut, le script s'exécute toutes les 29 minutes. Personnalisez l'intervalle avec la variable d'environnement CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS.

Support des organisations multi-équipes

Les organisations avec plusieurs équipes ou départements peuvent ajouter des attributs personnalisés pour distinguer les différents groupes en utilisant la variable d'environnement OTEL_RESOURCE_ATTRIBUTES :

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

Ces attributs personnalisés sont inclus dans toutes les métriques et événements, ce qui vous permet de :

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

Claude Code attache ces valeurs comme attributs sur chaque point de données de métrique et enregistrement d'événement, en plus de les envoyer dans le bloc de ressource OTLP. Parce que la plupart des backends de métriques exposent les attributs de point de données comme des étiquettes interrogeables, vous pouvez regrouper et filtrer les métriques par vos clés personnalisées directement. À l'exception des attributs de référentiel vcs.*, les clés personnalisées ne remplacent jamais les attributs standard tels que user.id ou session.id : lorsqu'une clé entre en collision, Claude Code conserve la valeur intégrée.

Chaque clé personnalisée devient une étiquette sur chaque série de métriques, donc les valeurs de cardinalité élevée augmentent le coût de stockage dans votre backend de métriques. Pour envoyer des attributs personnalisés dans le bloc de ressource uniquement et les omettre des étiquettes de point de données, définissez OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES=false. Voir Contrôle de la cardinalité des métriques.

Warning

La variable d'environnement OTEL_RESOURCE_ATTRIBUTES utilise des paires clé=valeur séparées par des virgules avec des exigences de formatage strictes :

Aucun espace autorisé : les valeurs ne peuvent pas contenir d'espaces. Par exemple, user.organizationName=My Company est invalide
Format : doit être des paires clé=valeur séparées par des virgules : key1=value1,key2=value2
Caractères autorisés : uniquement les caractères US-ASCII à l'exclusion des caractères de contrôle, des espaces, des guillemets doubles, des virgules, des points-virgules et des barres obliques inverses
Caractères spéciaux : les caractères en dehors de la plage autorisée doivent être codés en pourcentage

Pour une valeur qui aurait besoin d'un espace, utilisez des traits de soulignement ou camelCase à la place. Les exemples suivants définissent org.name avec chaque forme :

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

Vous pouvez coder en pourcentage n'importe quel caractère, pas seulement les caractères exclus. Cet exemple code à la fois l'espace et l'apostrophe :

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

L'enveloppe des valeurs entre guillemets n'échappe pas aux espaces. Par exemple, org.name="My Company" résulte en la valeur littérale "My Company" avec les guillemets inclus, pas My Company.

Exemples de configurations

Définissez ces variables d'environnement avant d'exécuter claude. Chaque scénario ci-dessous montre une configuration complète, et chaque variable est décrite sous Variables de configuration communes. Pour confirmer qu'une configuration a pris effet, vérifiez votre backend pour la métrique claude_code.session.count après le démarrage d'une session ; le Démarrage rapide couvre la vérification en logs uniquement et ce qu'il faut vérifier lorsque rien n'arrive.

Pour le débogage de console avec un intervalle d'export d'une seconde :

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

Pour OTLP sur 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

Pour Prometheus, récupéré à partir de http://localhost:9464/metrics :

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=prometheus

Sur un environnement auto-hébergé, la session lie le port 9464 uniquement à la capacité par défaut du runner d'une. À une capacité plus élevée, le runner réexpose les compteurs et jauges de session sur son propre point de terminaison /metrics à la place.

Pour envoyer des métriques à plusieurs exportateurs :

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

Pour envoyer des métriques et des journaux à différents points de terminaison ou backends :

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

Pour exporter uniquement les métriques, sans événements ni journaux :

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

Pour exporter uniquement les événements et journaux, sans métriques :

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

Les sessions cloud, y compris les sessions du canal Claude Tag, s'exécutent dans des environnements cloud plutôt que sur les appareils de vos utilisateurs, donc un fichier de paramètres gérés ou un profil shell sur ces appareils ne configure pas leur télémétrie. Pour les sessions dans les environnements hébergés par Anthropic, cette section couvre l'endroit où définir les variables de télémétrie, comment rendre votre collecteur accessible à partir de l'environnement, et comment distinguer les sessions cloud et Claude Tag dans les données exportées.

Pour exporter la télémétrie de ces sessions, définissez CLAUDE_CODE_ENABLE_TELEMETRY et les variables OTEL_*, en utilisant les mêmes clés que l'exemple de configuration administrateur, dans l'un des deux endroits suivants :

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.

Quiconque utilise un environnement peut lire ses variables, donc ne mettez pas une credential là, comme un jeton de collecteur dans OTEL_EXPORTER_OTLP_HEADERS. Une credential API sur l'environnement n'aide pas non plus, car l'export de télémétrie propre de Claude Code est l'une des requêtes qui ne reçoivent jamais la credential. Si votre collecteur nécessite une credential, configurez l'export entier via les paramètres gérés par le serveur à la place, car lorsque vous définissez une credential là, Claude Code supprime les variables de point de terminaison définies en dehors des paramètres gérés.

Gardez ces contraintes à l'esprit lorsque vous configurez la télémétrie pour les sessions cloud :

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

Par défaut, les métriques et les événements d'une session cloud portent les attributs standard, y compris session.id, ccr.session.id, et organization.id, afin que vous puissiez filtrer par session ou organisation sans configuration supplémentaire. La valeur ccr.session.id est le CLAUDE_CODE_REMOTE_SESSION_ID de la session. Pour le transformer en URL de transcription de la session, voir Lier la sortie à la session.

Pour attribuer la télémétrie plus en détail, utilisez ces options :

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.

Dans les sessions du canal Claude Tag, Claude fonctionne comme l'identité partagée de votre organisation plutôt que comme n'importe quel membre, donc ne vous fiez pas aux attributs user.* pour identifier qui a tagué Claude.

Métriques et événements disponibles

Attributs standard

Toutes les métriques et tous les événements partagent ces attributs standard :

Attribut	Description	Contrôlé par
`session.id`	Identifiant de session unique	`OTEL_METRICS_INCLUDE_SESSION_ID` (par défaut : true)
`ccr.session.id`	Identifiant de session cloud, la valeur de `CLAUDE_CODE_REMOTE_SESSION_ID`, sur les sessions qui s'exécutent dans un environnement cloud	`OTEL_METRICS_INCLUDE_SESSION_ID` (par défaut : true)
`app.version`	Version actuelle de Claude Code	`OTEL_METRICS_INCLUDE_VERSION` (par défaut : false)
`app.entrypoint`	Comment la session a été lancée, par exemple `cli`, `sdk-cli`, `sdk-ts`, `sdk-py`, `claude-vscode`, ou `claude-in-slack` pour les sessions Claude Tag	`OTEL_METRICS_INCLUDE_ENTRYPOINT` (par défaut : false)
`organization.id`	UUID d'organisation (lorsqu'authentifié)	Toujours inclus lorsque disponible
`user.account_uuid`	UUID de compte (lorsqu'authentifié)	`OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (par défaut : true)
`user.account_id`	ID de compte au format balisé correspondant aux API d'administration Anthropic (lorsqu'authentifié), par exemple `user_01BWBeN28...`	`OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (par défaut : true)
`user.id`	Identifiant anonyme aléatoire généré à la première exécution et persisté dans `~/.claude.json`. Il ne contient aucune information personnelle et n'est pas dérivé de votre compte Claude. La suppression du fichier produit une nouvelle valeur sans rapport à la prochaine exécution.	Toujours inclus
`user.email`	Adresse e-mail de l'utilisateur, de votre connexion ou, dans une session cloud, des identifiants de la session elle-même	Toujours inclus lorsque disponible
`terminal.type`	Type de terminal, par exemple `iTerm.app`, `vscode`, `cursor`, ou `tmux`	Toujours inclus lorsque détecté
Clés de `OTEL_RESOURCE_ATTRIBUTES`	Attributs personnalisés que vous définissez, par exemple `department` ou `team.id`. Voir Support des organisations multi-équipes	`OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (par défaut : true)
`vcs.repository.url.full`, `vcs.owner.name`, `vcs.repository.name`, `vcs.provider.name`	L'identité du référentiel de la session, dérivée de sa télécommande `origin`. Voir Attributs du référentiel	`OTEL_METRICS_INCLUDE_REPOSITORY` (par défaut : false). Nécessite Claude Code v2.1.269 ou ultérieur

Lorsque Claude Code est connecté à une passerelle d'applications Claude, la CLI marque les exportations avec l'identité authentifiée de la session de la passerelle : user.id est le sujet IdP plutôt qu'un identifiant d'installation anonyme, user.email est l'e-mail connecté, et user.groups porte l'appartenance au groupe IdP sous forme de chaîne séparée par des virgules. Chaque exportation porte également identity.source: gateway-oidc. L'identité de la passerelle est appliquée en dernier, donc les clés user.* et identity.* définies via OTEL_RESOURCE_ATTRIBUTES sont ignorées sur les sessions de passerelle.

Les événements incluent en outre les attributs suivants. Ceux-ci ne sont jamais attachés aux métriques car ils causeraient une cardinalité illimitée :

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

Définissez OTEL_METRICS_INCLUDE_REPOSITORY=true pour baliser les métriques et les événements avec l'identité du référentiel de la session, afin qu'un collecteur partagé puisse attribuer l'utilisation par référentiel. Nécessite Claude Code v2.1.269 ou ultérieur.

Claude Code dérive ces attributs une fois par session à partir de la télécommande origin du référentiel. Lorsque les télécommandes HTTPS et SSH d'un référentiel nomment le même hôte et le même chemin, comme c'est le cas sur GitHub, GitLab et Bitbucket Cloud, les deux produisent des valeurs identiques :

Attribut	Valeur
`vcs.repository.url.full`	L'URL du navigateur du référentiel sans `.git`, par exemple `https://github.com/example-org/example-repo`
`vcs.owner.name`	Le chemin du propriétaire ou du groupe, par exemple `example-org` ; omis lorsque le chemin distant a un seul segment
`vcs.repository.name`	Le nom du référentiel nu, par exemple `example-repo`
`vcs.provider.name`	`github`, `gitlab`, `bitbucket`, ou `gitea` lorsque Claude Code reconnaît l'hôte distant ou la forme d'URL comme l'un de ces fournisseurs ; omis sinon

Les valeurs sont en minuscules, et les identifiants, les chaînes de requête et les fragments de l'URL distante n'y apparaissent jamais. Les attributs sont omis lorsque la session n'a pas de télécommande origin, lorsque la télécommande n'a pas la forme d'une URL, ou lorsque le seul référentiel englobant est votre répertoire personnel.

Pour obtenir ces attributs à partir d'une session cloud, définissez les variables de télémétrie, y compris OTEL_METRICS_INCLUDE_REPOSITORY, sur son environnement cloud. Autorisez également le domaine de votre collecteur dans l'accès réseau de l'environnement.

Une clé vcs.* que vous déclarez dans OTEL_RESOURCE_ATTRIBUTES remplace la valeur dérivée pour cette clé. Si vous déclarez vcs.repository.url.full, Claude Code ne lit jamais la télécommande et signale uniquement les clés que vous déclarez.

Si les clones HTTPS et SSH d'un référentiel signalent des valeurs différentes, par exemple sur une installation auto-hébergée dont l'URL de clone HTTPS porte un préfixe de chemin que l'URL SSH n'a pas, déclarez vcs.repository.url.full dans OTEL_RESOURCE_ATTRIBUTES ainsi que toute autre clé vcs.* que vous souhaitez signaler. Chaque clone signale alors l'identité que vous déclarez.

Les attributs ne circulent que vers vos propres exportateurs ; la télémétrie d'Anthropic supprime chaque clé vcs.*.

Métriques

Claude Code exporte les métriques suivantes. La colonne Unité affiche la chaîne d'unité OpenTelemetry attachée à chaque métrique ; les métriques de comptage n'en ont aucune.

Nom de la métrique	Description	Unité
`claude_code.session.count`	Nombre de sessions CLI démarrées	aucune
`claude_code.lines_of_code.count`	Nombre de lignes de code modifiées	aucune
`claude_code.pull_request.count`	Nombre de demandes de tirage créées	aucune
`claude_code.commit.count`	Nombre de commits git créés	aucune
`claude_code.cost.usage`	Coût de la session Claude Code	USD
`claude_code.token.usage`	Nombre de jetons utilisés	tokens
`claude_code.code_edit_tool.decision`	Nombre de décisions de permission de l'outil d'édition de code	aucune
`claude_code.active_time.total`	Temps actif total	s

Lorsque prometheus est le seul exportateur listé dans OTEL_METRICS_EXPORTER, Claude Code omet les unités USD, tokens et s des métriques exportées afin que le scrape reste au format texte Prometheus valide. Les noms de métriques ne changent pas, et les configurations qui combinent des exportateurs, par exemple otlp,prometheus, conservent les unités. Avant v2.1.216, le scrape Prometheus incluait des lignes # UNIT OpenMetrics uniquement que certains scrapers rejetaient.

Détails des métriques

Chaque métrique inclut les attributs standard listés ci-dessus. Les métriques avec des attributs supplémentaires spécifiques au contexte sont notées ci-dessous.

Compteur de sessions

Incrémenté au début de chaque session.

Attributs :

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

Incrémenté lorsque du code est ajouté ou supprimé.

Attributs :

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

Incrémenté lorsque Claude Code crée une demande de tirage ou de fusion via une commande shell ou un outil MCP.

Attributs :

Tous les attributs standard

Compteur de commits

Incrémenté lors de la création de commits git via Claude Code.

Attributs :

Tous les attributs standard

Compteur de coûts

Incrémenté après chaque demande API.

Les attributs agent.name, skill.name, plugin.name, mcp_server.name et mcp_tool.name rédactent chacun certains noms à un espace réservé "custom" ou "third-party" par défaut. Si vous définissez OTEL_LOG_TOOL_DETAILS=1, ils portent les noms réels à la place. Avant v2.1.273, les compteurs de coûts et de jetons et les événements api_request, api_error et api_refusal portaient les valeurs rédactées même avec OTEL_LOG_TOOL_DETAILS=1 défini.

Attributs :

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

Incrémenté après chaque demande API.

Attributs :

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

Incrémenté lorsque l'utilisateur accepte ou rejette l'utilisation de l'outil Edit, Write ou NotebookEdit.

Attributs :

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

Suit le temps réel passé à utiliser activement Claude Code, excluant le temps d'inactivité. Cette métrique est incrémentée lors des interactions utilisateur, telles que la saisie et la lecture des réponses, et lors du traitement CLI, tel que l'exécution d'outils et la génération de réponses IA.

Attributs :

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

Claude Code exporte les événements suivants via les journaux/événements OpenTelemetry (lorsque OTEL_LOGS_EXPORTER est configuré) :

Attributs de corrélation d'événements

Lorsqu'un utilisateur soumet une invite, Claude Code peut effectuer plusieurs appels API et exécuter plusieurs outils. L'attribut prompt.id vous permet de lier tous ces événements à l'invite unique qui les a déclenchés.

Attribut	Description
`prompt.id`	Identifiant UUID v4 reliant tous les événements produits lors du traitement d'une seule invite utilisateur
`event.sequence`	Compteur basé sur 0 pour ordonner les événements, compté par processus Claude Code plutôt que par session
`message.uuid`	UUID du message tel que persisté dans la transcription de session, les fichiers `~/.claude/projects//.jsonl`. Présent sur `assistant_response`, sur `api_response_body`, et sur `user_prompt` sauf pour les dispatches de commandes, qui peuvent produire zéro ou plusieurs messages. Sur `assistant_response` et `api_response_body`, c'est l'entrée de transcription finale de la réponse, à partir de laquelle le `parentUuid` du tour suivant s'enchaîne. Nécessite Claude Code v2.1.214 ou ultérieur, ou v2.1.274 ou ultérieur sur `api_response_body`
`request_id`	ID assigné par le serveur de la demande API, lu à partir de l'en-tête de réponse `request-id`, par exemple `req_011...`. Sur une réponse sans en-tête `request-id`, comme sur Amazon Bedrock, la valeur provient de l'en-tête `x-amzn-requestid` à la place. Présent sur `api_request`, `api_error`, `api_refusal`, `assistant_response`, et `api_response_body` lorsque la réponse porte l'un ou l'autre en-tête. Correspond au même attribut sur la plage de trace `llm_request`. La source `x-amzn-requestid` nécessite Claude Code v2.1.282 ou ultérieur
`client_request_id`	UUID généré par le client envoyé comme en-tête de demande `x-client-request-id`. Présent sur `api_request` et `api_error` sur les connexions API propriétaires ; absent sur les backends de fournisseurs tiers et lorsque la demande a été retentée via le secours non-streaming. Apparie une demande avec sa réponse et reste disponible pour les défaillances telles que les délais d'expiration qui n'ont jamais produit de `request_id` serveur. Correspond au même attribut sur la plage de trace `llm_request`. Nécessite Claude Code v2.1.214 ou ultérieur

Pour tracer toute l'activité déclenchée par une seule invite, filtrez vos événements par une valeur prompt.id spécifique. Cela retourne l'événement user_prompt, tous les événements api_request, et tous les événements tool_result qui se sont produits lors du traitement de cette invite.

event.sequence commence à 0 chaque fois qu'un processus Claude Code démarre et compte jusqu'à la fin de ce processus. Il continue de compter à travers /clear, qui assigne un nouveau session.id. Si vous reprenez une session sans la forker, la session conserve son session.id mais prend ses valeurs event.sequence du processus qui l'a reprise, donc au sein d'une session un événement ultérieur peut porter une valeur inférieure à celle d'un événement antérieur, ou en répéter une. Pour ordonner les événements d'une session, triez par event.timestamp et utilisez event.sequence pour ordonner les événements qui partagent un timestamp.

Pour la reconstruction au niveau du message, chaque classe d'événement porte une clé qui correspond à un champ dans la transcription de session. Le format d'entrée de transcription est interne à Claude Code et change entre les versions, donc un pipeline qui se joint sur ces champs peut se casser à chaque version ; traitez les jointures comme spécifiques à la version plutôt que comme un contrat stable :

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

Enregistré lorsqu'un utilisateur soumet une invite.

Nom de l'événement : claude_code.user_prompt

Attributs :

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

Enregistré après chaque demande API qui retourne du contenu textuel du modèle. Seuls les blocs de texte de la réponse sont inclus ; les blocs de réflexion et les blocs d'utilisation d'outils sont exclus. Nécessite Claude Code v2.1.193 ou ultérieur.

Nom de l'événement : claude_code.assistant_response

Attributs :

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

Enregistré lorsqu'un outil termine son exécution. Non émis si l'appel d'outil a été rejeté ; voir l'événement de décision d'outil pour les rejets.

Nom de l'événement : claude_code.tool_result

Attributs :

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

Enregistré pour chaque demande API à Claude.

Nom de l'événement : claude_code.api_request

Attributs :

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

Enregistré lorsqu'une demande API à Claude échoue.

Nom de l'événement : claude_code.api_error

Attributs :

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

Enregistré lorsqu'une demande API retourne stop_reason: "refusal". Les refus arrivent sur un flux de réponse réussi plutôt que comme une erreur HTTP, donc l'événement api_error ne se déclenche pas pour eux. Cet événement vous permet de suivre la fréquence des refus et de regrouper les refus par les mêmes attributs que api_request et api_error.

Nom de l'événement : claude_code.api_refusal

Attributs :

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

Enregistré pour chaque tentative de demande API lorsque OTEL_LOG_RAW_API_BODIES est défini. Un événement est émis par tentative, donc les nouvelles tentatives avec des paramètres ajustés produisent chacune leur propre événement.

Nom de l'événement : claude_code.api_request_body

Attributs :

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

Enregistré pour chaque réponse API réussie lorsque OTEL_LOG_RAW_API_BODIES est défini.

En mode fichier (OTEL_LOG_RAW_API_BODIES=file:<dir>), Claude Code ajoute également une ligne JSON à <dir>/index.jsonl pour chaque réponse réussie, avec les champs timestamp, session_id, query_source, model, request_id, message_id, message_uuid, request_file, et response_file. Lisez-le pour trouver les fichiers de demande et de réponse derrière un message de transcription donné sans interroger votre backend de télémétrie. Le fichier d'index nécessite Claude Code v2.1.274 ou ultérieur.

Nom de l'événement : claude_code.api_response_body

Attributs :

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

Enregistré lorsqu'une décision de permission d'outil est prise (accepter/rejeter).

Nom de l'événement : claude_code.tool_decision

Attributs :

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

Enregistré lorsque le mode de permission change, par exemple à partir du cyclage Shift+Tab, de la sortie du mode plan, ou d'une vérification de porte en mode automatique.

Nom de l'événement : claude_code.permission_mode_changed

Attributs :

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

Enregistré lorsque /login ou /logout se termine.

Nom de l'événement : claude_code.auth

Attributs :

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

Enregistré lorsqu'un serveur MCP se connecte, se déconnecte ou échoue à se connecter.

Nom de l'événement : claude_code.mcp_server_connection

Attributs :

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

Enregistré lorsque Claude Code détecte une erreur interne inattendue. Seul le nom de la classe d'erreur et un code de style errno sont enregistrés. Le message d'erreur et la trace de pile ne sont jamais inclus. Cet événement n'est pas émis lors de l'exécution sur Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry, ou lorsque DISABLE_ERROR_REPORTING est défini.

Nom de l'événement : claude_code.internal_error

Attributs :

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é

Enregistré lorsqu'un plugin termine son installation, à partir à la fois de la commande CLI claude plugin install et de l'interface utilisateur interactive /plugin.

Nom de l'événement : claude_code.plugin_installed

Attributs :

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é

Enregistré une fois par plugin activé au démarrage de la session. Utilisez cet événement pour inventorier les plugins actifs dans votre flotte, en complément de plugin_installed qui enregistre l'action d'installation elle-même.

Nom de l'événement : claude_code.plugin_loaded

Attributs :

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

Enregistré lorsqu'une compétence est invoquée, que Claude l'appelle via l'outil Skill ou que vous l'exécutiez en tant que commande /.

Nom de l'événement : claude_code.skill_activated

Attributs :

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 @

Enregistré lorsque Claude Code résout une mention @ dans une invite. Pas chaque mention n'émet un événement : les chemins de sortie anticipée tels que les refus de permission, les fichiers surdimensionnés, les pièces jointes de référence PDF et les défaillances de listage de répertoires retournent sans journalisation.

Nom de l'événement : claude_code.at_mention

Attributs :

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

Enregistré une fois lorsqu'une demande API échoue après plus d'une tentative. Émis aux côtés de l'événement api_error final.

Nom de l'événement : claude_code.api_retries_exhausted

Attributs :

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é

Enregistré une fois par hook configuré au démarrage de la session. Utilisez cet événement pour inventorier les hooks actifs dans votre flotte, en complément des événements par exécution hook_execution_start et hook_execution_complete.

Nom de l'événement : claude_code.hook_registered

Attributs :

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

Enregistré lorsqu'un ou plusieurs hooks commencent à s'exécuter pour un événement hook.

Nom de l'événement : claude_code.hook_execution_start

Attributs :

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

Enregistré lorsque tous les hooks pour un événement hook ont terminé.

Nom de l'événement : claude_code.hook_execution_complete

Attributs :

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

Enregistré lorsqu'un hook de plugin de place de marché officielle émet des métriques par invocation. Seuls les plugins installés à partir d'une place de marché Anthropic officielle peuvent émettre ceci. Les plugins de place de marché tiers et les hooks configurés par l'utilisateur n'émettent pas vers cet événement. Utilisez cet événement pour surveiller le comportement du plugin, par exemple les taux de découverte, les coûts et les durées à partir de votre propre pile d'observabilité.

Nom de l'événement : claude_code.hook_plugin_metrics

Attributs :

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

Enregistré lorsque la compaction de conversation se termine.

Nom de l'événement : claude_code.compaction

Attributs :

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

Enregistré lorsqu'un sous-agent se termine et retourne son résultat à la conversation qui l'a démarré. Utilisez-le pour regrouper l'utilisation d'outils et le temps d'exécution par type de sous-agent ; pour les regroupements de jetons ou de coûts, utilisez le compteur de jetons et le compteur de coûts filtrés sur query_source "subagent", puisque le total_tokens de cet événement couvre uniquement la demande finale. La catégorie "subagent" compte également les demandes des hooks basés sur des agents, qui n'émettent aucun événement de sous-agent.

Nom de l'événement : claude_code.subagent_completed

Attributs :

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

Enregistré lorsqu'une enquête de qualité de session est affichée ou répondue. Voir Enquêtes de qualité de session pour ce que les enquêtes collectent et comment les contrôler.

Nom de l'événement : claude_code.feedback_survey

Attributs :

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

Enregistré une fois par exécution du balayage de nettoyage de rétention, qui supprime les transcriptions de session et autres données d'application plus anciennes que le paramètre cleanupPeriodDays. Claude Code exécute le balayage en arrière-plan au maximum une fois par session, et une exécution qui ne supprime rien émet quand même l'événement. Si Claude Code a exécuté le balayage dans n'importe quelle session sur la même machine au cours des 24 dernières heures, il retarde le balayage de cette session d'au moins 10 minutes, donc une session qui se termine plus tôt n'émet rien. Lorsque vous exécutez claude -p avec --bare, Claude Code n'exécute pas le balayage et n'émet rien.

Comme chaque événement OTel sur cette page, il va uniquement au backend de télémétrie que vous configurez. Nécessite Claude Code v2.1.227 ou ultérieur.

Lorsque Claude Code ne peut pas déterminer avec certitude la période de rétention, il met en pause le balayage et émet l'événement avec result défini à "skipped" et une skip_reason. Lorsque les paramètres gérés définissent cleanupPeriodDays, la valeur gérée épingle la période de rétention et le balayage s'exécute même lorsqu'un fichier de paramètres dans une portée de priorité inférieure est cassé ou invalide. Lorsque managed-settings.json lui-même ne peut pas être lu, Claude Code met quand même en pause le balayage sauf si le niveau géré fournit cleanupPeriodDays d'ailleurs, par exemple à partir des paramètres gérés par le serveur ou d'une suppression managed-settings.d/ à côté du fichier cassé. Les attributs du compteur de suppression sont présents uniquement lorsque result est "complete".

Nom de l'événement : claude_code.retention_sweep

Attributs :

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

Enregistré avec les paramètres gérés qu'une session a résolus : une fois au démarrage de la session, à nouveau lorsque soit les paramètres gérés soit l'état de l'assistant de politique change pendant la session, et lorsque Claude Code refuse de démarrer ou termine la session pour l'une des raisons que l'attribut error.type énumère. Utilisez cet événement pour trouver les machines exécutées sur une source gérée inattendue, les machines dont l'assistant de politique échoue, et la raison pour laquelle une machine a refusé de démarrer. Nécessite Claude Code v2.1.274 ou ultérieur.

Par défaut, l'événement porte les sources gérées et l'état de l'assistant de politique mais pas les paramètres eux-mêmes. Pour ajouter l'attribut managed_settings.settings rédacté et le digest managed_settings.resolved_sha256, définissez OTEL_LOG_MANAGED_SETTINGS=1 :

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à.

Dans une session interactive dans un dossier que vous n'avez pas approuvé, Claude Code n'exporte pas l'événement de refus.

Nom de l'événement : claude_code.managed_settings_resolved

Attributs :

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

Les métriques et événements exportés prennent en charge une gamme d'analyses :

Surveillance de l'utilisation

Métrique	Opportunité d'analyse
`claude_code.token.usage`	Ventiler par `type` (entrée/sortie), utilisateur, équipe, modèle, `skill.name`, `plugin.name`, ou `agent.name`
`claude_code.session.count`	Suivre l'adoption et l'engagement au fil du temps
`claude_code.lines_of_code.count`	Mesurer la productivité en suivant les ajouts et suppressions de code, ventilés par modèle
`claude_code.commit.count` & `claude_code.pull_request.count`	Comprendre l'impact sur les flux de travail de développement

Surveillance des coûts

La métrique claude_code.cost.usage aide à :

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

Claude Code compte chaque réponse en streaming vers les métriques de coûts et de jetons exactement une fois, y compris lorsqu'une passerelle ou un proxy derrière ANTHROPIC_BASE_URL diffuse l'utilisation progressivement sur plusieurs images. Avant la v2.1.214, les flux qui contenaient l'utilisation dans plus d'une image gonflaient claude_code.cost.usage et claude_code.token.usage d'environ une demande complète supplémentaire par image supplémentaire.

Alertes et segmentation

Les alertes courantes à considérer :

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

Toutes les métriques peuvent être segmentées par les attributs standard. L'attribut model est disponible sur claude_code.token.usage, claude_code.cost.usage, et à partir de la v2.1.172, claude_code.lines_of_code.count.

Les ventilations par modèle des commits ne peuvent être approximées que en joignant les métriques de jetons ou de coûts sur session.id, puisqu'une session peut s'étendre sur plusieurs modèles. Filtrez le côté jetons ou coûts pour les lignes où query_source est "main" afin que les demandes auxiliaires et de sous-agents n'attribuent pas les commits de la session à un modèle qui ne les a pas effectués.

Détecter l'épuisement des tentatives

Claude Code réessaie les demandes d'API échouées en interne et n'émet un seul événement claude_code.api_error qu'après avoir abandonné, donc l'événement lui-même est le signal terminal pour cette demande. Les tentatives de nouvelle tentative intermédiaires ne sont pas enregistrées comme des événements séparés.

L'attribut attempt sur l'événement enregistre le nombre total de tentatives effectuées. CLAUDE_CODE_MAX_RETRIES est par défaut 10 et plafonné à 15. À partir de la v2.1.199, vous pouvez définir CLAUDE_CODE_RETRY_WATCHDOG pour augmenter la valeur par défaut et supprimer le plafond.

Lorsque la demande épuise toutes les tentatives sur une erreur transitoire, attempt est égal à un de plus que cette limite effective : 11 par défaut, et jamais plus de 16 sauf si le watchdog est défini. Une valeur inférieure indique une erreur non réessayable telle qu'une réponse 400, ou une cause avec son propre budget de tentatives plus petit. Par exemple, Claude Code réessaie un échec de chargement des identifiants AWS ou Google Cloud au maximum deux fois.

Pour distinguer une session qui s'est rétablie d'une qui s'est bloquée, groupez les événements par session.id et vérifiez si un événement api_request ultérieur existe après l'erreur.

Analyse des événements

Les données d'événements fournissent des informations détaillées sur les interactions de Claude Code :

Modèles d'utilisation des outils : analyser les événements de résultat d'outil pour identifier :

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

Surveillance des performances : suivre les durées des demandes d'API et les temps d'exécution des outils pour identifier les goulots d'étranglement de performance.

Audit des événements de sécurité

Les événements OpenTelemetry sont la source de données d'audit pour l'activité de Claude Code. Chaque événement porte des attributs d'identité qui lient les appels d'outils, l'activité MCP et les décisions de permission à l'utilisateur qui les a déclenchés. L'exportateur de journaux OTLP peut livrer ces événements à n'importe quelle plateforme SIEM (Security Information and Event Management) avec un récepteur OTLP, ou à un collecteur OpenTelemetry qui transfère vers votre SIEM.

Attribuer les actions aux utilisateurs

Les attributs standard sur chaque événement incluent l'identité de l'utilisateur authentifié : user.email, user.account_uuid, user.account_id, et organization.id lorsqu'il est connecté avec un compte Claude ou, dans une session cloud, lorsque les propres identifiants de la session les portent, plus user.id et le per-session session.id. user.id est un identifiant limité à l'installation, sauf sur les sessions de passerelle d'applications Claude, où il s'agit du sujet IdP du jeton émis par la passerelle.

Dans une session qu'un développeur démarre, les appels d'outils MCP, les commandes Bash et les éditions de fichiers sont donc attribués à ce développeur. Claude Code n'agit pas sous un compte de service distinct ; l'identité enregistrée sur chaque événement est le propre compte Claude du développeur, ou l'identité IdP du développeur sur une session de passerelle d'applications Claude. Dans les sessions de canal Claude Tag, Claude fonctionne plutôt comme l'identité partagée de votre organisation.

Lorsque Claude Code s'authentifie avec une clé API directe, ou contre Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry, il n'y a pas de compte Claude dans la session et seuls user.id et session.id sont remplis. Dans ces déploiements, attachez l'identité utilisateur vous-même avec OTEL_RESOURCE_ATTRIBUTES, défini par utilisateur via le fichier paramètres gérés ou un wrapper de lancement. Les sessions de passerelle d'applications Claude n'ont besoin d'aucune de ces opérations : le CLI horodate l'identité IdP automatiquement, comme décrit dans Attributs standard.

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

Audit de l'activité MCP

Pour capturer l'activité du serveur MCP avec tous les détails d'appel, activez l'exportateur de journaux et définissez OTEL_LOG_TOOL_DETAILS=1. Chaque opération MCP produit alors des événements structurés qui portent le nom du serveur, le nom de l'outil et les arguments d'appel aux côtés des attributs d'identité standard :

Événement	Ce qu'il enregistre pour MCP
`mcp_server_connection`	Connexion du serveur, déconnexion et défaillance de connexion avec `server_name`, `transport_type`, `server_scope`, et détail d'erreur
`tool_result`	Chaque appel d'outil MCP avec `tool_name` et `mcp_server_scope`, une charge utile `tool_parameters` contenant `mcp_server_name` et `mcp_tool_name`, et une charge utile `tool_input` contenant les arguments d'appel
`tool_decision`	Si l'appel a été autorisé ou refusé, si la décision provenait de la configuration, d'un hook ou de l'utilisateur, et une charge utile `tool_parameters` contenant `mcp_server_name` et `mcp_tool_name`

Sans OTEL_LOG_TOOL_DETAILS, ces événements suppriment le détail d'identification :

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

Lors de la création de règles de détection, recherchez le signal que vous souhaitez surveiller et interrogez votre backend pour l'événement correspondant et les attributs :

Signal	Événement	Attributs clés
Appel d'outil autorisé ou refusé, et par quoi	`tool_decision`	`decision`, `source`, `tool_name`, `tool_parameters`
Escalade du mode de permission	`permission_mode_changed`	`from_mode`, `to_mode`, `trigger`
Hook de politique a bloqué une action	`hook_execution_complete`	`hook_event`, `num_blocking`
Connexion, déconnexion et défaillance d'authentification	`auth`	`action`, `success`, `error_category`
Connexion du serveur MCP ou défaillance	`mcp_server_connection`	`status`, `server_name`, `is_plugin`, `error_code`
Plugin installé et sa source	`plugin_installed`	`plugin.name`, `marketplace.name`, `marketplace.is_official`
Commandes exécutées et fichiers touchés	`tool_result` (exécuté) ou `tool_decision` (rejeté) avec `OTEL_LOG_TOOL_DETAILS=1`	`tool_parameters` ; `tool_input` (`tool_result` uniquement)
Quelles sources de paramètres gérés une machine exécute, si son assistant de politique est sain et pourquoi une machine a refusé de démarrer	`managed_settings_resolved`	`managed_settings.trigger`, `managed_settings.sources`, `managed_settings.source_behavior`, `managed_settings.helper.state`, `error.type` ; `managed_settings.settings` et `managed_settings.resolved_sha256` avec `OTEL_LOG_MANAGED_SETTINGS=1`

Claude Code émet uniquement le flux d'événements brut. La détection d'anomalies, l'établissement de lignes de base, la corrélation entre les sessions et les alertes sont la responsabilité de votre SIEM ou backend d'observabilité.

Envoyer les événements à un SIEM

Pointez OTEL_EXPORTER_OTLP_LOGS_ENDPOINT vers le récepteur OTLP de votre SIEM, ou vers un collecteur OpenTelemetry qui transfère vers l'API d'ingestion native de votre SIEM. L'exemple de paramètres gérés suivant exporte uniquement les événements, avec tous les détails d'outil activés pour l'audit MCP et Bash :

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

Pour confirmer que les événements arrivent, soumettez une invite dans une session exécutée sous cette configuration et vérifiez votre SIEM pour l'événement claude_code.user_prompt. Si rien n'arrive, démarrez Claude Code avec claude --debug-file <path> et vérifiez ce journal pour les erreurs d'exportation [3P telemetry].

Considérations relatives aux backends

Votre choix de backends de métriques, de journaux et de traces détermine les types d'analyses que vous pouvez effectuer :

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

Choisissez un backend qui prend en charge le stockage de traces distribuées et la corrélation d'intervalles :

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

Pour les organisations nécessitant des métriques d'utilisateurs actifs quotidiens/hebdomadaires/mensuels (DAU/WAU/MAU), envisagez des backends qui prennent en charge les requêtes de valeurs uniques efficaces.

Informations sur le service

Toutes les métriques et tous les événements sont exportés avec les attributs de ressource suivants :

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

Si vos pipelines de collecteur ou vos tableaux de bord filtrent sur service.name = claude-code, ajoutez claude-code-desktop au filtre pour capturer également la télémétrie des sessions de l'onglet Code.

Ressources de mesure du ROI

Pour un guide complet sur la mesure du retour sur investissement pour Claude Code, y compris la configuration de la télémétrie, l'analyse des coûts, les métriques de productivité et les rapports automatisés, consultez le Guide de mesure du ROI de Claude Code. Ce référentiel fournit des configurations Docker Compose prêtes à l'emploi, des configurations Prometheus et OpenTelemetry, et des modèles pour générer des rapports de productivité intégrés à des outils comme Linear.

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

Pour des conseils détaillés sur la surveillance de l'utilisation de Claude Code pour Amazon Bedrock, consultez Implémentation de la surveillance de Claude Code (Amazon Bedrock).

monitoring-usage.md +355 −311

39 39

40Pour vérifier une configuration qui exporte des métriques, vérifiez votre backend pour la métrique `claude_code.session.count`, que Claude Code émet au démarrage d'une session. Pour vérifier une configuration réservée aux journaux, soumettez une invite et vérifiez l'événement `claude_code.user_prompt`.40Pour vérifier une configuration qui exporte des métriques, vérifiez votre backend pour la métrique `claude_code.session.count`, que Claude Code émet au démarrage d'une session. Pour vérifier une configuration réservée aux journaux, soumettez une invite et vérifiez l'événement `claude_code.user_prompt`.

41 41

42Si rien n'arrive, exécutez `claude --debug` et vérifiez le journal de débogage. Claude Code signale les défaillances des exportateurs que vous configurez en tant qu'erreurs `[3P telemetry]`, où 3P signifie tiers. Les lignes préfixées par `[Anthropic telemetry]` décrivent la [télémétrie opérationnelle distincte d'Anthropic](/docs/fr/data-usage#telemetry-services) et n'indiquent pas un problème avec votre configuration.42Si rien n'arrive, démarrez Claude Code avec `claude --debug-file <path>` et vérifiez le journal qu'il écrit dans ce chemin. Claude Code signale les défaillances des exportateurs que vous configurez en tant qu'erreurs `[3P telemetry]`, où 3P signifie tiers. Les lignes préfixées par `[Anthropic telemetry]` décrivent la [télémétrie opérationnelle distincte d'Anthropic](/docs/fr/data-usage#telemetry-services) et n'indiquent pas un problème avec votre configuration.

43 43

44Pour les options de configuration complètes, consultez la [spécification OpenTelemetry](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/protocol/exporter.md#configuration-options).44Pour les options de configuration complètes, consultez la [spécification OpenTelemetry](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/protocol/exporter.md#configuration-options).

45 45

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

73</h3>73</h3>

74 74

75Lorsque vous définissez une variable `OTEL_EXPORTER_OTLP_*` dans les paramètres gérés, Claude Code supprime les variables conflictuelles définies par les développeurs au démarrage et enregistre un avertissement que vous pouvez voir avec `claude --debug`. Ce qu'il supprime dépend de la variable que vous définissez :75Lorsque vous définissez une variable `OTEL_EXPORTER_OTLP_*` dans les paramètres gérés, Claude Code supprime les variables conflictuelles définies par les développeurs au démarrage et enregistre un avertissement dans le journal de débogage. Ce qu'il supprime dépend de la variable que vous définissez :

76 76

77* **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.77* **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.

78* **Protocoles** : lorsque vous définissez `OTEL_EXPORTER_OTLP_PROTOCOL`, Claude Code supprime tous les protocoles par signal définis par les développeurs.78* **Protocoles** : lorsque vous définissez `OTEL_EXPORTER_OTLP_PROTOCOL`, Claude Code supprime tous les protocoles par signal définis par les développeurs.

96Lorsque l'application de bureau ou un exécuteur d'[environnement auto-hébergé](/docs/fr/self-hosted-environments) lance Claude Code et nomme un point de terminaison OTLP dans l'environnement qu'il fournit, Claude Code épingle la destination de la même manière : les variables de télémétrie du lanceur suppriment les variables définies par les développeurs exactement comme le font les paramètres gérés. Claude Code ne supprime pas les variables que le lanceur lui-même a définies. Nécessite Claude Code v2.1.251 ou version ultérieure.96Lorsque l'application de bureau ou un exécuteur d'[environnement auto-hébergé](/docs/fr/self-hosted-environments) lance Claude Code et nomme un point de terminaison OTLP dans l'environnement qu'il fournit, Claude Code épingle la destination de la même manière : les variables de télémétrie du lanceur suppriment les variables définies par les développeurs exactement comme le font les paramètres gérés. Claude Code ne supprime pas les variables que le lanceur lui-même a définies. Nécessite Claude Code v2.1.251 ou version ultérieure.

97 97

98<h2 id="configuration-details">98<h2 id="configuration-details">

~~99 Détails de la configuration~~99 Détails de configuration

100</h2>100</h2>

101 101

102<h3 id="common-configuration-variables">102<h3 id="common-configuration-variables">

103 Variables de configuration courantes103 Variables de configuration communes

104</h3>104</h3>

105 105

106Ces variables configurent les exportateurs, les points de terminaison et le comportement d'export pour tous les déploiements.106Ces variables configurent les exportateurs, les points de terminaison et le comportement d'export pour tous les déploiements.

107 107

108Si vous définissez une variable de point de terminaison ou de protocole par signal, telle que `OTEL_EXPORTER_OTLP_METRICS_ENDPOINT`, Claude Code l'utilise à la place de la variable générique pour ce signal. Si vous définissez une variable d'en-têtes par signal, telle que `OTEL_EXPORTER_OTLP_METRICS_HEADERS`, Claude Code la fusionne avec la variable générique `OTEL_EXPORTER_OTLP_HEADERS` pour ce signal.108Si vous définissez une variable de point de terminaison ou de protocole par signal, comme `OTEL_EXPORTER_OTLP_METRICS_ENDPOINT`, Claude Code l'utilise à la place de la variable générique pour ce signal. Si vous définissez une variable d'en-têtes par signal, comme `OTEL_EXPORTER_OTLP_METRICS_HEADERS`, Claude Code la fusionne avec l'en-tête générique `OTEL_EXPORTER_OTLP_HEADERS` pour ce signal.

109 109

110Sur les machines avec des paramètres gérés, voir [Comment les paramètres gérés verrouillent la destination OTLP](#how-managed-settings-lock-the-otlp-destination) pour savoir ce que Claude Code supprime.110Sur les machines avec des paramètres gérés, consultez [Comment les paramètres gérés verrouillent la destination OTLP](#how-managed-settings-lock-the-otlp-destination) pour voir ce que Claude Code supprime.

111 111

113| - | - | - |113| - | - | - |

114| `CLAUDE_CODE_ENABLE_TELEMETRY` | Active la collecte de télémétrie (obligatoire) | `1` |114| `CLAUDE_CODE_ENABLE_TELEMETRY` | Active la collecte de télémétrie (obligatoire) | `1` |

117| `OTEL_EXPORTER_OTLP_PROTOCOL` | Protocole pour l'exportateur OTLP, s'applique à tous les signaux. Claude Code n'a pas de protocole par défaut, donc définissez ceci ou la variable de protocole spécifique au signal pour chaque exportateur `otlp` que vous activez | `grpc`, `http/json`, `http/protobuf` |117| `OTEL_EXPORTER_OTLP_PROTOCOL` | Protocole pour l'exportateur OTLP, s'applique à tous les signaux. Claude Code n'a pas de protocole par défaut, donc définissez ceci ou la variable de protocole spécifique au signal pour chaque exportateur `otlp` que vous activez | `grpc`, `http/json`, `http/protobuf` |

126| `OTEL_METRIC_EXPORT_INTERVAL` | Intervalle d'export en millisecondes (par défaut : 60000) | `5000`, `60000` |126| `OTEL_METRIC_EXPORT_INTERVAL` | Intervalle d'export en millisecondes (par défaut : 60000) | `5000`, `60000` |

127| `OTEL_LOGS_EXPORT_INTERVAL` | Intervalle d'export des journaux en millisecondes (par défaut : 5000) | `1000`, `10000` |127| `OTEL_LOGS_EXPORT_INTERVAL` | Intervalle d'export des journaux en millisecondes (par défaut : 5000) | `1000`, `10000` |

129| `OTEL_LOG_ASSISTANT_RESPONSES` | Activer la journalisation du texte de réponse de l'assistant sur les événements `assistant_response` (par défaut : désactivé). Lorsque non défini, revient à la valeur de `OTEL_LOG_USER_PROMPTS`. Nécessite Claude Code v2.1.193 ou version ultérieure | `1` pour activer, `0` pour garder masqué |129| `OTEL_LOG_ASSISTANT_RESPONSES` | Activer la journalisation du texte de réponse de l'assistant sur les événements `assistant_response` (par défaut : désactivé). Lorsque non défini, revient à la valeur de `OTEL_LOG_USER_PROMPTS`. Nécessite Claude Code v2.1.193 ou ultérieur | `1` pour activer, `0` pour garder masqué |

130| `OTEL_LOG_TOOL_DETAILS` | Activer la journalisation des paramètres d'outil et des arguments d'entrée dans les événements d'outil et les attributs d'intervalle de trace : commandes Bash, noms de serveur MCP et d'outil, noms de compétences, noms de workflow créés par l'utilisateur et entrée d'outil. Active également les noms de commandes personnalisées, de plugin et MCP sur les événements `user_prompt` (par défaut : désactivé). Pour les serveurs intégrés de Claude Desktop, dans les sessions que Claude Desktop possède, `mcp_server_name`/`mcp_tool_name` sont émis sur `tool_decision`/`tool_result` même avec l'indicateur désactivé. L'exception nécessite Claude Code v2.1.214 ou version ultérieure | `1` pour activer |130| `OTEL_LOG_TOOL_DETAILS` | Activer la journalisation des paramètres d'outils et des arguments d'entrée dans les événements d'outils et les attributs de span de trace : commandes Bash, noms de serveur MCP et d'outils, noms de compétences, noms de flux de travail créés par l'utilisateur et entrée d'outils. Active également les noms de commandes personnalisées, de plugins et MCP sur les événements `user_prompt`, et les noms réels d'agent, de compétence, de plugin et de serveur MCP et d'outils sur les [compteurs de coûts et de jetons](#cost-counter) (par défaut : désactivé). Pour les serveurs intégrés de Claude Desktop, dans les sessions que Claude Desktop possède, `mcp_server_name`/`mcp_tool_name` émettent sur `tool_decision`/`tool_result` même avec l'indicateur désactivé. L'exception nécessite Claude Code v2.1.214 ou ultérieur | `1` pour activer |

131| `OTEL_LOG_TOOL_CONTENT` | Activer la journalisation du contenu d'outil dans l'[événement d'intervalle `tool.output`](#tool-output-span-event) (par défaut : désactivé). Les attributs d'intervalle portent le contenu d'outil sous [leurs propres portes](#new-context-gates). Nécessite [traçage](#traces-beta). Le contenu est tronqué à la limite de contenu (60 Ko par défaut) | `1` pour activer |131| `OTEL_LOG_TOOL_CONTENT` | Activer la journalisation du contenu des outils dans l'[événement de span `tool.output`](#tool-output-span-event) (par défaut : désactivé). Les attributs de span portent le contenu des outils sous [leurs propres portes](#new-context-gates). Nécessite [traçage](#traces-beta). Le contenu est tronqué à la limite de contenu (60 Ko par défaut) | `1` pour activer |

132| `OTEL_LOG_MANAGED_SETTINGS` | Ajouter les paramètres gérés masqués et un résumé SHA-256 des paramètres avant masquage aux événements [managed settings resolved](#managed-settings-resolved-event) (par défaut : désactivé). Une valeur dans les paramètres de projet ou locaux ne l'active pas. Nécessite Claude Code v2.1.274 ou version ultérieure | `1` pour activer |132| `OTEL_LOG_MANAGED_SETTINGS` | Ajouter les paramètres gérés masqués et un résumé SHA-256 des paramètres avant masquage aux événements [paramètres gérés résolus](#managed-settings-resolved-event) (par défaut : désactivé). Une valeur dans les paramètres de projet ou locaux ne l'active pas. Nécessite Claude Code v2.1.274 ou ultérieur | `1` pour activer |

133| `OTEL_LOG_RAW_API_BODIES` | Émettre les corps JSON complets de la demande et de la réponse de l'API Messages d'Anthropic sous forme d'événements de journaux `api_request_body` / `api_response_body` (par défaut : désactivé). Les corps incluent l'historique complet de la conversation. L'activation de cette option implique le consentement à tout ce que `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS` et `OTEL_LOG_TOOL_CONTENT` révèleraient | `1` pour les corps en ligne tronqués à la limite de contenu (60 Ko par défaut), ou `file:<dir>` pour les corps non tronqués sur disque avec un pointeur `body_ref` dans l'événement |133| `OTEL_LOG_RAW_API_BODIES` | Émettre la demande et la réponse JSON complètes de l'API Messages Anthropic en tant qu'événements de journal `api_request_body` / `api_response_body` (par défaut : désactivé). Les corps incluent l'historique complet de la conversation. L'activation de ceci implique le consentement à tout ce que `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS` et `OTEL_LOG_TOOL_CONTENT` révèleraient | `1` pour les corps en ligne tronqués à la limite de contenu (60 Ko par défaut), ou `file:<dir>` pour les corps non tronqués sur disque avec un pointeur `body_ref` dans l'événement |

134| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Limite de contenu : la longueur maximale des attributs porteurs de contenu tels que les réponses du modèle, le contenu d'outil, les invites système et les corps API bruts, marqueur de troncature inclus, en unités de code UTF-16 (par défaut : 61440, c'est-à-dire 60 Ko). La valeur par défaut est dimensionnée pour les backends qui limitent les valeurs d'attribut à 64 Ko ; augmentez-la uniquement si votre backend accepte des valeurs plus grandes, ou diminuez-la pour réduire le volume de télémétrie. Lorsqu'une limite d'attribut du SDK OpenTelemetry, `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` ou l'une de ses variantes logrecord et span, est définie plus bas, Claude Code tronque à cette valeur plus petite afin que le marqueur `[TRUNCATED ...]` reste dans la limite du SDK. Nécessite Claude Code v2.1.214 ou version ultérieure | `262144` |134| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Limite de contenu : la longueur maximale des attributs porteurs de contenu tels que les réponses du modèle, le contenu des outils, les invites système et les corps API bruts, marqueur de troncature inclus, en unités de code UTF-16 (par défaut : 61440, c.-à-d. 60 Ko). La valeur par défaut est dimensionnée pour les backends qui limitent les valeurs d'attribut à 64 Ko ; augmentez-la uniquement si votre backend accepte des valeurs plus grandes, ou diminuez-la pour réduire le volume de télémétrie. Lorsqu'une limite d'attribut du SDK OpenTelemetry, `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` ou l'une de ses variantes de journal et de span, est définie plus bas, Claude Code tronque à cette valeur plus petite afin que le marqueur `[TRUNCATED ...]` reste dans la limite du SDK. Nécessite Claude Code v2.1.214 ou ultérieur | `262144` |

135| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | Préférence de temporalité des métriques (par défaut : `delta`). Définissez sur `cumulative` si votre backend attend une temporalité cumulative | `delta`, `cumulative` |135| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | Préférence de temporalité des métriques (par défaut : `delta`). Définissez sur `cumulative` si votre backend s'attend à une temporalité cumulative | `delta`, `cumulative` |

136| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervalle d'actualisation des en-têtes dynamiques (par défaut : 1740000ms / 29 minutes) | `900000` |136| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervalle d'actualisation des en-têtes dynamiques (par défaut : 1740000ms / 29 minutes) | `900000` |

137 137

138Pour les protocoles `http/protobuf` et `http/json`, Claude Code envoie chaque demande d'export avec un en-tête `Content-Length`. Avant v2.1.212, les versions de Claude Code à partir de v2.1.191 envoyaient ces demandes avec un codage de transfert fragmenté ; Azure Monitor et d'autres points de terminaison qui nécessitent une longueur déclarée les rejetaient avec des erreurs `411 Length Required` ou `400`.138Pour les protocoles `http/protobuf` et `http/json`, Claude Code envoie chaque demande d'export avec un en-tête `Content-Length`. Avant v2.1.212, les versions de Claude Code à partir de v2.1.191 envoyaient ces demandes avec un codage de transfert fragmenté ; Azure Monitor et d'autres points de terminaison qui nécessitent une longueur déclarée les rejetaient avec des erreurs `411 Length Required` ou `400`.

141 Authentification mTLS141 Authentification mTLS

142</h3>142</h3>

143 143

144La façon dont vous configurez les certificats clients pour l'exportateur OTLP dépend du protocole OTLP utilisé pour ce signal, défini via `OTEL_EXPORTER_OTLP_PROTOCOL` ou le remplacement par signal. La même configuration s'applique aux métriques, journaux et traces.144La façon dont vous configurez les certificats clients pour l'exportateur OTLP dépend du protocole OTLP utilisé pour ce signal, défini via `OTEL_EXPORTER_OTLP_PROTOCOL` ou le remplacement spécifique au signal. La même configuration s'applique aux métriques, journaux et traces.

145 145

147| :- | :- | :- |147| :- | :- | :- |

148| `http/protobuf`, `http/json` | `CLAUDE_CODE_CLIENT_CERT`, `CLAUDE_CODE_CLIENT_KEY`, et optionnellement `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`. Voir [Configuration réseau](/docs/fr/network-config#mtls-authentication) | `NODE_EXTRA_CA_CERTS` |148| `http/protobuf`, `http/json` | `CLAUDE_CODE_CLIENT_CERT`, `CLAUDE_CODE_CLIENT_KEY` et optionnellement `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`. Voir [Configuration réseau](/docs/fr/network-config#mtls-authentication) | `NODE_EXTRA_CA_CERTS` |

149| `grpc` | `OTEL_EXPORTER_OTLP_CLIENT_KEY` et `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`, ou les variantes par signal telles que `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY` pour utiliser un certificat différent par signal | `OTEL_EXPORTER_OTLP_CERTIFICATE` |149| `grpc` | `OTEL_EXPORTER_OTLP_CLIENT_KEY` et `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`, ou les variantes spécifiques au signal telles que `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY` pour utiliser un certificat différent par signal | `OTEL_EXPORTER_OTLP_CERTIFICATE` |

150 150

151Pour `grpc`, le SDK OpenTelemetry lit les variables OTLP standard directement, donc les configurations existantes qui définissent les variables de métriques par signal continuent de fonctionner. Sur les machines avec des paramètres gérés, Claude Code [peut supprimer les identifiants et points de terminaison par signal définis par le développeur](#how-managed-settings-lock-the-otlp-destination) au démarrage.151Pour `grpc`, le SDK OpenTelemetry lit les variables OTLP standard directement, donc les configurations existantes qui définissent les variables de métriques spécifiques au signal continuent de fonctionner. Sur les machines avec des paramètres gérés, Claude Code [peut supprimer les identifiants et points de terminaison spécifiques au signal définis par le développeur](#how-managed-settings-lock-the-otlp-destination) au démarrage.

152 152

153<h3 id="metrics-cardinality-control">153<h3 id="metrics-cardinality-control">

154 Contrôle de la cardinalité des métriques154 Contrôle de la cardinalité des métriques

158 158

160| - | - | - | - |160| - | - | - | - |

166| `OTEL_METRICS_INCLUDE_REPOSITORY` | Inclure les [attributs d'identité de référentiel](#repository-attributes) `vcs.*` sur les métriques et événements. Nécessite Claude Code v2.1.269 ou version ultérieure | `false` | `true` |166| `OTEL_METRICS_INCLUDE_REPOSITORY` | Inclure les [attributs d'identité de référentiel](#repository-attributes) `vcs.*` sur les métriques et événements. Nécessite Claude Code v2.1.269 ou ultérieur | `false` | `true` |

167 167

168Une cardinalité plus faible signifie généralement de meilleures performances et des coûts de stockage plus bas, mais des données moins granulaires pour l'analyse.168Une cardinalité plus basse signifie généralement de meilleures performances et des coûts de stockage plus bas, mais des données moins granulaires pour l'analyse.

169 169

170<h3 id="traces-beta">170<h3 id="traces-beta">

171 Traces (bêta)171 Traces (bêta)

172</h3>172</h3>

173 173

174Le traçage distribué exporte des intervalles qui lient chaque invite utilisateur aux demandes d'API et aux exécutions d'outils qu'elle déclenche, afin que vous puissiez afficher une demande complète sous forme de trace unique dans votre backend de traçage.174Le traçage distribué exporte des spans qui lient chaque invite utilisateur aux demandes API et exécutions d'outils qu'elle déclenche, afin que vous puissiez afficher une demande complète sous forme d'une seule trace dans votre backend de traçage.

175 175

176Le traçage est désactivé par défaut. Pour l'activer, définissez à la fois `CLAUDE_CODE_ENABLE_TELEMETRY=1` et `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1`, puis définissez `OTEL_TRACES_EXPORTER` pour choisir où les intervalles sont envoyés. Les traces réutilisent la [configuration OTLP courante](#common-configuration-variables) pour le point de terminaison, le protocole, les en-têtes et [mTLS](#mtls-authentication). Sur les machines avec des paramètres gérés, Claude Code [peut supprimer les identifiants et points de terminaison par signal définis par le développeur](#how-managed-settings-lock-the-otlp-destination) au démarrage.176Le traçage est désactivé par défaut. Pour l'activer, définissez à la fois `CLAUDE_CODE_ENABLE_TELEMETRY=1` et `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1`, puis définissez `OTEL_TRACES_EXPORTER` pour choisir où les spans sont envoyés. Les traces réutilisent la [configuration OTLP commune](#common-configuration-variables) pour le point de terminaison, le protocole, les en-têtes et [mTLS](#mtls-authentication). Sur les machines avec des paramètres gérés, Claude Code [peut supprimer les identifiants et points de terminaison spécifiques au signal définis par le développeur](#how-managed-settings-lock-the-otlp-destination) au démarrage.

177 177

179| - | - | - |179| - | - | - |

180| `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` | Activer le traçage d'intervalle (obligatoire). `ENABLE_ENHANCED_TELEMETRY_BETA` est également accepté | `1` |180| `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` | Activer le traçage des spans (obligatoire). `ENABLE_ENHANCED_TELEMETRY_BETA` est également accepté | `1` |

185| `OTEL_TRACES_EXPORT_INTERVAL` | Intervalle d'export par lot d'intervalles en millisecondes (par défaut : 5000) | `1000`, `10000` |185| `OTEL_TRACES_EXPORT_INTERVAL` | Intervalle d'export de lot de spans en millisecondes (par défaut : 5000) | `1000`, `10000` |

186 186

187Les intervalles masquent le texte de l'invite utilisateur, les détails d'entrée d'outil et le contenu d'outil par défaut. Définissez `OTEL_LOG_USER_PROMPTS=1`, `OTEL_LOG_TOOL_DETAILS=1` et `OTEL_LOG_TOOL_CONTENT=1` pour les inclure.187Les spans masquent le texte de l'invite utilisateur, les détails d'entrée des outils et le contenu des outils par défaut. Définissez `OTEL_LOG_USER_PROMPTS=1`, `OTEL_LOG_TOOL_DETAILS=1` et `OTEL_LOG_TOOL_CONTENT=1` pour les inclure.

188 188

189Lorsque le traçage est actif, les sous-processus Bash et PowerShell héritent automatiquement d'une variable d'environnement `TRACEPARENT` contenant le contexte de trace W3C de l'intervalle d'exécution d'outil actif. Cela permet à tout sous-processus qui lit `TRACEPARENT` de placer ses propres intervalles sous la même trace, permettant le traçage distribué de bout en bout via les scripts et les commandes que Claude exécute.189Lorsque le traçage est actif, les sous-processus Bash et PowerShell héritent automatiquement d'une variable d'environnement `TRACEPARENT` contenant le contexte de trace W3C du span d'exécution d'outil actif. Cela permet à tout sous-processus qui lit `TRACEPARENT` de placer ses propres spans sous la même trace, permettant le traçage distribué de bout en bout à travers les scripts et commandes que Claude exécute.

190 190

191Lorsque le traçage est actif et que Claude Code est connecté directement à l'API Anthropic, chaque demande de modèle porte un en-tête W3C `traceparent` défini au contexte de l'intervalle `claude_code.llm_request`, et l'en-tête `traceresponse` de l'API est enregistré comme un lien d'intervalle. Ensemble, ceux-ci connectent les intervalles côté client de Claude Code à la trace côté serveur via tout intermédiaire conforme. Les demandes HTTP MCP sortantes portent `traceparent` de la même manière. L'en-tête n'est pas envoyé aux fournisseurs tiers.191Lorsque le traçage est actif et que Claude Code est connecté directement à l'API Anthropic, chaque demande de modèle porte un en-tête W3C `traceparent` défini sur le contexte du span `claude_code.llm_request`, et l'en-tête `traceresponse` de l'API est enregistré comme un lien de span. Ensemble, ceux-ci connectent les spans côté client de Claude Code à la trace côté serveur via tout intermédiaire conforme. Les demandes HTTP MCP sortantes portent `traceparent` de la même manière. L'en-tête n'est pas envoyé aux fournisseurs tiers.

192 192

193Par défaut, l'en-tête `traceparent` sur les demandes de modèle et MCP HTTP est envoyé uniquement lorsque `ANTHROPIC_BASE_URL` n'est pas défini ou pointe vers l'API Anthropic, car certains proxies rejettent les en-têtes non reconnus. La variable `TRACEPARENT` du sous-processus est contrôlée par le même commutateur pour la cohérence. Si vous exécutez Claude Code via un proxy `ANTHROPIC_BASE_URL` personnalisé et souhaitez que le contexte de trace soit propagé, définissez `CLAUDE_CODE_PROPAGATE_TRACEPARENT=1`.193Par défaut, l'en-tête `traceparent` sur les demandes de modèle et MCP HTTP n'est envoyé que lorsque `ANTHROPIC_BASE_URL` n'est pas défini ou pointe vers l'API Anthropic, car certains proxies rejettent les en-têtes non reconnus. La variable `TRACEPARENT` du sous-processus est contrôlée par le même commutateur pour la cohérence. Si vous exécutez Claude Code via un proxy `ANTHROPIC_BASE_URL` personnalisé et souhaitez que le contexte de trace soit propagé, définissez `CLAUDE_CODE_PROPAGATE_TRACEPARENT=1`.

194 194

195Dans le SDK Agent et les sessions non interactives démarrées avec `-p`, Claude Code lit également `TRACEPARENT` et `TRACESTATE` de son propre environnement au démarrage de chaque intervalle d'interaction. Cela permet à un processus d'intégration de transmettre son contexte de trace W3C actif au sous-processus afin que les intervalles de Claude Code apparaissent comme des enfants de la trace distribuée de l'appelant. Les sessions interactives ignorent `TRACEPARENT` entrant pour éviter d'hériter accidentellement des valeurs ambiantes des environnements CI ou conteneur.195Dans le SDK Agent et les sessions non interactives démarrées avec `-p`, Claude Code lit également `TRACEPARENT` et `TRACESTATE` de son propre environnement au démarrage de chaque span d'interaction. Cela permet à un processus d'intégration de transmettre son contexte de trace W3C actif au sous-processus afin que les spans de Claude Code apparaissent comme des enfants de la trace distribuée de l'appelant. Les sessions interactives ignorent `TRACEPARENT` entrant pour éviter d'hériter accidentellement de valeurs ambiantes de CI ou d'environnements de conteneur.

196 196

197Le contexte de trace entrant s'applique également aux [événements](#events). Dans les sessions du SDK Agent et `-p` avec `TRACEPARENT` défini, chaque enregistrement de journal d'événement OTLP porte les valeurs `trace_id` et `span_id` qui le joignent à la trace de votre application, même lorsque l'exportateur de traces n'est pas configuré, afin que votre backend de journalisation puisse corréler les événements avec le reste de la trace.197Le contexte de trace entrant s'applique également aux [événements](#events). Dans les sessions SDK Agent et `-p` avec `TRACEPARENT` défini, chaque enregistrement de journal d'événement OTLP porte les valeurs `trace_id` et `span_id` qui le joignent à la trace de votre application, même lorsque l'exportateur de traces n'est pas configuré, afin que votre backend de journalisation puisse corréler les événements avec le reste de la trace.

198 198

199Un enregistrement émis pendant qu'une interaction est active porte les ID de l'intervalle d'interaction, même lorsque Claude Code l'émet en dehors du contexte asynchrone de l'intervalle, tel que dans un rappel d'invite de permission ou pour un enregistrement mis en mémoire tampon au démarrage et exporté ultérieurement. Un enregistrement émis sans intervalle d'interaction actif porte directement les ID `TRACEPARENT` entrants. Avant v2.1.214, les enregistrements émis en dehors du contexte asynchrone de l'intervalle portaient les ID `TRACEPARENT` entrants à la place des ID de l'intervalle. Avant v2.1.212, les enregistrements d'événements émis en dehors d'un intervalle actif ne portaient pas `trace_id` ou `span_id`.199Un enregistrement émis pendant qu'une interaction est active porte les ID du span d'interaction, même lorsque Claude Code l'émet en dehors du contexte asynchrone du span, comme dans un rappel d'invite de permission ou pour un enregistrement mis en mémoire tampon au démarrage et exporté ultérieurement. Un enregistrement émis sans span d'interaction actif porte directement les ID `TRACEPARENT` entrants. Avant v2.1.214, les enregistrements émis en dehors du contexte asynchrone du span portaient les ID `TRACEPARENT` entrants à la place des ID du span. Avant v2.1.212, les enregistrements d'événements émis en dehors d'un span actif ne portaient pas `trace_id` ou `span_id`.

200 200

201<h4 id="span-hierarchy">201<h4 id="span-hierarchy">

202 Hiérarchie des intervalles202 Hiérarchie des spans

203</h4>203</h4>

204 204

205Chaque invite utilisateur démarre un intervalle racine `claude_code.interaction`. Les appels d'API, les appels d'outils et les exécutions de hooks sont enregistrés comme ses enfants. Les intervalles d'outils ont deux intervalles enfants : un pour le temps passé à attendre une décision de permission et un pour l'exécution elle-même. Lorsque l'outil Agent ou l'outil Task hérité génère un sous-agent, les intervalles d'API et d'outils du sous-agent se placent sous l'intervalle `claude_code.tool` du parent.205Chaque invite utilisateur démarre un span racine `claude_code.interaction`. Les appels API, les appels d'outils et les exécutions de hooks sont enregistrés comme ses enfants. Les spans d'outils ont deux spans enfants : un pour le temps passé à attendre une décision de permission et un pour l'exécution elle-même. Lorsque l'outil Agent ou l'outil Task hérité génère un sous-agent, les spans API et d'outils du sous-agent s'imbriquent sous le span `claude_code.tool` du parent.

206 206

207```text theme={null}207```text theme={null}

208claude_code.interaction208claude_code.interaction

209├── claude_code.llm_request209├── claude_code.llm_request

210├── claude_code.hook (nécessite un traçage bêta détaillé)210├── claude_code.hook (requires detailed beta tracing)

211└── claude_code.tool211└── claude_code.tool

212 ├── claude_code.tool.blocked_on_user212 ├── claude_code.tool.blocked_on_user

213 ├── claude_code.tool.execution213 ├── claude_code.tool.execution

214 └── (outil Agent) intervalles claude_code.llm_request / claude_code.tool du sous-agent214 └── (Agent tool) subagent claude_code.llm_request / claude_code.tool spans

215```215```

216 216

217Dans les sessions du SDK Agent et `claude -p`, `claude_code.interaction` lui-même devient un enfant de l'intervalle de l'appelant lorsque `TRACEPARENT` est défini dans l'environnement.217Dans les sessions SDK Agent et `claude -p`, `claude_code.interaction` lui-même devient un enfant du span de l'appelant lorsque `TRACEPARENT` est défini dans l'environnement.

218 218

219Lorsqu'un hook `PreToolUse` [reporte un appel d'outil](/docs/fr/hooks#defer-a-tool-call-for-later), Claude Code enregistre le contexte de trace du tour qui l'a reporté. Lorsque vous reprenez la session et que l'outil s'exécute à nouveau, les intervalles de l'outil rejoignent la trace de ce tour antérieur en tant qu'enfants de l'intervalle `claude_code.interaction` du tour.219Lorsqu'un hook `PreToolUse` [reporte un appel d'outil](/docs/fr/hooks#defer-a-tool-call-for-later), Claude Code enregistre le contexte de trace du tour qui l'a reporté. Lorsque vous reprenez la session et que l'outil s'exécute à nouveau, les spans de l'outil rejoignent la trace du tour antérieur en tant qu'enfants du span `claude_code.interaction` du tour.

220 220

221<h4 id="span-attributes">221<h4 id="span-attributes">

222 Attributs des intervalles222 Attributs des spans

223</h4>223</h4>

224 224

225Chaque intervalle porte les [attributs standard](#standard-attributes) plus un attribut `span.type` correspondant à son nom. Les tableaux ci-dessous listent les attributs supplémentaires définis sur chaque intervalle. Les intervalles `llm_request`, `tool.execution` et `hook` définissent le statut OpenTelemetry `ERROR` lorsqu'ils enregistrent un échec ; les autres intervalles se terminent toujours avec le statut `UNSET`.225Chaque span porte les [attributs standard](#standard-attributes) plus un attribut `span.type` correspondant à son nom. Les tableaux ci-dessous énumèrent les attributs supplémentaires définis sur chaque span. Les spans `llm_request`, `tool.execution` et `hook` définissent le statut OpenTelemetry `ERROR` lorsqu'ils enregistrent un échec ; les autres spans se terminent toujours avec le statut `UNSET`.

226 226

227**`claude_code.interaction`**227**`claude_code.interaction`**

228 228

233| `interaction.sequence` | Compteur basé sur 1 des interactions, compté par processus Claude Code plutôt que par session, comme décrit pour [`event.sequence`](#event-correlation-attributes) | |233| `interaction.sequence` | Compteur basé sur 1 des interactions, compté par processus Claude Code plutôt que par session, comme décrit pour [`event.sequence`](#event-correlation-attributes) | |

234| `parent.source` | Comment l'intervalle a obtenu son parent de trace : `env` lorsqu'il a été parent sous un `TRACEPARENT` entrant, `none` lorsqu'il a démarré sa propre trace. Nécessite Claude Code v2.1.268 ou version ultérieure | |234| `parent.source` | Comment le span a obtenu son parent de trace : `env` lorsqu'il a été parent sous un `TRACEPARENT` entrant, `none` lorsqu'il a démarré sa propre trace. Nécessite Claude Code v2.1.268 ou ultérieur | |

236 236

237**`claude_code.llm_request`**237**`claude_code.llm_request`**

240| - | - | - |240| - | - | - |

245| `query_source_safe` | Forme bornée de `query_source`, émise que le traçage bêta détaillé soit actif ou non, avec des valeurs telles que `repl_main_thread` ou `agent.builtin.general-purpose`. `:` devient `.` et les agents nommés par l'utilisateur apparaissent comme `agent.custom`. Nécessite Claude Code v2.1.268 ou version ultérieure | |245| `query_source_safe` | Forme bornée de `query_source`, émise que le traçage bêta détaillé soit actif ou non, avec des valeurs telles que `repl_main_thread` ou `agent.builtin.general-purpose`. `:` devient `.` et les agents nommés par l'utilisateur apparaissent comme `agent.custom`. Nécessite Claude Code v2.1.268 ou ultérieur | |

247| `parent_agent_id` | Identifiant de l'agent qui a généré celui-ci. Absent pour la session principale et pour les agents générés directement à partir de celle-ci | |247| `parent_agent_id` | Identifiant de l'agent qui a généré celui-ci. Absent pour la session principale et pour les agents générés directement à partir de celle-ci | |

248| `workflow.run_id` | Identifiant d'exécution de l'exécution de l'outil [Workflow](/docs/fr/workflows), préfixé `wf_`. Absent pour les agents non générés par un workflow | |248| `workflow.run_id` | Identifiant d'exécution de l'exécution de l'outil [Workflow](/docs/fr/workflows) qui a généré cet agent, préfixé `wf_`. Absent pour les agents non générés par un flux de travail | |

249| `workflow.name` | Nom du workflow qui a généré cet agent. Les noms créés par l'utilisateur sont remplacés par `custom` sauf si la porte est définie | `OTEL_LOG_TOOL_DETAILS` |249| `workflow.name` | Nom du flux de travail qui a généré cet agent. Les noms créés par l'utilisateur sont remplacés par `custom` sauf si la porte est définie | `OTEL_LOG_TOOL_DETAILS` |

251| `effort` | [Niveau d'effort](/docs/fr/model-config#adjust-effort-level) appliqué à la demande : `low`, `medium`, `high`, `xhigh`, ou `max`. Absent lorsque Claude Code n'envoie pas de niveau d'effort, par exemple sur un modèle qui ne supporte pas l'effort. Nécessite Claude Code v2.1.274 ou version ultérieure | |251| `effort` | [Niveau d'effort](/docs/fr/model-config#adjust-effort-level) 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 le supporte pas. Nécessite Claude Code v2.1.274 ou ultérieur | |

255| `first_content_ms` | Temps du début de la demande au premier bloc de contenu de la tentative réussie, en millisecondes. Absent sur les demandes qui sont revenues au chemin non-streaming. Nécessite Claude Code v2.1.268 ou version ultérieure | |255| `first_content_ms` | Temps du début de la demande au premier bloc de contenu de la tentative réussie, en millisecondes. Absent sur les demandes qui sont revenues au chemin non-streaming. Nécessite Claude Code v2.1.268 ou ultérieur | |

267| `error_class` | Jeton de classe d'erreur court lorsque la demande a échoué, tel que `api_timeout` ou `server_overload`. Nécessite Claude Code v2.1.268 ou version ultérieure | |267| `error_class` | Jeton de classe d'erreur court lorsque la demande a échoué, comme `api_timeout` ou `server_overload`. Nécessite Claude Code v2.1.268 ou ultérieur | |

269| `stop_reason` | `stop_reason` de la réponse API, tel que `end_turn`, `tool_use`, `max_tokens`, `stop_sequence`, `pause_turn`, ou `refusal` | |269| `stop_reason` | `stop_reason` de réponse API, comme `end_turn`, `tool_use`, `max_tokens`, `stop_sequence`, `pause_turn` ou `refusal` | |

270| `gen_ai.response.finish_reasons` | Même valeur que `stop_reason`, enveloppée dans un tableau de chaînes. Convention sémantique GenAI OpenTelemetry | |270| `gen_ai.response.finish_reasons` | Même valeur que `stop_reason`, enveloppée dans un tableau de chaînes. Convention sémantique OpenTelemetry GenAI | |

271 271

272Chaque tentative de nouvelle tentative est également enregistrée comme un événement d'intervalle `gen_ai.request.attempt` avec les attributs `attempt` et `client_request_id`.272Chaque tentative de nouvelle tentative est également enregistrée en tant qu'événement de span `gen_ai.request.attempt` avec les attributs `attempt` et `client_request_id`.

273 273

274**`claude_code.tool`**274**`claude_code.tool`**

275 275

277| - | - | - |277| - | - | - |

279| `tool_name_safe` | Forme de `tool_name` qui ne porte aucun nom choisi par l'utilisateur. Les noms d'outils intégrés passent verbatim. Les noms d'outils MCP apparaissent comme `mcp_other`, sauf les noms d'outils correspondant à quelques formes fixes, tels que les outils `playwright` nommés `browser_*`, qui passent verbatim. Nécessite Claude Code v2.1.268 ou version ultérieure | |279| `tool_name_safe` | Forme de `tool_name` qui ne porte aucun nom choisi par l'utilisateur. Les noms d'outils intégrés passent verbatim. Les noms d'outils MCP apparaissent comme `mcp_other`, sauf les noms d'outils correspondant à quelques formes fixes, comme les outils `playwright` nommés `browser_*`, qui passent verbatim. Nécessite Claude Code v2.1.268 ou ultérieur | |

280| `bash_command_class` | Pour l'outil Bash : catégorie du premier programme de la commande à partir d'une liste fixe, telle que `vcs` ou `package_manager`. `other` pour un programme en dehors de la liste, `unparsed` lorsque la ligne ne peut pas être analysée. Nécessite Claude Code v2.1.268 ou version ultérieure | |280| `bash_command_class` | Pour l'outil Bash : catégorie du premier programme de la commande à partir d'une liste fixe, comme `vcs` ou `package_manager`. `other` pour un programme en dehors de la liste, `unparsed` lorsque la ligne ne peut pas être analysée. Nécessite Claude Code v2.1.268 ou ultérieur | |

281| `bash_argv0` | Pour l'outil Bash : le premier programme de la commande lorsqu'il est sur la même liste fixe, tel que `git` ou `npm`. `other` pour tout programme en dehors de la liste. Nécessite Claude Code v2.1.268 ou version ultérieure | |281| `bash_argv0` | Pour l'outil Bash : le premier programme de la commande lorsqu'il est sur la même liste fixe, comme `git` ou `npm`. `other` pour tout programme en dehors de la liste. Nécessite Claude Code v2.1.268 ou ultérieur | |

285| `parent_agent_id` | Identifiant de l'agent qui a généré celui-ci. Absent pour la session principale et pour les agents générés directement à partir de celle-ci | |285| `parent_agent_id` | Identifiant de l'agent qui a généré celui-ci. Absent pour la session principale et pour les agents générés directement à partir de celle-ci | |

286| `workflow.run_id` | Identifiant d'exécution de l'exécution de l'outil Workflow qui a généré cet agent, préfixé `wf_`. Absent pour les agents non générés par un workflow | |286| `workflow.run_id` | Identifiant d'exécution de l'exécution de l'outil Workflow qui a généré cet agent, préfixé `wf_`. Absent pour les agents non générés par un flux de travail | |

287| `workflow.name` | Nom du workflow qui a généré cet agent. Les noms créés par l'utilisateur sont remplacés par `custom` sauf si la porte est définie | `OTEL_LOG_TOOL_DETAILS` |287| `workflow.name` | Nom du flux de travail qui a généré cet agent. Les noms créés par l'utilisateur sont remplacés par `custom` sauf si la porte est définie | `OTEL_LOG_TOOL_DETAILS` |

288| `tool_use_id` | L'ID du bloc `tool_use` du modèle pour cet appel. Correspond au `tool_use_id` sur les événements [tool\_result](#tool-result-event) et [tool\_decision](#tool-decision-event) et dans les charges utiles de hooks, afin que vous puissiez joindre l'intervalle à ces enregistrements | |288| `tool_use_id` | L'ID du bloc `tool_use` du modèle pour cet appel. Correspond au `tool_use_id` sur les événements [tool\_result](#tool-result-event) et [tool\_decision](#tool-decision-event) et dans les charges utiles de hooks, afin que vous puissiez joindre le span à ces enregistrements | |

294 294

~~295<span id="tool-output-span-event" />**Événement d'intervalle `tool.output` sur `claude_code.tool`**~~295<span id="tool-output-span-event" />**Événement de span `tool.output` sur `claude_code.tool`**

296 296

297Si vous définissez `OTEL_LOG_TOOL_CONTENT=1`, les appels Read et Bash peuvent enregistrer un événement d'intervalle `tool.output` sur l'intervalle `claude_code.tool`. Les appels Edit et Write enregistrent un événement uniquement lorsque vous définissez également `OTEL_LOG_TOOL_DETAILS=1`. Cette variable n'est pas limitée à ces deux outils, donc vérifiez sa [ligne dans le tableau de configuration](#common-configuration-variables) pour les arguments qu'elle ajoute ailleurs.297Si vous définissez `OTEL_LOG_TOOL_CONTENT=1`, les appels Read et Bash peuvent enregistrer un événement de span `tool.output` sur le span `claude_code.tool`. Les appels Edit et Write en enregistrent un uniquement lorsque vous définissez également `OTEL_LOG_TOOL_DETAILS=1`. Cette variable n'est pas limitée à ces deux outils, donc vérifiez sa [ligne dans le tableau de configuration](#common-configuration-variables) pour les arguments qu'elle ajoute ailleurs.

298 298

299Claude Code écrit cet événement à partir du retour réussi d'un appel d'outil, donc un appel qui lève une erreur n'enregistre rien, quel que soit l'outil. Parmi les appels qui retournent, il n'enregistre pas d'événement `tool.output` pour :299Les outils MCP, WebFetch et WebSearch enregistrent également cet événement, sur Claude Code v2.1.283 ou ultérieur.

300 300

301* Un appel à tout outil autre que Read, Edit, Write et Bash, y compris les outils MCP et WebFetch301Claude Code écrit cet événement à partir du retour réussi d'un appel d'outil, donc un appel qui lève une erreur n'enregistre rien, quel que soit l'outil. Parmi les appels qui retournent, il n'enregistre aucun événement `tool.output` pour :

302* Un Read qui retourne autre chose que du texte de fichier, tel qu'une image, un PDF ou une relecture d'un fichier dont le contenu n'a pas changé302

303* Un appel à tout outil autre que Read, Edit, Write, Bash, WebFetch, WebSearch et les outils MCP

304* 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é

303* Un appel Edit ou Write, sauf si vous définissez également `OTEL_LOG_TOOL_DETAILS=1`305* Un appel Edit ou Write, sauf si vous définissez également `OTEL_LOG_TOOL_DETAILS=1`

306* 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](/docs/fr/interactive-mode#when-claude-code-sends-what-you-queued) pendant que l'appel s'exécutait. Claude reçoit ce résultat plus tard, après la fin du span d'outil

304 307

305L'événement porte ces attributs, chacun tronqué à la limite de contenu (60 Ko par défaut). `Contrôlé par` nomme la variable qu'un attribut nécessite en plus de `OTEL_LOG_TOOL_CONTENT=1`, et pour Edit et Write cette variable contrôle l'événement lui-même plutôt que l'attribut.308L'événement porte ces attributs, chacun tronqué à la limite de contenu (60 Ko par défaut). `Contrôlé par` nomme la variable dont un attribut a besoin en plus de `OTEL_LOG_TOOL_CONTENT=1`, et pour Edit et Write cette variable contrôle l'événement lui-même plutôt que l'attribut.

306 309

308| - | - | - |311| - | - | - |

310| `output` | Sortie combinée d'une commande Bash, avec stderr entrelacé dans stdout | |313| `output` | Pour l'outil Bash, la sortie combinée de la commande, avec stderr entrelacé dans stdout. Pour un outil MCP, WebFetch ou WebSearch, le résultat que l'outil a retourné : blocs de texte joints par des sauts de ligne, avec une image ou un document remplacé par un espace réservé comme `[image]` | |

314 317

315L'attribut `tool_name` de l'intervalle parent vous indique quel outil un événement provient. Un attribut coupé à la limite de contenu est accompagné de `<attribute>_truncated` et `<attribute>_original_length`.318L'attribut `tool_name` du span parent vous indique quel outil un événement provient. Un attribut coupé à la limite de contenu est accompagné de `<attribute>_truncated` et `<attribute>_original_length`.

316 319

317**`claude_code.tool.blocked_on_user`**320**`claude_code.tool.blocked_on_user`**

318 321

320| - | - | - |323| - | - | - |

324 327

325**`claude_code.tool.execution`**328**`claude_code.tool.execution`**

326 329

328| - | - | - |331| - | - | - |

333| `error` | Chaîne de catégorie d'erreur lorsque l'exécution a échoué, telle que `Error:ENOENT` ou `ShellError`. Contient le message d'erreur complet à la place lorsque la porte est définie | `OTEL_LOG_TOOL_DETAILS` |336| `error` | Chaîne de catégorie d'erreur lorsque l'exécution a échoué, comme `Error:ENOENT` ou `ShellError`. Contient le message d'erreur complet à la place lorsque la porte est définie | `OTEL_LOG_TOOL_DETAILS` |

334| `error_class` | La catégorie d'erreur sous forme d'identifiant, avec les caractères en dehors des lettres, des chiffres et des traits de soulignement remplacés par `_`, tels que `Error_ENOENT` ou `ShellError`. Porte la catégorie même lorsque `error` porte le message complet. Nécessite Claude Code v2.1.268 ou version ultérieure | |337| `error_class` | La catégorie d'erreur sous forme d'identifiant, avec les caractères en dehors des lettres, chiffres et traits de soulignement remplacés par `_`, comme `Error_ENOENT` ou `ShellError`. Porte la catégorie même lorsque `error` porte le message complet. Nécessite Claude Code v2.1.268 ou ultérieur | |

335 338

336**`claude_code.hook`**339**`claude_code.hook`**

337 340

338Cet intervalle n'apparaît que lorsque le traçage bêta détaillé est actif, ce qui nécessite `ENABLE_BETA_TRACING_DETAILED=1` et `BETA_TRACING_ENDPOINT`, une paire qui [change également où vos journaux et traces vont](/docs/fr/env-vars#variables). Définissez la paire dans votre shell, vos paramètres utilisateur ou vos paramètres gérés ; les deux variables sont ignorées dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env). `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` seul ne le produit pas.341Ce span n'apparaît que lorsque le traçage bêta détaillé est actif, ce qui nécessite `ENABLE_BETA_TRACING_DETAILED=1` et `BETA_TRACING_ENDPOINT`, une paire qui [change également où vos journaux et traces vont](/docs/fr/env-vars#variables). Définissez la paire dans votre shell, vos paramètres utilisateur ou vos paramètres gérés ; les deux variables sont ignorées dans les [paramètres de projet et locaux](/docs/fr/settings-reference#variables-claude-code-ignores-in-env). `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` seul ne le produit pas.

339 342

340Dans les sessions CLI interactives, le traçage bêta détaillé nécessite également que votre organisation soit sur liste blanche pour la fonctionnalité. Les sessions du SDK Agent et non interactives `-p` ne nécessitent pas de liste blanche.343Dans les sessions CLI interactives, le traçage bêta détaillé nécessite également que votre organisation soit sur la liste blanche pour la fonctionnalité. Les sessions SDK Agent et non interactives `-p` ne nécessitent pas de liste blanche.

341 344

343| - | - | - |346| - | - | - |

354<span id="new-context-gates" />357<span id="new-context-gates" />

355 358

356<Note>359<Note>

357 Les attributs supplémentaires porteurs de contenu tels que `new_context`, `system_prompt_preview`, `user_system_prompt`, `tool_input` et `response.model_output` sont émis uniquement lorsque le traçage bêta détaillé est actif. Ils ne font pas partie du schéma d'intervalle stable.360 Les attributs supplémentaires porteurs de contenu tels que `new_context`, `system_prompt_preview`, `user_system_prompt`, `tool_input` et `response.model_output` ne sont émis que lorsque le traçage bêta détaillé est actif. Ils ne font pas partie du schéma de span stable.

358 361

359 La porte sur `new_context` dépend de l'intervalle qui le porte, et chaque copie est tronquée à la limite de contenu (60 Ko par défaut). Sur l'intervalle `claude_code.tool` il porte le résultat de cet appel d'outil, quel que soit l'outil, et nécessite `OTEL_LOG_TOOL_CONTENT=1`. Sur l'intervalle `claude_code.interaction` il porte l'invite utilisateur, et sur l'intervalle `claude_code.llm_request` les nouveaux messages utilisateur et résultats d'outils de cette demande. Les deux nécessitent `OTEL_LOG_USER_PROMPTS=1`.362 La porte sur `new_context` dépend du span qui le porte, et chaque copie est tronquée à la limite de contenu (60 Ko par défaut). Sur le span `claude_code.tool`, il porte le résultat de cet appel d'outil, quel que soit l'outil, et nécessite `OTEL_LOG_TOOL_CONTENT=1`. Sur le span `claude_code.interaction`, il porte l'invite utilisateur, et sur le span `claude_code.llm_request`, les nouveaux messages utilisateur et résultats d'outils de cette demande. Les deux nécessitent `OTEL_LOG_USER_PROMPTS=1`.

360 363

361 `user_system_prompt` nécessite également `OTEL_LOG_USER_PROMPTS=1`. Il porte uniquement le texte du prompt système que vous fournissez via l'option SDK `systemPrompt` ou les drapeaux `--system-prompt` et `--append-system-prompt`, tronqué à la limite de contenu (60 Ko par défaut), et est émis une fois par session plutôt que par demande.364 `user_system_prompt` nécessite en outre `OTEL_LOG_USER_PROMPTS=1`. Il porte uniquement le texte d'invite système que vous fournissez via l'option SDK `systemPrompt` ou les drapeaux `--system-prompt` et `--append-system-prompt`, tronqué à la limite de contenu (60 Ko par défaut), et est émis une fois par session plutôt que par demande.

362</Note>365</Note>

363 366

364<h3 id="dynamic-headers">367<h3 id="dynamic-headers">

365 En-têtes dynamiques368 En-têtes dynamiques

366</h3>369</h3>

367 370

368Pour les environnements d'entreprise qui nécessitent une authentification dynamique, vous pouvez configurer un script pour générer des en-têtes dynamiquement. Les en-têtes dynamiques s'appliquent uniquement aux protocoles `http/protobuf` et `http/json`. Avec le protocole `grpc`, Claude Code utilise uniquement les variables d'en-têtes statiques, `OTEL_EXPORTER_OTLP_HEADERS` et ses variantes par signal.371Pour les environnements d'entreprise qui nécessitent une authentification dynamique, vous pouvez configurer un script pour générer des en-têtes dynamiquement. Les en-têtes dynamiques s'appliquent uniquement aux protocoles `http/protobuf` et `http/json`. Avec le protocole `grpc`, Claude Code utilise uniquement les variables d'en-têtes statiques, `OTEL_EXPORTER_OTLP_HEADERS` et ses variantes spécifiques au signal.

369 372

370<h4 id="settings-configuration">373<h4 id="settings-configuration">

371 Configuration des paramètres374 Configuration des paramètres

385 Exigences du script388 Exigences du script

386</h4>389</h4>

387 390

388Le script doit générer du JSON valide avec des paires clé-valeur de chaînes représentant les en-têtes HTTP :391Le script doit produire un JSON valide avec des paires clé-valeur de chaîne représentant les en-têtes HTTP :

389 392

390```bash theme={null}393```bash theme={null}

391#!/bin/bash394#!/bin/bash

392# Exemple : plusieurs en-têtes395# Example: Multiple headers

393echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"396echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"

394```397```

395 398

396Si le script d'aide échoue ou imprime une sortie qui ne répond pas à ces exigences, les exports échouent et votre backend de télémétrie ne reçoit rien de la session jusqu'à ce que le script fonctionne à nouveau. Claude Code signale l'erreur dans :399Si l'assistant échoue ou imprime une sortie qui ne répond pas à ces exigences, les exports échouent et votre backend de télémétrie ne reçoit rien de la session jusqu'à ce que l'assistant fonctionne à nouveau. Claude Code signale l'échec dans :

397 400

398* Une notification d'avertissement dans les sessions interactives, [`otelHeadersHelper failed; telemetry is not being exported`](/docs/fr/errors#otelheadershelper-failed), affichée une fois par session lorsque le script d'aide échoue pour la première fois401* Une notification d'avertissement dans les sessions interactives, [`otelHeadersHelper failed; telemetry is not being exported`](/docs/fr/errors#otelheadershelper-failed), affichée une fois par session lorsque l'assistant échoue pour la première fois

399* La sortie `/status`402* Sortie `/status`

400* Le journal de débogage, lors de l'exécution avec [`--debug`](/docs/fr/cli-reference#cli-flags) ou après l'exécution de `/debug` dans la session403* Le journal de débogage, lors de l'exécution avec [`--debug`](/docs/fr/cli-reference#cli-flags) ou après l'exécution de `/debug` dans la session

401* stderr, dans les sessions non interactives démarrées avec `-p`404* stderr, dans les sessions non interactives démarrées avec `-p`

402 405

404 Comportement d'actualisation407 Comportement d'actualisation

405</h4>408</h4>

406 409

407Le script d'aide des en-têtes s'exécute au démarrage et périodiquement par la suite pour prendre en charge l'actualisation des jetons. Par défaut, le script s'exécute toutes les 29 minutes. Personnalisez l'intervalle avec la variable d'environnement `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`.410Le script d'assistant d'en-têtes s'exécute au démarrage et périodiquement par la suite pour prendre en charge l'actualisation des jetons. Par défaut, le script s'exécute toutes les 29 minutes. Personnalisez l'intervalle avec la variable d'environnement `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`.

408 411

409<h3 id="multi-team-organization-support">412<h3 id="multi-team-organization-support">

410 Support des organisations multi-équipes413 Support des organisations multi-équipes

411</h3>414</h3>

412 415

413Les organisations avec plusieurs équipes ou départements peuvent ajouter des attributs personnalisés pour distinguer les différents groupes à l'aide de la variable d'environnement `OTEL_RESOURCE_ATTRIBUTES` :416Les organisations avec plusieurs équipes ou départements peuvent ajouter des attributs personnalisés pour distinguer les différents groupes en utilisant la variable d'environnement `OTEL_RESOURCE_ATTRIBUTES` :

414 417

415```bash theme={null}418```bash theme={null}

416# Ajouter des attributs personnalisés pour l'identification de l'équipe419# Add custom attributes for team identification

417export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"420export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"

418```421```

419 422

420Ces attributs personnalisés seront inclus dans toutes les métriques et tous les événements, ce qui vous permet de :423Ces attributs personnalisés sont inclus dans toutes les métriques et événements, ce qui vous permet de :

421 424

422* Filtrer les métriques par équipe ou département425* Filtrer les métriques par équipe ou département

423* Suivre les coûts par centre de coûts426* Suivre les coûts par centre de coûts

424* Créer des tableaux de bord spécifiques à l'équipe427* Créer des tableaux de bord spécifiques à l'équipe

425* Configurer des alertes pour des équipes spécifiques428* Configurer des alertes pour des équipes spécifiques

426 429

427Claude Code attache ces valeurs comme attributs sur chaque point de données de métriques et enregistrement d'événement, en plus de les envoyer dans le bloc de ressources OTLP. Parce que la plupart des backends de métriques exposent les attributs de point de données comme des étiquettes interrogeables, vous pouvez regrouper et filtrer les métriques par vos clés personnalisées directement. Sauf pour les [attributs de référentiel](#repository-attributes) `vcs.*`, les clés personnalisées ne remplacent jamais les [attributs standard](#standard-attributes) tels que `user.id` ou `session.id` : lorsqu'une clé entre en collision, Claude Code conserve la valeur intégrée.430Claude Code attache ces valeurs comme attributs sur chaque point de données de métrique et enregistrement d'événement, en plus de les envoyer dans le bloc de ressource OTLP. Parce que la plupart des backends de métriques exposent les attributs de point de données comme des étiquettes interrogeables, vous pouvez regrouper et filtrer les métriques par vos clés personnalisées directement. À l'exception des [attributs de référentiel](#repository-attributes) `vcs.*`, les clés personnalisées ne remplacent jamais les [attributs standard](#standard-attributes) tels que `user.id` ou `session.id` : lorsqu'une clé entre en collision, Claude Code conserve la valeur intégrée.

428 431

429Chaque clé personnalisée devient une étiquette sur chaque série de métriques, donc les valeurs de haute cardinalité augmentent le coût de stockage dans votre backend de métriques. Pour envoyer des attributs personnalisés dans le bloc de ressources uniquement et les omettre des étiquettes de point de données, définissez `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES=false`. Voir [Contrôle de la cardinalité des métriques](#metrics-cardinality-control).432Chaque clé personnalisée devient une étiquette sur chaque série de métriques, donc les valeurs de cardinalité élevée augmentent le coût de stockage dans votre backend de métriques. Pour envoyer des attributs personnalisés dans le bloc de ressource uniquement et les omettre des étiquettes de point de données, définissez `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES=false`. Voir [Contrôle de la cardinalité des métriques](#metrics-cardinality-control).

430 433

431<Warning>434<Warning>

432 La variable d'environnement `OTEL_RESOURCE_ATTRIBUTES` utilise des paires clé=valeur séparées par des virgules avec des exigences de formatage strictes :435 La variable d'environnement `OTEL_RESOURCE_ATTRIBUTES` utilise des paires clé=valeur séparées par des virgules avec des exigences de formatage strictes :

433 436

434 * **Aucun espace autorisé** : Les valeurs ne peuvent pas contenir d'espaces. Par exemple, `user.organizationName=My Company` est invalide437 * **Aucun espace autorisé** : les valeurs ne peuvent pas contenir d'espaces. Par exemple, `user.organizationName=My Company` est invalide

435 * **Format** : Doit être des paires clé=valeur séparées par des virgules : `key1=value1,key2=value2`438 * **Format** : doit être des paires clé=valeur séparées par des virgules : `key1=value1,key2=value2`

436 * **Caractères autorisés** : Uniquement les caractères US-ASCII à l'exclusion des caractères de contrôle, des espaces, des guillemets doubles, des virgules, des points-virgules et des barres obliques inverses439 * **Caractères autorisés** : uniquement les caractères US-ASCII à l'exclusion des caractères de contrôle, des espaces, des guillemets doubles, des virgules, des points-virgules et des barres obliques inverses

437 * **Caractères spéciaux** : Les caractères en dehors de la plage autorisée doivent être codés en pourcentage440 * **Caractères spéciaux** : les caractères en dehors de la plage autorisée doivent être codés en pourcentage

438 441

439 Pour une valeur qui aurait besoin d'un espace, utilisez des traits de soulignement ou camelCase à la place. Les exemples suivants définissent `org.name` avec chaque forme :442 Pour une valeur qui aurait besoin d'un espace, utilisez des traits de soulignement ou camelCase à la place. Les exemples suivants définissent `org.name` avec chaque forme :

440 443

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

450 ```453 ```

451 454

452 Entourer les valeurs de guillemets n'échappe pas aux espaces. Par exemple, `org.name="My Company"` donne la valeur littérale `"My Company"` avec les guillemets inclus, pas `My Company`.455 L'enveloppe des valeurs entre guillemets n'échappe pas aux espaces. Par exemple, `org.name="My Company"` résulte en la valeur littérale `"My Company"` avec les guillemets inclus, pas `My Company`.

453</Warning>456</Warning>

454 457

455<h3 id="example-configurations">458<h3 id="example-configurations">

456 Exemples de configurations459 Exemples de configurations

457</h3>460</h3>

458 461

459Définissez ces variables d'environnement avant d'exécuter `claude`. Chaque scénario ci-dessous montre une configuration complète, et chaque variable est décrite sous [Variables de configuration courantes](#common-configuration-variables). Pour confirmer qu'une configuration a pris effet, vérifiez votre backend pour la métrique `claude_code.session.count` après le démarrage d'une session ; le [Démarrage rapide](#quick-start) couvre la vérification en journaux uniquement et ce qu'il faut vérifier quand rien n'arrive.462Définissez ces variables d'environnement avant d'exécuter `claude`. Chaque scénario ci-dessous montre une configuration complète, et chaque variable est décrite sous [Variables de configuration communes](#common-configuration-variables). Pour confirmer qu'une configuration a pris effet, vérifiez votre backend pour la métrique `claude_code.session.count` après le démarrage d'une session ; le [Démarrage rapide](#quick-start) couvre la vérification en logs uniquement et ce qu'il faut vérifier lorsque rien n'arrive.

460 463

461Pour le débogage de console avec un intervalle d'export d'1 seconde :464Pour le débogage de console avec un intervalle d'export d'une seconde :

462 465

463```bash theme={null}466```bash theme={null}

464export CLAUDE_CODE_ENABLE_TELEMETRY=1467export CLAUDE_CODE_ENABLE_TELEMETRY=1

475export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317478export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

476```479```

477 480

478Pour Prometheus, récupéré depuis `http://localhost:9464/metrics` :481Pour Prometheus, récupéré à partir de `http://localhost:9464/metrics` :

479 482

480```bash theme={null}483```bash theme={null}

481export CLAUDE_CODE_ENABLE_TELEMETRY=1484export CLAUDE_CODE_ENABLE_TELEMETRY=1

482export OTEL_METRICS_EXPORTER=prometheus485export OTEL_METRICS_EXPORTER=prometheus

483```486```

484 487

485Sur un [environnement auto-hébergé](/docs/fr/self-hosted-environments-reference#pass-through-session-child-metrics), la session lie le port 9464 uniquement à la capacité par défaut du runner d'un. À une capacité plus élevée, le runner réexpose les compteurs et jauges de session sur son propre point de terminaison `/metrics` à la place.488Sur un [environnement auto-hébergé](/docs/fr/self-hosted-environments-reference#pass-through-session-child-metrics), la session lie le port 9464 uniquement à la capacité par défaut du runner d'une. À une capacité plus élevée, le runner réexpose les compteurs et jauges de session sur son propre point de terminaison `/metrics` à la place.

486 489

487Pour envoyer des métriques à plusieurs exportateurs :490Pour envoyer des métriques à plusieurs exportateurs :

488 491

504export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=http://logs.example.com:4317507export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=http://logs.example.com:4317

505```508```

506 509

507Pour exporter les métriques uniquement, sans événements ni journaux :510Pour exporter uniquement les métriques, sans événements ni journaux :

508 511

509```bash theme={null}512```bash theme={null}

510export CLAUDE_CODE_ENABLE_TELEMETRY=1513export CLAUDE_CODE_ENABLE_TELEMETRY=1

513export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317516export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

514```517```

515 518

516Pour exporter les événements et journaux uniquement, sans métriques :519Pour exporter uniquement les événements et journaux, sans métriques :

517 520

518```bash theme={null}521```bash theme={null}

519export CLAUDE_CODE_ENABLE_TELEMETRY=1522export CLAUDE_CODE_ENABLE_TELEMETRY=1

522export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317525export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

523```526```

524 527

528<h2 id="telemetry-from-cloud-sessions-and-claude-tag">

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

530</h2>

531

532[Les sessions cloud](/docs/fr/claude-code-on-the-web), y compris les sessions du canal [Claude Tag](https://claude.com/docs/claude-tag/overview), s'exécutent dans des [environnements cloud](/docs/fr/cloud-environments) plutôt que sur les appareils de vos utilisateurs, donc un fichier de paramètres gérés ou un profil shell sur ces appareils ne configure pas leur télémétrie. Pour les sessions dans les environnements hébergés par Anthropic, cette section couvre l'endroit où définir les variables de télémétrie, comment rendre votre collecteur accessible à partir de l'environnement, et comment distinguer les sessions cloud et Claude Tag dans les données exportées.

533

534Pour exporter la télémétrie de ces sessions, définissez `CLAUDE_CODE_ENABLE_TELEMETRY` et les variables `OTEL_*`, en utilisant les mêmes clés que l'exemple de [configuration administrateur](#administrator-configuration), dans l'un des deux endroits suivants :

535

536* **Paramètres gérés par le serveur** : ajoutez-les au bloc `env` des [paramètres gérés par le serveur](/docs/fr/server-managed-settings) 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](/docs/fr/model-config#surface-coverage), 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.

537* **Les variables de l'environnement** : ajoutez-les aux [variables d'environnement](/docs/fr/cloud-environments#set-environment-variables) 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.

538

539Quiconque utilise un environnement peut lire ses variables, donc ne mettez pas une credential là, comme un jeton de collecteur dans `OTEL_EXPORTER_OTLP_HEADERS`. Une [credential API](/docs/fr/cloud-environments#add-api-credentials) sur l'environnement n'aide pas non plus, car l'export de télémétrie propre de Claude Code est l'une des [requêtes qui ne reçoivent jamais la credential](/docs/fr/cloud-environments#requests-that-never-get-the-credential). Si votre collecteur nécessite une credential, configurez l'export entier via les paramètres gérés par le serveur à la place, car lorsque vous définissez une credential là, [Claude Code supprime les variables de point de terminaison définies en dehors des paramètres gérés](#how-managed-settings-lock-the-otlp-destination).

540

541Gardez ces contraintes à l'esprit lorsque vous configurez la télémétrie pour les sessions cloud :

542

543* **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](/docs/fr/cloud-environments#access-levels) 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](/docs/fr/cloud-environments#allow-specific-domains), car aucun paramètre géré par le serveur n'ajoute de domaines à la liste d'autorisation réseau d'un environnement.

544* **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é](/docs/fr/cloud-environments#organization-shared-environments) défini comme défaut de votre organisation ou épinglé au canal.

545* **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](/docs/fr/model-config#surface-coverage), donc le bloc `env` géré par le serveur ne configure pas leur télémétrie.

546

547<h3 id="attribute-telemetry-to-cloud-sessions">

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

549</h3>

550

551Par défaut, les métriques et les événements d'une session cloud portent les [attributs standard](#standard-attributes), y compris `session.id`, `ccr.session.id`, et `organization.id`, afin que vous puissiez filtrer par session ou organisation sans configuration supplémentaire. La valeur `ccr.session.id` est le `CLAUDE_CODE_REMOTE_SESSION_ID` de la session. Pour le transformer en URL de transcription de la session, voir [Lier la sortie à la session](/docs/fr/cloud-environments#link-output-back-to-the-session).

552

553Pour attribuer la télémétrie plus en détail, utilisez ces options :

554

555* **Identifier les sessions Claude Tag** : définissez `OTEL_METRICS_INCLUDE_ENTRYPOINT=true`, comme décrit sous [Contrôle de la cardinalité des métriques](#metrics-cardinality-control). Les métriques portent alors `app.entrypoint`, dont la valeur est `claude-in-slack` pour les sessions Claude Tag.

556* **Ajouter des attributs personnalisés** : définissez [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support) au même endroit où vous définissez les autres variables `OTEL_*` pour ces sessions. Si vous l'`export` dans le [script de configuration](/docs/fr/cloud-environments#setup-scripts) 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.

557

558Dans les sessions du canal Claude Tag, Claude fonctionne comme l'[identité partagée](/docs/fr/cloud-environments#set-the-environment-a-claude-tag-channel-uses) de votre organisation plutôt que comme n'importe quel membre, donc ne vous fiez pas aux attributs `user.*` pour identifier qui a tagué Claude.

559

525<h2 id="available-metrics-and-events">560<h2 id="available-metrics-and-events">

526 Métriques et événements disponibles561 Métriques et événements disponibles

527</h2>562</h2>

536| - | - | - |571| - | - | - |

573| `ccr.session.id` | Identifiant de session cloud, la valeur de `CLAUDE_CODE_REMOTE_SESSION_ID`, sur les sessions qui s'exécutent dans un [environnement cloud](/docs/fr/cloud-environments) | `OTEL_METRICS_INCLUDE_SESSION_ID` (par défaut : true) |

539| `app.entrypoint` | Comment la session a été lancée, par exemple `cli`, `sdk-cli`, `sdk-ts`, `sdk-py`, ou `claude-vscode` | `OTEL_METRICS_INCLUDE_ENTRYPOINT` (par défaut : false) |575| `app.entrypoint` | Comment la session a été lancée, par exemple `cli`, `sdk-cli`, `sdk-ts`, `sdk-py`, `claude-vscode`, ou `claude-in-slack` pour les sessions Claude Tag | `OTEL_METRICS_INCLUDE_ENTRYPOINT` (par défaut : false) |

542| `user.account_id` | ID du compte au format balisé correspondant aux API d'administration Anthropic (si authentifié), par exemple `user_01BWBeN28...` | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (par défaut : true) |578| `user.account_id` | ID de compte au format balisé correspondant aux API d'administration Anthropic (lorsqu'authentifié), par exemple `user_01BWBeN28...` | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (par défaut : true) |

543| `user.id` | Identifiant anonyme aléatoire généré à la première exécution et persisté dans `~/.claude.json`. Il ne contient aucune information personnelle et n'est pas dérivé de votre compte Claude. La suppression du fichier produit une nouvelle valeur sans rapport à la prochaine exécution. | Toujours inclus |579| `user.id` | Identifiant anonyme aléatoire généré à la première exécution et persisté dans `~/.claude.json`. Il ne contient aucune information personnelle et n'est pas dérivé de votre compte Claude. La suppression du fichier produit une nouvelle valeur sans rapport à la prochaine exécution. | Toujours inclus |

544| `user.email` | Adresse e-mail de l'utilisateur, de votre connexion ou, dans une [session cloud](/docs/fr/claude-code-on-the-web), des identifiants de la session elle-même | Toujours inclus quand disponible |580| `user.email` | Adresse e-mail de l'utilisateur, de votre connexion ou, dans une [session cloud](/docs/fr/claude-code-on-the-web), des identifiants de la session elle-même | Toujours inclus lorsque disponible |

546| Clés de `OTEL_RESOURCE_ATTRIBUTES` | Attributs personnalisés que vous définissez, par exemple `department` ou `team.id`. Voir [Support des organisations multi-équipes](#multi-team-organization-support) | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (par défaut : true) |582| Clés de `OTEL_RESOURCE_ATTRIBUTES` | Attributs personnalisés que vous définissez, par exemple `department` ou `team.id`. Voir [Support des organisations multi-équipes](#multi-team-organization-support) | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (par défaut : true) |

547| `vcs.repository.url.full`, `vcs.owner.name`, `vcs.repository.name`, `vcs.provider.name` | L'identité du référentiel de la session, dérivée de sa télécommande `origin`. Voir [Attributs du référentiel](#repository-attributes) | `OTEL_METRICS_INCLUDE_REPOSITORY` (par défaut : false). Nécessite Claude Code v2.1.269 ou ultérieur |583| `vcs.repository.url.full`, `vcs.owner.name`, `vcs.repository.name`, `vcs.provider.name` | L'identité du référentiel de la session, dérivée de sa télécommande `origin`. Voir [Attributs du référentiel](#repository-attributes) | `OTEL_METRICS_INCLUDE_REPOSITORY` (par défaut : false). Nécessite Claude Code v2.1.269 ou ultérieur |

548 584

549Quand Claude Code est connecté à une [passerelle d'applications Claude](/docs/fr/claude-apps-gateway), l'interface de ligne de commande marque les exportations avec l'identité authentifiée de la session de la passerelle : `user.id` est le sujet IdP plutôt qu'un identifiant d'installation anonyme, `user.email` est l'e-mail connecté, et `user.groups` porte l'appartenance au groupe IdP sous forme de chaîne séparée par des virgules. Chaque exportation porte également `identity.source: gateway-oidc`. L'identité de la passerelle est appliquée en dernier, donc les clés `user.*` et `identity.*` définies via `OTEL_RESOURCE_ATTRIBUTES` sont ignorées sur les sessions de passerelle.585Lorsque Claude Code est connecté à une [passerelle d'applications Claude](/docs/fr/claude-apps-gateway), la CLI marque les exportations avec l'identité authentifiée de la session de la passerelle : `user.id` est le sujet IdP plutôt qu'un identifiant d'installation anonyme, `user.email` est l'e-mail connecté, et `user.groups` porte l'appartenance au groupe IdP sous forme de chaîne séparée par des virgules. Chaque exportation porte également `identity.source: gateway-oidc`. L'identité de la passerelle est appliquée en dernier, donc les clés `user.*` et `identity.*` définies via `OTEL_RESOURCE_ATTRIBUTES` sont ignorées sur les sessions de passerelle.

550 586

551Les événements incluent en outre les attributs suivants. Ceux-ci ne sont jamais attachés aux métriques car ils causeraient une cardinalité non bornée :587Les événements incluent en outre les attributs suivants. Ceux-ci ne sont jamais attachés aux métriques car ils causeraient une cardinalité illimitée :

552 588

553* `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](#event-correlation-attributes).589* `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](#event-correlation-attributes).

554* `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înes590* `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

555* `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](/docs/fr/workflows). 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érieur591* `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](/docs/fr/workflows). 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

556* `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 quand 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érieur592* `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

557 593

558<h4 id="repository-attributes">594<h4 id="repository-attributes">

559 Attributs du référentiel595 Attributs du référentiel

560</h4>596</h4>

561 597

562Définissez `OTEL_METRICS_INCLUDE_REPOSITORY=true` pour balisez les métriques et les événements avec l'identité du référentiel de la session, afin qu'un collecteur partagé puisse attribuer l'utilisation par référentiel. Nécessite Claude Code v2.1.269 ou ultérieur.598Définissez `OTEL_METRICS_INCLUDE_REPOSITORY=true` pour baliser les métriques et les événements avec l'identité du référentiel de la session, afin qu'un collecteur partagé puisse attribuer l'utilisation par référentiel. Nécessite Claude Code v2.1.269 ou ultérieur.

563 599

564Claude Code dérive ces attributs une fois par session à partir de la télécommande `origin` du référentiel. Les télécommandes HTTPS et SSH d'un référentiel produisent des valeurs identiques :600Claude Code dérive ces attributs une fois par session à partir de la télécommande `origin` du référentiel. Lorsque les télécommandes HTTPS et SSH d'un référentiel nomment le même hôte et le même chemin, comme c'est le cas sur GitHub, GitLab et Bitbucket Cloud, les deux produisent des valeurs identiques :

565 601

566| Attribut | Valeur |602| Attribut | Valeur |

567| - | - |603| - | - |

568| `vcs.repository.url.full` | L'URL du navigateur du référentiel sans `.git`, par exemple `https://github.com/example-org/example-repo` |604| `vcs.repository.url.full` | L'URL du navigateur du référentiel sans `.git`, par exemple `https://github.com/example-org/example-repo` |

569| `vcs.owner.name` | Le chemin du propriétaire ou du groupe, par exemple `example-org` ; omis quand le chemin de la télécommande a un seul segment |605| `vcs.owner.name` | Le chemin du propriétaire ou du groupe, par exemple `example-org` ; omis lorsque le chemin distant a un seul segment |

571| `vcs.provider.name` | `github`, `gitlab`, `bitbucket`, ou `gitea` quand Claude Code reconnaît l'hôte de la télécommande ou la forme de l'URL comme l'un de ces fournisseurs ; omis sinon |607| `vcs.provider.name` | `github`, `gitlab`, `bitbucket`, ou `gitea` lorsque Claude Code reconnaît l'hôte distant ou la forme d'URL comme l'un de ces fournisseurs ; omis sinon |

608

609Les valeurs sont en minuscules, et les identifiants, les chaînes de requête et les fragments de l'URL distante n'y apparaissent jamais. Les attributs sont omis lorsque la session n'a pas de télécommande `origin`, lorsque la télécommande n'a pas la forme d'une URL, ou lorsque le seul référentiel englobant est votre répertoire personnel.

572 610

573Les valeurs sont en minuscules, et les identifiants, chaînes de requête et fragments de l'URL de la télécommande n'apparaissent jamais en eux. Les attributs sont omis quand la session n'a pas de télécommande `origin`, quand la télécommande n'a pas la forme d'une URL, ou quand le seul référentiel englobant est votre répertoire personnel.611Pour obtenir ces attributs à partir d'une [session cloud](/docs/fr/claude-code-on-the-web), définissez les variables de télémétrie, y compris `OTEL_METRICS_INCLUDE_REPOSITORY`, sur son [environnement cloud](/docs/fr/cloud-environments#set-environment-variables). Autorisez également le domaine de votre collecteur dans l'[accès réseau](/docs/fr/cloud-environments#network-access) de l'environnement.

574 612

575Une clé `vcs.*` que vous déclarez dans [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support) remplace la valeur dérivée pour cette clé. Si vous déclarez `vcs.repository.url.full`, Claude Code ne lit jamais la télécommande et signale uniquement les clés que vous déclarez.613Une clé `vcs.*` que vous déclarez dans [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support) remplace la valeur dérivée pour cette clé. Si vous déclarez `vcs.repository.url.full`, Claude Code ne lit jamais la télécommande et signale uniquement les clés que vous déclarez.

576 614

615Si les clones HTTPS et SSH d'un référentiel signalent des valeurs différentes, par exemple sur une installation auto-hébergée dont l'URL de clone HTTPS porte un préfixe de chemin que l'URL SSH n'a pas, déclarez `vcs.repository.url.full` dans `OTEL_RESOURCE_ATTRIBUTES` ainsi que toute autre clé `vcs.*` que vous souhaitez signaler. Chaque clone signale alors l'identité que vous déclarez.

616

577Les attributs ne circulent que vers vos propres exportateurs ; la télémétrie d'Anthropic supprime chaque clé `vcs.*`.617Les attributs ne circulent que vers vos propres exportateurs ; la télémétrie d'Anthropic supprime chaque clé `vcs.*`.

578 618

579<h3 id="metrics">619<h3 id="metrics">

580 Métriques620 Métriques

581</h3>621</h3>

582 622

583Claude Code exporte les métriques suivantes. La colonne Unité affiche la chaîne d'unité OpenTelemetry attachée à chaque métrique ; les métriques de comptage n'en portent aucune.623Claude Code exporte les métriques suivantes. La colonne Unité affiche la chaîne d'unité OpenTelemetry attachée à chaque métrique ; les métriques de comptage n'en ont aucune.

584 624

586| - | - | - |626| - | - | - |

594| `claude_code.active_time.total` | Temps actif total | s |634| `claude_code.active_time.total` | Temps actif total | s |

595 635

596Quand `prometheus` est le seul exportateur listé dans `OTEL_METRICS_EXPORTER`, Claude Code omet les unités `USD`, `tokens`, et `s` des métriques exportées afin que le scrape reste au format texte Prometheus valide. Les noms de métriques ne changent pas, et les configurations qui combinent des exportateurs, par exemple `otlp,prometheus`, conservent les unités. Avant v2.1.216, le scrape Prometheus incluait des lignes `# UNIT` uniquement OpenMetrics que certains scrapers rejetaient.636Lorsque `prometheus` est le seul exportateur listé dans `OTEL_METRICS_EXPORTER`, Claude Code omet les unités `USD`, `tokens` et `s` des métriques exportées afin que le scrape reste au format texte Prometheus valide. Les noms de métriques ne changent pas, et les configurations qui combinent des exportateurs, par exemple `otlp,prometheus`, conservent les unités. Avant v2.1.216, le scrape Prometheus incluait des lignes `# UNIT` OpenMetrics uniquement que certains scrapers rejetaient.

597 637

598<h3 id="metric-details">638<h3 id="metric-details">

599 Détails des métriques639 Détails des métriques

602Chaque métrique inclut les attributs standard listés ci-dessus. Les métriques avec des attributs supplémentaires spécifiques au contexte sont notées ci-dessous.642Chaque métrique inclut les attributs standard listés ci-dessus. Les métriques avec des attributs supplémentaires spécifiques au contexte sont notées ci-dessous.

603 643

604<h4 id="session-counter">644<h4 id="session-counter">

605 Compteur de session645 Compteur de sessions

606</h4>646</h4>

607 647

608Incrémenté au début de chaque session.648Incrémenté au début de chaque session.

610**Attributs** :650**Attributs** :

611 651

612* Tous les [attributs standard](#standard-attributes)652* Tous les [attributs standard](#standard-attributes)

613* `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 d'interface utilisateur des sessions conversationnelles dans vos tableaux de bord.653* `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.

614 654

615<h4 id="lines-of-code-counter">655<h4 id="lines-of-code-counter">

616 Compteur de lignes de code656 Compteur de lignes de code

617</h4>657</h4>

618 658

619Incrémenté quand du code est ajouté ou supprimé.659Incrémenté lorsque du code est ajouté ou supprimé.

620 660

621**Attributs** :661**Attributs** :

622 662

625* `model` : Identifiant du modèle pour le modèle qui a effectué la modification (par exemple, « claude-sonnet-5 »)665* `model` : Identifiant du modèle pour le modèle qui a effectué la modification (par exemple, « claude-sonnet-5 »)

626 666

627<h4 id="pull-request-counter">667<h4 id="pull-request-counter">

628 Compteur de demande de tirage668 Compteur de demandes de tirage

629</h4>669</h4>

630 670

631Incrémenté quand Claude Code crée une demande de tirage ou de fusion via une commande shell ou un outil MCP.671Incrémenté lorsque Claude Code crée une demande de tirage ou de fusion via une commande shell ou un outil MCP.

632 672

633**Attributs** :673**Attributs** :

634 674

635* Tous les [attributs standard](#standard-attributes)675* Tous les [attributs standard](#standard-attributes)

636 676

637<h4 id="commit-counter">677<h4 id="commit-counter">

638 Compteur de commit678 Compteur de commits

639</h4>679</h4>

640 680

641Incrémenté lors de la création de commits git via Claude Code.681Incrémenté lors de la création de commits git via Claude Code.

645* Tous les [attributs standard](#standard-attributes)685* Tous les [attributs standard](#standard-attributes)

646 686

647<h4 id="cost-counter">687<h4 id="cost-counter">

648 Compteur de coût688 Compteur de coûts

649</h4>689</h4>

650 690

651Incrémenté après chaque demande API.691Incrémenté après chaque demande API.

652 692

693Les attributs `agent.name`, `skill.name`, `plugin.name`, `mcp_server.name` et `mcp_tool.name` rédactent chacun certains noms à un espace réservé `"custom"` ou `"third-party"` par défaut. Si vous définissez `OTEL_LOG_TOOL_DETAILS=1`, ils portent les noms réels à la place. Avant v2.1.273, les compteurs de coûts et de jetons et les événements `api_request`, `api_error` et `api_refusal` portaient les valeurs rédactées même avec `OTEL_LOG_TOOL_DETAILS=1` défini.

694

653**Attributs** :695**Attributs** :

654 696

655* Tous les [attributs standard](#standard-attributes)697* Tous les [attributs standard](#standard-attributes)

656* `model` : Identifiant du modèle (par exemple, « claude-sonnet-5 »)698* `model` : Identifiant du modèle (par exemple, « claude-sonnet-5 »)

657* `query_source` : Catégorie du sous-système qui a émis la demande. L'une de `"main"`, `"subagent"`, ou `"auxiliary"`699* `query_source` : Catégorie du sous-système qui a émis la demande. L'une de `"main"`, `"subagent"`, ou `"auxiliary"`

658* `speed` : `"fast"` quand la demande a utilisé le mode rapide. Absent sinon700* `speed` : `"fast"` lorsque la demande a utilisé le mode rapide. Absent sinon

659* `effort` : [Niveau d'effort](/docs/fr/model-config#adjust-effort-level) appliqué à la demande : `"low"`, `"medium"`, `"high"`, `"xhigh"`, ou `"max"`. Absent quand Claude Code n'envoie aucun niveau d'effort, par exemple sur un modèle qui ne supporte pas l'effort.701* `effort` : [Niveau d'effort](/docs/fr/model-config#adjust-effort-level) 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.

660* `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"` sauf si `OTEL_LOG_TOOL_DETAILS=1` est défini. Absent quand la demande n'a pas été émise par un type de sous-agent nommé.702* `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é.

661* `skill.name` : Compétence active pour la demande, définie par l'outil Skill, 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"` sauf si `OTEL_LOG_TOOL_DETAILS=1` est défini. Absent quand aucune compétence n'est active.703* `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.

662* `plugin.name` : Plugin propriétaire quand la compétence active ou le sous-agent est fourni par un plugin. Les noms de plugins de la place de marché officielle apparaissent textuellement. Les noms de plugins tiers sont remplacés par `"third-party"` sauf si `OTEL_LOG_TOOL_DETAILS=1` est défini. Absent quand ni la compétence ni le sous-agent n'a de plugin propriétaire.704* `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.

663* `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. Absent sinon.705* `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.

664* `mcp_server.name` : Serveur MCP dont le résultat de l'outil cette demande a consommé. Les noms de serveurs intégrés, proxifiés par claude.ai, et de registre officiel apparaissent textuellement. Les noms de serveurs configurés par l'utilisateur sont remplacés par `"custom"` sauf si `OTEL_LOG_TOOL_DETAILS=1` est défini. Absent quand 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.706* `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.

665* `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 quand la demande n'a consommé aucun résultat d'outil MCP.707* `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.

666 708

667<h4 id="token-counter">709<h4 id="token-counter">

668 Compteur de jetons710 Compteur de jetons

676* `type` : (`"input"`, `"output"`, `"cacheRead"`, `"cacheCreation"`)718* `type` : (`"input"`, `"output"`, `"cacheRead"`, `"cacheCreation"`)

677* `model` : Identifiant du modèle (par exemple, « claude-sonnet-5 »)719* `model` : Identifiant du modèle (par exemple, « claude-sonnet-5 »)

678* `query_source` : Catégorie du sous-système qui a émis la demande. L'une de `"main"`, `"subagent"`, ou `"auxiliary"`720* `query_source` : Catégorie du sous-système qui a émis la demande. L'une de `"main"`, `"subagent"`, ou `"auxiliary"`

679* `speed` : `"fast"` quand la demande a utilisé le mode rapide. Absent sinon721* `speed` : `"fast"` lorsque la demande a utilisé le mode rapide. Absent sinon

680* `effort` : [Niveau d'effort](/docs/fr/model-config#adjust-effort-level) appliqué à la demande. Voir [Compteur de coût](#cost-counter) pour les détails.722* `effort` : [Niveau d'effort](/docs/fr/model-config#adjust-effort-level) appliqué à la demande. Voir [Compteur de coûts](#cost-counter) pour les détails.

681* `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ût](#cost-counter) pour les définitions et le comportement de rédaction.723* `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](#cost-counter) pour les définitions et le comportement de rédaction.

682 724

683<h4 id="code-edit-tool-decision-counter">725<h4 id="code-edit-tool-decision-counter">

684 Compteur de décision de l'outil d'édition de code726 Compteur de décisions de l'outil d'édition de code

685</h4>727</h4>

686 728

687Incrémenté quand l'utilisateur accepte ou rejette l'utilisation de l'outil Edit, Write, ou NotebookEdit.729Incrémenté lorsque l'utilisateur accepte ou rejette l'utilisation de l'outil Edit, Write ou NotebookEdit.

688 730

689**Attributs** :731**Attributs** :

690 732

691* Tous les [attributs standard](#standard-attributes)733* Tous les [attributs standard](#standard-attributes)

692* `tool_name` : Nom de l'outil (`"Edit"`, `"Write"`, `"NotebookEdit"`)734* `tool_name` : Nom de l'outil (`"Edit"`, `"Write"`, `"NotebookEdit"`)

693* `decision` : Décision de l'utilisateur (`"accept"`, `"reject"`)735* `decision` : Décision de l'utilisateur (`"accept"`, `"reject"`)

694* `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](#tool-decision-event) pour ce que chaque valeur signifie.736* `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](#tool-decision-event) pour ce que signifie chaque valeur.

695* `language` : Langage de programmation du fichier édité, par exemple `"TypeScript"`, `"Python"`, `"JavaScript"`, ou `"Markdown"`. Retourne `"unknown"` pour les extensions de fichier non reconnues.737* `language` : Langage de programmation du fichier édité, par exemple `"TypeScript"`, `"Python"`, `"JavaScript"`, ou `"Markdown"`. Retourne `"unknown"` pour les extensions de fichier non reconnues.

696 738

697<h4 id="active-time-counter">739<h4 id="active-time-counter">

698 Compteur de temps actif740 Compteur de temps actif

699</h4>741</h4>

700 742

701Suit le temps réel passé à utiliser activement Claude Code, excluant le temps d'inactivité. Cette métrique est incrémentée lors des interactions utilisateur, par exemple la saisie et la lecture des réponses, et lors du traitement CLI, par exemple l'exécution d'outils et la génération de réponses IA.743Suit le temps réel passé à utiliser activement Claude Code, excluant le temps d'inactivité. Cette métrique est incrémentée lors des interactions utilisateur, telles que la saisie et la lecture des réponses, et lors du traitement CLI, tel que l'exécution d'outils et la génération de réponses IA.

702 744

703**Attributs** :745**Attributs** :

704 746

709 Événements751 Événements

710</h3>752</h3>

711 753

712Claude Code exporte les événements suivants via les journaux/événements OpenTelemetry (quand `OTEL_LOGS_EXPORTER` est configuré) :754Claude Code exporte les événements suivants via les journaux/événements OpenTelemetry (lorsque `OTEL_LOGS_EXPORTER` est configuré) :

713 755

714<h4 id="event-correlation-attributes">756<h4 id="event-correlation-attributes">

715 Attributs de corrélation d'événements757 Attributs de corrélation d'événements

716</h4>758</h4>

717 759

718Quand un utilisateur soumet une invite, Claude Code peut effectuer plusieurs appels API et exécuter plusieurs outils. L'attribut `prompt.id` vous permet de lier tous ces événements à l'invite unique qui les a déclenchés.760Lorsqu'un utilisateur soumet une invite, Claude Code peut effectuer plusieurs appels API et exécuter plusieurs outils. L'attribut `prompt.id` vous permet de lier tous ces événements à l'invite unique qui les a déclenchés.

719 761

720| Attribut | Description |762| Attribut | Description |

721| - | - |763| - | - |

722| `prompt.id` | Identifiant UUID v4 liant tous les événements produits lors du traitement d'une invite utilisateur unique |764| `prompt.id` | Identifiant UUID v4 reliant tous les événements produits lors du traitement d'une seule invite utilisateur |

723| `event.sequence` | Compteur basé sur 0 pour ordonner les événements, compté par processus Claude Code plutôt que par session |765| `event.sequence` | Compteur basé sur 0 pour ordonner les événements, compté par processus Claude Code plutôt que par session |

724| `message.uuid` | UUID du message tel que persisté dans la transcription de session, les fichiers `~/.claude/projects/*/*.jsonl`. Présent sur `assistant_response`, sur `api_response_body`, et sur `user_prompt` sauf pour les dispatches de commande, qui peuvent produire zéro ou plusieurs messages. Sur `assistant_response` et `api_response_body`, c'est l'entrée de transcription finale de la réponse, à partir de laquelle le `parentUuid` du tour suivant s'enchaîne. Nécessite Claude Code v2.1.214 ou ultérieur, ou v2.1.274 ou ultérieur sur `api_response_body` |766| `message.uuid` | UUID du message tel que persisté dans la transcription de session, les fichiers `~/.claude/projects/*/*.jsonl`. Présent sur `assistant_response`, sur `api_response_body`, et sur `user_prompt` sauf pour les dispatches de commandes, qui peuvent produire zéro ou plusieurs messages. Sur `assistant_response` et `api_response_body`, c'est l'entrée de transcription finale de la réponse, à partir de laquelle le `parentUuid` du tour suivant s'enchaîne. Nécessite Claude Code v2.1.214 ou ultérieur, ou v2.1.274 ou ultérieur sur `api_response_body` |

725| `client_request_id` | UUID généré par le client envoyé comme en-tête de demande `x-client-request-id`. Présent sur `api_request` et `api_error` sur les connexions API de première partie ; absent sur les backends de fournisseurs tiers et quand la demande a été retentée via le secours non-streaming. Associe une demande à sa réponse et reste disponible pour les défaillances telles que les délais d'expiration qui n'ont jamais produit un `request_id` serveur. Correspond au même attribut sur la plage de trace `llm_request`. Nécessite Claude Code v2.1.214 ou ultérieur |767| `request_id` | ID assigné par le serveur de la demande API, lu à partir de l'en-tête de réponse `request-id`, par exemple `req_011...`. Sur une réponse sans en-tête `request-id`, comme sur [Amazon Bedrock](/docs/fr/amazon-bedrock), la valeur provient de l'en-tête `x-amzn-requestid` à la place. Présent sur `api_request`, `api_error`, `api_refusal`, `assistant_response`, et `api_response_body` lorsque la réponse porte l'un ou l'autre en-tête. Correspond au même attribut sur la plage de trace `llm_request`. La source `x-amzn-requestid` nécessite Claude Code v2.1.282 ou ultérieur |

768| `client_request_id` | UUID généré par le client envoyé comme en-tête de demande `x-client-request-id`. Présent sur `api_request` et `api_error` sur les connexions API propriétaires ; absent sur les backends de fournisseurs tiers et lorsque la demande a été retentée via le secours non-streaming. Apparie une demande avec sa réponse et reste disponible pour les défaillances telles que les délais d'expiration qui n'ont jamais produit de `request_id` serveur. Correspond au même attribut sur la plage de trace `llm_request`. Nécessite Claude Code v2.1.214 ou ultérieur |

726 769

727Pour tracer toute l'activité déclenchée par une invite unique, filtrez vos événements par une valeur `prompt.id` spécifique. Cela retourne l'événement user\_prompt, tous les événements api\_request, et tous les événements tool\_result qui se sont produits lors du traitement de cette invite.770Pour tracer toute l'activité déclenchée par une seule invite, filtrez vos événements par une valeur `prompt.id` spécifique. Cela retourne l'événement user\_prompt, tous les événements api\_request, et tous les événements tool\_result qui se sont produits lors du traitement de cette invite.

728 771

729`event.sequence` commence à 0 chaque fois qu'un processus Claude Code démarre et compte jusqu'à la fin de ce processus. Il continue de compter à travers `/clear`, qui assigne un nouveau `session.id`. Si vous [reprenez une session sans la forker](/docs/fr/how-claude-code-works#resume-or-fork-sessions), la session conserve son `session.id` mais prend ses valeurs `event.sequence` du processus qui l'a reprise, donc dans une session un événement ultérieur peut porter une valeur inférieure à celle d'un événement antérieur, ou en répéter une. Pour ordonner les événements d'une session, triez par `event.timestamp` et utilisez `event.sequence` pour ordonner les événements qui partagent un timestamp.772`event.sequence` commence à 0 chaque fois qu'un processus Claude Code démarre et compte jusqu'à la fin de ce processus. Il continue de compter à travers `/clear`, qui assigne un nouveau `session.id`. Si vous [reprenez une session sans la forker](/docs/fr/how-claude-code-works#resume-or-fork-sessions), la session conserve son `session.id` mais prend ses valeurs `event.sequence` du processus qui l'a reprise, donc au sein d'une session un événement ultérieur peut porter une valeur inférieure à celle d'un événement antérieur, ou en répéter une. Pour ordonner les événements d'une session, triez par `event.timestamp` et utilisez `event.sequence` pour ordonner les événements qui partagent un timestamp.

730 773

731Pour la reconstruction au niveau du message, chaque classe d'événement porte une clé qui correspond à un champ dans la transcription de session. Le format d'entrée de transcription est [interne à Claude Code](/docs/fr/sessions#where-transcripts-are-stored) et change entre les versions, donc un pipeline qui se joint sur ces champs peut se casser à chaque version ; traitez les jointures comme spécifiques à la version plutôt que comme un contrat stable :774Pour la reconstruction au niveau du message, chaque classe d'événement porte une clé qui correspond à un champ dans la transcription de session. Le format d'entrée de transcription est [interne à Claude Code](/docs/fr/sessions#where-transcripts-are-stored) et change entre les versions, donc un pipeline qui se joint sur ces champs peut se casser à chaque version ; traitez les jointures comme spécifiques à la version plutôt que comme un contrat stable :

732 775

738 Événement d'invite utilisateur781 Événement d'invite utilisateur

739</h4>782</h4>

740 783

741Enregistré quand un utilisateur soumet une invite.784Enregistré lorsqu'un utilisateur soumet une invite.

742 785

743**Nom de l'événement** : `claude_code.user_prompt`786**Nom de l'événement** : `claude_code.user_prompt`

744 787

750* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)793* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)

751* `prompt_length` : Longueur de l'invite794* `prompt_length` : Longueur de l'invite

752* `prompt` : Contenu de l'invite. Rédacté par défaut. Définissez `OTEL_LOG_USER_PROMPTS=1` pour l'inclure795* `prompt` : Contenu de l'invite. Rédacté par défaut. Définissez `OTEL_LOG_USER_PROMPTS=1` pour l'inclure

753* `message.uuid` : UUID du message utilisateur résultant, correspondant à l'entrée de transcription persistée. Absent sur les dispatches de commande, qui peuvent produire zéro ou plusieurs messages. Nécessite Claude Code v2.1.214 ou ultérieur796* `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

754* `command_name` : Nom de la commande quand l'invite en invoque une. Les noms de commande 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 commande personnalisés, de plugins et MCP s'effondrent en `custom` ou `mcp` sauf si `OTEL_LOG_TOOL_DETAILS=1` est défini797* `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

755* `command_source` : Origine de la commande quand présente : `builtin`, `custom`, ou `mcp`. Les commandes fournies par les plugins signalent comme `custom`798* `command_source` : Origine de la commande lorsqu'elle est présente : `builtin`, `custom`, ou `mcp`. Les commandes fournies par les plugins signalent comme `custom`

756 799

757<h4 id="assistant-response-event">800<h4 id="assistant-response-event">

758 Événement de réponse d'assistant801 Événement de réponse d'assistant

769* `event.timestamp` : Timestamp ISO 8601812* `event.timestamp` : Timestamp ISO 8601

770* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)813* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)

771* `response_length` : Longueur du texte de réponse en caractères814* `response_length` : Longueur du texte de réponse en caractères

772* `response` : Texte de réponse, tronqué à la limite de contenu (60 Ko par défaut). Rédacté à `<REDACTED>` par défaut. Définissez `OTEL_LOG_ASSISTANT_RESPONSES=1` pour l'inclure. Quand `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ée815* `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

773* `model` : Identifiant du modèle (par exemple, « claude-sonnet-5 »)816* `model` : Identifiant du modèle (par exemple, « claude-sonnet-5 »)

774* `request_id` : ID de demande API Anthropic de l'en-tête `request-id` de la réponse. Présent uniquement quand l'API en retourne un817* `request_id` : ID de demande API, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)

775* `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érieur818* `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

776* `query_source` : Sous-système qui a émis la demande, par exemple `"repl_main_thread"`, `"compact"`, ou un nom de sous-agent819* `query_source` : Sous-système qui a émis la demande, par exemple `"repl_main_thread"`, `"compact"`, ou un nom de sous-agent

777 820

779 Événement de résultat d'outil822 Événement de résultat d'outil

780</h4>823</h4>

781 824

782Enregistré quand un outil termine son exécution. Non émis si l'appel d'outil a été rejeté ; voir l'[événement de décision d'outil](#tool-decision-event) pour les rejets.825Enregistré lorsqu'un outil termine son exécution. Non émis si l'appel d'outil a été rejeté ; voir l'[événement de décision d'outil](#tool-decision-event) pour les rejets.

783 826

784**Nom de l'événement** : `claude_code.tool_result`827**Nom de l'événement** : `claude_code.tool_result`

785 828

793* `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.836* `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.

794* `success` : `"true"` ou `"false"`837* `success` : `"true"` ou `"false"`

795* `duration_ms` : Temps d'exécution en millisecondes838* `duration_ms` : Temps d'exécution en millisecondes

796* `error_type` : Chaîne de catégorie d'erreur quand l'outil a échoué, par exemple `"Error:ENOENT"` ou `"ShellError"`839* `error_type` : Chaîne de catégorie d'erreur lorsque l'outil a échoué, par exemple `"Error:ENOENT"` ou `"ShellError"`

797* `error` (quand `OTEL_LOG_TOOL_DETAILS=1`) : Message d'erreur complet quand l'outil a échoué840* `error` (lorsque `OTEL_LOG_TOOL_DETAILS=1`) : Message d'erreur complet lorsque l'outil a échoué

798* `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'outil841* `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

799* `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](#tool-decision-event) pour ce que chaque valeur signifie. Les sources réservées au rejet `"user_abort"` et `"user_reject"` n'apparaissent jamais sur cet événement.842* `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](#tool-decision-event) 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.

800* `tool_input_size_bytes` : Taille de l'entrée d'outil sérialisée en JSON en octets843* `tool_input_size_bytes` : Taille de l'entrée d'outil sérialisée en JSON en octets

801* `tool_result_size_bytes` : Taille du résultat d'outil en octets844* `tool_result_size_bytes` : Taille du résultat d'outil en octets

802* `mcp_server_scope` : Identifiant de portée du serveur MCP (pour les outils MCP)845* `mcp_server_scope` : Identifiant de portée du serveur MCP (pour les outils MCP)

803* `vcs.ref.head.revision`, `vcs.ref.head.name`, `vcs.ref.head.type` (quand `OTEL_LOG_TOOL_DETAILS=1`) : l'identité du 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 quand le commit a été effectué sur un HEAD détaché. Nécessite Claude Code v2.1.269 ou ultérieur846* `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

804* `tool_parameters` (quand `OTEL_LOG_TOOL_DETAILS=1`) : Chaîne JSON contenant les paramètres spécifiques à l'outil. Pour les serveurs intégrés de 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](#tool-decision-event), nécessitant Claude Code v2.1.214 ou ultérieur. Les paramètres varient selon l'outil :847* `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](#tool-decision-event), nécessitant Claude Code v2.1.214 ou ultérieur. Les paramètres varient selon l'outil :

805 * Pour l'outil Bash : inclut `bash_command`, `full_command`, `timeout`, `description`, et `dangerouslyDisableSandbox`, plus `git_commit_id` et `git_branch` quand une commande `git commit` réussit. `git_commit_id` est le SHA du commit complet quand 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é848 * 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é

806 * 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`849 * 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`

807 * Pour les outils MCP : inclut `mcp_server_name`, `mcp_tool_name`850 * Pour les outils MCP : inclut `mcp_server_name`, `mcp_tool_name`

808 * Pour l'outil Skill : inclut `skill_name`851 * Pour l'outil Skill : inclut `skill_name`

809 * Pour l'outil Agent ou l'outil Task hérité : inclut `subagent_type`852 * Pour l'outil Agent ou l'outil Task hérité : inclut `subagent_type`

810* `tool_input` (quand `OTEL_LOG_TOOL_DETAILS=1`) : Arguments d'outil sérialisés en JSON. Les valeurs individuelles sur 512 caractères sont tronquées, et la charge utile complète est bornée à environ 4 K caractères. S'applique à tous les outils, y compris les outils MCP.853* `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.

811 854

812<h4 id="api-request-event">855<h4 id="api-request-event">

813 Événement de demande API856 Événement de demande API

825* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)868* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)

826* `model` : Modèle utilisé (par exemple, « claude-sonnet-5 »)869* `model` : Modèle utilisé (par exemple, « claude-sonnet-5 »)

827* `cost_usd` : Coût estimé en USD870* `cost_usd` : Coût estimé en USD

828* `cost_usd_micros` : Coût estimé en millionièmes de dollar américain, émis comme un entier871* `cost_usd_micros` : Coût estimé en millionièmes de dollar américain, émis sous forme d'entier

829* `duration_ms` : Durée de la demande en millisecondes872* `duration_ms` : Durée de la demande en millisecondes

830* `input_tokens` : Nombre de jetons d'entrée873* `input_tokens` : Nombre de jetons d'entrée

831* `output_tokens` : Nombre de jetons de sortie874* `output_tokens` : Nombre de jetons de sortie

832* `cache_read_tokens` : Nombre de jetons lus du cache875* `cache_read_tokens` : Nombre de jetons lus du cache

833* `cache_creation_tokens` : Nombre de jetons utilisés pour la création du cache876* `cache_creation_tokens` : Nombre de jetons utilisés pour la création du cache

834* `request_id` : ID de demande API Anthropic de l'en-tête `request-id` de la réponse, par exemple `"req_011..."`. Présent uniquement quand l'API en retourne un.877* `request_id` : ID de demande API, par exemple `"req_011..."`, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes).

835* `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](#event-correlation-attributes) pour quand il est présent. Nécessite Claude Code v2.1.214 ou ultérieur878* `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](#event-correlation-attributes) pour savoir quand il est présent. Nécessite Claude Code v2.1.214 ou ultérieur

836* `speed` : `"fast"` ou `"normal"`, indiquant si le mode rapide était actif879* `speed` : `"fast"` ou `"normal"`, indiquant si le mode rapide était actif

837* `query_source` : Sous-système qui a émis la demande, par exemple `"repl_main_thread"`, `"compact"`, ou un nom de sous-agent880* `query_source` : Sous-système qui a émis la demande, par exemple `"repl_main_thread"`, `"compact"`, ou un nom de sous-agent

838* `effort` : [Niveau d'effort](/docs/fr/model-config#adjust-effort-level) appliqué à la demande : `"low"`, `"medium"`, `"high"`, `"xhigh"`, ou `"max"`. Absent quand Claude Code n'envoie aucun niveau d'effort, par exemple sur un modèle qui ne supporte pas l'effort.881* `effort` : [Niveau d'effort](/docs/fr/model-config#adjust-effort-level) 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.

839* `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ût](#cost-counter) pour les définitions et le comportement de rédaction.882* `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](#cost-counter) pour les définitions et le comportement de rédaction.

840 883

841<h4 id="api-error-event">884<h4 id="api-error-event">

842 Événement d'erreur API885 Événement d'erreur API

843</h4>886</h4>

844 887

845Enregistré quand une demande API à Claude échoue.888Enregistré lorsqu'une demande API à Claude échoue.

846 889

847**Nom de l'événement** : `claude_code.api_error`890**Nom de l'événement** : `claude_code.api_error`

848 891

854* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)897* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)

855* `model` : Modèle utilisé (par exemple, « claude-sonnet-5 »)898* `model` : Modèle utilisé (par exemple, « claude-sonnet-5 »)

856* `error` : Message d'erreur899* `error` : Message d'erreur

857* `status_code` : Code de statut HTTP en tant que nombre. Absent pour les erreurs non-HTTP telles que les défaillances de connexion.900* `status_code` : Code de statut HTTP sous forme de nombre. Absent pour les erreurs non-HTTP telles que les défaillances de connexion.

858* `duration_ms` : Durée de la demande en millisecondes901* `duration_ms` : Durée de la demande en millisecondes

859* `attempt` : Nombre total de tentatives effectuées, y compris la demande initiale (`1` signifie qu'aucune nouvelle tentative ne s'est produite)902* `attempt` : Nombre total de tentatives effectuées, y compris la demande initiale (`1` signifie qu'aucune nouvelle tentative n'a eu lieu)

860* `request_id` : ID de demande API Anthropic de l'en-tête `request-id` de la réponse, par exemple `"req_011..."`. Présent uniquement quand l'API en retourne un.903* `request_id` : ID de demande API, par exemple `"req_011..."`, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes).

861* `client_request_id` : UUID généré par le client envoyé comme en-tête de demande `x-client-request-id`. Disponible même quand une défaillance telle qu'un délai d'expiration ou une erreur de connexion n'a jamais produit un `request_id` serveur ; voir le tableau [attributs de corrélation d'événements](#event-correlation-attributes) pour quand il est présent. Nécessite Claude Code v2.1.214 ou ultérieur904* `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](#event-correlation-attributes) pour savoir quand il est présent. Nécessite Claude Code v2.1.214 ou ultérieur

862* `speed` : `"fast"` ou `"normal"`, indiquant si le mode rapide était actif905* `speed` : `"fast"` ou `"normal"`, indiquant si le mode rapide était actif

863* `query_source` : Sous-système qui a émis la demande, par exemple `"repl_main_thread"`, `"compact"`, ou un nom de sous-agent906* `query_source` : Sous-système qui a émis la demande, par exemple `"repl_main_thread"`, `"compact"`, ou un nom de sous-agent

864* `effort` : [Niveau d'effort](/docs/fr/model-config#adjust-effort-level) appliqué à la demande. Absent quand Claude Code n'envoie aucun niveau d'effort, par exemple sur un modèle qui ne supporte pas l'effort.907* `effort` : [Niveau d'effort](/docs/fr/model-config#adjust-effort-level) 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.

865* `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ût](#cost-counter) pour les définitions et le comportement de rédaction.908* `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](#cost-counter) pour les définitions et le comportement de rédaction.

866 909

867<h4 id="api-refusal-event">910<h4 id="api-refusal-event">

868 Événement de refus API911 Événement de refus API

869</h4>912</h4>

870 913

871Enregistré quand une demande API retourne `stop_reason: "refusal"`. Les refus arrivent sur un flux de réponse réussi plutôt que comme une erreur HTTP, donc l'événement `api_error` ne se déclenche pas pour eux. Cet événement vous permet de suivre la fréquence des refus et de regrouper les refus par les mêmes attributs que `api_request` et `api_error`.914Enregistré lorsqu'une demande API retourne `stop_reason: "refusal"`. Les refus arrivent sur un flux de réponse réussi plutôt que comme une erreur HTTP, donc l'événement `api_error` ne se déclenche pas pour eux. Cet événement vous permet de suivre la fréquence des refus et de regrouper les refus par les mêmes attributs que `api_request` et `api_error`.

872 915

873**Nom de l'événement** : `claude_code.api_refusal`916**Nom de l'événement** : `claude_code.api_refusal`

874 917

879* `event.timestamp` : Timestamp ISO 8601922* `event.timestamp` : Timestamp ISO 8601

880* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)923* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)

881* `model` : Identifiant du modèle de la demande924* `model` : Identifiant du modèle de la demande

882* `request_id` : ID de demande API Anthropic de l'en-tête `request-id` de la réponse, par exemple `"req_011..."`. Présent uniquement quand l'API en retourne un.925* `request_id` : ID de demande API, par exemple `"req_011..."`, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes).

883* `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`](#api-request-event) pour les définitions.926* `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`](#api-request-event) pour les définitions.

884* `speed` : Soit `"fast"` quand le [Mode rapide](/docs/fr/fast-mode) est actif, soit `"normal"`927* `speed` : Soit `"fast"` lorsque le [Mode rapide](/docs/fr/fast-mode) est actif, soit `"normal"`

885* `attempt` : Numéro de tentative de nouvelle tentative. La première tentative est `1`.928* `attempt` : Numéro de tentative de nouvelle tentative. La première tentative est `1`.

886* `effort` : [Niveau d'effort](/docs/fr/model-config#adjust-effort-level) appliqué à la demande. Absent quand Claude Code n'envoie aucun niveau d'effort, par exemple sur un modèle qui ne supporte pas l'effort.929* `effort` : [Niveau d'effort](/docs/fr/model-config#adjust-effort-level) 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.

887* `server_fallback_hop` : `true` quand 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` quand 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 quand le modèle de secours refuse également.930* `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.

888* `has_category` : `true` quand la réponse API portait une `stop_details.category` de `"cyber"`, `"bio"`, `"frontier_llm"`, ou `"reasoning_extraction"`. `false` quand la réponse ne portait aucune catégorie ou une valeur en dehors de cet ensemble. Absent quand `server_fallback_hop` est `true`, car les blocs hop ne portent pas `stop_details`.931* `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`.

889* `has_explanation` : `true` quand la réponse API portait une `stop_details.explanation`, sinon `false`. Absent quand `server_fallback_hop` est `true`.932* `has_explanation` : `true` lorsque la réponse API portait une `stop_details.explanation`, sinon `false`. Absent lorsque `server_fallback_hop` est `true`.

890* `category` : La valeur `stop_details.category` de la réponse API. L'une de `"cyber"`, `"bio"`, `"frontier_llm"`, ou `"reasoning_extraction"`. Présent uniquement quand `OTEL_LOG_TOOL_DETAILS=1` est défini et `has_category` est `true`.933* `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`.

891* `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ût](#cost-counter) pour les définitions et le comportement de rédaction.934* `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](#cost-counter) pour les définitions et le comportement de rédaction.

892 935

893<h4 id="api-request-body-event">936<h4 id="api-request-body-event">

894 Événement de corps de demande API937 Événement de corps de demande API

895</h4>938</h4>

896 939

897Enregistré pour chaque tentative de demande API quand `OTEL_LOG_RAW_API_BODIES` est défini. Un événement est émis par tentative, donc les nouvelles tentatives avec des paramètres ajustés produisent chacune leur propre événement.940Enregistré pour chaque tentative de demande API lorsque `OTEL_LOG_RAW_API_BODIES` est défini. Un événement est émis par tentative, donc les nouvelles tentatives avec des paramètres ajustés produisent chacune leur propre événement.

898 941

899**Nom de l'événement** : `claude_code.api_request_body`942**Nom de l'événement** : `claude_code.api_request_body`

900 943

904* `event.name` : `"api_request_body"`947* `event.name` : `"api_request_body"`

905* `event.timestamp` : Timestamp ISO 8601948* `event.timestamp` : Timestamp ISO 8601

906* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)949* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)

907* `body` : Paramètres de demande API Messages sérialisés en JSON, par exemple l'invite système, les messages et les outils, tronqués à la limite de contenu (60 Ko 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`).950* `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`).

908* `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>`).951* `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>`).

909* `body_length` : Longueur du corps non tronqué. Octets UTF-8 quand `OTEL_LOG_RAW_API_BODIES=file:<dir>`, ou unités de code UTF-16 quand `=1`952* `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`

910* `body_truncated` : `"true"` quand la troncature en ligne s'est produite. Absent en mode fichier et quand aucune troncature ne s'est produite.953* `body_truncated` : `"true"` lorsque la troncature en ligne s'est produite. Absent en mode fichier et lorsqu'aucune troncature ne s'est produite.

911* `model` : Identifiant du modèle à partir des paramètres de demande954* `model` : Identifiant du modèle à partir des paramètres de demande

912* `query_source` : Sous-système qui a émis la demande (par exemple, `"compact"`)955* `query_source` : Sous-système qui a émis la demande (par exemple, `"compact"`)

913* `request_body_id` : UUID qui identifie le corps de demande de cette tentative. L'[événement `api_response_body`](#api-response-body-event) pour la tentative qui réussit porte la même valeur, donc vous pouvez associer une réponse à la demande exacte qui l'a produite. Nécessite Claude Code v2.1.274 ou ultérieur956* `request_body_id` : UUID qui identifie le corps de demande de cette tentative. L'[événement `api_response_body`](#api-response-body-event) 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

914 957

915<h4 id="api-response-body-event">958<h4 id="api-response-body-event">

916 Événement de corps de réponse API959 Événement de corps de réponse API

917</h4>960</h4>

918 961

919Enregistré pour chaque réponse API réussie quand `OTEL_LOG_RAW_API_BODIES` est défini.962Enregistré pour chaque réponse API réussie lorsque `OTEL_LOG_RAW_API_BODIES` est défini.

920 963

921En mode fichier (`OTEL_LOG_RAW_API_BODIES=file:<dir>`), Claude Code ajoute également une ligne JSON à `<dir>/index.jsonl` pour chaque réponse réussie, avec les champs `timestamp`, `session_id`, `query_source`, `model`, `request_id`, `message_id`, `message_uuid`, `request_file`, et `response_file`. Lisez-le pour trouver les fichiers de demande et de réponse derrière un message de transcription donné sans interroger votre backend de télémétrie. Le fichier d'index nécessite Claude Code v2.1.274 ou ultérieur.964En mode fichier (`OTEL_LOG_RAW_API_BODIES=file:<dir>`), Claude Code ajoute également une ligne JSON à `<dir>/index.jsonl` pour chaque réponse réussie, avec les champs `timestamp`, `session_id`, `query_source`, `model`, `request_id`, `message_id`, `message_uuid`, `request_file`, et `response_file`. Lisez-le pour trouver les fichiers de demande et de réponse derrière un message de transcription donné sans interroger votre backend de télémétrie. Le fichier d'index nécessite Claude Code v2.1.274 ou ultérieur.

922 965

928* `event.name` : `"api_response_body"`971* `event.name` : `"api_response_body"`

929* `event.timestamp` : Timestamp ISO 8601972* `event.timestamp` : Timestamp ISO 8601

930* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)973* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)

931* `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 Ko par défaut). Le contenu de réflexion étendue est rédacté. Émis uniquement en mode en ligne (`OTEL_LOG_RAW_API_BODIES=1`).974* `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`).

932* `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>`).975* `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>`).

933* `body_length` : Longueur du corps non tronqué. Octets UTF-8 quand `OTEL_LOG_RAW_API_BODIES=file:<dir>`, ou unités de code UTF-16 quand `=1`976* `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`

934* `body_truncated` : `"true"` quand la troncature en ligne s'est produite. Absent en mode fichier et quand aucune troncature ne s'est produite.977* `body_truncated` : `"true"` lorsque la troncature en ligne s'est produite. Absent en mode fichier et lorsqu'aucune troncature ne s'est produite.

935* `model` : Identifiant du modèle978* `model` : Identifiant du modèle

936* `query_source` : Sous-système qui a émis la demande979* `query_source` : Sous-système qui a émis la demande

937* `request_id` : ID de demande API Anthropic de l'en-tête `request-id` de la réponse, par exemple `"req_011..."`. Présent uniquement quand l'API en retourne un.980* `request_id` : ID de demande API, par exemple `"req_011..."`, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes).

938* `request_body_id` : Le `request_body_id` de l'[événement `api_request_body`](#api-request-body-event) auquel cette réponse répond. Nécessite Claude Code v2.1.274 ou ultérieur981* `request_body_id` : Le `request_body_id` de l'[événement `api_request_body`](#api-request-body-event) auquel cette réponse répond. Nécessite Claude Code v2.1.274 ou ultérieur

939* `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érieur982* `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

940* `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érieur983* `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

943 Événement de décision d'outil986 Événement de décision d'outil

944</h4>987</h4>

945 988

946Enregistré quand une décision de permission d'outil est prise (accepter/rejeter).989Enregistré lorsqu'une décision de permission d'outil est prise (accepter/rejeter).

947 990

948**Nom de l'événement** : `claude_code.tool_decision`991**Nom de l'événement** : `claude_code.tool_decision`

949 992

956* `tool_name` : Nom de l'outil (par exemple, « Read », « Edit », « Write », « NotebookEdit »)999* `tool_name` : Nom de l'outil (par exemple, « Read », « Edit », « Write », « NotebookEdit »)

957* `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.1000* `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.

958* `decision` : Soit `"accept"` soit `"reject"`1001* `decision` : Soit `"accept"` soit `"reject"`

959* `tool_source` : Toujours présent. La provenance de l'outil, comme un ensemble fermé de valeurs créées par l'interface de ligne de commande. Nécessite Claude Code v2.1.214 ou ultérieur1002* `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

960 * `"builtin"` : les outils de l'interface de ligne de commande elle-même1003 * `"builtin"` : les outils propres de la CLI

961 * `"mcp"` : serveurs MCP en général1004 * `"mcp"` : serveurs MCP en général

962 * `"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 démarrée à partir de l'un de ses propres points d'entrée, `claude-desktop`, `claude-desktop-3p`, ou `local-agent`, quand 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"`1005 * `"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"`

963* `source` : D'où provient la décision :1006* `source` : D'où provient la décision :

964 * `"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"` quand la demande d'invite de permission elle-même échoue, par exemple quand le rappel [`canUseTool`](/docs/fr/agent-sdk/typescript#canusetool) du SDK Agent ou l'outil [`--permission-prompt-tool`](/docs/fr/cli-reference#cli-flags) retourne un résultat invalide, ou quand le flux d'entrée se ferme tandis que la demande est en attente. Avant v2.1.216, Claude Code signalait ces défaillances comme `"user_reject"`.1007 * `"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`](/docs/fr/agent-sdk/typescript#canusetool) du SDK Agent ou l'outil [`--permission-prompt-tool`](/docs/fr/cli-reference#cli-flags) 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"`.

965 * `"hook"` : Un hook `PreToolUse` ou `PermissionRequest` a retourné la décision.1008 * `"hook"` : Un hook `PreToolUse` ou `PermissionRequest` a retourné la décision.

966 * `"user_permanent"` : Émis quand 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 l'interface de ligne de commande 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.1009 * `"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.

967 * `"user_temporary"` : Émis quand 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 l'interface de ligne de commande 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.1010 * `"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.

968 * `"user_abort"` : Émis quand l'utilisateur a fermé l'invite de permission sans répondre. Dans les sessions SDK Agent et non-interactive `-p`, ceci inclut l'interruption du tour tandis 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.1011 * `"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.

969 * `"user_reject"` : Émis quand l'utilisateur a choisi « Non » quand invité. Dans l'interface de ligne de commande 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.1012 * `"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.

970* `tool_parameters` (quand `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](#tool-result-event), 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 quand `decision` est `"reject"`.1013* `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](#tool-result-event), 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"`.

971 * Pour les outils `"sdk_host_builtin_mcp"` : `mcp_server_name` et `mcp_tool_name` sont inclus même quand `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 n'apparaissent que 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érieur1014 * 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

972 * 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`1015 * 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`

973 * Pour les outils MCP : inclut `mcp_server_name`, `mcp_tool_name`1016 * Pour les outils MCP : inclut `mcp_server_name`, `mcp_tool_name`

974 * Pour l'outil Skill : inclut `skill_name`1017 * Pour l'outil Skill : inclut `skill_name`

978 Événement de changement de mode de permission1021 Événement de changement de mode de permission

979</h4>1022</h4>

980 1023

981Enregistré quand le mode de permission change, par exemple à partir du cycle Maj+Tab, de la sortie du mode plan, ou d'une vérification de porte en mode automatique.1024Enregistré lorsque le mode de permission change, par exemple à partir du cyclage `Shift+Tab`, de la sortie du mode plan, ou d'une vérification de porte en mode automatique.

982 1025

983**Nom de l'événement** : `claude_code.permission_mode_changed`1026**Nom de l'événement** : `claude_code.permission_mode_changed`

984 1027

990* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)1033* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)

991* `from_mode` : Le mode de permission précédent, par exemple `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, ou `"bypassPermissions"`1034* `from_mode` : Le mode de permission précédent, par exemple `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, ou `"bypassPermissions"`

992* `to_mode` : Le nouveau mode de permission1035* `to_mode` : Le nouveau mode de permission

993* `trigger` : Ce qui a causé le changement. L'une de `"shift_tab"`, `"exit_plan_mode"`, `"auto_gate_denied"`, ou `"auto_opt_in"`. Absent quand la transition provient du SDK ou du pont1036* `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

994 1037

995<h4 id="auth-event">1038<h4 id="auth-event">

996 Événement d'authentification1039 Événement d'authentification

997</h4>1040</h4>

998 1041

999Enregistré quand `/login` ou `/logout` se termine.1042Enregistré lorsque `/login` ou `/logout` se termine.

1000 1043

1001**Nom de l'événement** : `claude_code.auth`1044**Nom de l'événement** : `claude_code.auth`

1002 1045

1009* `action` : `"login"` ou `"logout"`1052* `action` : `"login"` ou `"logout"`

1010* `success` : `"true"` ou `"false"`1053* `success` : `"true"` ou `"false"`

1011* `auth_method` : Méthode d'authentification, par exemple `"oauth"`1054* `auth_method` : Méthode d'authentification, par exemple `"oauth"`

1012* `error_category` : Type d'erreur catégorique quand l'action a échoué. Le message d'erreur brut n'est jamais inclus1055* `error_category` : Type d'erreur catégorique lorsque l'action a échoué. Le message d'erreur brut n'est jamais inclus

1013* `status_code` : Code de statut HTTP en tant que chaîne quand l'action a échoué avec une erreur HTTP1056* `status_code` : Code de statut HTTP sous forme de chaîne lorsque l'action a échoué avec une erreur HTTP

1014 1057

1015<h4 id="mcp-server-connection-event">1058<h4 id="mcp-server-connection-event">

1016 Événement de connexion du serveur MCP1059 Événement de connexion du serveur MCP

1017</h4>1060</h4>

1018 1061

1019Enregistré quand un serveur MCP se connecte, se déconnecte, ou échoue à se connecter.1062Enregistré lorsqu'un serveur MCP se connecte, se déconnecte ou échoue à se connecter.

1020 1063

1021**Nom de l'événement** : `claude_code.mcp_server_connection`1064**Nom de l'événement** : `claude_code.mcp_server_connection`

1022 1065

1030* `transport_type` : Transport du serveur, par exemple `"stdio"`, `"sse"`, ou `"http"`1073* `transport_type` : Transport du serveur, par exemple `"stdio"`, `"sse"`, ou `"http"`

1031* `server_scope` : Portée à laquelle le serveur est configuré, par exemple `"user"`, `"project"`, ou `"local"`1074* `server_scope` : Portée à laquelle le serveur est configuré, par exemple `"user"`, `"project"`, ou `"local"`

1032* `duration_ms` : Durée de la tentative de connexion en millisecondes1075* `duration_ms` : Durée de la tentative de connexion en millisecondes

1033* `error_code` : Code d'erreur quand la connexion a échoué1076* `error_code` : Code d'erreur lorsque la connexion a échoué

1034* `is_plugin` : `true` quand le serveur est fourni par un plugin, `false` sinon1077* `is_plugin` : `true` lorsque le serveur est fourni par un plugin, `false` sinon

1035* `plugin_id_hash` (quand `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-loaded-event)1078* `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-loaded-event)

1036* `plugin.name` (quand `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` ; ceci protège les noms de plugins tiers d'apparaître dans les journaux par défaut. Les plugins 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 à Anthropic1079* `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

1037* `server_name` (quand `OTEL_LOG_TOOL_DETAILS=1`) : Nom du serveur configuré1080* `server_name` (lorsque `OTEL_LOG_TOOL_DETAILS=1`) : Nom du serveur configuré

1038* `error` (quand `OTEL_LOG_TOOL_DETAILS=1`) : Message d'erreur complet quand la connexion a échoué1081* `error` (lorsque `OTEL_LOG_TOOL_DETAILS=1`) : Message d'erreur complet lorsque la connexion a échoué

1039 1082

1040<h4 id="internal-error-event">1083<h4 id="internal-error-event">

1041 Événement d'erreur interne1084 Événement d'erreur interne

1042</h4>1085</h4>

1043 1086

1044Enregistré quand Claude Code capture une erreur interne inattendue. Seul le nom de la classe d'erreur et un code de style errno sont enregistrés. Le message d'erreur et la trace de pile ne sont jamais inclus. Cet événement n'est pas émis lors de l'exécution contre Amazon Bedrock, la plateforme d'agents de Google Cloud, ou Microsoft Foundry, ou quand `DISABLE_ERROR_REPORTING` est défini.1087Enregistré lorsque Claude Code détecte une erreur interne inattendue. Seul le nom de la classe d'erreur et un code de style errno sont enregistrés. Le message d'erreur et la trace de pile ne sont jamais inclus. Cet événement n'est pas émis lors de l'exécution sur Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry, ou lorsque `DISABLE_ERROR_REPORTING` est défini.

1045 1088

1046**Nom de l'événement** : `claude_code.internal_error`1089**Nom de l'événement** : `claude_code.internal_error`

1047 1090

1052* `event.timestamp` : Timestamp ISO 86011095* `event.timestamp` : Timestamp ISO 8601

1053* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)1096* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)

1054* `error_name` : Nom de la classe d'erreur, par exemple `"TypeError"` ou `"SyntaxError"`1097* `error_name` : Nom de la classe d'erreur, par exemple `"TypeError"` ou `"SyntaxError"`

1055* `error_code` : Code errno Node.js tel que `"ENOENT"` quand présent sur l'erreur1098* `error_code` : Code errno Node.js tel que `"ENOENT"` lorsqu'il est présent sur l'erreur

1056 1099

1057<h4 id="plugin-installed-event">1100<h4 id="plugin-installed-event">

1058 Événement de plugin installé1101 Événement de plugin installé

1059</h4>1102</h4>

1060 1103

1061Enregistré quand un plugin termine son installation, à partir à la fois de la commande CLI `claude plugin install` et de l'interface utilisateur interactive `/plugin`.1104Enregistré lorsqu'un plugin termine son installation, à partir à la fois de la commande CLI `claude plugin install` et de l'interface utilisateur interactive `/plugin`.

1062 1105

1063**Nom de l'événement** : `claude_code.plugin_installed`1106**Nom de l'événement** : `claude_code.plugin_installed`

1064 1107

1068* `event.name` : `"plugin_installed"`1111* `event.name` : `"plugin_installed"`

1069* `event.timestamp` : Timestamp ISO 86011112* `event.timestamp` : Timestamp ISO 8601

1070* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)1113* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)

1071* `marketplace.is_official` : `"true"` si la place de marché est une place de marché officielle Anthropic, `"false"` sinon1114* `marketplace.is_official` : `"true"` si la place de marché est une place de marché Anthropic officielle, `"false"` sinon

1072* `install.trigger` : `"cli"` ou `"ui"`1115* `install.trigger` : `"cli"` ou `"ui"`

1073* `plugin.name` : Nom du plugin installé. Pour les places de marché tiers, ceci n'est inclus que quand `OTEL_LOG_TOOL_DETAILS=1`1116* `plugin.name` : Nom du plugin installé. Pour les places de marché tiers, ceci n'est inclus que lorsque `OTEL_LOG_TOOL_DETAILS=1`

1074* `plugin.version` : Version du plugin quand déclarée dans l'entrée de la place de marché. Pour les places de marché tiers, ceci n'est inclus que quand `OTEL_LOG_TOOL_DETAILS=1`1117* `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`

1075* `marketplace.name` : Place de marché à partir de laquelle le plugin a été installé. Pour les places de marché tiers, ceci n'est inclus que quand `OTEL_LOG_TOOL_DETAILS=1`1118* `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`

1076 1119

1077<h4 id="plugin-loaded-event">1120<h4 id="plugin-loaded-event">

1078 Événement de plugin chargé1121 Événement de plugin chargé

1079</h4>1122</h4>

1080 1123

1081Enregistré une fois par plugin activé au démarrage de la session. Utilisez cet événement pour inventorier quels plugins sont actifs dans votre flotte, en complément de `plugin_installed` qui enregistre l'action d'installation elle-même.1124Enregistré une fois par plugin activé au démarrage de la session. Utilisez cet événement pour inventorier les plugins actifs dans votre flotte, en complément de `plugin_installed` qui enregistre l'action d'installation elle-même.

1082 1125

1083**Nom de l'événement** : `claude_code.plugin_loaded`1126**Nom de l'événement** : `claude_code.plugin_loaded`

1084 1127

1089* `event.timestamp` : Timestamp ISO 86011132* `event.timestamp` : Timestamp ISO 8601

1090* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)1133* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)

1091* `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`1134* `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`

1092* `marketplace.name` : place de marché à partir de laquelle le plugin a été installé, quand connue. Rédacté à `"third-party"` sous la même condition que `plugin.name`1135* `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`

1093* `plugin.version` : version du manifeste du plugin. Inclus uniquement quand le nom n'est pas rédacté et que le manifeste déclare une version1136* `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

1094* `plugin.scope` : catégorie de provenance pour le plugin : `"official"`, `"community"`, `"org"`, `"user-local"`, ou `"default-bundle"`1137* `plugin.scope` : catégorie de provenance du plugin : `"official"`, `"community"`, `"org"`, `"user-local"`, ou `"default-bundle"`

1095* `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 de l'organisation > Plugins et compétences**](https://claude.ai/admin-settings/skills?tab=inventory). Avant v2.1.246, Claude Code signalait ces plugins comme `"user-install"` ou `"seed-mount"`1138* `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**](https://claude.ai/admin-settings/skills?tab=inventory). Avant v2.1.246, Claude Code signalait ces plugins comme `"user-install"` ou `"seed-mount"`

1096* `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](/docs/fr/plugins/loading#synced-plugins), 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 hash1139* `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](/docs/fr/plugins/loading#synced-plugins), 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

1097* `has_hooks` : si le plugin contribue des hooks1140* `has_hooks` : si le plugin contribue des hooks

1098* `has_mcp` : si le plugin contribue des serveurs MCP1141* `has_mcp` : si le plugin contribue des serveurs MCP

1099* `host_owned_mcp` : `true` quand 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érieur1142* `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

1100* `skill_path_count` : nombre de répertoires de compétences que le plugin déclare1143* `skill_path_count` : nombre de répertoires de compétences que le plugin déclare

1101* `command_path_count` : nombre de répertoires de commandes que le plugin déclare1144* `command_path_count` : nombre de répertoires de commandes que le plugin déclare

1102* `agent_path_count` : nombre de répertoires d'agents que le plugin déclare1145* `agent_path_count` : nombre de répertoires d'agents que le plugin déclare

1103* `safe_mode` : `"true"` quand la session a été démarrée avec [`--safe-mode`](/docs/fr/cli-reference), `"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érieur1146* `safe_mode` : `"true"` lorsque la session a été démarrée avec [`--safe-mode`](/docs/fr/cli-reference), `"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

1104 1147

1105<h4 id="skill-activated-event">1148<h4 id="skill-activated-event">

1106 Événement de compétence activée1149 Événement de compétence activée

1107</h4>1150</h4>

1108 1151

1109Enregistré quand une compétence est invoquée, que Claude l'appelle via l'outil Skill ou que vous l'exécutiez en tant que commande `/`.1152Enregistré lorsqu'une compétence est invoquée, que Claude l'appelle via l'outil Skill ou que vous l'exécutiez en tant que commande `/`.

1110 1153

1111**Nom de l'événement** : `claude_code.skill_activated`1154**Nom de l'événement** : `claude_code.skill_activated`

1112 1155

1119* `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`1162* `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`

1120* `invocation_trigger` : Comment la compétence a été déclenchée (`"user-slash"`, `"claude-proactive"`, ou `"nested-skill"`)1163* `invocation_trigger` : Comment la compétence a été déclenchée (`"user-slash"`, `"claude-proactive"`, ou `"nested-skill"`)

1121* `skill.source` : D'où la compétence a été chargée (par exemple, `"bundled"`, `"userSettings"`, `"projectSettings"`, `"plugin"`)1164* `skill.source` : D'où la compétence a été chargée (par exemple, `"bundled"`, `"userSettings"`, `"projectSettings"`, `"plugin"`)

1122* `skill.kind` : `"workflow"` quand la compétence est une compétence de flux de travail. Absent sinon1165* `skill.kind` : `"workflow"` lorsque la compétence est une compétence de flux de travail. Absent sinon

1123* `plugin.name` (quand `OTEL_LOG_TOOL_DETAILS=1` ou le plugin provient d'une place de marché officielle) : Nom du plugin propriétaire quand la compétence est fournie par un plugin1166* `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

1124* `marketplace.name` (quand `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é, quand la compétence est fournie par un plugin1167* `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

1125 1168

1126<h4 id="at-mention-event">1169<h4 id="at-mention-event">

1127 Événement de mention @1170 Événement de mention @

1128</h4>1171</h4>

1129 1172

1130Enregistré quand Claude Code résout une mention `@` dans une invite. Pas chaque mention n'émet un événement : les chemins de sortie anticipée tels que les refus de permission, les fichiers surdimensionnés, les pièces jointes de référence PDF et les défaillances de listage de répertoires retournent sans journalisation.1173Enregistré lorsque Claude Code résout une mention `@` dans une invite. Pas chaque mention n'émet un événement : les chemins de sortie anticipée tels que les refus de permission, les fichiers surdimensionnés, les pièces jointes de référence PDF et les défaillances de listage de répertoires retournent sans journalisation.

1131 1174

1132**Nom de l'événement** : `claude_code.at_mention`1175**Nom de l'événement** : `claude_code.at_mention`

1133 1176

1141* `success` : Si la mention a été résolue avec succès (`"true"` ou `"false"`)1184* `success` : Si la mention a été résolue avec succès (`"true"` ou `"false"`)

1142 1185

1143<h4 id="api-retries-exhausted-event">1186<h4 id="api-retries-exhausted-event">

1144 Événement de nouvelles tentatives API épuisées1187 Événement de tentatives API épuisées

1145</h4>1188</h4>

1146 1189

1147Enregistré une fois quand une demande API échoue après plus d'une tentative. Émis aux côtés de l'événement `api_error` final.1190Enregistré une fois lorsqu'une demande API échoue après plus d'une tentative. Émis aux côtés de l'événement `api_error` final.

1148 1191

1149**Nom de l'événement** : `claude_code.api_retries_exhausted`1192**Nom de l'événement** : `claude_code.api_retries_exhausted`

1150 1193

1156* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)1199* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)

1157* `model` : Modèle utilisé1200* `model` : Modèle utilisé

1158* `error` : Message d'erreur final1201* `error` : Message d'erreur final

1159* `status_code` : Code de statut HTTP en tant que nombre. Absent pour les erreurs non-HTTP.1202* `status_code` : Code de statut HTTP sous forme de nombre. Absent pour les erreurs non-HTTP.

1160* `total_attempts` : Nombre total de tentatives effectuées1203* `total_attempts` : Nombre total de tentatives effectuées

1161* `total_retry_duration_ms` : Temps mural total à travers toutes les tentatives1204* `total_retry_duration_ms` : Temps mural total sur toutes les tentatives

1162* `speed` : `"fast"` ou `"normal"`1205* `speed` : `"fast"` ou `"normal"`

1163 1206

1164<h4 id="hook-registered-event">1207<h4 id="hook-registered-event">

1165 Événement de hook enregistré1208 Événement de hook enregistré

1166</h4>1209</h4>

1167 1210

1168Enregistré une fois par hook configuré au démarrage de la session. Utilisez cet événement pour inventorier quels hooks sont actifs dans votre flotte, en complément des événements par exécution `hook_execution_start` et `hook_execution_complete`.1211Enregistré une fois par hook configuré au démarrage de la session. Utilisez cet événement pour inventorier les hooks actifs dans votre flotte, en complément des événements par exécution `hook_execution_start` et `hook_execution_complete`.

1169 1212

1170**Nom de l'événement** : `claude_code.hook_registered`1213**Nom de l'événement** : `claude_code.hook_registered`

1171 1214

1178* `hook_event` : type d'événement hook, par exemple `"PreToolUse"` ou `"PostToolUse"`1221* `hook_event` : type d'événement hook, par exemple `"PreToolUse"` ou `"PostToolUse"`

1179* `hook_type` : type d'implémentation du hook : `"command"`, `"prompt"`, `"mcp_tool"`, `"http"`, ou `"agent"`1222* `hook_type` : type d'implémentation du hook : `"command"`, `"prompt"`, `"mcp_tool"`, `"http"`, ou `"agent"`

1180* `hook_source` : où le hook est défini : `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"`, ou `"pluginHook"`1223* `hook_source` : où le hook est défini : `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"`, ou `"pluginHook"`

1181* `safe_mode` : `"true"` quand la session a été démarrée avec [`--safe-mode`](/docs/fr/cli-reference), `"false"` sinon. Nécessite Claude Code v2.1.169 ou ultérieur1224* `safe_mode` : `"true"` lorsque la session a été démarrée avec [`--safe-mode`](/docs/fr/cli-reference), `"false"` sinon. Nécessite Claude Code v2.1.169 ou ultérieur

1182* `hook_matcher` (quand `OTEL_LOG_TOOL_DETAILS=1`) : la chaîne de correspondance de la configuration du hook, quand une est définie1225* `hook_matcher` (lorsque `OTEL_LOG_TOOL_DETAILS=1`) : la chaîne de correspondance de la configuration du hook, lorsqu'une est définie

1183* `plugin.name` (quand `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`1226* `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`

1184* `plugin_id_hash` (quand `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é](#plugin-loaded-event)1227* `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é](#plugin-loaded-event)

1185 1228

1186<h4 id="hook-execution-start-event">1229<h4 id="hook-execution-start-event">

1187 Événement de début d'exécution de hook1230 Événement de début d'exécution de hook

1188</h4>1231</h4>

1189 1232

1190Enregistré quand un ou plusieurs hooks commencent à s'exécuter pour un événement hook.1233Enregistré lorsqu'un ou plusieurs hooks commencent à s'exécuter pour un événement hook.

1191 1234

1192**Nom de l'événement** : `claude_code.hook_execution_start`1235**Nom de l'événement** : `claude_code.hook_execution_start`

1193 1236

1198* `event.timestamp` : Timestamp ISO 86011241* `event.timestamp` : Timestamp ISO 8601

1199* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)1242* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)

1200* `hook_event` : Type d'événement hook, par exemple `"PreToolUse"` ou `"PostToolUse"`1243* `hook_event` : Type d'événement hook, par exemple `"PreToolUse"` ou `"PostToolUse"`

1201* `hook_name` : Nom complet du hook incluant la correspondance, par exemple `"PreToolUse:Write"`1244* `hook_name` : Nom complet du hook incluant le correspondant, par exemple `"PreToolUse:Write"`

1202* `num_hooks` : Nombre de commandes hook correspondantes1245* `num_hooks` : Nombre de commandes hook correspondantes

1203* `managed_only` : `"true"` quand seuls les hooks de politique gérée sont autorisés1246* `managed_only` : `"true"` lorsque seuls les hooks de politique gérée sont autorisés

1204* `hook_source` : `"policySettings"` ou `"merged"`1247* `hook_source` : `"policySettings"` ou `"merged"`

1205* `safe_mode` : `"true"` quand la session a été démarrée avec [`--safe-mode`](/docs/fr/cli-reference), `"false"` sinon. Nécessite Claude Code v2.1.169 ou ultérieur1248* `safe_mode` : `"true"` lorsque la session a été démarrée avec [`--safe-mode`](/docs/fr/cli-reference), `"false"` sinon. Nécessite Claude Code v2.1.169 ou ultérieur

1206* `hook_definitions` : Configuration du hook sérialisée en JSON. Inclus uniquement quand le traçage bêta détaillé et `OTEL_LOG_TOOL_DETAILS=1` sont tous deux activés1249* `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

1207 1250

1208<h4 id="hook-execution-complete-event">1251<h4 id="hook-execution-complete-event">

1209 Événement de fin d'exécution de hook1252 Événement de fin d'exécution de hook

1210</h4>1253</h4>

1211 1254

1212Enregistré quand tous les hooks pour un événement hook ont terminé.1255Enregistré lorsque tous les hooks pour un événement hook ont terminé.

1213 1256

1214**Nom de l'événement** : `claude_code.hook_execution_complete`1257**Nom de l'événement** : `claude_code.hook_execution_complete`

1215 1258

1220* `event.timestamp` : Timestamp ISO 86011263* `event.timestamp` : Timestamp ISO 8601

1221* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)1264* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)

1222* `hook_event` : Type d'événement hook1265* `hook_event` : Type d'événement hook

1223* `hook_name` : Nom complet du hook incluant la correspondance1266* `hook_name` : Nom complet du hook incluant le correspondant

1224* `num_hooks` : Nombre de commandes hook correspondantes1267* `num_hooks` : Nombre de commandes hook correspondantes

1225* `num_success` : Nombre qui ont terminé avec succès1268* `num_success` : Nombre qui ont réussi

1226* `num_blocking` : Nombre qui ont retourné une décision de blocage1269* `num_blocking` : Nombre qui ont retourné une décision de blocage

1227* `num_non_blocking_error` : Nombre qui ont échoué sans bloquer1270* `num_non_blocking_error` : Nombre qui ont échoué sans bloquer

1228* `num_cancelled` : Nombre annulé avant la fin1271* `num_cancelled` : Nombre annulé avant la fin

1229* `total_duration_ms` : Durée mural de tous les hooks correspondants1272* `total_duration_ms` : Durée mural de tous les hooks correspondants

1230* `stdout_chars` : Nombre total de caractères de stdout à travers les hooks correspondants qui ont réussi. Nécessite Claude Code v2.1.280 ou ultérieur1273* `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

1231* `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érieur1274* `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

1232* `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érieur1275* `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

1233* `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érieur1276* `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

1234* `num_outputs_persisted` : Nombre de sorties de hook au-delà de la [limite de 10 000 caractères](/docs/fr/hooks#json-output) que Claude Code a enregistrées dans un fichier. Nécessite Claude Code v2.1.280 ou ultérieur1277* `num_outputs_persisted` : Nombre de sorties de hook au-delà de la [limite de 10 000 caractères](/docs/fr/hooks#json-output) que Claude Code a enregistrées dans un fichier. Nécessite Claude Code v2.1.280 ou ultérieur

1235* `managed_only` : `"true"` quand seuls les hooks de politique gérée sont autorisés1278* `managed_only` : `"true"` lorsque seuls les hooks de politique gérée sont autorisés

1236* `hook_source` : `"policySettings"` ou `"merged"`1279* `hook_source` : `"policySettings"` ou `"merged"`

1237* `safe_mode` : `"true"` quand la session a été démarrée avec [`--safe-mode`](/docs/fr/cli-reference), `"false"` sinon. Nécessite Claude Code v2.1.169 ou ultérieur1280* `safe_mode` : `"true"` lorsque la session a été démarrée avec [`--safe-mode`](/docs/fr/cli-reference), `"false"` sinon. Nécessite Claude Code v2.1.169 ou ultérieur

1238* `hook_definitions` : Configuration du hook sérialisée en JSON. Inclus uniquement quand le traçage bêta détaillé et `OTEL_LOG_TOOL_DETAILS=1` sont tous deux activés1281* `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

1239 1282

1240<h4 id="hook-plugin-metrics-event">1283<h4 id="hook-plugin-metrics-event">

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

1242</h4>1285</h4>

1243 1286

1244Enregistré quand un hook de plugin de la place de marché officielle émet des métriques par invocation. Seuls les plugins installés à partir d'une place de marché Anthropic officielle peuvent émettre ceci. Les plugins de place de marché tiers et les hooks configurés par l'utilisateur n'émettent pas vers cet événement. Utilisez cet événement pour surveiller le comportement du plugin, par exemple les taux de découverte, les coûts et les durées à partir de votre propre pile d'observabilité.1287Enregistré lorsqu'un hook de plugin de place de marché officielle émet des métriques par invocation. Seuls les plugins installés à partir d'une place de marché Anthropic officielle peuvent émettre ceci. Les plugins de place de marché tiers et les hooks configurés par l'utilisateur n'émettent pas vers cet événement. Utilisez cet événement pour surveiller le comportement du plugin, par exemple les taux de découverte, les coûts et les durées à partir de votre propre pile d'observabilité.

1245 1288

1246**Nom de l'événement** : `claude_code.hook_plugin_metrics`1289**Nom de l'événement** : `claude_code.hook_plugin_metrics`

1247 1290

1259 Événement de compaction1302 Événement de compaction

1260</h4>1303</h4>

1261 1304

1262Enregistré quand la compaction de conversation se termine.1305Enregistré lorsque la compaction de conversation se termine.

1263 1306

1264**Nom de l'événement** : `claude_code.compaction`1307**Nom de l'événement** : `claude_code.compaction`

1265 1308

1274* `duration_ms` : Durée de compaction1317* `duration_ms` : Durée de compaction

1275* `pre_tokens` : Nombre approximatif de jetons avant compaction1318* `pre_tokens` : Nombre approximatif de jetons avant compaction

1276* `post_tokens` : Nombre approximatif de jetons après compaction1319* `post_tokens` : Nombre approximatif de jetons après compaction

1277* `error` : Message d'erreur quand la compaction a échoué1320* `error` : Message d'erreur lorsque la compaction a échoué

1278* `precompute_reuse` : Défini uniquement quand `trigger` est `"manual"`. La compaction automatique peut préparer un résumé en arrière-plan avant que la fenêtre de contexte 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érieur1321* `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

1279 1322

1280<h4 id="subagent-completed-event">1323<h4 id="subagent-completed-event">

1281 Événement de sous-agent terminé1324 Événement de fin de sous-agent

1282</h4>1325</h4>

1283 1326

1284Enregistré quand un [sous-agent](/docs/fr/sub-agents) se termine et retourne son résultat à la conversation qui l'a démarré. Utilisez-le pour cumuler l'utilisation d'outils et le temps d'exécution par type de sous-agent ; pour les cumuls de jetons ou de coûts, utilisez le [compteur de jetons](#token-counter) et le [compteur de coût](#cost-counter) filtrés sur `query_source` `"subagent"`, puisque le `total_tokens` de cet événement couvre uniquement la demande finale. La catégorie `"subagent"` compte également les demandes des hooks basés sur les agents, qui n'émettent aucun événement de sous-agent.1327Enregistré lorsqu'un [sous-agent](/docs/fr/sub-agents) se termine et retourne son résultat à la conversation qui l'a démarré. Utilisez-le pour regrouper l'utilisation d'outils et le temps d'exécution par type de sous-agent ; pour les regroupements de jetons ou de coûts, utilisez le [compteur de jetons](#token-counter) et le [compteur de coûts](#cost-counter) filtrés sur `query_source` `"subagent"`, puisque le `total_tokens` de cet événement couvre uniquement la demande finale. La catégorie `"subagent"` compte également les demandes des hooks basés sur des agents, qui n'émettent aucun événement de sous-agent.

1285 1328

1286**Nom de l'événement** : `claude_code.subagent_completed`1329**Nom de l'événement** : `claude_code.subagent_completed`

1287 1330

1292* `event.timestamp` : Timestamp ISO 86011335* `event.timestamp` : Timestamp ISO 8601

1293* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)1336* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)

1294* `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éfini1337* `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

1295* `agent.source` : D'où provient la définition de l'agent : `built-in`, `plugin`, ou la source de paramètres qui a défini un agent personnalisé, par exemple `userSettings` ou `projectSettings`1338* `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`

1296* `is_built_in` : Si le sous-agent est un type d'agent intégré1339* `is_built_in` : Si le sous-agent est un type d'agent intégré

1297* `is_async` : Si le sous-agent s'est exécuté en [arrière-plan](/docs/fr/sub-agents#run-subagents-in-foreground-or-background)1340* `is_async` : Si le sous-agent s'exécutait en [arrière-plan](/docs/fr/sub-agents#run-subagents-in-foreground-or-background)

1298* `total_tokens` : L'empreinte de jeton 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 à travers l'exécution1341* `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

1299* `total_tool_uses` : Nombre d'appels d'outils que le sous-agent a effectués à travers toute l'exécution1342* `total_tool_uses` : Nombre d'appels d'outils que le sous-agent a effectués sur toute l'exécution

1300* `duration_ms` : Temps d'exécution en millisecondes1343* `duration_ms` : Temps d'exécution en millisecondes

1301* `model` : Le modèle auquel le sous-agent a été résolu pour s'exécuter1344* `model` : Le modèle auquel le sous-agent a été résolu pour s'exécuter

1302* `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érieur1345* `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

1303* `model_swapped` : Si plus d'un modèle a servi les demandes du sous-agent. Nécessite Claude Code v2.1.212 ou ultérieur1346* `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

1304* `plugin_id_hash`, `plugin.name` : Présent pour les agents fournis par les plugins. Les noms de 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éfini1347* `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

1305 1348

1306<h4 id="feedback-survey-event">1349<h4 id="feedback-survey-event">

1307 Événement d'enquête de rétroaction1350 Événement d'enquête de rétroaction

1308</h4>1351</h4>

1309 1352

1310Enregistré quand une enquête de qualité de session est affichée ou répondue. Voir [Enquêtes de qualité de session](/docs/fr/data-usage#session-quality-surveys) pour ce que les enquêtes collectent et comment les contrôler.1353Enregistré lorsqu'une enquête de qualité de session est affichée ou répondue. Voir [Enquêtes de qualité de session](/docs/fr/data-usage#session-quality-surveys) pour ce que les enquêtes collectent et comment les contrôler.

1311 1354

1312**Nom de l'événement** : `claude_code.feedback_survey`1355**Nom de l'événement** : `claude_code.feedback_survey`

1313 1356

1318* `event.timestamp` : Timestamp ISO 86011361* `event.timestamp` : Timestamp ISO 8601

1319* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)1362* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)

1320* `event_type` : Événement du cycle de vie de l'enquête, par exemple `"appeared"`, `"responded"`, ou `"transcript_prompt_appeared"`1363* `event_type` : Événement du cycle de vie de l'enquête, par exemple `"appeared"`, `"responded"`, ou `"transcript_prompt_appeared"`

1321* `appearance_id` : ID unique liant les événements émis pour une instance d'enquête1364* `appearance_id` : ID unique reliant les événements émis pour une instance d'enquête

1322* `survey_type` : Quelle enquête a produit l'événement. `"session"` est l'invite d'évaluation « Comment Claude se débrouille-t-il ? »1365* `survey_type` : Quelle enquête a produit l'événement. `"session"` est l'invite d'évaluation « Comment Claude se débrouille-t-il ? »

1323* `response` : La sélection de l'utilisateur sur les événements `responded`1366* `response` : La sélection de l'utilisateur sur les événements `responded`

1324* `enabled_via_override` : `true` quand [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/docs/fr/env-vars) est défini. Émis comme un booléen, pas une 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 flotte1367* `enabled_via_override` : `true` lorsque [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/docs/fr/env-vars) 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

1325 1368

1326<h4 id="retention-sweep-event">1369<h4 id="retention-sweep-event">

1327 Événement de balayage de rétention1370 Événement de balayage de rétention

1328</h4>1371</h4>

1329 1372

1330Enregistré une fois par exécution du balayage de nettoyage de rétention, qui supprime les [transcriptions de session et autres données d'application](/docs/fr/claude-directory#cleaned-up-automatically) plus anciennes que le paramètre [`cleanupPeriodDays`](/docs/fr/settings-reference#cleanupperioddays). Claude Code exécute le balayage en arrière-plan au maximum une fois par session, et une exécution qui ne supprime rien émet quand même l'événement. Si Claude Code a exécuté le balayage dans n'importe quelle session sur la même machine au cours des 24 dernières heures, il retarde le balayage de cette session d'au moins 10 minutes, donc une session qui se termine plus tôt n'émet rien. Quand vous exécutez `claude -p` avec `--bare`, Claude Code n'exécute pas le balayage et n'émet rien.1373Enregistré une fois par exécution du balayage de nettoyage de rétention, qui supprime les [transcriptions de session et autres données d'application](/docs/fr/claude-directory#cleaned-up-automatically) plus anciennes que le paramètre [`cleanupPeriodDays`](/docs/fr/settings-reference#cleanupperioddays). Claude Code exécute le balayage en arrière-plan au maximum une fois par session, et une exécution qui ne supprime rien émet quand même l'événement. Si Claude Code a exécuté le balayage dans n'importe quelle session sur la même machine au cours des 24 dernières heures, il retarde le balayage de cette session d'au moins 10 minutes, donc une session qui se termine plus tôt n'émet rien. Lorsque vous exécutez `claude -p` avec `--bare`, Claude Code n'exécute pas le balayage et n'émet rien.

1331 1374

1332Comme chaque événement OTel sur cette page, il va uniquement au backend de télémétrie que vous configurez. Nécessite Claude Code v2.1.227 ou ultérieur.1375Comme chaque événement OTel sur cette page, il va uniquement au backend de télémétrie que vous configurez. Nécessite Claude Code v2.1.227 ou ultérieur.

1333 1376

1334Quand Claude Code ne peut pas déterminer avec certitude la période de rétention, il met en pause le balayage et émet l'événement avec `result` défini à `"skipped"` et une `skip_reason`. Quand les [paramètres gérés](/docs/fr/server-managed-settings) définissent `cleanupPeriodDays`, la valeur gérée épingle la période de rétention et le balayage s'exécute même quand un fichier de paramètres dans une portée de priorité inférieure est cassé ou invalide. Quand `managed-settings.json` lui-même ne peut pas être lu, Claude Code met quand même en pause le balayage sauf si le [niveau géré](/docs/fr/managed-settings#how-claude-code-combines-managed-sources) fournit `cleanupPeriodDays` d'ailleurs, par exemple les paramètres gérés par le serveur ou une suppression `managed-settings.d/` à côté du fichier cassé. Les attributs du compteur de suppression sont présents uniquement quand `result` est `"complete"`.1377Lorsque Claude Code ne peut pas déterminer avec certitude la période de rétention, il met en pause le balayage et émet l'événement avec `result` défini à `"skipped"` et une `skip_reason`. Lorsque les [paramètres gérés](/docs/fr/server-managed-settings) définissent `cleanupPeriodDays`, la valeur gérée épingle la période de rétention et le balayage s'exécute même lorsqu'un fichier de paramètres dans une portée de priorité inférieure est cassé ou invalide. Lorsque `managed-settings.json` lui-même ne peut pas être lu, Claude Code met quand même en pause le balayage sauf si le [niveau géré](/docs/fr/managed-settings#how-claude-code-combines-managed-sources) fournit `cleanupPeriodDays` d'ailleurs, par exemple à partir des paramètres gérés par le serveur ou d'une suppression `managed-settings.d/` à côté du fichier cassé. Les attributs du compteur de suppression sont présents uniquement lorsque `result` est `"complete"`.

1335 1378

1336**Nom de l'événement** : `claude_code.retention_sweep`1379**Nom de l'événement** : `claude_code.retention_sweep`

1337 1380

1341* `event.name` : `"retention_sweep"`1384* `event.name` : `"retention_sweep"`

1342* `event.timestamp` : Timestamp ISO 86011385* `event.timestamp` : Timestamp ISO 8601

1343* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)1386* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)

1344* `result` : `"complete"` quand le balayage s'est exécuté, `"skipped"` quand Claude Code l'a mis en pause1387* `result` : `"complete"` lorsque le balayage s'est exécuté, `"skipped"` lorsque Claude Code l'a mis en pause

1345* `period_days` : La valeur `cleanupPeriodDays` des paramètres fusionnés, en jours, ou `30` quand 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 a pu lire1388* `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

1346* `used_default` : `"true"` quand 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'appliquait1389* `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

1347* `skip_reason` : Pourquoi Claude Code a mis en pause le balayage. Présent uniquement quand `result` est `"skipped"` :1390* `skip_reason` : Pourquoi Claude Code a mis en pause le balayage. Présent uniquement lorsque `result` est `"skipped"` :

1348 * `"user_source_disabled"` : Les paramètres utilisateur sont exclus, par exemple par le drapeau [`--setting-sources`](/docs/fr/cli-reference#cli-flags) ou l'option [`settingSources`](/docs/fr/agent-sdk/typescript#options) du SDK, et aucune source activée ne fournit `cleanupPeriodDays`1391 * `"user_source_disabled"` : Les paramètres utilisateur sont exclus, par exemple par le drapeau [`--setting-sources`](/docs/fr/cli-reference#cli-flags) ou l'option [`settingSources`](/docs/fr/agent-sdk/typescript#options) du SDK, et aucune source activée ne fournit `cleanupPeriodDays`

1349 * `"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 voir1392 * `"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

1350 * `"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ètre1393 * `"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

1351* `transcripts_deleted` : Nombre de transcriptions de session, les fichiers `~/.claude/projects/*/*.jsonl` de niveau supérieur, que le balayage a supprimés1394* `transcripts_deleted` : Nombre de transcriptions de session, les fichiers `~/.claude/projects/*/*.jsonl` de niveau supérieur, que le balayage a supprimés

1352* `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](/docs/fr/claude-directory#cleaned-up-automatically). Celles-ci ne comptent pas vers `files_past_cutoff`. Nécessite Claude Code v2.1.248 ou ultérieur1395* `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](/docs/fr/claude-directory#cleaned-up-automatically). Celles-ci ne comptent pas vers `files_past_cutoff`. Nécessite Claude Code v2.1.248 ou ultérieur

1353* `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'outils1396* `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

1354* `artifacts_deleted` : Nombre total d'éléments que le balayage a supprimés à travers 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 de fichiers exact1397* `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

1355* `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 normal1398* `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

1356* `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 place1399* `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

1357* `error_count` : Nombre d'erreurs que le balayage a rencontrées lors de la liste ou de la suppression de fichiers1400* `error_count` : Nombre d'erreurs que le balayage a rencontrées lors de la liste ou de la suppression de fichiers

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

1361</h4>1404</h4>

1362 1405

1363Enregistré avec les [paramètres gérés](/docs/fr/managed-settings) qu'une session a résolus : une fois au démarrage de la session, à nouveau quand soit les paramètres gérés soit l'état de l'[assistant de politique](/docs/fr/managed-settings#compute-the-policy-with-a-helper-program) change pendant la session, et quand Claude Code refuse de démarrer ou termine la session pour l'une des raisons que l'attribut `error.type` liste.1406Enregistré avec les [paramètres gérés](/docs/fr/managed-settings) qu'une session a résolus : une fois au démarrage de la session, à nouveau lorsque soit les paramètres gérés soit l'état de l'[assistant de politique](/docs/fr/managed-settings#compute-the-policy-with-a-helper-program) change pendant la session, et lorsque Claude Code refuse de démarrer ou termine la session pour l'une des raisons que l'attribut `error.type` énumère.

1364Utilisez cet événement pour trouver les machines exécutées sur une source gérée inattendue, les machines dont l'assistant de politique échoue, et la raison pour laquelle une machine a refusé de démarrer.1407Utilisez cet événement pour trouver les machines exécutées sur une source gérée inattendue, les machines dont l'assistant de politique échoue, et la raison pour laquelle une machine a refusé de démarrer.

1365Nécessite Claude Code v2.1.274 ou ultérieur.1408Nécessite Claude Code v2.1.274 ou ultérieur.

1366 1409

1379* `event.name` : `"managed_settings_resolved"`1422* `event.name` : `"managed_settings_resolved"`

1380* `event.timestamp` : Timestamp ISO 86011423* `event.timestamp` : Timestamp ISO 8601

1381* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)1424* `event.sequence` : compteur par processus pour ordonner les événements, décrit sous [Attributs de corrélation d'événements](#event-correlation-attributes)

1382* `managed_settings.trigger` : `"startup"` pour l'événement de démarrage de session, `"change"` quand les paramètres gérés ou l'état de l'assistant de politique ont changé plus tard dans la session, ou `"refused"` quand une politique de paramètres gérés a arrêté la session. Claude Code envoie un événement `change` uniquement quand un attribut diffère du dernier événement qu'il a envoyé, et une valeur de paramètre modifiée compte même quand `OTEL_LOG_MANAGED_SETTINGS` est désactivé1425* `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é

1383* `error.type` : pourquoi Claude Code a arrêté la session. Présent uniquement sur les événements `refused` :1426* `error.type` : pourquoi Claude Code a arrêté la session. Présent uniquement sur les événements `refused` :

1384 * `"helper_failed"` : une [exécution d'assistant de politique a échoué](/docs/fr/settings-reference#helper-failures)1427 * `"helper_failed"` : une [exécution d'assistant de politique a échoué](/docs/fr/settings-reference#helper-failures)

1385 * `"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 de l'organisation1428 * `"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

1386 * `"consent_rejected"` : l'utilisateur a rejeté la [boîte de dialogue d'approbation de sécurité](/docs/fr/server-managed-settings#security-approval-dialogs) pour les paramètres gérés par le serveur1429 * `"consent_rejected"` : l'utilisateur a rejeté la [boîte de dialogue d'approbation de sécurité](/docs/fr/server-managed-settings#security-approval-dialogs) pour les paramètres gérés par le serveur

1387 * `"force_refresh_failed"` : l'extraction de paramètres que [`forceRemoteSettingsRefresh`](/docs/fr/settings-reference#forceremotesettingsrefresh) nécessite a échoué1430 * `"force_refresh_failed"` : la récupération de paramètres que [`forceRemoteSettingsRefresh`](/docs/fr/settings-reference#forceremotesettingsrefresh) nécessite a échoué

1388 * `"gateway_rejected"` : une [passerelle d'applications Claude](/docs/fr/claude-apps-gateway) a répondu au chargement des paramètres gérés avec HTTP 4031431 * `"gateway_rejected"` : une [passerelle d'applications Claude](/docs/fr/claude-apps-gateway) a répondu au chargement des paramètres gérés avec HTTP 403

1389 * `"version_below_minimum"` : cette version de Claude Code est en dessous de [`requiredMinimumVersion`](/docs/fr/settings-reference#requiredminimumversion) ou au-dessus de [`requiredMaximumVersion`](/docs/fr/settings-reference#requiredmaximumversion)1432 * `"version_below_minimum"` : cette version de Claude Code est inférieure à [`requiredMinimumVersion`](/docs/fr/settings-reference#requiredminimumversion) ou supérieure à [`requiredMaximumVersion`](/docs/fr/settings-reference#requiredmaximumversion)

1390 * `"_OTHER"` : le chargement des paramètres gérés de la passerelle d'applications Claude a échoué pour une autre raison1433 * `"_OTHER"` : le chargement des paramètres gérés de la passerelle d'applications Claude a échoué pour une autre raison

1391* `managed_settings.sources` : chaque source gérée qui fournit au moins une [clé de politique](/docs/fr/managed-settings#how-claude-code-combines-managed-sources), 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"` quand un [hôte d'intégration](/docs/fr/managed-settings#let-an-embedding-host-add-policy) fournit des paramètres, et `"hkcu"` pour la [valeur du registre Windows HKCU](/docs/fr/managed-settings#where-each-mechanism-stores-the-policy) quand Claude Code la [lit](/docs/fr/managed-settings#how-claude-code-combines-managed-sources). 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 comme un tableau de chaînes, vide quand aucune source gérée ne fournit une clé de politique1434* `managed_settings.sources` : chaque source gérée qui fournit au moins une [clé de politique](/docs/fr/managed-settings#how-claude-code-combines-managed-sources), 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](/docs/fr/managed-settings#let-an-embedding-host-add-policy) fournit des paramètres, et `"hkcu"` pour la [valeur du registre Windows HKCU](/docs/fr/managed-settings#where-each-mechanism-stores-the-policy) lorsque Claude Code la [lit](/docs/fr/managed-settings#how-claude-code-combines-managed-sources). 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

1392* `managed_settings.source_behavior` : la valeur [`managedSourcesBehavior`](/docs/fr/settings-reference#managedsourcesbehavior) que Claude Code a lue, `"first-wins"` ou `"merge"`. `"first-wins"` quand aucune source ne définit la clé1435* `managed_settings.source_behavior` : la valeur [`managedSourcesBehavior`](/docs/fr/settings-reference#managedsourcesbehavior) que Claude Code a lue, `"first-wins"` ou `"merge"`. `"first-wins"` lorsqu'aucune source ne définit la clé

1393* `managed_settings.helper.state` : état de l'assistant de politique que la source MDM ou fichier sélectionnée configure :1436* `managed_settings.helper.state` : état de l'assistant de politique que la source MDM ou fichier sélectionnée configure :

1394 * `"ok"` : la sortie de l'assistant sert de paramètres gérés1437 * `"ok"` : la sortie de l'assistant sert de paramètres gérés

1395 * `"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](/docs/fr/settings-reference#helper-failures) décrivent les cas1438 * `"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](/docs/fr/settings-reference#helper-failures) décrivent les cas

1396 * `"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és1439 * `"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

1397* `managed_settings.helper.applied` : `"output"` tandis que la propre sortie de l'assistant sert de paramètres gérés, `"none"` quand ce n'est pas le cas1440* `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

1398* `managed_settings.helper.entry` : `"policyHelper"` quand Claude Code a sélectionné un [`policyHelper`](/docs/fr/settings-reference#policyhelper). Absent quand il n'a sélectionné aucun assistant1441* `managed_settings.helper.entry` : `"policyHelper"` lorsque Claude Code a sélectionné un [`policyHelper`](/docs/fr/settings-reference#policyhelper). Absent lorsqu'il n'a sélectionné aucun assistant

1399* `managed_settings.helper.path` : le [`path`](/docs/fr/settings-reference#policyhelper-path) configuré de l'assistant. Présent chaque fois que Claude Code a sélectionné un assistant, que `OTEL_LOG_MANAGED_SETTINGS` soit défini ou non1442* `managed_settings.helper.path` : le [`path`](/docs/fr/settings-reference#policyhelper-path) configuré de l'assistant. Présent chaque fois que Claude Code a sélectionné un assistant, qu'il ait réussi ou non

1400* `managed_settings.resolved_sha256` (quand `OTEL_LOG_MANAGED_SETTINGS=1`) : SHA-256 des paramètres gérés résolus avant rédaction, sérialisé 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 quand aucun paramètre géré n'a été résolu, et sur les événements `refused`1443* `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`

1401* `managed_settings.settings` (quand `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 :1444* `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 :

1402 1445

1403 * 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é1446 * 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é

1404 * 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]"`1447 * 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]"`

1405 * Chaque autre chaîne, par exemple `model`, `apiKeyHelper`, chaque valeur `env`, chaque URL et chaque commande, est exportée comme `"[REDACTED]"`1448 * Chaque autre chaîne, par exemple `model`, `apiKeyHelper`, chaque valeur `env`, chaque URL et chaque commande, est exportée comme `"[REDACTED]"`

1406 * 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 commande1449 * 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

1407 * Une liste conserve sa longueur, avec chaque entrée rédactée par les mêmes règles1450 * Une liste conserve sa longueur, avec chaque entrée rédactée par les mêmes règles

1408 * 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])`, quand 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]"`1451 * 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]"`

1409 * 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]"`1452 * 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]"`

1410 1453

1411 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])"]}}`.1454 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])"]}}`.

1412 1455

1413 Claude Code coupe la valeur à 8 Ko d'UTF-8, et la valeur coupée n'est pas du JSON valide1456 Claude Code coupe la valeur à 8 KB d'UTF-8, et la valeur coupée n'est pas un JSON valide

1414* `managed_settings.settings_truncated` (quand `managed_settings.settings` est présent) : `true` quand Claude Code a coupé `managed_settings.settings` à 8 Ko, `false` sinon. Émis comme un booléen, pas une chaîne1457* `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

1415 1458

1416<h2 id="interpret-metrics-and-events-data">1459<h2 id="interpret-metrics-and-events-data">

1417 Interpréter les données de métriques et d'événements1460 Interpréter les données de métriques et d'événements

1499 1542

1500Les [attributs standard](#standard-attributes) sur chaque événement incluent l'identité de l'utilisateur authentifié : `user.email`, `user.account_uuid`, `user.account_id`, et `organization.id` lorsqu'il est connecté avec un compte Claude ou, dans une [session cloud](/docs/fr/claude-code-on-the-web), lorsque les propres identifiants de la session les portent, plus `user.id` et le per-session `session.id`. `user.id` est un identifiant limité à l'installation, sauf sur les sessions de [passerelle d'applications Claude](/docs/fr/claude-apps-gateway), où il s'agit du sujet IdP du jeton émis par la passerelle.1543Les [attributs standard](#standard-attributes) sur chaque événement incluent l'identité de l'utilisateur authentifié : `user.email`, `user.account_uuid`, `user.account_id`, et `organization.id` lorsqu'il est connecté avec un compte Claude ou, dans une [session cloud](/docs/fr/claude-code-on-the-web), lorsque les propres identifiants de la session les portent, plus `user.id` et le per-session `session.id`. `user.id` est un identifiant limité à l'installation, sauf sur les sessions de [passerelle d'applications Claude](/docs/fr/claude-apps-gateway), où il s'agit du sujet IdP du jeton émis par la passerelle.

1501 1544

1502Les appels d'outils MCP, les commandes Bash et les éditions de fichiers sont donc attribués au développeur qui a démarré la session. Claude Code n'agit pas sous un compte de service distinct ; l'identité enregistrée sur chaque événement est le propre compte Claude du développeur, ou l'identité IdP du développeur sur une session de [passerelle d'applications Claude](/docs/fr/claude-apps-gateway).1545Dans une session qu'un développeur démarre, les appels d'outils MCP, les commandes Bash et les éditions de fichiers sont donc attribués à ce développeur. Claude Code n'agit pas sous un compte de service distinct ; l'identité enregistrée sur chaque événement est le propre compte Claude du développeur, ou l'identité IdP du développeur sur une session de [passerelle d'applications Claude](/docs/fr/claude-apps-gateway). Dans les sessions de canal Claude Tag, Claude fonctionne plutôt comme l'[identité partagée](/docs/fr/cloud-environments#set-the-environment-a-claude-tag-channel-uses) de votre organisation.

1503 1546

1504Lorsque Claude Code s'authentifie avec une clé API directe, ou contre Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry, il n'y a pas de compte Claude dans la session et seuls `user.id` et `session.id` sont remplis. Dans ces déploiements, attachez l'identité utilisateur vous-même avec `OTEL_RESOURCE_ATTRIBUTES`, défini par utilisateur via le fichier [paramètres gérés](#administrator-configuration) ou un wrapper de lancement. Les sessions de passerelle d'applications Claude n'ont besoin d'aucune de ces opérations : le CLI horodate l'identité IdP automatiquement, comme décrit dans [Attributs standard](#standard-attributes).1547Lorsque Claude Code s'authentifie avec une clé API directe, ou contre Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry, il n'y a pas de compte Claude dans la session et seuls `user.id` et `session.id` sont remplis. Dans ces déploiements, attachez l'identité utilisateur vous-même avec `OTEL_RESOURCE_ATTRIBUTES`, défini par utilisateur via le fichier [paramètres gérés](#administrator-configuration) ou un wrapper de lancement. Les sessions de passerelle d'applications Claude n'ont besoin d'aucune de ces opérations : le CLI horodate l'identité IdP automatiquement, comme décrit dans [Attributs standard](#standard-attributes).

1505 1548

1563}1606}

1564```1607```

1565 1608

1566Pour confirmer que les événements arrivent, soumettez une invite dans une session exécutée sous cette configuration et vérifiez votre SIEM pour l'événement `claude_code.user_prompt`. Si rien n'arrive, exécutez `claude --debug` et vérifiez le journal de débogage pour les erreurs d'exportation `[3P telemetry]`.1609Pour confirmer que les événements arrivent, soumettez une invite dans une session exécutée sous cette configuration et vérifiez votre SIEM pour l'événement `claude_code.user_prompt`. Si rien n'arrive, démarrez Claude Code avec `claude --debug-file <path>` et vérifiez ce journal pour les erreurs d'exportation `[3P telemetry]`.

1567 1610

1568<h2 id="backend-considerations">1611<h2 id="backend-considerations">

1569 Considérations relatives aux backends1612 Considérations relatives aux backends

1633 * 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 troncature1676 * 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

1634 * 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ères1677 * 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

1635 * Les événements `user_prompt` incluent le `command_name` verbatim pour les commandes personnalisées, de plugin et MCP1678 * Les événements `user_prompt` incluent le `command_name` verbatim pour les commandes personnalisées, de plugin et MCP

1679 * Les [compteurs de coût et de jeton](#cost-counter) 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

1636 * 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`1680 * 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`

1637* 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`](#tool-output-span-event) avec les contenus de fichiers bruts et la sortie de commande Bash, tronqués à la limite de contenu (60 Ko par défaut) par attribut. Le contenu d'outil atteint également les intervalles via [`new_context`, dont la porte diffère par intervalle](#new-context-gates). Configurez votre backend de télémétrie pour filtrer ou masquer ces attributs selon les besoins1681* 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`](#tool-output-span-event) 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](#new-context-gates). Configurez votre backend de télémétrie pour filtrer ou masquer ces attributs selon les besoins

1638* 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](/docs/fr/settings-reference#variables-claude-code-ignores-in-env). 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 :1682* 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](/docs/fr/settings-reference#variables-claude-code-ignores-in-env). 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 :

1639 * 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)1683 * 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)

1640 * 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.1684 * 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.

monitoring-usage.md 2026-09-28 22:59 UTC to 2026-09-29 21:02 UTC

Surveillance

Démarrage rapide

Configuration de l'administrateur

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

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

Attributs des spans

En-têtes dynamiques

Configuration des paramètres

Exigences du script

Comportement d'actualisation

Support des organisations multi-équipes

Exemples de configurations

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

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

Métriques et événements disponibles

Attributs standard

Attributs du référentiel

Métriques

Détails des métriques

Compteur de sessions

Compteur de lignes de code

Compteur de demandes de tirage

Compteur de commits

Compteur de coûts

Compteur de jetons

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

Compteur de temps actif

Événements

Attributs de corrélation d'événements

Événement d'invite utilisateur

Événement de réponse d'assistant

Événement de résultat d'outil

Événement de demande API

Événement d'erreur API

Événement de refus API

Événement de corps de demande API

Événement de corps de réponse API

Événement de décision d'outil

Événement de changement de mode de permission

Événement d'authentification

Événement de connexion du serveur MCP

Événement d'erreur interne

Événement de plugin installé

Événement de plugin chargé

Événement de compétence activée

Événement de mention @

Événement de tentatives API épuisées

Événement de hook enregistré

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

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

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

Événement de compaction

Événement de fin de sous-agent

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

Événement de balayage de rétention

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

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

Surveillance de l'utilisation

Surveillance des coûts

Alertes et segmentation

Détecter l'épuisement des tentatives

Analyse des événements

Audit des événements de sécurité

Attribuer les actions aux utilisateurs

Audit de l'activité MCP

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

Envoyer les événements à un SIEM

Considérations relatives aux backends

Pour les métriques

Pour les événements/journaux

Pour les traces

Informations sur le service

Ressources de mesure du ROI

Sécurité et confidentialité