Anthropic ajoute l’export de traces OpenTelemetry à la plateforme Claude

Anthropic a ajouté l’export de traces OpenTelemetry à la plateforme Claude et a annoncé, le 14 octobre 2026, que les développeurs peuvent désormais envoyer les traces de Claude Managed Agents, de l’API Messages et des SDK Claude vers n’importe quel outil d’observabilité prenant en charge cette norme. La fonctionnalité est disponible en bêta publique.

Dans son annonce, Anthropic a indiqué que l’ajout d’une destination dans la console Claude envoie chaque tour d’agent, appel de modèle et utilisation d’outil vers l’outil d’observabilité de l’utilisateur sous la forme d’une trace OpenTelemetry standard, contenant la latence, le nombre de jetons et des identifiants. Managed Agents et l’API Messages nécessitent la configuration de cette destination dans la console, tandis que les SDK Claude exportent automatiquement les traces. Les développeurs qui envoient déjà les traces de Claude Code ou de Cowork vers un outil d’observabilité peuvent aussi y voir apparaître les agents conçus sur la plateforme Claude.

Anthropic a indiqué que les traces Claude respectent les conventions sémantiques GenAI d’OpenTelemetry. Les données de Claude et d’autres fournisseurs sont ainsi compatibles avec les mêmes outils et tableaux de bord, et les traces fonctionnent également avec tout outil OpenTelemetry prenant en charge un point de terminaison OTLP standard.

Deux méthodes de configuration et un modèle de trace

La documentation de la plateforme Claude définit une trace comme l’enregistrement complet d’une requête traversant un système, et un span comme une étape de cette trace, par exemple une requête de modèle ou l’utilisation d’un outil. Elle décrit deux méthodes de configuration. Le traçage par SDK se configure dans le code en installant le SDK et en enregistrant un fournisseur de traceurs ; aucune autorisation particulière n’est nécessaire. Le traçage par API se configure en ajoutant une destination dans la console Claude et nécessite une autorisation d’administrateur.

La couverture varie selon la méthode. Le traçage par API capture chaque exécution de modèle au sein d’une requête, les tours de Managed Agents et les outils serveur exécutés par l’API. Le traçage par SDK ajoute les outils client exécutés par le gestionnaire d’outils, les outils dans un environnement isolé hébergé par l’utilisateur, ainsi que d’autres requêtes API, comme les téléversements de fichiers. La configuration des deux méthodes regroupe les spans SDK et API d’une requête dans une seule trace ; pour les requêtes adressées à la plateforme Claude sur AWS, les spans API apparaissent plutôt dans leurs propres traces.

Avec Managed Agents, une session génère un span pour chaque requête à l’API Sessions et un span de tour pour chaque tour d’agent. Chaque tour comprend des spans pour chaque requête de modèle, chaque outil exécuté par l’API et chaque évaluation de résultat. La documentation renvoie les utilisateurs de Claude Code, d’Agent SDK et de Cowork à la documentation distincte sur la surveillance et l’observabilité de ces produits.

Modes de contenu, limites et règles de conformité

Chaque destination et chaque client SDK dispose d’un mode de contenu qui détermine si les spans incluent les invites et les réponses du modèle. Le mode « Métadonnées uniquement », activé par défaut, enregistre les identifiants, la durée, le statut, le nombre de jetons et les textes choisis par l’utilisateur, comme les noms et descriptions des agents et des outils, ainsi que les noms des serveurs MCP. Le mode « Contenu intégral » ajoute les invites et les réponses du modèle.

En mode « Contenu intégral », chaque span peut contenir par défaut jusqu’à 0,75 Mo de données. Selon la documentation, cette limite suffit pour une fenêtre de contexte de 200 000 jetons de texte anglais et reste inférieure à la limite de requête de 1 Mo appliquée par de nombreuses plateformes et de nombreux serveurs mandataires d’observabilité ; une fenêtre de contexte complète de 1 million de jetons nécessite environ 4 Mo. Lorsque le contenu dépasse la limite, le SDK ou l’API le tronque et définit l’attribut anthropic.content.truncated sur true. Dans les spans de requête, l’invite système et les messages les plus anciens sont supprimés en premier ; les images et les documents n’apparaissent que sous la forme de leur type.

