For AI agents: the public content index is available at https://we0.ai/llms.txt, and the English article bundle is available at https://we0.ai/llms-full.txt.
For AI agents: the public content index is available at https://we0.ai/llms.txt, and the English article bundle is available at https://we0.ai/llms-full.txt.
For AI agents: the complete content index is available at https://we0.ai/llms.txt, the full English article bundle is available at https://we0.ai/llms-full.txt, and this page is available as Markdown at https://we0.ai/fr/articles/claude-opentelemetry-tracing-api-and-sdk-4adbbb12.md.
Anthropic a introduit l’export de traces OpenTelemetry pour les agents gérés Claude, l’API Messages et les SDK Claude. Annoncée le 14 octobr...
Anthropic a introduit l’export de traces OpenTelemetry pour les agents gérés Claude, l’API Messages et les SDK Claude. Annoncée le 14 octobre 2026, cette fonctionnalité est en bêta publique et envoie des données de traçage standard vers les plateformes d’observabilité qui acceptent OTLP.
L’objectif est concret : suivre les appels de modèles et l’activité des outils d’un agent parallèlement à l’application qui l’a appelé. Au lieu d’enquêter séparément sur la latence, les échecs et l’utilisation de jetons, une équipe peut examiner les spans pertinents dans son système d’observabilité existant.
Une trace enregistre le parcours d’une requête dans un système. Un span enregistre une opération au sein de ce parcours, comme un appel de modèle ou l’exécution d’un outil. Les spans de Claude suivent les conventions sémantiques GenAI d’OpenTelemetry, ce qui aide les outils compatibles à interpréter les données entre plusieurs fournisseurs de modèles.
Source : Anthropic. Le diagramme illustre la structure des traces et les flux de travail d’analyse, et non des résultats de performance mesurés.
Il existe deux moyens complémentaires de collecter ces données :
| Fonctionnalité | Traçage SDK | Traçage API |
|---|---|---|
| Configuration | Code de l’application et fournisseur de traceur | Destination dans la Console Claude |
| Autorisation Claude particulière | Aucune | Rôle d’administrateur nécessaire pour ajouter ou modifier des destinations |
| Exécutions de modèles à l’intérieur d’une requête | Non exposées individuellement par le seul traçage SDK | Incluses |
| Tours des agents gérés | Non exposés par le seul traçage SDK | Inclus |
| Outils exécutés par l’API | Non exposés par le seul traçage SDK | Inclus |
| Outils client exécutés par l’exécuteur d’outils du SDK | Inclus | Non capturés par le seul traçage API |
| Outils dans un bac à sable auto-hébergé | Inclus via le worker SDK pris en charge | Non capturés par le seul traçage API |
| Autres opérations API côté client, telles que les téléversements de fichiers | Incluses | Non capturées par le seul traçage API |
Les deux parcours enregistrent les spans de requête et l’utilisation de jetons. Ensemble, ils apportent une visibilité sur le travail côté client ainsi que sur le travail effectué dans l’API Claude. L’envoi des deux flux vers le même backend permet aussi à ce dernier d’afficher leur relation.
Le traçage API ne nécessite pas de modifier le code des requêtes ordinaires pour recevoir des traces API autonomes. Un administrateur ajoute une destination indiquant l’emplacement vers lequel Claude doit les envoyer.
anthropic.test est reçu.service.name = claude-platform.Pour une destination personnalisée, l’exigence documentée est un point de terminaison OTLP/HTTP acceptant Protobuf sur un nom d’hôte HTTPS au port 443. Un Collector qui écoute uniquement sur son port habituel 4318 nécessite une exposition HTTPS adaptée ou un proxy inverse. Les identifiants doivent être placés dans les valeurs d’en-tête.
Le point de terminaison de base omet normalement /v1/traces, car Claude l’ajoute. Un point de terminaison de traces avancé peut remplacer ce chemin, mais doit utiliser le même hôte. Les points de terminaison d’adresses privées et les redirections ne sont pas pris en charge comme destinations de livraison ordinaires.
Le traçage SDK commence par l’installation d’un SDK Claude actuellement pris en charge et par l’enregistrement d’un fournisseur de traceur OpenTelemetry avant le premier appel à tracer. L’application fournit l’exportateur qui transmet les spans au backend d’observabilité. Ainsi, l’« export SDK automatique » ne signifie pas qu’une nouvelle application envoie des données quelque part sans fournisseur de traceur ni exportateur de destination.
Un exportateur de console peut aider à vérifier l’instrumentation locale avant la connexion à une plateforme distante. Une fois configuré, le SDK émet des spans de requête et des spans pour les outils exécutés via son exécuteur d’outils. Les appels effectués à l’intérieur d’un span d’application peuvent être imbriqués sous ce span.
Pendant la bêta, les options SDK, les noms de spans et les attributs peuvent évoluer. Anthropic recommande d’épingler la version du SDK afin que les équipes puissent choisir quand adopter ces changements.
Le SDK propage le contexte de trace afin que les spans serveur de l’API puissent apparaître sous les spans client du SDK. Les requêtes vers Claude Platform on AWS constituent une exception : leurs spans API apparaissent dans leurs propres traces, car cette plateforme ne prend pas encore en charge le même comportement de jonction par contexte de trace.
Les sessions des agents gérés exposent les spans de requête de l’API Sessions, les spans de tours d’agent, les requêtes de modèle, les outils exécutés par l’API et les évaluations de résultat. Une session peut s’étendre sur plusieurs traces et, avec un fonctionnement multiagent, sur plusieurs fils d’exécution. La documentation recommande de regrouper par anthropic.session.id pour une session ou par gen_ai.conversation.id pour un fil.
Claude Code, le SDK Agent et Cowork disposent de leur propre documentation de supervision. Cette nouvelle fonctionnalité de plateforme ne doit pas être considérée comme un remplacement de toutes les instructions d’instrumentation existantes de chaque produit.
Chaque destination de la Console et chaque client SDK disposent d’un mode de contenu. Le mode par défaut, Metadata only, inclut les identifiants, les données temporelles, les statuts, les volumes de jetons et certains textes descriptifs, tels que les noms d’outils, les descriptions d’outils et les noms de serveurs MCP. Il exclut les prompts et les réponses des modèles, mais ne garantit pas que chaque champ exporté soit dépourvu de texte fourni par l’application.
Le mode Full content inclut également les prompts et les réponses. Il est donc utile pour déboguer les interactions en échec et créer des évaluations à partir du trafic réel, mais il transfère le contenu des conversations vers un système distinct, doté de ses propres paramètres d’accès et de conservation.
La limite de contenu par défaut est de 0,75 Mo par span. Anthropic indique que cette limite couvre approximativement un contexte anglais de 200 000 jetons et reste sous la limite de requête de 1 Mo utilisée par de nombreux services d’observabilité et proxys. Un contexte complet d’un million de jetons peut nécessiter environ 4 Mo ; la limite par défaut ne suffit donc pas à conserver intégralement chaque prompt de grande taille.
Lorsqu’un span dépasse sa limite de contenu, le SDK ou l’API le raccourcit et définit anthropic.content.truncated sur true. Les spans de requête éliminent d’abord le prompt système et les messages les plus anciens ; les spans d’outils éliminent les blocs à partir de la fin du résultat de l’outil. Les images et les documents apparaissent par type plutôt que sous la forme de leur charge média complète.
Le SDK utilise traces.max_content_bytes pour contrôler la limite. Les destinations de la Console exposent une taille maximale de contenu dans les paramètres avancés, et les fournisseurs répertoriés peuvent avoir une valeur par défaut propre au fournisseur.
Decrivez votre idee une fois, et We0 AI peut generer un site vitrine, des pages et un CMS, puis vous aider a attirer clients et trafic apres le lancement.
Une génération de projet complète pour une inscription gratuite
Idéal pour essayer un flux de génération complet et voir rapidement une première ébauche de projet.
Les organisations soumises à des restrictions de traitement HIPAA, FERPA ou K–12 avec Anthropic exportent uniquement des métadonnées via les destinations API, quel que soit le mode de contenu sélectionné. La documentation précise que cette restriction ne s’applique pas aux spans SDK ; la configuration SDK nécessite donc toujours un examen distinct.
L’export de contenu complet peut être utilisé avec des requêtes éligibles de l’API Messages à conservation zéro des données, car l’API conserve le contenu à exporter en mémoire jusqu’à sa livraison. Managed Agents n’est pas éligible à la conservation zéro des données, et l’activation d’OpenTelemetry ne modifie pas ses conditions de conservation.
Une même requête peut enregistrer son utilisation de jetons sur plusieurs spans. Additionner tous les spans de la trace peut donc surestimer l’utilisation.
Lorsque des spans SDK et API existent pour une requête de l’API Messages, utilisez la source API. Au sein de cette source, additionnez les spans de requête ou leurs spans de requête de modèle, mais pas les deux ; tenez compte de la compaction selon les règles précises de la documentation. Pour Managed Agents, les spans API pertinents sont les requêtes de modèle et les évaluations de résultat.
Les nouvelles tentatives de livraison peuvent également produire des spans en double. Dédupliquez à l’aide de l’identifiant de trace et de l’identifiant de span si le backend ne le fait pas déjà.
Les traces exportées constituent un enregistrement de débogage, et non un registre de facturation complet garanti. La livraison s’effectue au mieux, et l’échantillonnage peut omettre des requêtes. Anthropic oriente les équipes nécessitant un suivi complet de l’utilisation par clé API vers l’API Usage.
Anthropic cite Grafana Cloud, Honeycomb, Sentry et Splunk pour visualiser les traces d’agents à côté des journaux et métriques d’application. L’entreprise mentionne aussi Arize AI, Braintrust, Datadog, Langfuse, LangSmith, New Relic et PostHog pour les flux de travail reliant les traces aux évaluations et aux améliorations de qualité. Databricks Unity Gateway est mis en avant pour la visibilité à l’échelle de l’organisation.
Ces outils sont des exemples, et non une liste de compatibilité exclusive. D’autres outils peuvent recevoir les données s’ils acceptent l’export OTLP standard requis.
L’annonce comprend des déclarations de clients de Foxglove, Ramp, Sterling Labs et FloQast. Leurs cas d’usage comprennent le débogage de robotique, l’analyse d’agents de marché et le traçage de flux de travail comptables.
Ramp décrit un système interne appelé Reflect, qui évalue les traces Langfuse et propose des corrections. Son ingénieur rapporte une utilisation de jetons inférieure de 10 à 20 % et des sessions 30 % plus rapides pour certains agents. Il s’agit de résultats rapportés par un client dans le cadre de ce flux d’amélioration ; ils ne garantissent pas que l’activation du seul export de traces produise ces gains.
Il envoie des spans standard décrivant les requêtes API Claude, les tours d’agents, les appels de modèles et l’activité des outils pris en charge vers un backend d’observabilité. La fonctionnalité est en bêta publique et prend en charge des parcours distincts de traçage API et SDK.
Vous avez besoin du rôle d’administrateur pour ajouter ou modifier des destinations de traçage API dans la Console Claude. Le traçage SDK se configure dans le code de l’application et ne demande aucune autorisation particulière dans l’organisation Claude.
Non, le mode par défaut est Metadata only. Full content ajoute les prompts et les réponses, sous réserve des limites de contenu et des restrictions documentées pour certaines organisations.
Oui, à condition que la destination API satisfasse aux exigences réseau et de protocole documentées. En particulier, l’export API requiert un récepteur OTLP/HTTP Protobuf accessible via un nom d’hôte HTTPS public au port 443, plutôt qu’un simple écouteur Collector privé.
Oui, lorsque le contexte de trace est propagé et que les spans atteignent le même backend d’observabilité. Les spans API des requêtes vers Claude Platform on AWS apparaissent actuellement dans leurs propres traces.
Non, les traces peuvent être échantillonnées, perdues ou livrées plus d’une fois. Utilisez les règles de comptage documentées pour l’analyse et l’API Usage lorsque vous avez besoin d’une comptabilité complète de l’utilisation.
La bêta OpenTelemetry de Claude connecte les appels de modèles et les outils d’agents aux systèmes de traçage que les équipes utilisent déjà. Le traçage API expose l’activité côté serveur, tandis que le traçage SDK ajoute les opérations et outils côté client ; leur combinaison fournit la chronologie applicative la plus claire lorsque la jonction des traces est prise en charge.
Choisissez délibérément les modes de contenu, vérifiez la troncature et l’état de livraison, puis comptez les jetons à partir d’une source appropriée unique. Le traçage améliore la visibilité, mais la comptabilité complète de l’utilisation et les contrôles de conservation restent des responsabilités distinctes.
Partez d’une phrase et obtenez un site complet en quelques minutes.
