Lorsqu’un flux ne fait pas ce que vous attendez, regardez d’abord ce qu’il a réellement fait avant de le modifier. Cette page indique où regarder et liste les causes courantes.
Où regarder
| Emplacement | Affiche | Conservé |
|---|---|---|
| Ligne de la liste des flux | État (Running, Off, Paused, Needs approval, Invalid, Draft), Activity, erreurs sur 24 h, Limited · … lorsqu’une protection est intervenue | |
| Barre supérieure de l’éditeur | Live ou Every 5 s, messages par seconde, messages en attente, erreurs sur 24 h | |
| Liaisons et blocs | Nombre de messages sur les liaisons ; compteurs In, Out et Errors sur les blocs ; une marque rouge sur un bloc en échec, un anneau jaune lorsqu’une protection est intervenue | 24 heures |
| Activity > Debug | Messages arrivant aux blocs Debug | 24 heures |
| Activity > Runs | Exécutions enregistrées étape par étape : Started with, In, Sent on, It did, Left the flow | 24 heures |
| Activity > Trace | Un message suivi à travers chaque étape | 24 heures |
| Activity > Errors | Compteurs d’erreurs par bloc, erreurs les plus récentes, lieu de capture de chacune | 7 jours |
| Événements : Log | Lignes des blocs System log et du moteur | 24 heures |
| Événements : Lifecycle | Déploiements, mises en marche et arrêts, pauses, reprises, retours arrière, changements de racine, échecs de démarrage, ouverture et fermeture du disjoncteur | 30 jours (100 dernières) |
| Événements : Stats | Par bloc : entrées, sorties par port, erreurs, abandons, refus par une limite, temps moyen et temps le plus long, étapes lentes | 24 heures |
| Événements : Audit | Qui a modifié le flux (50 dernières entrées) | Durée de conservation du journal d’audit |
| Failed messages | Messages que le flux n’a pas pu exécuter | Jusqu’à leur rejeu ou leur suppression |
| Errors and alerts (menu de la liste des flux) | Alertes de 6 heures, flux avec erreurs, erreurs les plus fréquentes sur 7 jours |
Le contenu des messages n’est affiché qu’aux personnes disposant de Inject messages, see payloads and dead letters. Les autres voient uniquement des compteurs.
Enregistrer ce qui se passe
Par défaut, seuls les compteurs sont conservés. Pour voir le contenu des messages :
- Ouvrez Activity, puis Runs.
- Réglez Record sur Runs that fail, ou sur Every run, for 5 minutes.
- Laissez arriver des messages, puis ouvrez une exécution. « Kept x of y runs » indique combien ont été enregistrées.
Pour suivre un message précis, sélectionnez un déclencheur et Trace the next message. Pour cibler un bloc, faites un clic droit dessus et choisissez Debug node (ou Record this block for 5 minutes).
Depuis n’importe quelle entrée enregistrée, Test with this input la rejoue en test, sans rien stocker ni envoyer.
Problèmes courants
| Symptôme | Cause probable | Solution |
|---|---|---|
| Le flux ne démarre jamais | Il est Off, Paused, Needs approval ou n’a jamais été déployé | Déployez-le avec Run the flow after the deploy, ou Resume-le |
| Un flux avec un déclencheur Device message n’entend rien | Ce n’est pas une racine ; les messages d’appareils ordinaires n’atteignent que la racine | Faites-en une racine de profil, ou transmettez les messages depuis la racine avec Run flow. Seuls alarm et attributes_updated atteignent tous les flux, et uniquement lorsqu’ils sont cochés par nom. |
| Une racine ne reçoit rien sur son déclencheur Device message | L’entrée Flow input de la racine est reliée, elle constitue donc le point d’entrée | Reliez vos étapes après le Flow input |
| Les données ne sont pas stockées | Save telemetry manque sur le chemin, ou signale une erreur | Voir Hosts, the root flow and profile root flows |
not_a_device | Le message a été lancé par une planification, un inject, un événement, une minuterie ou un webhook, qui ne concernent pas un appareil | Effectuez le travail sur appareil dans la racine, ou dans un flux qu’elle lance |
| Une Schedule se déclenche à la mauvaise heure | Le tz du bloc est vide et le fuseau par défaut de l’organisation est différent | Renseignez tz ; vérifiez avec Show the next runs |
| Le déploiement refuse une planification solaire | Aucune latitude ni longitude | Renseignez lat et lon |
Un bloc continue de produire l’erreur circuit_open | Ses appels ont continuellement échoué et sont suspendus | Corrigez le récepteur ; il se rétablit automatiquement |
La requête HTTP échoue avec ssrf_blocked | L’adresse est privée, ou ne figure pas dans les hôtes autorisés du point de terminaison, ou le chemin sort du chemin de base | Utilisez une adresse publique et ajoutez l’hôte à allowed_hosts |
| Rien n’est envoyé après une panne | Les messages étaient en retard ; les blocs de sortie ignorent les messages en retard | Réglez late sur send pour les flux de données qui ont besoin de l’arriéré |
| Un Notify n’envoie rien | Tous les destinataires sont en période de blocage (held), ou invalides, ou tous les canaux ont épuisé leur quota | Vérifiez msg.metadata.notify dans une exécution ; renseignez Repeat reason |
| Les membres ne reçoivent pas de courriel de Notify | Les membres (utilisateurs, rôles, équipes) sont joints dans l’application, par notification push et dans les applications de messagerie uniquement | Ajoutez des lignes address |
| Le flux s’est mis en pause tout seul | Une boucle (une exécution dépassant la limite d’une minute) ou des exécutions en échec | Voir Protections and failed messages |
| « Ces blocs envoient des messages en boucle sans jamais attendre » | Un cycle sans bloc d’attente | Ajoutez un Delay, ou rompez le cycle |
flow_cycle au déploiement | Des flux se déclenchent mutuellement par événements ou par Run flow | Supprimez un lien du cycle |
| Un compteur ou une moyenne a redémarré | Les réglages du bloc ont changé lors du dernier déploiement | Comportement attendu : un bloc modifié démarre avec une mémoire vide |
Un script échoue avec script_unavailable ou host_busy | Le service de script est injoignable ou occupé | Réessayez plus tard ; contactez le support si cela persiste |
Un script échoue avec timeout ou blocked | Plus de 50 ms de CPU, trois fois de suite | Simplifiez le script, ou déplacez le travail vers des blocs prêts à l’emploi |
queue_full | Un bloc retient trop de messages ou de clés | Raccourcissez les attentes, définissez une clé, ou réduisez le débit d’entrée |
| Les mesures arrivent mais le tableau de bord est en retard | Les graphiques sur plus de 24 heures lisent des synthèses par minute, remplies chaque minute | Attendez une minute ou deux |
Un flux en fait trop
- Stop one flow : désactivez-le dans la liste des flux (sa mémoire et ses messages en attente sont conservés).
- Arrêter tous les flux : l’arrêt d’urgence, depuis le menu d’en-tête de la liste des flux. Les données des appareils ne sont pas stockées tant qu’il est activé. Voir Protections et messages en échec.
- Annuler une modification : Versions > Roll back to this. Voir Versions, testing and rollback.
Demander de l’aide
Lorsque vous contactez le support, indiquez le nom et le slug du flux, l’heure du problème (avec votre fuseau horaire), le bloc et son code d’erreur, et, si possible, une copie exportée du flux (les secrets n’y figurent jamais). Voir Getting help.

