Traces et sessions

Visualisez une exécution d’agent comme une chronologie et une conversation entière comme une session : quels appels ont tourné en parallèle, où le temps est passé, ce qui a échoué et ce que cela a coûté.

Dans la barre latérale de la console (elle apparaît dès que la fonctionnalité s'applique à votre compte) : Traces Ouvrir ↗

Étapes

1. Envoyez X-Trace-Id sur chaque appel d’une exécution (une requête utilisateur, une tâche d’agent), X-Span-Id pour nommer chaque appel et X-Session-Id sur chaque appel d’une conversation. Les outils qui envoient leurs propres en-têtes de trace ou de session, comme Claude Code, sont regroupés sans modification.
2. Ouvrez Traces. Les traces et sessions des 7 derniers jours y sont listées avec leurs appels, leur durée et leur coût, la requête la plus récente en premier ; cliquez sur un en-tête de colonne pour trier la liste. Renommer, sur la page d'une trace ou d'une session, lui donne un nom visible par tout l'espace de travail. La recherche accepte un ID complet ou n'importe quelle partie d'un nom.
3. Ouvrez une trace pour voir sa cascade : une barre par appel, placée dans le temps, et les intervalles où votre propre code tournait affichés comme votre app. Les appels faits en parallèle se chevauchent. Un appel en échec est hachuré et affiche son code de statut ; sélectionnez un appel pour voir sa latence, ses tokens et son coût.
4. Ouvrez une session pour voir ses totaux, ses modèles, ses erreurs par code de statut et ses appels dans le temps. Voir les appels dans les journaux liste chaque requête de la session.

Limites et pièges

• Les traces et sessions sont construites à partir de votre journal de requêtes : elles couvrent les mêmes 90 jours et les mêmes appels que lui.
• Un appel en échec affiche le code de statut que votre code a reçu, y compris une erreur renvoyée par le fournisseur.
• Les ID sont les vôtres : jusqu’à 128 caractères ASCII imprimables chacun. Ils reviennent dans la réponse et ne sont jamais envoyés au fournisseur.
• Quand un agent de code identifie ses sous-agents, une session liste ses agents avec les appels et le coût de chacun, et une trace signale les compactions et les appels annexes et nomme les outils qui ont tourné entre deux appels.
• Une requête que la passerelle a dû tenter plusieurs fois liste ses tentatives dans son détail : le modèle, le statut et la durée de chacune. Dans la cascade, les tentatives échouées forment le début hachuré de sa barre.

Référence API pour la même fonctionnalité : En-têtes de requête