Aller au contenu principal
Version: 1.4.0

Lire les traces d’exécution

Une trace décrit les appels, les décisions et les contrôles d’une exécution. Commencez par son état final, puis suivez les événements qui expliquent le résultat.

Produire et lire une trace​

touba run programme.air.json --entry strategy:app/Run --trace-out trace.json
touba inspect trace.json

Adaptez l’entrée à votre programme. L’inspecteur résume l’exécution et ses événements marquants. Ouvrez le fichier exporté pour lire le détail des événements. Dans VS Code, Touba: Render Trace propose une lecture textuelle ; Touba: Open Trace Event Source retrouve la source lorsque les artefacts correspondants sont disponibles.

Repérer les événements​

ÉlémentLecture
État final et motifRésultat, attente, refus ou erreur du traitement
call_started / call_completedDébut et fin d’un appel
Agent et ressourceContexte responsable et cible déclarée
Décision humaineDemande, réponse et reprise enregistrées
Budgets et refusLimite rencontrée ou autorisation manquante

Les identifiants de contexte relient les appels au sein d’une exécution. La référence des traces décrit leur structure.

Journaux persistants​

Le stockage des traces décrit SQLite, la lecture par pages et l’export vers PostgreSQL. Une référence de trace désigne un segment du journal ; conservez ensemble la référence et le stockage correspondant.

Préparer un audit​

touba audit --trace trace.json --air programme.air.json --output text

Le guide d’audit présente les contrôles et les pièces à joindre. Relisez les données et les identifiants avant de partager un export.

Pour pratiquer : lire sa première trace.