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ément | Lecture |
|---|---|
| État final et motif | Résultat, attente, refus ou erreur du traitement |
call_started / call_completed | Début et fin d’un appel |
| Agent et ressource | Contexte responsable et cible déclarée |
| Décision humaine | Demande, réponse et reprise enregistrées |
| Budgets et refus | Limite 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.