---
title: OpenTelemetry pour l'API Claude
url: https://platform.claude.com/docs/fr/manage-claude/opentelemetry
description: Tracez vos requêtes à l'API Messages, vos utilisations d'outils et vos sessions Managed Agents avec des spans OpenTelemetry provenant du SDK Claude et de l'API Claude.
featureMetadata:
  topic:
    title: OpenTelemetry
    url: https://platform.claude.com/docs/en/manage-claude/opentelemetry
  status: beta
---

<Note>
  L'export OpenTelemetry est en bêta. Il est fourni dans le cadre de votre accord avec Anthropic, y compris la section Services bêta des [Conditions spécifiques aux services](https://www.anthropic.com/legal/service-specific-terms).
</Note>

L'API Claude et le SDK peuvent tracer vos requêtes à l'API Messages, vos utilisations d'outils et vos sessions Managed Agents avec [OpenTelemetry](https://opentelemetry.io/). Vous pouvez consulter ces traces dans la plateforme d'observabilité dont vous disposez déjà. Utilisez-les pour déboguer les requêtes en échec ou lentes, suivre la consommation de tokens et la « latency » (latence), et construire des évaluations à partir du trafic réel. Vous pouvez également voir chaque requête dans les propres traces de votre application, reliée à l'utilisateur ou à la fonctionnalité qui l'a envoyée.

