Lorsqu’un flux ne fait pas ce que vous attendez, regardez 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 là où une protection est intervenue | 24 heures |
| Activity > Debug | Messages qui atteignent les 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, point de capture de chaque erreur | 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, disjoncteur ouvert et fermé | 30 jours (100 dernières) |
| Événements : Stats | Par bloc : entrées, sorties par port, erreurs, messages abandonnés, refusés par une limite, durée moyenne et durée maximale, é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 sur 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 ne voient que 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 exactement un message, sélectionnez un déclencheur puis Trace the next message. Pour cibler un bloc, faites un clic droit dessus et choisissez Debug node (ou Record this block for 5 minutes).
À partir de toute 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 chaque flux, et seulement lorsqu’ils sont cochés par nom. |
| Une racine ne reçoit rien sur son déclencheur Device message | L’Flow input de la racine est relié, il sert donc d’entrée | Reliez vos étapes après l’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, un minuteur 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 | Pas de latitude ni de longitude | Renseignez lat et lon |
Un bloc continue à produire circuit_open | Ses appels ont échoué en continu et sont suspendus | Corrigez le destinataire ; il se rétablit de lui-même |
La requête HTTP échoue avec ssrf_blocked | L’adresse est privée, ou n’est pas dans les hôtes autorisés du point d’accès, 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 du retard accumulé |
| Un Notify n’envoie rien | Tous les destinataires sont en délai d’attente (held), ou invalides, ou tous les canaux ont épuisé leur quota | Vérifiez msg.metadata.notify dans une exécution ; réglez Repeat reason |
| Les membres ne reçoivent pas d’e-mail depuis 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 (plus d’une minute au-delà de la limite) 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 | Les flux se déclenchent mutuellement par des é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é au 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 scripts est injoignable ou occupé | Réessayez plus tard ; contactez le support si le problème 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 les résumés par minute, complétés chaque minute | Attendez une minute ou deux |
Un flux fait trop de choses
- Stop one flow : désactivez-le dans la liste des flux (sa mémoire et ses messages en attente sont conservés).
- Stop all flows : l’arrêt d’urgence, depuis le menu de l’en-tête de la liste des flux. Les données des appareils ne sont pas stockées tant qu’il est actif. Voir Protections and failed messages.
- 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.