Règles et automatisation
Agissez sur les données en direct, avec un interrupteur pour les arrêter
Trois outils agissent sur les données des appareils : les règles d'alarme sur un profil d'appareil, les règles dans une carte Règles, et les flux. Choisissez le plus simple qui fait le travail. Chaque emplacement dispose d'un interrupteur Manuel et Auto, et les flux sont protégés contre les automatisations incontrôlées.
Trois outils
Quel outil utiliser
Les trois utilisent les mêmes alarmes, commandes et notifications.
| Règles d’alarme | Carte Règles | Flux | |
|---|---|---|---|
| Utilisation | Ouvrir une alarme lorsqu’une valeur dépasse une limite ou qu’un appareil ne donne plus signe de vie | Quand ceci se produit, si cela est vrai, faites ceci, pour un site ou un appareil | Tout traitement que vous pouvez dessiner sous forme de blocs : transformer, enrichir, router, appeler des systèmes externes |
| Emplacement | Le profil d’appareil, pour chaque appareil de ce profil | Une carte Règles sur un tableau de bord, liée à un actif ou à un appareil | Automatisation, sur l’hôte IoT ou l’hôte général |
| Exemple | temperature au-dessus de max_temp de l’appareil pendant 60 secondes ouvre une alarme Majeure | Ventilateur en marche lorsque la pièce reste au-dessus de 28 °C pendant cinq minutes pendant les heures de travail | Transformer le compteur d’un compteur de consommation en consommation par heure et le stocker comme une nouvelle clé |
| Limites | 50 règles par profil, 16 comparaisons par condition | 10 déclencheurs, 16 conditions et 20 actions par règle | Versions, exécuteur de tests et pause automatique |
| Documentation | Règles d’alarme | Le moteur de règles | Flux |
Écrire une règle
Quand, seulement si, alors
Les règles s’écrivent dans le tiroir d’une carte Règles, sans dessiner de flux. Chacune s’exécute comme un flux en arrière-plan.
1
Quand
Une valeur franchit une limite ou y reste pendant un certain temps ; un appareil se connecte, se déconnecte ou devient inactif ; une alarme est levée ou effacée ; une heure, toutes les N minutes, le lever ou le coucher du soleil, une date ; ou une exécution manuelle.
2
Seulement si
D’autres valeurs, l’état d’un appareil, une alarme active, une plage horaire, le jour ou la nuit, une plage de dates, le calendrier des jours fériés de votre organisation, ou une formule sur les valeurs des appareils.
3
Alors
Envoyer une commande, modifier un réglage d’appareil, notifier des utilisateurs, des rôles ou des équipes, lever ou effacer une alarme, attendre, attendre jusqu’à ce qu’une condition soit vraie, choisir entre jusqu’à cinq branches, ou activer ou désactiver une autre règle.
Manuel et Auto
Arrêter l’automatisation d’un emplacement avec un seul interrupteur
Chaque actif et chaque appareil a un mode, et Auto est le mode par défaut. En Manuel, chaque règle dont le lieu d’origine se trouve à cet emplacement s’arrête, les exécutions en cours s’arrêtent à leur prochaine étape, et aucune règle, d’où qu’elle vienne, n’envoie de commande ni de réglage à ses appareils. Un emplacement est en Manuel lorsque lui-même, ou un actif situé au-dessus de lui, l’est.
- Manuel jusqu’à : 30 minutes, 1 heure, 4 heures, une heure précise ou indéfiniment ; la personne qui l’a réglé est informée du retour en Auto
- Continue de fonctionner en Manuel : une règle ne comportant que des actions de notification et d’alarme peut continuer à s’exécuter, afin que les avis de sécurité soient toujours envoyés
- Le retour en Auto liste les règles dont les déclencheurs sont vrais maintenant, et peut les exécuter une fois à partir des valeurs actuelles
- Chaque changement d’interrupteur est journalisé et envoyé sous forme d’événement webhook
rules.mode_changed
Le mode Manuel s’applique aux règles des cartes Règles. Les règles d’alarme sur les profils d’appareil sont un outil distinct.
Limites d’une règle
- Une action sur un type d’appareil s’exécute une fois pour chaque appareil de ce type dans l’emplacement, jusqu’à 200 appareils
- Une attente dure au plus 24 heures ; une minuterie de maintien au plus 24 heures, et elle survit à un redémarrage
- Les règles comparent à des valeurs fixes. Les limites propres à chaque appareil relèvent des règles d’alarme, qui peuvent lire un attribut d’appareil comme seuil
- Une règle qui nomme un appareil supprimé passe à Action requise et reste arrêtée jusqu’à ce que quelqu’un la modifie
- Les règles ont leur propre limite de forfait et ne sont pas décomptées de vos flux
Flux
Flux avec versions et arrêt d’urgence
Le flux racine de votre organisation enregistre la télémétrie et les attributs, et exécute les règles d’alarme pour chaque message d’appareil. Les autres flux ajoutent tout traitement que vous pouvez dessiner sous forme de blocs. Chaque déploiement crée une nouvelle version vers laquelle vous pouvez revenir.
- Un exécuteur de tests avant le déploiement
- Pause automatique d’un flux qui échoue ou s’exécute trop souvent, avec une alerte
- Détection de boucles, limites de commandes par appareil et arrêt d’urgence
- Messages en échec conservés pour être rejoués ou supprimés
Blocs de flux
Blocs pour les tâches courantes
Chaque bloc dispose de sa propre aide dans l’éditeur. Les flux s’exportent et s’importent sous forme de fichiers, et des modèles vous donnent un point de départ.
Planifications et webhooks
Démarrez un flux chaque jour, selon une expression cron, au lever ou au coucher du soleil, ou lorsqu’un système externe appelle l’adresse du flux.
Compteurs et statistiques
Écarts d’un compteur, avec gestion des redémarrages ; comptages sur une fenêtre ; et comptage, somme, moyenne, minimum, maximum et taux sur un nombre de messages ou sur jusqu’à 7 jours.
Chiens de garde et bandes morte
Détecter une clé qui n’arrive plus, et ne transmettre que les changements supérieurs à une bande morte, en valeur ou en pourcentage.
Enrichir et stocker
Ajouter les champs et attributs de l’appareil, les entités liées ou les dernières valeurs, et stocker les clés dérivées comme télémétrie de l’appareil du message.
Systèmes externes
Requêtes HTTP avec jetons porteurs ou identifiants client OAuth2, avec blocage des adresses privées ; MQTT sortant vers d’autres brokers ; avis par e-mail avec pièces jointes.
Alarmes et commandes
Lever, effacer et acquitter des alarmes avec le cycle de vie habituel, et envoyer des commandes du catalogue à l’appareil du message.
FAQ
Questions sur les règles et les flux
Faut-il écrire du code ?
Non. Les règles d’alarme et les règles des cartes Règles sont des formulaires. Les flux se dessinent à partir de blocs ; un bloc script est là pour les cas que les blocs ne couvrent pas.
Que se passe-t-il pour l’automatisation pendant que quelqu’un intervient sur site ?
Passez l’emplacement en Manuel. Ses règles s’arrêtent, et aucune règle n’envoie de commandes ou de réglages à ses appareils tant qu’il n’est pas repassé en Auto. Les règles de notification seule marquées Continue de fonctionner en Manuel continuent de fonctionner.
Une règle peut-elle faire monter une alarme que personne n’a acquittée ?
Pas en tant que condition de règle : la vérification d’alarme active ne distingue pas les alarmes acquittées des autres. Utilisez plutôt le rappel répété de la règle d’alarme et ses niveaux de gravité ; une hausse de gravité renvoie une notification.
Chaque appareil peut-il avoir sa propre limite ?
Dans les règles d’alarme, oui : le seuil peut être un attribut d’appareil comme max_temp. Les règles des cartes Règles comparent à des valeurs fixes, et une règle cible un appareil ou chaque appareil d’un profil dans son emplacement ; utilisez donc des profils séparés lorsque les appareils doivent se comporter différemment.
Les flux peuvent-ils atteindre nos autres systèmes ?
Oui : requêtes HTTP, MQTT sortant, et flux démarrés par un appel webhook. Les webhooks sortants signés signalent aussi les événements d’appareil, d’alarme, de commande, de micrologiciel et de règle.
Vous automatisez un site ?
Dites-nous ce qui doit se passer et quand. Nous vous indiquons si une règle, une alarme ou un flux convient, et nous configurons la première avec vous.