Les flux fonctionnent sans surveillance, donc Hermetry les protège : un flux pris dans une boucle ou qui échoue en boucle se met en pause automatiquement, les effets de bord sont limités en débit, et les messages qui n’ont pas pu être exécutés sont conservés comme messages en échec que vous pouvez rejouer. Cette page explique chaque protection et ce que vous faites lorsqu’elle se déclenche.
Protections des flux
| Protection | Valeur par défaut | Ce qui se passe |
|---|---|---|
| Exécutions par minute | 6 000 exécutions d’un même flux sur une minute glissante | Le flux se met en pause : une boucle est suspectée |
| Exécutions en échec | 100 exécutions en échec d’affilée | Le flux se met en pause |
| Exécutions simultanées | 16 exécutions d’un même flux en même temps | Les exécutions suivantes attendent (au maximum 1 000 par flux ; les plus anciennes sont supprimées au-delà) |
| Fan-out | 100 messages envoyés par un bloc pour une même entrée | Les autres messages de ce bloc pour cette entrée sont supprimés |
| Taille des messages | 256 KiB par message | Le message est refusé (msg_too_big) |
| Garde-fou de boucle | 4 sauts d’événements et de Exécuter le flux entre flux ; 512 étapes dans une même exécution | La chaîne est coupée |
| Tentatives épuisées | 5 tentatives au maximum pour un appel externe | L’entrée devient un message en échec, sauf si le flux intercepte l’erreur |
| Messages répétés | Un message d’appareil revu dans les 60 secondes | Acquitté sans exécution |
| Trop anciens | Un message en attente depuis plus de 5 minutes | Non exécuté (les messages d’appareil s’exécutent encore dans leur racine, marqués en retard) |
| Commandes d’appareil par minute | 30 commandes et réglages envoyés par les flux à un même appareil | La commande est refusée (limit) |
| Notifications répétées | La même notification à la même personne dans les 10 minutes | Cette personne est exclue |
Votre offre peut définir d’autres valeurs, dans des limites fixes. Chaque fois qu’une protection agit, elle est comptabilisée : sur la ligne du flux (Limité · protection), dans l’éditeur (« Une protection de flux a agi sur ce flux : … », avec les blocs signalés) et dans la carte d’utilisation (Protections de flux ce mois-ci). Voir Limites des flux.
Un flux mis en pause automatiquement
Un flux en pause ne démarre aucune exécution tant qu’il n’est pas repris. Sa ligne indique la raison :
- « Il s’est mis en pause : il a été exécuté plus souvent en une minute que ne le permet cet espace de travail, une boucle est donc suspectée. »
- « Il s’est mis en pause : trop de ses exécutions ont échoué d’affilée. »
Les gestionnaires de l’automatisation reçoivent l’alerte Flux mis en pause automatiquement. Que faire :
- Ouvrez le flux et consultez Activité > Erreurs ainsi que les Exécutions des dernières minutes.
- Corrigez la cause : supprimez la boucle (un flux qui se déclenche lui-même, un déclencheur Statut qui surveille un bloc changeant son statut à chaque message), ou corrigez l’appel en échec.
- Déployez, puis sélectionnez Reprendre dans le menu de la ligne du flux ou dans la bannière de l’éditeur. Une pause conserve la mémoire du flux et les messages en attente.
Les flux racines ne sont jamais mis en pause automatiquement
Un root flow stocke les données de chaque appareil qu’il dessert ; il est donc exempté de la pause automatique et de Runs at once. Si un root échoue trop souvent, les propriétaires et administrateurs de l’organisation reçoivent l’alerte critique Root flow not paused (« This root flow was not paused, because it stores the data of every device it serves… »), au maximum une fois toutes les 6 heures par flux. Corrigez-la rapidement : les exécutions en échec d’un root peuvent signifier que les mesures ne sont pas stockées.
L’arrêt d’urgence
L’arrêt d’urgence met en pause tous les flux en cours de l’organisation, sur chaque hôte, immédiatement, racines comprises.
- Dans Automatisation, ouvrez le menu d’en-tête et sélectionnez Arrêter tous les flux.
- Lisez : « Tous les flux actifs de cet espace de travail, sur chaque hôte, sont suspendus en même temps : les messages des appareils, les planifications, les webhooks et les événements ne déclenchent aucune exécution tant que vous ne reprenez pas. Les exécutions en cours se terminent. Un flux racine est également suspendu, donc les données des appareils ne sont pas stockées entre-temps. »
- Cochez « Je comprends que rien ne s’exécute tant que les flux ne sont pas repris. », saisissez
STOPet confirmez.
Une bannière affiche « Arrêt d’urgence : n flux sont en pause… ». Pour y mettre fin, sélectionnez Reprendre les flux : chaque flux arrêté par cette action repart ; un flux qui s’était mis en pause automatiquement reste en pause. Les deux actions sont tracées dans le journal d’audit.
Utilisez-le uniquement lorsque des flux causent un préjudice (envoi de mauvaises commandes, saturation d’un système partenaire). Les données des appareils ne sont pas stockées tant qu’il est activé.
Messages en échec
Un message que la plateforme n’a pas pu exécuter est conservé comme message en échec (lettre morte). Ouvrez-les depuis le menu d’en-tête de la liste des flux (Messages en échec, tous les flux d’un hôte) ou dans l’éditeur (Messages en échec, les messages destinés à ce flux).
| Motif | Signification |
|---|---|
| Échecs répétés | Livré plusieurs fois sans être terminé |
| Un appel a échoué à chaque tentative | Un appel externe a épuisé ses tentatives et le flux n’a pas intercepté l’erreur |
| Attente trop longue | Un appel de webhook ou une minuterie nommée a attendu plus longtemps que sa durée de vie (après une panne). « Rejouez-le pour l’exécuter maintenant. » |
| Laissé inachevé par un redéploiement | Son exécution ne s’est pas terminée avant que la version sur laquelle elle tournait ait été remplacée |
| File d’attente trop longue | Trop de messages de l’organisation attendaient |
| Illisible | L’entrée stockée est endommagée |
| Refusé par l’hôte | L’hôte ne l’a pas accepté |
Chaque ligne affiche Vu pour la première fois, Motif, Erreur et Tentatives. Voir affiche l’entrée stockée (réservé aux personnes habilitées au débogage).
- Rejouer remet le message dans la file avec ses identifiants d’origine. « Son exécution a pu déjà accomplir une partie de son travail : les appels, messages ou écritures qu’elle a faits peuvent se reproduire. » Les blocs qui appellent l’extérieur envoient la même clé d’idempotence, si bien qu’un récepteur qui déduplique ne voit qu’un seul appel.
- Supprimer l’efface. Il ne pourra plus être rejoué ensuite.
Chaque hôte conserve ses propres messages en échec. Par défaut, 10 000 au maximum sont conservés ; au-delà, les plus anciens sont supprimés. À 80 %, les gestionnaires reçoivent l’alerte Messages en échec presque pleins, au plus une fois toutes les 6 heures.
Un message d’appareil en retard dans une racine n’est jamais un message en échec : il est stocké. Une échéance de planification en retard est simplement ignorée.
Alertes
Erreurs et alertes (menu d’en-tête de la liste des flux) affiche les alertes d’automatisation des 6 dernières heures, une ligne par flux déployé avec ses erreurs sur 24 heures, ses messages en échec du jour et son niveau d’enregistrement, les erreurs les plus fréquentes sur 7 jours et les totaux par jour.
La Règle d’alerte détermine qui est prévenu et quand :
| Champ | Signification |
|---|---|
| Envoyer les alertes | Activé ou désactivé |
| Erreurs par minute | 1 à 10 000 |
| Minutes consécutives | 1 à 19 |
| Flux | Aucun coché = tous les flux |
| Événements | Aucun coché = tous les types d’alerte |
| Destinataires | Un identifiant d’utilisateur membre par ligne, 100 au plus. Vide : les personnes habilitées à gérer l’automatisation. Les adresses e-mail ne sont pas acceptées. |
Types d’alerte : Beaucoup d’erreurs, Appels suspendus (disjoncteur ouvert), Effet de bord limité, Bloc qui ne démarre pas, Messages en échec presque pleins, Flux mis en pause automatiquement et Flux racine non mis en pause. Flux racine non mis en pause est toujours envoyée, quelle que soit la règle, aux propriétaires et administrateurs ainsi qu’aux destinataires de la règle.
Appels suspendus (disjoncteur)
Un bloc dont les appels externes échouent sans cesse (un point d’accès HTTP hors service) suspend ses appels un certain temps ; ses messages échouent entre-temps avec circuit_open. Les événements du flux affichent Appels suspendus (disjoncteur ouvert), puis plus tard Appels repris (disjoncteur fermé). Corrigez le récepteur ; le bloc se rétablit de lui-même.

