Trazas y sesiones

Consulta una ejecución de un agente como una línea de tiempo y una conversación entera como una sesión: qué llamadas se hicieron en paralelo, en qué se fue el tiempo, qué falló y cuánto costó.

En la barra lateral de la consola (aparece cuando la función se aplica a tu cuenta): Traces Abrir ↗

Pasos

1. Envía X-Trace-Id en cada llamada de una ejecución (una solicitud de usuario, una tarea de agente), X-Span-Id para nombrar cada llamada y X-Session-Id en cada llamada de una conversación. Las herramientas que envían sus propias cabeceras de traza o sesión, como Claude Code, se agrupan sin cambios.
2. Abre Trazas. Allí aparecen las trazas y sesiones de los últimos 7 días con sus llamadas, duración y coste, la solicitud más reciente primero; pulsa el encabezado de una columna para ordenar la lista. Renombrar, en la página de una traza o sesión, le pone un nombre que ve todo el espacio de trabajo. La búsqueda admite un ID completo o cualquier parte de un nombre.
3. Abre una traza para ver su cascada: una barra por llamada, colocada en el tiempo, y los tramos en que se ejecutaba tu propio código marcados como tu app. Las llamadas en paralelo se superponen. Una llamada fallida aparece rayada con su código de estado; selecciona una llamada para ver su latencia, tokens y coste.
4. Abre una sesión para ver sus totales, sus modelos, sus errores por código de estado y sus llamadas en el tiempo. Ver las llamadas en Registros lista cada solicitud de la sesión.

Límites y detalles a tener en cuenta

• Las trazas y sesiones se construyen a partir de tu registro de solicitudes, así que cubren los mismos 90 días y las mismas llamadas.
• Una llamada fallida muestra el código de estado que recibió tu código, incluido un error devuelto por el proveedor.
• Los ID los defines tú: hasta 128 caracteres ASCII imprimibles cada uno. Vuelven en la respuesta y nunca se envían al proveedor.
• Cuando un agente de código identifica a sus subagentes, una sesión enumera sus agentes con las llamadas y el costo de cada uno, y una traza marca las compactaciones y las llamadas auxiliares y nombra las herramientas que se ejecutaron entre dos llamadas.
• Una solicitud que la pasarela tuvo que intentar más de una vez enumera sus intentos en el detalle: el modelo, el estado y el tiempo de cada uno. En la cascada, los intentos fallidos son el inicio rayado de su barra.

Referencia de API de lo mismo: Cabeceras de solicitud