Pour les organisations soumises auprès d’Anthropic à des restrictions de traitement des données liées à HIPAA, FERPA ou au secteur K-12, seules les métadonnées sont exportées depuis les destinations, quel que soit le mode de contenu configuré ; les spans SDK ne sont toutefois pas concernés. Avec la conservation nulle des données, le mode « Contenu intégral » reste utilisable, car l’API ne conserve le contenu exporté qu’en mémoire, jusqu’à son envoi à la destination. Claude Managed Agents n’est pas admissible à la conservation nulle des données, et ses conditions de conservation restent inchangées lorsque OpenTelemetry est utilisé.

Pour comptabiliser les jetons, la documentation recommande de compter chaque jeton une seule fois en additionnant les spans provenant d’une seule source par requête et, lorsqu’une requête comporte à la fois des spans SDK et API, d’utiliser ceux de l’API. Elle précise également que des spans peuvent être reçus plusieurs fois lorsqu’une livraison fait l’objet d’une nouvelle tentative.

Intégrations citées et témoignages des premiers clients

L’annonce classe les plateformes d’observabilité prises en charge selon leur usage. Pour déboguer des agents en parallèle du reste d’une pile logicielle, elle cite Grafana Cloud, Honeycomb, Sentry et Splunk : les traces des agents y côtoient les journaux et les métriques, ce qui permet aux développeurs de repérer le service à l’origine d’une étape lente ou ayant échoué. Pour améliorer les agents à partir de données de production, elle cite Arize AI, Braintrust, Datadog, Langfuse, LangSmith by LangChain, New Relic et PostHog, et évoque notamment la conversion de traces réelles en évaluations et la détection de problèmes de qualité. Pour suivre l’utilisation à l’échelle d’une organisation, elle cite Databricks Unity Gateway, qui permet aux équipes chargées de la plateforme et de la sécurité de consulter l’utilisation des jetons par équipe et de repérer les activités inhabituelles.

Plusieurs des premiers clients ont décrit leurs déploiements dans l’annonce. Roman Shtylman, cofondateur et directeur technique de Foxglove, a indiqué que l’entreprise crée des agents qui aident les équipes de robotique à déboguer leurs robots. Il a ajouté que l’export OpenTelemetry natif de la plateforme Claude lui permet d’analyser dans PostHog les interactions avec les agents, en parallèle des données d’utilisation du produit, afin d’évaluer les performances des agents en conditions réelles et de hiérarchiser les améliorations destinées aux équipes de robotique.

L’ingénieur logiciel senior de Ramp, David Traina, a déclaré que l’entreprise avait créé Reflect, un système agentique qui évalue les traces Langfuse, repère les défaillances récurrentes et propose des correctifs. « Pour certains agents, nous avons déjà réduit de 10 à 20 % la consommation de jetons et accéléré les sessions de 30 % », a déclaré Traina, ajoutant que l’export natif d’OpenTelemetry depuis Claude API peut alimenter directement cette boucle d’amélioration avec les données d’instrumentation, sans étape supplémentaire.

Le directeur technique de Sterling Labs, Hyon Lee, a déclaré que l’export natif transmet chaque trace à Langfuse, sans instrumentation personnalisée, pour les agents de l’entreprise qui analysent les marchés en temps réel. Le responsable de l’infrastructure de FloQast, Ankush Sharma, a déclaré que les agents de l’éditeur de logiciels comptables fonctionnent sur Claude Platform, avec la télémétrie dans Grafana Cloud. Chaque appel de modèle figure ainsi dans la même trace que le flux de travail de rapprochement ou d’écriture comptable dans lequel il s’inscrit, ce qui permet à l’entreprise de répondre aux questions des auditeurs sur les actions d’un agent à partir d’une seule chronologie.