Una nuova era di osservabilità per Claude Platform

Il 14 ottobre 2026 Anthropic ha annunciato l’introduzione dell’esportazione delle tracce OpenTelemetry su Claude Platform, ampliando notevolmente le possibilità di monitoraggio per gli sviluppatori. Grazie a questa integrazione, le Claude Managed Agents, la Messages API e gli SDK Claude possono ora inviare dati di tracciamento a qualsiasi strumento di osservabilità che supporti lo standard OTLP (OpenTelemetry Protocol).

La funzionalità è stata rilasciata in beta pubblica, consentendo agli utenti di testare rapidamente la nuova capacità senza attendere una release completa. Impostare una destinazione di esportazione è semplice: basta configurare una destinazione nella Claude Console e, per gli SDK, includere il provider di tracer nel codice.

Come funziona l’esportazione delle tracce

Due modalità di configurazione

La documentazione di Claude Platform distingue due modalità di configurazione:

    • Tracciamento tramite SDK: si imposta direttamente nel codice installando l’SDK e registrando un provider di tracer. Non richiede autorizzazioni speciali e cattura gli span generati dal client, dagli strumenti in sandbox e da operazioni API come il caricamento di file.
    • Tracciamento tramite API: richiede l’aggiunta di una destinazione in Claude Console, operazione riservata agli amministratori. Registra ogni esecuzione del modello, i turni di Managed Agents e gli strumenti server invocati dall’API.

Quando entrambe le modalità sono attive, gli span SDK e API di una singola richiesta vengono aggregati in un’unica traccia, garantendo una visione completa del flusso di lavoro. Per le richieste eseguite su Claude Platform in AWS, invece, gli span API compaiono in tracce separate.

Definizioni chiave: traccia e span

Secondo la documentazione, una traccia è il resoconto completo di una richiesta che attraversa il sistema, mentre uno span rappresenta una singola fase della traccia, ad esempio una chiamata al modello o l’uso di uno strumento. Questo modello consente di ricostruire in modo dettagliato il percorso di una singola operazione, dall’inizio alla fine.

Gestione dei contenuti e limiti di dimensione

Modalità dei contenuti

Ogni destinazione e ogni client SDK dispone di una modalità dei contenuti che determina quali dati vengono inclusi negli span:

    • Solo metadati (predefinita): registra ID, timestamp, stato, conteggio token e il testo scelto dall’utente, come nomi e descrizioni di agenti e strumenti, nonché nomi dei server MCP.
    • Contenuto completo: aggiunge anche i prompt inviati al modello e le risposte generate.

Con la modalità Contenuto completo, ogni span può contenere fino a 0,75 MB di dati, sufficiente per una finestra di contesto di circa 200.000 token di testo inglese. Se il contenuto supera questo limite, l’S​DK o l’API lo troncano e impostano l’attributo anthropic.content.truncated a true. I dati troncati sono gestiti eliminando prima il prompt di sistema e i messaggi più vecchi; immagini e documenti sono rappresentati solo dal loro tipo.

Conformità e conservazione zero

Per le organizzazioni soggette a normative come HIPAA, FERPA o accordi K‑12, le destinazioni esportano esclusivamente metadati, indipendentemente dalla modalità dei contenuti configurata. Gli span SDK non sono soggetti a questa limitazione. Inoltre, la “conservazione zero” mantiene i contenuti in memoria solo fino all’invio verso la destinazione, garantendo che non vengano memorizzati a lungo termine.

È importante notare che i Claude Managed Agents non beneficiano della conservazione zero e i termini di conservazione rimangono invariati quando si utilizza OpenTelemetry.

Conteggio dei token e gestione dei retry

La documentazione fornisce regole precise per il conteggio dei token: ogni token deve essere contato una sola volta, sommando gli span provenienti da una singola fonte per richiesta. Quando una richiesta contiene sia span SDK sia span API, si devono utilizzare gli span API per il conteggio finale. Inoltre, gli span possono essere inviati più volte in caso di ritentativi, pertanto gli strumenti di osservabilità dovrebbero gestire eventuali duplicati.

