Surveillance et journalisation de l'exécution
Liste des exécutions, flux d'événements en temps réel, journaux / coûts / tokens, localisation des erreurs — voyez clairement l'état d'exécution.
Une fois un workflow lancé, votre capacité à comprendre « ce qu'il a réellement fait et combien il a coûté » détermine votre confiance à le mettre en production. Cette page traite de la liste des exécutions, des détails d'exécution, des événements en temps réel, de l'enregistrement des token et des coûts, de l'export et du tableau de bord de données.
Page de liste d'exécution
Navigation de gauche « Historique des exécutions ». Deux vues sont prises en charge (cartes et tableau), et la liste se rafraîchit automatiquement (avec possibilité de mise en pause) tant qu'une exécution est en cours. Filtrage et tri :
- Recherche par mot-clé — par ID d'exécution ou nom de workflow
- Filtrage par état — PENDING / RUNNING / COMPLETED / FAILED / CANCELLED / INTERRUPTED
- Filtrage du workflow : affichez uniquement l'historique d'un certain workflow
- Tri — heure de début / heure de fin / durée / workflow / état / progression
En haut de la liste figure aussi une rangée de filtres rapides avec compteurs (En cours / Échoué / Terminé / Interrompu), qu'un clic permet de basculer.
Informations affichées pour chaque enregistrement
- Badge d'état + ID d'exécution + nom du workflow
- Barre de progression et nombre d'étapes achevées (par exemple : 5/7)
- Heure de début (temps relatif) et durée
- Un enregistrement RUNNING affiche en plus l'étape en cours d'exécution
- Un enregistrement terminé peut être exporté directement en ligne au format JSON / YAML
Une sélection multiple permet d'annuler en masse les exécutions en cours, ou de supprimer en masse les enregistrements terminés.
PENDING— Créée mais pas encore démarrée. Une exécution dépassant la limite de concurrence attend d'abord dans cet état et passe automatiquement à RUNNING une fois les exécutions précédentes terminées.RUNNING— Au moins une étape est en cours d'exécution.COMPLETED— Toutes les étapes ont été exécutées (y compris celles SKIPPED faute de satisfaction de leur condition).FAILED— Une étape a rencontré une erreur, et l'exécution se termine en échec.CANCELLED— Annulée manuellement par l'utilisateur.INTERRUPTED— Interrompue par une cause système telle qu'un redémarrage du service. Pour la reprise automatique, voir la page de reprise automatique dans « Étape suivante » ci-dessous.
Page de détails d'exécution
Cliquez sur une exécution pour accéder à sa page de détails. De haut en bas :
- Barre supérieure — annuler, rafraîchir, exporter (JSON / YAML), accéder à l'éditeur du workflow correspondant
- Carte d'état — état, progression, durée, ainsi qu'un aperçu des token (envoyés / reçus / total)
- Onglets de la zone principale (voir le tableau ci-dessous)
- Flux « Journal d'exécution » en bas — journal déroulant de tous les événements, filtrable par niveau (debug / info / warn / error), consultable par mot-clé, avec possibilité de mettre en pause le défilement automatique
| Onglet | contenu |
|---|---|
| étapes | Chronologie verticale : état, durée et progression des itérations de chaque étape. Un clic ouvre le volet latéral de détails d'étape ; une fois l'exécution terminée, une relance depuis une étape désignée est possible. |
| dialoguer | Combine chronologiquement les prises de parole de l'Agent, les sorties LLM, les appels d'outils et les messages système en un flux de conversation. |
| Messages externes | N'affiche que les enregistrements d'envoi et de réception des canaux IM (Slack / Telegram, etc.). |
| DAG | Graphe des étapes tracé selon les dépendances, avec coloration de l'état d'exécution en temps réel. |
| Lecture | Rejoue le déroulement de cette exécution le long de la frise chronologique. |
| chaîne de raisonnement | Contenu du raisonnement intermédiaire de l'Agent. |
| Livrable | Tous les fichiers d'artefacts : prévisualisation, téléchargement, partage de fichier unique, ou génération d'un lien public pour tout le répertoire. |
| Performances | Analyse des durées après la fin de l'exécution. |
| Débogage | Apparaît lorsqu'un point d'arrêt a été défini ou qu'une session de débogage est en cours. |
Volet latéral de détails d'étape
Cliquez sur une étape de la chronologie : toutes les informations de cette étape apparaissent par glissement sur la droite, réparties en plusieurs onglets — sortie, événements, raisonnement, artefacts, conversation (les étapes de type itération / interaction / orchestration disposent d'onglets supplémentaires dédiés) —, avec en plus les heures de début et de fin et un bouton « Réexécuter depuis cette étape ». Le message d'erreur et le nombre de tentatives d'une étape en échec se consultent également ici.
Mise à jour en temps réel (WebSocket)
Lorsqu'une exécution est à l'état RUNNING, la page de détails reçoit des mises à jour incrémentales via WebSocket, sans rafraîchissement manuel. Une déconnexion entraîne une reconnexion automatique (backoff exponentiel, 5 tentatives au maximum) ; en cas d'échec persistant, la page bascule automatiquement vers un polling toutes les 2 secondes et l'indique.
Types de messages poussés
| Tapez | sens |
|---|---|
full_status | Instantané complet de l'état d'exécution |
status_change | Changement d'état / de progression de l'exécution |
step_update | Mise à jour de l'état d'une étape individuelle |
new_event | Nouvel événement d'exécution (voir les types d'événements ci-dessous) |
artifact_found | Génération d'un nouveau fichier d'artefact |
user_interaction_request | L'étape demande une saisie humaine ; un champ de réponse apparaît sur la page de conversation |
Liste des types d'événements
Le flux d'événements de chaque étape distingue les types d'événements par le champ type. Les types courants sont listés par famille :
| type d'événement | sens |
|---|---|
agent_starting / agent_completed / agent_failed | Cycle de vie d'une étape Agent |
llm_call_starting / llm_call_completed | Un appel LLM ; l'événement completed inclut le décompte de token de cet appel |
llm_streaming_starting / llm_streaming_completed / llm_streaming_failed | Sortie LLM en streaming |
tool_call_starting / tool_call_completed / tool_call_failed | Appel d'outil de l'Agent, avec les paramètres et un résumé du résultat |
external_message / im_message / telegram_message | Envoi et réception de messages sur les canaux IM |
group_chat_started / group_chat_message / group_chat_summarizing / group_chat_completed | Processus de discussion multi-Agents d'une étape group_chat |
state_machine_started / state_machine_transition / state_machine_state_completed | Transitions d'état d'une étape state_machine |
agent_based_started / agent_based_completed | Processus de délégation d'une étape d'orchestration agent_based |
user_interaction_request / user_interaction_message / user_interaction_timeout | Poser une question à l'utilisateur en cours d'exécution, recevoir une réponse, attendre jusqu'à expiration |
claude_code_* | Événements de progression en streaming du runtime Claude Code |
Un événement porte aussi un champ category (agent / llm / tool / message / strategy / user_interaction), sur lequel se fonde le regroupement du filtre par catégorie de la page de conversation.
Filtrage de la vue conversation
- Recherche par mot-clé — recherche dans le contenu des messages et parmi les intervenants
- Filtrer par Agent — n'afficher que les messages d'un Agent ou d'une étape donnés
- Filtrer par catégorie — Agent / LLM / Outil / Message externe / Stratégie / Interaction
- Bascule de défilement automatique — indique si l'on suit jusqu'en bas à l'arrivée d'un nouveau message
Token et coût
- Les événements liés au LLM enregistrent au fil du temps les token d'input / output, et la carte d'état affiche le cumul en temps réel des token envoyés / reçus / total.
- Après la fin de l'exécution,
GET /api/executions/{executionId}/costestime le coût de cette exécution d'après le prix des modèles utilisés, et renvoie le montant total ainsi que le détail de chaque étape. - Le coût est estimé a posteriori d'après la consommation de token ; la plateforme ne fournit pas de devis avant exécution.
Processus d'exécution de l'exportation
Le bouton « Exporter » de la barre supérieure de la page de détails ou d'une ligne de la liste exporte une exécution dans un fichier JSON ou YAML, dont le contenu comprend l'état d'exécution, les résultats, les indicateurs de performance, ainsi qu'un instantané de la définition du workflow et son code source YAML au moment de l'export. Les champs sensibles tels que les mots de passe, les API Key et les adresses de webhook sont automatiquement remplacés par [REDACTED]. Le nom de fichier se présente sous la forme execution-process-79621f70-completed.json.
La définition du workflow présente dans l'export est la version courante récupérée au moment de l'export ; si le workflow a été modifié après cette exécution, elle peut différer de la définition en vigueur lors de l'exécution.
Tableau de bord des données
La vue agrégée inter-exécutions se trouve dans Analytique Tableau de bord : nombre total d'exécutions, taux de réussite, durée moyenne, consommation totale de token, auxquels s'ajoutent la tendance des exécutions, la répartition des statuts et le classement des principaux workflows, avec une plage temporelle au choix de 24 heures / 7 jours / 30 jours.
Emplacement de l'erreur
Lorsqu'une exécution est FAILED, repérez d'abord l'étape en rouge dans la chronologie et ouvrez ses détails : le message d'erreur figure dans l'onglet « Sortie », et les détails du déroulement dans l'onglet « Événements » (le stderr des étapes code s'y trouve également). Une étape ayant fait l'objet de nouvelles tentatives affiche leur nombre.
Pour la manière de traiter les erreurs courantes, voir Dépannage.
Période de conservation
Les enregistrements d'exécution (état, résultats, événements, données de performance) et les fichiers d'artefacts sont conservés 90 jours par défaut, puis nettoyés périodiquement par la plateforme à échéance ; la durée exacte dépend de votre plan ou de votre configuration de déploiement, et une exécution encore en cours n'est pas nettoyée.
Étape suivante
- Débogage des points d'arrêt — Utilisez-le lorsque vous « ne comprenez pas pourquoi vous courez comme ça »
- Dépannage — Erreurs courantes et corrections correspondantes
- Reprise automatique — Comment traiter une exécution à l'état INTERRUPTED