OpenTelemetry est un standard indépendant des fournisseurs que la plupart des plateformes d'observabilité prennent en charge. Une *trace* (trace) est l'enregistrement complet d'une requête à travers votre système. Un *span* (segment) est une étape d'une trace, comme une requête au modèle ou une utilisation d'outil. L'API et le SDK utilisent des attributs issus des [conventions sémantiques GenAI](https://github.com/open-telemetry/semantic-conventions-genai), de sorte que les plateformes qui prennent en charge ces conventions peuvent reconnaître les spans sans configuration supplémentaire.

## Premiers pas

Vous pouvez configurer le traçage du SDK, le traçage de l'API, ou les deux. Configurez les deux pour voir les spans du SDK et de l'API d'une requête dans une même trace, comme dans les [exemples de traces](https://platform.claude.com/docs/fr/manage-claude/opentelemetry#example-traces-and-how-to-read-them). Pour les requêtes vers Claude Platform on AWS, les spans de l'API se trouvent plutôt dans leurs propres traces.

<CardGroup cols={3}>
  <Card title="Configurer le traçage du SDK" icon="code-brackets" href="https://platform.claude.com/docs/fr/manage-claude/opentelemetry/sdk" layout="horizontal">
    Installez le SDK et enregistrez un tracer provider.
  </Card>

  <Card title="Configurer le traçage de l'API" icon="cloud" href="https://platform.claude.com/docs/fr/manage-claude/opentelemetry/api" layout="horizontal">
    Ajoutez une destination dans la Claude Console.
  </Card>

  <Card title="Référence des spans" icon="book" href="https://platform.claude.com/docs/fr/api/opentelemetry/spans" layout="horizontal">
    Consultez les spans et leurs attributs.
  </Card>
</CardGroup>

| Ce que vous obtenez                                                                                                                    | Traçage SDK                                                                 | Traçage API                                                                                         | Les deux ensemble                                                                                   |
| -------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| Requêtes à l'[API Messages](https://platform.claude.com/docs/fr/api/messages/create)                                                   | ✅                                                                           | ✅                                                                                                   | ✅                                                                                                   |
| Requêtes à l'[API Sessions](https://platform.claude.com/docs/fr/managed-agents/sessions)                                               | ✅                                                                           | ✅                                                                                                   | ✅                                                                                                   |
| [Utilisation des tokens](https://platform.claude.com/docs/fr/manage-claude/opentelemetry#count-tokens)                                 | ✅                                                                           | ✅                                                                                                   | ✅                                                                                                   |
| Chaque exécution du modèle au sein d'une requête                                                                                       | —                                                                           | ✅                                                                                                   | ✅                                                                                                   |
| Tours [Managed Agents](https://platform.claude.com/docs/fr/managed-agents/overview)                                                    | —                                                                           | ✅                                                                                                   | ✅                                                                                                   |
| [Outils serveur](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/server-tools), exécutés par l'API                       | —                                                                           | ✅                                                                                                   | ✅                                                                                                   |
| Outils client, exécutés par le [tool runner](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/tool-runner)                | ✅                                                                           | —                                                                                                   | ✅                                                                                                   |
| Outils dans un [sandbox auto-hébergé](https://platform.claude.com/docs/fr/manage-claude/opentelemetry/sdk#trace-a-self-hosted-sandbox) | ✅                                                                           | —                                                                                                   | ✅                                                                                                   |
| Autres requêtes API, comme le téléversement de fichiers                                                                                | ✅                                                                           | —                                                                                                   | ✅                                                                                                   |
| Configuration                                                                                                                          | [Code](https://platform.claude.com/docs/fr/manage-claude/opentelemetry/sdk) | [Console](https://platform.claude.com/docs/fr/manage-claude/opentelemetry/api)                      | Les deux                                                                                            |
| Autorisation requise                                                                                                                   | Aucune                                                                      | [Administrateur](https://platform.claude.com/docs/fr/manage-claude/opentelemetry/api#what-you-need) | [Administrateur](https://platform.claude.com/docs/fr/manage-claude/opentelemetry/api#what-you-need) |
| Couverture                                                                                                                             | Clients qui utilisent le SDK                                                | Tout client                                                                                         | Tout client                                                                                         |
| Prise en charge des plateformes cloud                                                                                                  | Toutes                                                                      | Claude Platform<br />Claude Platform on AWS                                                         | Claude Platform<br />Claude Platform on AWS                                                         |

Pour Claude Code, l'Agent SDK ou Cowork, consultez [Surveillance de Claude Code](https://code.claude.com/docs/en/monitoring-usage), [Observabilité de l'Agent SDK](https://code.claude.com/docs/en/agent-sdk/observability) ou [Surveillance de l'activité de Cowork](https://support.claude.com/en/articles/14477985-monitor-claude-cowork-activity-with-opentelemetry).

## Envoyer des traces vers une plateforme partenaire

Envoyez des traces vers toute plateforme d'observabilité acceptant OTLP, y compris ces partenaires :

<CardGroup cols={3}>
  <Card title="Arize AI" image="https://platform.claude.com/docs/images/partner-logos/arize.svg" imageDark="https://platform.claude.com/docs/images/partner-logos/arize-dark.svg" imageOffsetLeft={2} href="https://arize.com/docs/ax/integrations/platforms/claude-managed-agents/claude-managed-agents-tracing">
    Plateforme unifiée d'observabilité et d'évaluation pour l'IA.
  </Card>

  <Card title="Braintrust" image="https://platform.claude.com/docs/images/partner-logos/braintrust.svg" imageDark="https://platform.claude.com/docs/images/partner-logos/braintrust-dark.svg" imageHeight={25} imageOffsetLeft={1} href="https://www.braintrust.dev/docs/integrations/ai-providers/anthropic#export-opentelemetry-traces-from-the-claude-api">
    Plateforme d'observabilité active pour les agents.
  </Card>

  <Card title="Databricks" image="https://platform.claude.com/docs/images/partner-logos/databricks.svg" imageDark="https://platform.claude.com/docs/images/partner-logos/databricks-dark.svg" imageHeight={26} imageOffsetLeft={1} href="https://docs.databricks.com/aws/en/ai-gateway/unified-trace-table">
    Plan de contrôle de l'IA unifié pour l'observabilité et l'évaluation.
  </Card>

  <Card title="Datadog" image="https://platform.claude.com/docs/images/partner-logos/datadog.svg" imageDark="https://platform.claude.com/docs/images/partner-logos/datadog-dark.svg" imageHeight={28} imageOffsetLeft={2} href="https://docs.datadoghq.com/llm_observability/instrument/otel_instrumentation/?tab=python#using-claude-managed-agents">
    Observabilité et sécurité propulsées par l'IA.
  </Card>

  <Card title="Grafana Cloud" image="https://platform.claude.com/docs/images/partner-logos/grafana.svg" imageDark="https://platform.claude.com/docs/images/partner-logos/grafana-dark.svg" imageHeight={34} imageOffsetLeft={2} href="https://grafana.com/docs/grafana-cloud/observe-and-act/agent-observability/guides/send-claude-platform-traces/">
    Plateforme d'observabilité ouverte entièrement gérée.
  </Card>

  <Card title="Honeycomb" image="https://platform.claude.com/docs/images/partner-logos/honeycomb.svg" imageDark="https://platform.claude.com/docs/images/partner-logos/honeycomb-dark.svg" imageHeight={36} imageOffsetLeft={4} href="https://docs.honeycomb.io/send-data/use-cases/claude-platform">
    Plateforme d'observabilité pour la nouvelle forme du logiciel.
  </Card>

  <Card title="Langfuse" image="https://platform.claude.com/docs/images/partner-logos/langfuse.svg" imageDark="https://platform.claude.com/docs/images/partner-logos/langfuse-dark.svg" imageHeight={26} imageOffsetLeft={1} href="https://langfuse.com/integrations/model-providers/claude-platform">
    Plateforme open source d'observabilité et d'évaluation d'agents.
  </Card>

  <Card title="LangSmith" image="https://platform.claude.com/docs/images/partner-logos/langchain.svg" imageDark="https://platform.claude.com/docs/images/partner-logos/langchain-dark.svg" imageHeight={29} href="https://docs.langchain.com/langsmith/trace-anthropic">
    Plateforme d'ingénierie d'agents LangSmith.
  </Card>

  <Card title="New Relic" image="https://platform.claude.com/docs/images/partner-logos/new-relic.svg" imageHeight={27} imageOffsetLeft={1} href="https://docs.newrelic.com/docs/ai-monitoring/opentelemetry-ai-monitoring/#anthropic">
    Plateforme d'observabilité intelligente.
  </Card>

  <Card title="PostHog" image="https://platform.claude.com/docs/images/partner-logos/posthog.svg" imageDark="https://platform.claude.com/docs/images/partner-logos/posthog-dark.svg" imageHeight={29} href="https://posthog.com/docs/ai-observability/installation/anthropic?tab=Claude+Platform&utm_source=anthropic&utm_campaign=anthropic-otel">
    Plateforme tout-en-un pour créer des produits à succès.
  </Card>

  <Card title="Sentry" image="https://platform.claude.com/docs/images/partner-logos/sentry.svg" imageDark="https://platform.claude.com/docs/images/partner-logos/sentry-dark.svg" imageHeight={25} href="https://sentry.io/cookbook/trace-claude-platform-with-opentelemetry/">
    Déboguez votre code défaillant et vos agents au comportement erratique.
  </Card>

  <Card title="Splunk" image="https://platform.claude.com/docs/images/partner-logos/splunk.svg" imageDark="https://platform.claude.com/docs/images/partner-logos/splunk-dark.svg" imageHeight={27} imageOffsetLeft={1} href="https://agent-observability-docs.splunk.com/sdk-api/third-party-integrations/claude">
    Observez, évaluez et sécurisez vos agents.
  </Card>
</CardGroup>

## Modes de contenu

Chaque destination et chaque client du SDK possède un mode de contenu, qui détermine si les spans incluent les prompts et les réponses du modèle. Définissez-le lorsque vous [ajoutez une destination](https://platform.claude.com/docs/fr/manage-claude/opentelemetry/api#add-a-destination) ou [configurez le SDK](https://platform.claude.com/docs/fr/manage-claude/opentelemetry/sdk#configure-the-sdk).

* **Metadata only** (`metadata_only` dans le SDK) : la valeur par défaut. Les spans incluent les identifiants, la chronologie, le statut, le nombre de tokens et le texte que vous choisissez, comme les noms et descriptions de vos agents et outils et les noms de vos serveurs MCP.
* **Full content** (`content` dans le SDK) : la visibilité la plus complète. Les spans incluent les prompts et les réponses du modèle, ainsi que tout ce que contient Metadata only.

Avec Full content, vous pouvez également voir pourquoi une exécution a échoué ou a été lente, lire des conversations complètes et construire des évaluations à partir de traces réelles. Dans la [référence des spans OpenTelemetry](https://platform.claude.com/docs/fr/api/opentelemetry/spans), les attributs qui contiennent des prompts et des réponses sont marqués <Badge>Contenu</Badge>.

<Info>
  Votre plateforme d'observabilité stocke ce contenu selon ses propres paramètres d'accès et de conservation ; vérifiez donc qu'ils répondent aux exigences de votre organisation.
</Info>

Si votre organisation a une restriction de traitement des données HIPAA, FERPA ou K-12 avec Anthropic, les destinations n'exportent que les métadonnées, quel que soit leur mode de contenu. Les spans du SDK ne sont pas concernés.

Avec la [conservation zéro des données](https://platform.claude.com/docs/fr/manage-claude/api-and-data-retention), vous pouvez toujours utiliser Full content. Pour les requêtes de l'API Messages, l'API conserve le contenu exporté uniquement en mémoire jusqu'à ce qu'elle le transmette à la destination. [Claude Managed Agents](https://platform.claude.com/docs/fr/managed-agents/overview) n'est pas éligible à la conservation zéro des données, et sa conservation des données reste la même lorsque vous utilisez OpenTelemetry.

### Limites de contenu

Avec Full content, chaque span contient par défaut jusqu'à 0,75 Mo de contenu. Cela convient à une fenêtre de contexte de 200k tokens remplie de texte en anglais, tout en restant sous la limite de requête de 1 Mo de nombreuses plateformes d'observabilité et proxys. Si vous choisissez une plateforme partenaire comme **Provider**, la Console définit une limite qu'accepte cette plateforme.

Lorsque le contenu dépasse la limite, le SDK ou l'API le raccourcit et définit `anthropic.content.truncated` sur `true`. Sur les spans de requête, l'invite système et les messages les plus anciens sont supprimés en premier, et sur les spans d'outil, des blocs sont supprimés en partant de la fin du résultat. Les images et les documents n'apparaissent que sous la forme de leur type.

Modifiez la limite dans les cas suivants :

* **Votre plateforme d'observabilité accepte des charges utiles plus volumineuses :** Augmentez ou supprimez la limite pour conserver intégralement les prompts et les réponses longs. Une fenêtre de contexte de 1M tokens entièrement remplie nécessite environ 4 Mo.
* **Votre plateforme d'observabilité ou un proxy placé devant elle rejette les requêtes volumineuses :** Réduisez la limite.

Dans le SDK, définissez `traces.max_content_bytes` (typescript, java, php: `traces.maxContentBytes`; csharp: `Traces.MaxContentBytes`; go: `option.WithOpenTelemetryTracesMaxContentBytes()`). Dans la Console, définissez **Content mode** sur **Full content** lorsque vous [ajoutez une destination](https://platform.claude.com/docs/fr/manage-claude/opentelemetry/api#add-a-destination), puis définissez **Maximum content size in MB** sous **Advanced settings**.

## Exemples de traces et comment les lire

### Une requête à l'API Messages

Sous le span de l'API d'une requête qui [crée un message](https://platform.claude.com/docs/fr/api/messages/create), l'API ajoute un span pour chaque requête au modèle et un span d'outil pour chaque utilisation d'un outil serveur ou d'un outil de connecteur MCP exécutée par l'API.

Dans cet exemple, votre application appelle le [tool runner](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/tool-runner), l'utilitaire du SDK qui exécute vos outils et renvoie leurs résultats à Claude. Chaque requête envoyée par le tool runner possède un span client provenant du SDK et un span serveur provenant de l'API. Les spans apparaissent dans l'ordre suivant :

1. Votre application démarre le span `answer_question` et appelle le tool runner de Messages à l'intérieur de celui-ci (représenté par le span [`anthropic.messages.tool_runner`](https://platform.claude.com/docs/fr/api/opentelemetry/spans#anthropic-messages-tool-runner)).
2. Le tool runner envoie la première requête (représentée par le premier span client [`anthropic.messages.create`](https://platform.claude.com/docs/fr/api/opentelemetry/spans#anthropic-messages-create) et les spans situés sous celui-ci). Dans cette requête, l'API exécute l'outil de recherche web entre deux requêtes au modèle.
3. Dans la seconde requête au modèle, le modèle demande à utiliser l'outil personnalisé `get_weather` ; la première requête se termine donc.
4. Le tool runner exécute `get_weather` (représenté par le span `anthropic.custom_tool_use get_weather`).
5. Le tool runner envoie la seconde requête avec le résultat de l'outil (représentée par le second span client `anthropic.messages.create` et les spans situés sous celui-ci).
6. Dans la seconde requête, le modèle donne la réponse finale.

![Exemple de trace du tool runner de Messages : deux requêtes avec des « client spans » (spans client) et des « server spans » (spans serveur), des « model requests » (requêtes au modèle), web\_search et get\_weather](https://platform.claude.com/docs/images/opentelemetry-sdk-trace-shape.svg)

Le SDK de votre application émet le span [`anthropic.messages.tool_runner`](https://platform.claude.com/docs/fr/api/opentelemetry/spans#anthropic-messages-tool-runner), le span [`anthropic.custom_tool_use`](https://platform.claude.com/docs/fr/api/opentelemetry/spans#anthropic-tool-use-anthropic-mcp-tool-use-and-anthropic-custom-tool-use) et le span client de chaque requête. Pour obtenir ces spans, [configurez le traçage du SDK](https://platform.claude.com/docs/fr/manage-claude/opentelemetry/sdk).

Chaque requête porte son utilisation de tokens sur plusieurs de ses spans. Pour compter chaque token une seule fois, consultez [Comptage des tokens](https://platform.claude.com/docs/fr/manage-claude/opentelemetry#count-tokens).

Avec [Full content](https://platform.claude.com/docs/fr/manage-claude/opentelemetry#choose-a-content-mode), le span serveur `anthropic.messages.create` contient le prompt et la réponse. L'invite système se trouve dans `gen_ai.system_instructions`, les messages de la requête dans `gen_ai.input.messages` et la réponse dans `gen_ai.output.messages`.

Pour chaque span et ses attributs, consultez la [référence des spans OpenTelemetry](https://platform.claude.com/docs/fr/api/opentelemetry/spans).

### Une session Managed Agents

Une session comporte un span pour chaque requête de l'API Sessions et un span de tour pour chaque tour de l'agent. Un tour démarré par une requête est un enfant du span de cette requête. Un tour contient un span pour chaque requête au modèle et pour chaque outil que l'API exécute, sauf dans les [cas répertoriés dans la référence des spans d'outils](https://platform.claude.com/docs/fr/api/opentelemetry/spans#anthropic-tool-use-anthropic-mcp-tool-use-and-anthropic-custom-tool-use). Il contient également un span pour chaque évaluation de résultat.

Cet exemple suit une requête de chat, dans laquelle votre application envoie un message à une session et exécute un outil personnalisé. La trace comporte des spans provenant à la fois de votre application et de l'API, dans l'ordre suivant :

1. Votre application reçoit une requête `POST /chat` d'un utilisateur.
2. Votre application démarre le session tool runner du SDK, qui liste et diffuse en streaming les événements de la session (représentés par les spans `anthropic.sessions.events.stream` et `anthropic.sessions.events.list`).
3. Votre application envoie le message de l'utilisateur à la session en appelant `sessions.events.send`.
4. Un tour démarre et comprend des requêtes au modèle, une utilisation de l'outil `bash` et un tour sur un autre thread (représentés par le premier span `anthropic.session.turn` et les spans situés en dessous).
5. Le modèle demande à utiliser l'[outil personnalisé](https://platform.claude.com/docs/fr/managed-agents/tools) `list_issues`, de sorte que le tour se termine avec la raison d'arrêt `requires_action`.
6. Le session tool runner exécute `list_issues` (représenté par le span `anthropic.custom_tool_use list_issues`) et envoie son résultat en appelant `sessions.events.send`.
7. Un second tour démarre avec le résultat de l'outil (représenté par le dernier span `anthropic.session.turn`).

![Exemple de trace d'une session Managed Agents : votre span POST /chat, les requêtes « event stream » (flux d'événements) et « event list » (liste d'événements) du tool runner de session, les « client spans » (spans client) et « server spans » (spans serveur) pour la requête qui envoie le message de l'utilisateur, un « turn » (tour) avec des requêtes au modèle, une utilisation de l'outil bash et un tour sur un autre thread, le runner exécutant list\_issues, les spans client et serveur pour la requête qui envoie le résultat de l'outil, et un deuxième tour.](https://platform.claude.com/docs/images/opentelemetry-trace-shape.svg)

Le SDK de votre application émet le span [`anthropic.custom_tool_use`](https://platform.claude.com/docs/fr/api/opentelemetry/spans#anthropic-tool-use-anthropic-mcp-tool-use-and-anthropic-custom-tool-use) et le span client de chaque requête. Pour obtenir ces spans, [configurez le traçage du SDK](https://platform.claude.com/docs/fr/manage-claude/opentelemetry/sdk).

Les spans d'une session peuvent se trouver dans plusieurs traces, par exemple lorsque vous envoyez une requête ultérieure depuis une nouvelle trace racine. Avec le mode [multiagent](https://platform.claude.com/docs/fr/managed-agents/multiagent-orchestration) activé, une session peut également comporter plusieurs threads. Pour trouver les spans dont vous avez besoin, regroupez-les par un ID.

* **Un seul thread :** regroupez les spans par `gen_ai.conversation.id`, qui contient l'ID du thread de la session. Triez-les par heure de début pour lire le thread comme une transcription.
* **Une session entière, avec tous ses threads :** regroupez les spans par `anthropic.session.id`, à travers les traces.

Avec [Contenu complet](https://platform.claude.com/docs/fr/manage-claude/opentelemetry#choose-a-content-mode), vous pouvez lire le contenu d'une session à partir de ses spans.

* Pour lire le contenu d'un tour, utilisez son [span de tour](https://platform.claude.com/docs/fr/api/opentelemetry/spans#anthropic-session-turn). L'invite système se trouve dans `gen_ai.system_instructions` sur le premier span de tour d'un thread, l'entrée dans `gen_ai.input.messages` (vos messages et résultats d'outils, les événements `system.message` et les messages provenant d'autres threads), et la sortie dans `gen_ai.output.messages` (les messages de l'agent, les utilisations d'outils et les résultats d'outils).
* Pour voir les arguments et le résultat d'une utilisation d'outil, lisez son [span d'outil](https://platform.claude.com/docs/fr/api/opentelemetry/spans#anthropic-tool-use-anthropic-mcp-tool-use-and-anthropic-custom-tool-use). Les arguments se trouvent dans `gen_ai.tool.call.arguments`, et le résultat dans `anthropic.tool_result.content`.

Pour chaque span et ses attributs, consultez la [référence des spans OpenTelemetry](https://platform.claude.com/docs/fr/api/opentelemetry/spans).

## Comptage des tokens

Pour compter chaque token une seule fois, additionnez les spans d'une seule source pour chaque requête. Lorsqu'une requête de l'API Messages comporte à la fois un span du SDK et un span de l'API, additionnez ses spans de l'API. Les deux sont nommés `anthropic.messages.create` ; distinguez-les donc par leur type : le span du SDK est `CLIENT` et son enfant, le span de l'API, est `SERVER`.

Pour chaque source, additionnez uniquement les spans suivants, car certains attributs d'utilisation se répètent sur plus d'un niveau des spans de l'API :

* **Spans du SDK :** additionnez les spans [`anthropic.messages.create`](https://platform.claude.com/docs/fr/api/opentelemetry/spans#anthropic-messages-create). Si une requête comporte des [compactions](https://platform.claude.com/docs/fr/build-with-claude/compaction), ajoutez également les attributs `anthropic.usage.compaction.input_tokens` et `anthropic.usage.compaction.output_tokens` du span, car les attributs `gen_ai.usage.*` n'incluent pas les tokens de compaction. Si un [modèle de repli](https://platform.claude.com/docs/fr/build-with-claude/refusals-and-fallback) a traité une requête, son span contient l'utilisation du seul modèle qui a fourni la réponse.
* **Spans de l'API d'une requête de l'API Messages :** additionnez soit les spans [`anthropic.messages.create`](https://platform.claude.com/docs/fr/api/opentelemetry/spans#anthropic-messages-create), soit leurs spans [`anthropic.model_request`](https://platform.claude.com/docs/fr/api/opentelemetry/spans#anthropic-model-request), mais pas les deux. Si une requête comporte des compactions, ajoutez également ses spans [`anthropic.compaction`](https://platform.claude.com/docs/fr/api/opentelemetry/spans#anthropic-compaction). N'ajoutez pas en plus les attributs `anthropic.usage.compaction.*` du span `anthropic.messages.create`, car ils contiennent les mêmes tokens.
* **Spans de l'API d'une session Managed Agents :** additionnez les spans `anthropic.model_request` et [`anthropic.session.outcome_evaluation`](https://platform.claude.com/docs/fr/api/opentelemetry/spans#anthropic-session-outcome-evaluation).

Les spans peuvent arriver plus d'une fois, par exemple lorsqu'une livraison est relancée. Si votre plateforme d'observabilité ne supprime pas les doublons, comptez chaque span une seule fois à l'aide de son ID de trace et de son ID de span.

`gen_ai.usage.input_tokens` inclut déjà les tokens lus depuis le cache de prompts et écrits dans celui-ci ; n'y ajoutez donc pas les attributs de cache. Pour tous les attributs d'utilisation, consultez [Utilisation des tokens](https://platform.claude.com/docs/fr/api/opentelemetry/spans#token-usage).

<Note>
  Il n'est pas garanti que les spans exportés constituent un enregistrement complet de votre utilisation de l'API. Leur livraison est assurée [au mieux](https://platform.claude.com/docs/fr/manage-claude/opentelemetry/api#delivery-and-health) ; un span peut donc être perdu. Un appelant peut aussi exclure les spans d'une requête en désactivant l'indicateur d'échantillonnage dans l'[en-tête `traceparent`](https://platform.claude.com/docs/fr/manage-claude/opentelemetry/api#connect-api-spans-to-your-own-traces) de la requête. Pour suivre l'utilisation de chaque clé API, par exemple pour repérer une clé divulguée, utilisez l'[API Usage](https://platform.claude.com/docs/fr/manage-claude/usage-cost-api#usage-api), qui comptabilise aussi l'utilisation des requêtes sans spans.
</Note>