Integrazioni supportate e casi d’uso

Piattaforme per il debug e l’analisi

Anthropic ha elencato una serie di piattaforme di osservabilità compatibili, suddivise per scenario d’uso:

    • Debug degli agenti: Grafana Cloud, Honeycomb, Sentry, Splunk. Queste soluzioni permettono di affiancare le tracce degli agenti a log e metriche, facilitando l’identificazione delle fasi lente o fallite.
    • Miglioramento della qualità in produzione: Arize AI, Braintrust, Datadog, Langfuse, LangSmith (by LangChain), New Relic, PostHog. Qui le tracce reali vengono trasformate in valutazioni, consentendo di rilevare problemi di qualità e ottimizzare le prestazioni.
    • Monitoraggio organizzativo: Databricks Unity Gateway, che offre visualizzazioni di consumo token per team, segnalazione di attività anomale e supporto per la governance.

Dichiarazioni dei primi clienti

Diverse aziende hanno già sperimentato la nuova funzionalità:

    • Foxglove (Roman Shtylman, CTO): utilizza gli agenti per il debug dei robot e analizza le interazioni in PostHog, combinando dati di utilizzo del prodotto con le tracce per valutare le prestazioni.
    • Ramp (David Traina, senior software engineer): ha sviluppato Reflect, che assegna punteggi alle tracce su Langfuse, identificando errori ricorrenti e riducendo il consumo token del 10‑20% e le durate delle sessioni del 30%.
    • Sterling Labs (Hyon Lee, CTO): esporta nativamente le tracce a Langfuse, eliminando la necessità di strumentazione personalizzata per gli agenti di analisi di mercato in tempo reale.
    • FloQast (Ankush Sharma, responsabile infrastruttura): ha integrato la telemetria in Grafana Cloud, consentendo di visualizzare le chiamate al modello nella stessa traccia dei flussi di riconciliazione contabile, facilitando la risposta ai revisori.

Implicazioni per gli sviluppatori e il futuro della piattaforma

L’introduzione delle tracce OpenTelemetry su Claude Platform segna un passo fondamentale verso la standardizzazione dell’osservabilità nei sistemi generativi. Grazie all’allineamento con le convenzioni semantiche GenAI di OpenTelemetry, i dati di Claude possono essere aggregati e confrontati con quelli di altri provider LLM senza dover costruire pipeline di conversione complesse. Questo favorisce una più rapida adozione di pratiche DevOps e SRE nel contesto dell’AI, rendendo più semplice rilevare colli di bottiglia, ottimizzare il consumo di token e garantire la conformità normativa.

Inoltre, la dualità di configurazione (SDK vs API) offre flessibilità: le organizzazioni con team di sviluppo autonomi possono instrumentare direttamente il codice, mentre quelle con team di operazioni centralizzate possono gestire le destinazioni a livello di console, mantenendo il controllo degli accessi.

Con la beta pubblica attiva, Anthropic invita gli sviluppatori a sperimentare la funzionalità, condividere feedback e contribuire al miglioramento del modello di traccia. Le prime adozioni già dimostrano vantaggi concreti in termini di riduzione dei costi operativi e di aumento della trasparenza delle decisioni degli agenti.

Conclusioni

L’esportazione delle tracce OpenTelemetry di Anthropic porta Claude Platform a un nuovo livello di maturità, ponendo le basi per un ecosistema di osservabilità interoperabile e conformità avanzata. Le numerose integrazioni con piattaforme di monitoraggio affermate, i controlli granulari sui contenuti e le opzioni di configurazione flessibili rendono questa funzionalità una risorsa preziosa per chiunque utilizzi agenti autonomi o API basate su LLM. Con i primi casi d’uso che mostrano miglioramenti tangibili in efficienza e qualità, la community potrà presto beneficiare di una maggiore visibilità e controllo sui propri carichi di lavoro AI.