Suivi des exécutions
Chaque fois qu'un déclencheur s'active, GCM crée une exécution de flux de travail — une seule tentative d'exécution pour un seul sujet. La page Exécutions montre l'historique, filtrable par flux de travail, statut, date et sujet.
Ouvrir la page des exécutions
Depuis Flux de travail → Exécutions. La vue par défaut affiche toutes les exécutions des 7 derniers jours, triées par les plus récentes.
Statut d'exécution
Une exécution peut être dans l'un des états suivants :
| Statut | Signification |
|---|---|
| En file | Créée, pas encore démarrée |
| En cours | Exécute activement des actions |
| En attente | Mise en pause sur un wait_delay, wait_until ou wait_event |
| Terminée | Toutes les actions terminées |
| Échec | Une action a échoué et l'exécution a été abandonnée |
| Annulée | Un humain l'a annulée |
| Sautée | Le déclencheur s'est activé mais un filtre au niveau du flux de travail a exclu le sujet |
Le statut se met à jour quasi en temps réel. Rafraîchissez la page ou attendez quelques secondes pour voir les changements.
Filtrage
La barre de filtres vous permet de restreindre par :
- Flux de travail — un ou plusieurs
- Statut
- Plage de dates
- Sujet — un membre spécifique
- Déclenché par — les exécutions manuelles affichent l'administrateur qui les a lancées
L'état du filtre encodé dans l'URL signifie que vous pouvez partager un lien vers une vue filtrée spécifique.
La page de détail d'une exécution
Cliquez sur n'importe quelle exécution pour voir la chronologie des exécutions d'actions. Pour chaque étape :
- Nom de l'action — ce qui s'est exécuté.
- Démarrée à — quand elle a commencé.
- Terminée à — quand elle s'est terminée (ou « Toujours en cours… »).
- Statut — réussie, échouée, sautée.
- Sortie — les données résultantes produites par l'action.
- Message d'erreur — pour les échecs.
Si l'exécution est en pause sur un délai, la chronologie affiche l'étape d'attente avec un horodatage « reprend à ».
Déboguer un échec
Une exécution échouée a généralement l'une des erreurs suivantes :
| Schéma d'erreur | Cause probable |
|---|---|
Permission denied | Le flux de travail a essayé de modifier un enregistrement en dehors de son organisation ou de sa portée. |
Provider returned 4xx | Un fournisseur de messagerie a rejeté l'envoi (mauvais numéro, désinscription, compte suspendu). |
Merge token resolved to empty | Un jeton référençait un champ qui est null sur le sujet. |
Condition evaluation failed | Une expression de condition avait un problème de syntaxe. |
Webhook timeout | Un système externe n'a pas répondu dans le délai imparti. |
La page de détail affiche l'erreur complète de l'action y compris tout code de réponse du fournisseur. Cliquez sur le nœud d'action pour revenir au constructeur et inspecter la configuration.
Réessayer
Pour les échecs transitoires (fournisseur 500, coupure réseau), vous pouvez réessayer une exécution échouée depuis la page de détail. La nouvelle tentative démarre à l'action échouée — les étapes précédentes réussies ne sont pas ré-exécutées.
WARNING
Pour les flux non idempotents que vous avez déjà partiellement terminés (ex. message à moitié envoyé), réessayer peut produire des effets secondaires en double. Le bouton de nouvelle tentative vous avertit lorsque le flux de travail a déjà eu des effets secondaires.
Annulation
Une exécution dans le statut En file, En cours ou En attente peut être annulée. L'action qui s'apprêtait à s'exécuter est sautée ; l'exécution se termine dans le statut Annulée. Les actions suivantes ne se déclenchent pas.
Utilisez l'annulation lorsque vous repérez un bug en plein déploiement et que vous ne voulez pas que des centaines de mauvais messages partent.
Annulation groupée
Si vous réalisez qu'un flux de travail a un bug et que 500 exécutions sont en cours, vous pouvez annuler en masse depuis la page de détail du flux de travail. Annuler toutes les exécutions en attente arrête tout pour ce flux de travail.
Tableau de bord d'analyses
Le haut de la page Exécutions a des analyses agrégées :
- Exécutions des dernières 24 heures — nombre total
- Taux de réussite — terminées vs échouées
- Durée moyenne — pour les exécutions synchrones (hors délais)
- Actions les plus en échec — quelles actions échouent le plus souvent (utile pour prioriser les correctifs)
Ces tuiles sont filtrées par votre sélection de filtre en haut de page.
Permissions
| Action | Admin | Berger | Membre |
|---|---|---|---|
| Voir la liste des exécutions | oui | restreint à l'unité | non |
| Voir le détail d'une exécution | oui | restreint | non |
| Réessayer une exécution échouée | oui | non | non |
| Annuler une exécution | oui | non | non |
Les bergers voient les exécutions pour les membres dans leur portée — utile lorsqu'ils veulent confirmer « le nouveau venu a-t-il reçu le message de bienvenue » sans accès administrateur.
Rétention
L'historique des exécutions est conservé pendant 90 jours. Les exécutions plus anciennes sont purgées chaque nuit. Les statistiques agrégées (nombre d'exécutions, taux de réussite) sont conservées indéfiniment pour que les rapports restent précis, mais le détail par étape disparaît.
TIP
Si vous avez besoin d'un audit à long terme des effets des flux de travail, les effets secondaires eux-mêmes (messages, mises à jour de membres) sont conservés dans leurs journaux respectifs (journal de communication, journal d'activité). La limite de 90 jours ne concerne que la tuyauterie d'exécution des flux de travail.
Questions courantes
Pourquoi mon exécution est-elle bloquée dans « En attente » ? Vérifiez l'étape active — c'est presque toujours un wait_delay ou wait_event. La page de détail affiche quand elle reprendra.
Pourquoi les exécutions pour un flux de travail sont-elles beaucoup plus lentes que pour un autre ? Habituellement parce que le flux de travail a des actions lentes (webhooks externes, grandes boucles de segments). La répartition de durée sur la page de détail d'exécution montre quelle étape prend le plus de temps.
Puis-je voir les exécutions pour un flux de travail supprimé ? Oui — les flux de travail supprimés restent dans le filtre des exécutions (grisés). Les exécutions historiques sont conservées pendant 90 jours quelle que soit la suppression du flux de travail.
Prochaines étapes
- Constructeur visuel — corrigez les problèmes que vous y trouvez.
- Multi-étapes et délais — comprenez les états d'attente.
- Actions — déboguez les échecs spécifiques aux actions.