Les règles d’alarme sont rattachées à 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.
De quoi avez-vous besoin
- Le rôle Admin ou supérieur (autorisation de gérer les règles d’alarme).
- Un appareil qui envoie
temperature. Voir Connect your first device.
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ée 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 | Rôle |
|---|---|---|
| Type | high_temperature | Le nom de ce type d’alarme. Lettres, chiffres et _ . : -, unique dans le profil. Un appareil ne peut avoir qu’une alarme ouverte par type au maximum. |
| Alarm title | {{device.name}}: temperature {{value}} °C | Le texte affiché aux utilisateurs. {{device.name}}, {{value}}, {{key}}, {{threshold}}, {{severity}} et {{type}} sont remplacés automatiquement. |
| Severity | Major | Le niveau 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 | Rôle |
|---|---|---|
| Count in | Readings in a row | Compte les échantillons, pas les 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 ferme pas l’alarme. |
| Hysteresis (clear margin) | 3 | L’alarme reste active tant que la température est supérieure à 77 ; 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 le nombre de règles modifiées et non enregistrées.
Astuce
Si temperature n’est pas déclaré dans l’onglet Telemetry keys du profil, le formulaire la 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 la règle
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 personnes
Une règle ne notifie personne tant que vous n’ajoutez pas de destinataires. 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. |
minSeverity | Facultatif : en dessous de ce niveau de 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. |
Les membres et les rôles sont atteints dans l’application (la cloche), par notification push et dans les applications de messagerie liées. Les e-mails ne sont envoyés qu’aux adresses que vous listez comme destinataires email, donc ajoutez-en une pour chaque boîte de réception qui doit recevoir l’alarme. Voir Notifications d’alarme en détail.
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 sous Alarms > Alarm settings (Critical alarms ignore notification preferences).
Voir Alarm notifications in depth pour les tempêtes, les récapitulatifs et les répétitions.
5. Traiter l’alarme
Tout membre peut Acknowledge une alarme, avec une note facultative (« What did you do? »). La fermer manuellement (Clear) requiert le rôle Admin. La plupart des alarmes se ferment d’elles-mêmes lorsque la condition cesse. Voir Working with alarms.
À voir aussi
- Une alarme lorsqu’un appareil ne répond plus : ajoutez une Device offline rule (Open after (seconds offline), de 10 secondes à 7 jours). Voir Offline alarms.
- Une limite différente par appareil : réglez la valeur sur
attribute:maxTempet stockezmaxTempcomme attribut serveur sur chaque appareil. Voir Attributes. - Un profil peut contenir jusqu’à 50 règles d’alarme. Voir Alarm rules on device profiles.

