Anthropic adaugă exportul urmelor OpenTelemetry pe Claude Platform

Anthropic a adăugat exportul urmelor OpenTelemetry pe Claude Platform, anunțând pe 14 octombrie 2026 că dezvoltatorii pot trimite acum urme din agenții gestionați Claude, din Messages API și din Claude SDK-uri către orice instrument de observabilitate care acceptă standardul. Funcția este disponibilă în versiune beta publică.

În anunțul Anthropic, compania a precizat că adăugarea unei destinații în Claude Console trimite fiecare tură a agentului, apelul fiecărui model și utilizarea fiecărui instrument către instrumentul de observabilitate al utilizatorului, sub forma unei urme OpenTelemetry standard care include latența, numărul de tokenuri și ID-uri. Managed Agents și Messages API necesită configurarea acelei destinații în Console, în timp ce Claude SDK-urile exportă automat urmele. Dezvoltatorii care trimit deja urme din Claude Code sau Cowork către un instrument de observabilitate pot vedea în același loc și agenții creați pe Claude Platform.

Anthropic a precizat că urmele Claude respectă convențiile semantice OpenTelemetry GenAI, astfel încât datele din Claude și de la alți furnizori funcționează în aceleași instrumente și tablouri de bord. Urmele sunt compatibile și cu orice instrument OpenTelemetry care acceptă un punct final OTLP standard.

Două modalități de configurare și un singur model de urmărire

Documentația Claude Platform definește o urmă ca înregistrarea completă a unei cereri care traversează un sistem și un span ca o etapă a unei urme, cum ar fi o solicitare către un model sau utilizarea unui instrument. Sunt descrise două modalități de configurare. Urmărirea prin SDK se configurează în cod prin instalarea SDK-ului și înregistrarea unui furnizor de urmăritori și nu necesită permisiuni speciale. Urmărirea prin API se configurează prin adăugarea unei destinații în Claude Console și necesită permisiunea de administrator.

Cele două modalități oferă niveluri diferite de acoperire. Urmărirea prin API captează fiecare execuție a unui model dintr-o cerere, turele Managed Agents și instrumentele de pe server executate de API. Urmărirea prin SDK include și instrumentele client executate de componenta care rulează instrumentele, instrumentele dintr-un mediu sandbox găzduit de utilizator și alte cereri API, cum ar fi încărcările de fișiere. Configurarea ambelor modalități reunește span-urile SDK și API ale unei cereri într-o singură urmă; însă, pentru cererile către Claude Platform pe AWS, span-urile API apar în urme separate.

În cazul Managed Agents, o sesiune generează câte un span pentru fiecare cerere către Sessions API și câte un span de tură pentru fiecare tură a agentului; fiecare tură conține span-uri pentru fiecare solicitare către un model, fiecare instrument executat de API și fiecare evaluare a rezultatului. Documentația îi îndrumă pe utilizatorii Claude Code, Agent SDK și Cowork către documentația separată de monitorizare și observabilitate pentru aceste produse.

Moduri de conținut, limite și comportamentul privind conformitatea

Fiecare destinație și fiecare client SDK are un mod de conținut care stabilește dacă span-urile includ solicitările trimise modelelor și răspunsurile acestora. Modul implicit, „Numai metadate”, înregistrează identificatori, durate, stări, numărul de tokenuri și textul ales de utilizator, cum ar fi numele și descrierile agenților și instrumentelor, precum și numele serverelor MCP. Modul „Conținut complet” include și solicitările trimise modelelor și răspunsurile acestora.

În modul „Conținut complet”, fiecare span poate conține implicit până la 0,75 MB de conținut. Potrivit documentației, această cantitate încape într-o fereastră de context de 200k de tokenuri de text în limba engleză și se încadrează sub limita de 1 MB pentru cereri impusă de multe platforme și servere proxy de observabilitate; o fereastră de context completă de 1M de tokenuri necesită aproximativ 4 MB. Când conținutul depășește limita, SDK-ul sau API-ul îl trunchiază și setează atributul anthropic.content.truncated la true. În span-urile cererilor sunt eliminate mai întâi solicitarea de sistem și cele mai vechi mesaje, iar imaginile și documentele sunt reprezentate doar prin tipul lor.

