Traces e sessões

Veja uma execução de agente como uma linha do tempo e uma conversa inteira como uma sessão: quais chamadas rodaram em paralelo, onde o tempo foi gasto, o que falhou e quanto custou.

Na barra lateral do console (aparece quando o recurso se aplica à sua conta): Traces Abrir ↗

Passos

1. Envie X-Trace-Id em cada chamada de uma execução (uma requisição de usuário, uma tarefa de agente), X-Span-Id para nomear cada chamada e X-Session-Id em cada chamada de uma conversa. Ferramentas que enviam seus próprios cabeçalhos de trace ou sessão, como o Claude Code, são agrupadas sem mudanças.
2. Abra Traces. Os traces e as sessões dos últimos 7 dias aparecem com chamadas, duração e custo, a requisição mais recente primeiro; clique no cabeçalho de uma coluna para ordenar a lista. Renomear, na página de um trace ou de uma sessão, dá a ele um nome que todo o workspace vê. A busca aceita um ID completo ou qualquer trecho de um nome.
3. Abra um trace para ver a cascata: uma barra por chamada, posicionada no tempo, e os trechos em que o seu próprio código estava rodando aparecem como seu app. Chamadas em paralelo se sobrepõem. Uma chamada com falha aparece hachurada com o código de status; selecione uma chamada para ver latência, tokens e custo.
4. Abra uma sessão para ver totais, modelos, erros por código de status e chamadas ao longo do tempo. Ver as chamadas em Logs lista cada requisição da sessão.

Limites e ressalvas

• Traces e sessões são montados a partir do seu registro de requisições, então cobrem os mesmos 90 dias e as mesmas chamadas.
• Uma chamada com falha mostra o código de status que o seu código recebeu, inclusive um erro retornado pelo provedor.
• Os IDs são seus: até 128 caracteres ASCII imprimíveis cada. Eles voltam na resposta e nunca são enviados ao provedor.
• Quando um agente de código identifica seus subagentes, uma sessão lista seus agentes com as chamadas e o custo de cada um, e um trace marca as compactações e as chamadas auxiliares e nomeia as ferramentas que rodaram entre duas chamadas.
• Uma requisição que o gateway precisou tentar mais de uma vez lista suas tentativas no detalhe: o modelo, o status e o tempo de cada uma. Na cascata, as tentativas com falha são o início hachurado da barra.

Referência da API para o mesmo recurso: Cabeçalhos de requisição