Configurer votre première alarme

Les règles d’alarme appartiennent à un profil d’appareil, et chaque appareil du profil les utilise. Cette page ajoute une règle : une alarme de température élevée qui s’ouvre après trois relevés consécutifs supérieurs à 80 °C et se ferme lorsque la température redescend à 77 °C ou moins. Elle teste ensuite la règle et ajoute une notification.

Ce dont vous avez besoin

Le rôle Admin ou supérieur (autorisation de gérer les règles d’alarme).
Un appareil qui envoie temperature. Voir Connecter votre premier appareil.

1. Ouvrir les règles d’alarme du profil

Ouvrez Device Profiles dans le menu IoT.
Ouvrez le profil utilisé par votre appareil (sur une nouvelle organisation, Default).
Sélectionnez l’onglet Alarm rules (« Évaluées pour chaque message des appareils de ce profil par l’étape alarm-rules du flux par défaut. »).

2. Ajouter la règle

Sélectionnez Add rule puis choisissez Threshold rule.
Remplissez le formulaire :

Champ	Valeur	Ce qu’il fait
Type	`high_temperature`	Le nom de ce type d’alarme. Lettres, chiffres et `_ . : -`, unique dans le profil. Un appareil a au plus une alarme ouverte par type.
Alarm title	`{{device.name}}: temperature {{value}} °C`	Le texte que voient les utilisateurs. `{{device.name}}`, `{{value}}`, `{{key}}`, `{{threshold}}`, `{{severity}}` et `{{type}}` sont remplacés.
Severity	Major	Le degré de gravité.
When : Key, Operator, Value	`temperature`, `>`, `80`	La condition. La valeur peut aussi être `attribute:<name>` pour utiliser une limite stockée sur chaque appareil.

Ouvrez Advanced et définissez :

Champ	Valeur	Ce qu’il fait
Count in	Readings in a row	Compte des échantillons, pas des secondes.
Raise after this many readings in a row	`3`	Un seul relevé isolé n’ouvre pas l’alarme.
Clear after this many readings in a row	`3`	Un seul bon relevé ne la ferme pas.
Hysteresis (clear margin)	`3`	L’alarme reste active tant que la température est supérieure à 77, donc elle ne se ferme qu’à 77 ou moins.
Runbook	`Check the burner and the flue sensor.`	Affiché à la personne qui traite l’alarme.

Sélectionnez Add to list, puis Save rules. Rien ne s’applique tant que vous n’avez pas enregistré ; l’onglet indique combien de règles sont modifiées et non enregistrées.

Astuce

Si temperature n’est pas déclaré dans l’onglet Telemetry keys du profil, le formulaire le marque Unknown key. Vous pouvez tout de même enregistrer ; la règle se déclenche sur les appareils qui envoient cette clé.

3. Tester

Envoyez trois messages consécutifs avec une température supérieure à 80 :

for t in 85 86 87; do
  mosquitto_pub -h <broker host> -p 8883 --capath /etc/ssl/certs \
    -u "<ACCESS_TOKEN>" -q 1 -t v1/telemetry -m "{\"temperature\": $t}"
done

Après le troisième message, une alarme s’ouvre avec la gravité Major et le statut Open. Vous la voyez :

sur la page Alarms du menu IoT,
dans l’onglet Alarms de l’appareil,
dans la cloche de la barre supérieure.

Envoyez ensuite trois messages à 77 ou moins. L’alarme est résolue automatiquement et affiche Resolved.

4. Prévenir les utilisateurs

Une règle n’informe personne tant que vous n’ajoutez pas de destinataires. Le formulaire n’affiche pas encore les paramètres de notification, donc ajoutez-les en JSON :

Rouvrez la règle avec Edit et passez de Form à JSON.
Ajoutez un bloc notify à côté des autres champs :

"notify": {
  "recipients": [
    { "kind": "role", "role": "ADMIN" },
    { "kind": "email", "email": "maintenance@example.com" }
  ],
  "minSeverity": "MAJOR",
  "repeatEverySec": 3600
}

Sélectionnez Update the list, puis Save rules.

Champ	Signification
`recipients`	De 1 à 20 entrées : un utilisateur (`{"kind": "user", "userId": "…"}`), un rôle intégré (`OWNER`, `ADMIN` ou `USER`), ou une adresse e-mail.
`channels`	Facultatif : les canaux à utiliser, par exemple `["inapp", "mail"]`. Si omis, tous les canaux autorisés par le destinataire sont utilisés.

Les membres et les rôles sont atteints dans l’application (la cloche) et dans les applications de chat liées. Les e-mails ne partent que vers les adresses listées comme destinataires email, donc ajoutez-en une pour chaque boîte qui doit recevoir l’alarme. Voir Alarm notifications in depth. | minSeverity | Facultatif : en dessous de cette gravité, l’alarme est enregistrée mais personne n’est prévenu. | | repeatEverySec | Facultatif : un rappel tant que l’alarme reste ouverte et non acquittée, de 60 secondes à 7 jours. |

Remarque

Par défaut, une alarme Critical atteint ses destinataires même s’ils ont désactivé ce type de notification. Un administrateur peut modifier ce comportement dans Alarms > Alarm settings (Critical alarms ignore notification preferences).

Voir Alarm notifications in depth pour les tempêtes, les récapitulatifs et les rappels.

5. Traiter l’alarme

Tout membre peut Acknowledge une alarme, éventuellement avec une note (« Qu’avez-vous fait ? »). La fermer manuellement (Clear) nécessite le rôle Admin. La plupart des alarmes se ferment d’elles-mêmes lorsque la condition cesse. Voir Working with alarms.

Également utile

Une alarme lorsqu’un appareil ne donne plus signe : ajoutez une Device offline rule (Open after (seconds offline), de 10 secondes à 7 jours). Voir Offline alarms.
Une limite différente par appareil : définissez la valeur sur attribute:maxTemp et stockez maxTemp comme attribut serveur sur chaque appareil. Voir Attributes.
Un profil peut contenir jusqu’à 50 règles d’alarme. Voir Alarm rules on device profiles.

Étape suivante

Invitez votre équipe.