Le 14 octobre 2026, ClaudeDevs a annoncé la bêta publique de l’export de traces OpenTelemetry pour Claude Platform : elle couvre les requêtes de Claude Messages API, les sessions Claude Managed Agents et l’activité des SDK. Anthropic distingue deux parcours : instrumenter l’application avec un SDK ou configurer l’export des traces API dans Console. Sa documentation présente la fonction comme une bêta soumise à l’accord client.
Une trace OpenTelemetry relie des « spans », c’est-à-dire des événements et des durées associés à une requête ou à une opération. Pour choisir le bon parcours, demandez-vous où se trouve l’activité que vous voulez observer : dans votre application, ou dans les services de Claude Platform.
Ce que chaque parcours permet de voir
Le traçage par SDK produit des spans dans l’application et s’appuie sur son propre exporteur OpenTelemetry. Il peut notamment couvrir les outils exécutés par le lanceur de l’application. Le traçage API, configuré dans Console, ajoute des spans du côté de Claude Platform : requêtes individuelles aux modèles, outils exécutés par l’API et tours de Claude Managed Agents. Les deux parcours peuvent être combinés ; avec la propagation du contexte de trace, leurs spans peuvent se retrouver dans une même trace pour les requêtes prises en charge. Anthropic décrit ces périmètres et leur combinaison.
| Critère | Traçage par SDK | Traçage API dans Console |
| Configuration | Dans l’application : enregistrer un provider de traçage et configurer un exporteur. | Ajouter une destination d’observabilité dans Claude Console. |
| Autorisation Console | Aucune autorisation particulière dans Console n’est requise pour ce parcours. | Un administrateur de l’organisation doit ajouter ou modifier les destinations. |
| Activité côté application | Les spans côté client et les outils exécutés par le lanceur de l’application. | Pas les outils côté client à lui seul. |
| Activité côté Claude Platform | Pas les exécutions individuelles des modèles ni les outils serveur à lui seul. | Les requêtes, les exécutions de modèles, les outils serveur et les tours de Claude Managed Agents. |
En pratique, le SDK convient si vous cherchez à suivre le déroulement dans votre propre application ; la destination Console ajoute la visibilité sur l’activité côté plateforme. Si vous avez besoin des deux perspectives, vous pouvez les combiner, en tenant compte des exceptions de propagation de contexte décrites pour certaines plateformes.
SDK : enregistrer le provider avant le premier appel
Pour que les premiers appels apparaissent dans les traces, le provider OpenTelemetry doit être enregistré avant la première requête que vous souhaitez suivre. Cette configuration se fait dans l’application ; les appels API gardent leur forme habituelle. Le guide SDK d’Anthropic précise l’ordre de configuration et le comportement du streaming.
Avec une réponse en streaming, le span se termine lorsque l’application a lu ou fermé le flux. En mode Full content, les données de réponse sont incluses si le flux est lu avec messages.stream(). Autrement dit, un flux laissé ouvert ou dont le contenu n’est pas lu comme prévu peut influer sur ce que contient le span.
Métadonnées par défaut, prompts et réponses en option
Le mode par défaut exporte les métadonnées seules. Le mode Full content peut aussi inclure les prompts et les réponses : les traces peuvent alors contenir des données que votre application envoie à Claude et reçoit en retour. Une fois les données livrées, le fournisseur d’observabilité choisi applique ses propres règles d’accès et de conservation. Anthropic détaille les modes de contenu et leurs limites.
En mode Full content, la limite par défaut est de 0,75 Mo par span. Si le contenu dépasse la limite configurée, il est tronqué et le span reçoit l’attribut anthropic.content.truncated=true. Pour les spans de requête, le prompt système et les messages les plus anciens sont supprimés en premier ; pour les spans d’outils, la troncature retire des blocs à la fin du résultat. Les images et les documents sont représentés par leur type.
Anthropic estime qu’un contexte d’un million de tokens occupe environ 4 Mo. En outre, pour les organisations soumises auprès d’Anthropic à des restrictions de traitement des données HIPAA, FERPA ou K‑12, les destinations Console exportent uniquement des métadonnées, quel que soit le mode configuré ; cette restriction ne s’applique pas aux spans SDK. Avec la conservation zéro des données, le mode Full content reste possible pour le traçage de Claude Messages API : Anthropic garde alors le contenu exporté en mémoire jusqu’à sa livraison. Claude Managed Agents n’est pas éligible à cette conservation zéro, et son régime de conservation ne change pas avec OpenTelemetry.
Destination Console : format, chemin et limites
Une destination API doit accepter le protocole OTLP/HTTP protobuf à une adresse HTTPS sur le port 443. Anthropic ajoute /v1/traces à l’adresse de base, sauf si une adresse distincte pour les traces est configurée. Une destination peut couvrir jusqu’à 1 000 espaces de travail ; une organisation peut configurer jusqu’à 10 destinations et 20 en-têtes de requête par destination. Le guide API d’Anthropic précise le format, les limites et les délais de livraison.
Les délais sont distincts : la négociation TLS doit s’achever en cinq secondes au plus, les en-têtes de réponse doivent arriver dans les cinq secondes, et chaque livraison expire au bout de dix secondes au total. Une destination est désactivée si toutes les livraisons échouent pendant 24 heures.
Les traces ne remplacent pas le suivi d’utilisation
Anthropic décrit la livraison comme « best effort » et « at least once » : certains spans peuvent être perdus ou dupliqués. Les identifiants de trace et de span permettent de repérer les doublons, mais pas de récupérer les spans perdus. Pour suivre l’utilisation des clés API, Anthropic recommande l’Usage API plutôt que l’export de traces.
Cette bêta concerne Claude Platform et ses requêtes API, agents gérés et SDK. Anthropic documente séparément la télémétrie de Claude Code ; l’annonce de Claude Platform ne décrit pas un changement direct de cette télémétrie. La documentation de suivi de Claude Code est distincte.
