Nouveau : le pare-feu IA surveille toute la plateforme et explique chaque incident en termes simples. Découvrez comment ça marche

Dépannage des flux

Découvrez ce qu'a fait un flux : chiffres en direct, panneau Activity, enregistrements d'exécution, traces, événements et journaux d'erreurs, ainsi que les solutions aux problèmes les plus courants.

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

EmplacementAfficheConservé
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’éditeurLive ou Every 5 s, messages par seconde, messages en attente, erreurs sur 24 h
Liaisons et blocsNombre 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 intervenue24 heures
Activity > DebugMessages arrivant aux blocs Debug24 heures
Activity > RunsExécutions enregistrées étape par étape : Started with, In, Sent on, It did, Left the flow24 heures
Activity > TraceUn message suivi à travers chaque étape24 heures
Activity > ErrorsCompteurs d’erreurs par bloc, erreurs les plus récentes, lieu de capture de chacune7 jours
Événements : LogLignes des blocs System log et du moteur24 heures
Événements : LifecycleDéploiements, mises en marche et arrêts, pauses, reprises, retours arrière, changements de racine, échecs de démarrage, ouverture et fermeture du disjoncteur30 jours (100 dernières)
Événements : StatsPar bloc : entrées, sorties par port, erreurs, abandons, refus par une limite, temps moyen et temps le plus long, étapes lentes24 heures
Événements : AuditQui a modifié le flux (50 dernières entrées)Durée de conservation du journal d’audit
Failed messagesMessages que le flux n’a pas pu exécuterJusqu’à 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 :

  1. Ouvrez Activity, puis Runs.
  2. Réglez Record sur Runs that fail, ou sur Every run, for 5 minutes.
  3. 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ômeCause probableSolution
Le flux ne démarre jamaisIl 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 rienCe n’est pas une racine ; les messages d’appareils ordinaires n’atteignent que la racineFaites-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 messageL’entrée Flow input de la racine est reliée, elle constitue donc le point d’entréeReliez vos étapes après le Flow input
Les données ne sont pas stockéesSave telemetry manque sur le chemin, ou signale une erreurVoir Hosts, the root flow and profile root flows
not_a_deviceLe message a été lancé par une planification, un inject, un événement, une minuterie ou un webhook, qui ne concernent pas un appareilEffectuez le travail sur appareil dans la racine, ou dans un flux qu’elle lance
Une Schedule se déclenche à la mauvaise heureLe tz du bloc est vide et le fuseau par défaut de l’organisation est différentRenseignez tz ; vérifiez avec Show the next runs
Le déploiement refuse une planification solaireAucune latitude ni longitudeRenseignez lat et lon
Un bloc continue de produire l’erreur circuit_openSes appels ont continuellement échoué et sont suspendusCorrigez le récepteur ; il se rétablit automatiquement
La requête HTTP échoue avec ssrf_blockedL’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 baseUtilisez une adresse publique et ajoutez l’hôte à allowed_hosts
Rien n’est envoyé après une panneLes messages étaient en retard ; les blocs de sortie ignorent les messages en retardRéglez late sur send pour les flux de données qui ont besoin de l’arriéré
Un Notify n’envoie rienTous les destinataires sont en période de blocage (held), ou invalides, ou tous les canaux ont épuisé leur quotaVérifiez msg.metadata.notify dans une exécution ; renseignez Repeat reason
Les membres ne reçoivent pas de courriel de NotifyLes membres (utilisateurs, rôles, équipes) sont joints dans l’application, par notification push et dans les applications de messagerie uniquementAjoutez des lignes address
Le flux s’est mis en pause tout seulUne boucle (une exécution dépassant la limite d’une minute) ou des exécutions en échecVoir Protections and failed messages
« Ces blocs envoient des messages en boucle sans jamais attendre »Un cycle sans bloc d’attenteAjoutez un Delay, ou rompez le cycle
flow_cycle au déploiementDes flux se déclenchent mutuellement par événements ou par Run flowSupprimez un lien du cycle
Un compteur ou une moyenne a redémarréLes réglages du bloc ont changé lors du dernier déploiementComportement attendu : un bloc modifié démarre avec une mémoire vide
Un script échoue avec script_unavailable ou host_busyLe service de script est injoignable ou occupéRéessayez plus tard ; contactez le support si cela persiste
Un script échoue avec timeout ou blockedPlus de 50 ms de CPU, trois fois de suiteSimplifiez le script, ou déplacez le travail vers des blocs prêts à l’emploi
queue_fullUn bloc retient trop de messages ou de clésRaccourcissez 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 retardLes graphiques sur plus de 24 heures lisent des synthèses par minute, remplies chaque minuteAttendez 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.