Pentru organizațiile care au convenit cu Anthropic asupra unor restricții privind gestionarea datelor în temeiul HIPAA, FERPA sau K-12, destinațiile exportă numai metadate, indiferent de modul de conținut configurat, însă span-urile SDK nu sunt afectate. În condițiile păstrării zero a datelor, modul „Conținut complet” rămâne utilizabil, deoarece API-ul păstrează conținutul exportat doar în memorie până când îl livrează la destinație. Claude Managed Agents nu este eligibil pentru păstrarea zero a datelor, iar condițiile de păstrare a datelor aferente nu se modifică atunci când se utilizează OpenTelemetry.

Pentru calcularea numărului de tokenuri, documentația le recomandă utilizatorilor să numere fiecare token o singură dată, însumând span-urile provenite dintr-o singură sursă pentru fiecare cerere. Dacă o cerere are atât span-uri SDK, cât și span-uri API, trebuie folosite cele API. De asemenea, documentația menționează că span-urile pot fi primite de mai multe ori atunci când o livrare este reîncercată.

Integrări menționate și declarații ale primilor clienți

Anunțul grupează platformele de observabilitate acceptate în funcție de cazurile de utilizare. Pentru depanarea agenților împreună cu restul stivei software, sunt menționate Grafana Cloud, Honeycomb, Sentry și Splunk. Acolo, urmele agenților apar alături de jurnale și indicatori, astfel încât dezvoltatorii să poată vedea de la ce serviciu provine o etapă lentă sau eșuată. Pentru îmbunătățirea agenților cu ajutorul datelor din mediul de producție, sunt menționate Arize AI, Braintrust, Datadog, Langfuse, LangSmith de la LangChain, New Relic și PostHog, cu exemple de utilizare precum transformarea urmelor reale în evaluări și detectarea problemelor de calitate. Pentru urmărirea utilizării la nivelul unei organizații, este menționat Databricks Unity Gateway, unde echipele de platformă și securitate pot vedea utilizarea tokenurilor în funcție de echipă și pot semnala activitatea neobișnuită.

Mai mulți clienți care au adoptat tehnologia în faza timpurie și-au descris implementările în anunț. Roman Shtylman, cofondator și director de tehnologie al Foxglove, a spus că firma creează agenți care ajută echipele de robotică să-și depaneze roboții. El a adăugat că exportul OpenTelemetry nativ din Claude Platform îi permite companiei să analizeze interacțiunile agenților în PostHog, alături de datele privind utilizarea produsului, pentru a evalua performanța agenților în practică și a stabili ce îmbunătățiri să prioritizeze pentru echipele de robotică.

David Traina, inginer software senior la Ramp, a declarat că firma a construit Reflect, un sistem bazat pe agenți care evaluează urmele Langfuse, identifică defecțiunile recurente și propune soluții. „În cazul unor agenți, am redus deja cu 10–20% numărul de tokenuri utilizate și am făcut sesiunile cu 30% mai rapide”, a spus Traina, adăugând că exportul nativ OpenTelemetry din Claude API poate trimite datele de instrumentare direct în acest proces de optimizare, fără pași suplimentari.

Hyon Lee, director tehnic la Sterling Labs, a declarat că exportul nativ transmite fiecare urmă către Langfuse, fără instrumentare personalizată pentru agenții firmei care analizează piețele în timp real. Ankush Sharma, responsabilul de infrastructură de la FloQast, a spus că agenții companiei de software de contabilitate rulează pe Claude Platform, iar datele de telemetrie sunt în Grafana Cloud. Astfel, fiecare apel către un model apare în aceeași urmă cu fluxul de lucru de reconciliere sau de înregistrare contabilă în care a fost efectuat, ceea ce permite companiei să răspundă la întrebările auditorilor despre acțiunile unui agent consultând o singură cronologie.