Trace e sessioni

Guarda un’esecuzione di un agente come una timeline e un’intera conversazione come una sessione: quali chiamate sono andate in parallelo, dove è finito il tempo, cosa è fallito e quanto è costato.

Nella barra laterale della console (appare quando la funzionalità si applica al tuo account): Traces Apri ↗

Passaggi

Invia X-Trace-Id su ogni chiamata di un’esecuzione (una richiesta utente, un task di un agente), X-Span-Id per dare un nome a ogni chiamata e X-Session-Id su ogni chiamata di una conversazione. Gli strumenti che inviano i propri header di trace o di sessione, come Claude Code, vengono raggruppati senza modifiche.
Apri Trace. Trace e sessioni degli ultimi 7 giorni sono elencate con chiamate, durata e costo, la richiesta più recente per prima; seleziona l'intestazione di una colonna per ordinare l'elenco. Rinomina, nella pagina di una trace o di una sessione, le dà un nome che vede tutto il workspace. La ricerca accetta un ID completo o qualsiasi parte di un nome.
Apri una trace per vederne la cascata: una barra per chiamata, collocata nel tempo, e i tratti in cui girava il tuo codice indicati come la tua app. Le chiamate in parallelo si sovrappongono. Una chiamata fallita è tratteggiata e mostra il suo codice di stato; seleziona una chiamata per vederne latenza, token e costo.
Apri una sessione per vederne totali, modelli, errori per codice di stato e chiamate nel tempo. Vedi le chiamate nei Log elenca ogni richiesta della sessione.

Limiti e insidie

Trace e sessioni sono costruite dal tuo log delle richieste, quindi coprono gli stessi 90 giorni e le stesse chiamate.
Una chiamata fallita mostra il codice di stato ricevuto dal tuo codice, compreso un errore restituito dal provider.
Gli ID li decidi tu: fino a 128 caratteri ASCII stampabili ciascuno. Tornano nella risposta e non vengono mai inviati al provider.
Quando un agente di coding identifica i suoi sub-agenti, una sessione elenca i suoi agenti con le chiamate e il costo di ciascuno, e una traccia segnala le compattazioni e le chiamate secondarie e nomina gli strumenti eseguiti tra due chiamate.
Una richiesta che il gateway ha dovuto tentare più volte elenca i tentativi nel dettaglio: il modello, lo stato e la durata di ciascuno. Nella cascata, i tentativi falliti sono l’inizio tratteggiato della sua barra.

Riferimento API per la stessa funzionalità: Header di richiesta