Nouveau : le pare-feu IA surveille toute la plateforme et explique chaque incident en termes simples. Découvrez comment ça marche

Configurez votre première alarme

Ajoutez une règle d'alarme à seuil à un profil d'appareil, testez-la avec quelques messages et ajoutez des destinataires pour que les bonnes personnes soient prévenues.

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

  1. Ouvrez Device Profiles dans le menu IoT.
  2. Ouvrez le profil utilisé par votre appareil (sur une nouvelle organisation, Default).
  3. 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

  1. Sélectionnez Add rule puis choisissez Threshold rule.
  2. Remplissez le formulaire :
ChampValeurRôle
Typehigh_temperatureLe 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}} °CLe texte affiché aux utilisateurs. {{device.name}}, {{value}}, {{key}}, {{threshold}}, {{severity}} et {{type}} sont remplacés automatiquement.
SeverityMajorLe niveau de gravité.
When : Key, Operator, Valuetemperature, >, 80La condition. La valeur peut aussi être attribute:<name> pour utiliser une limite stockée sur chaque appareil.
  1. Ouvrez Advanced et définissez :
ChampValeurRôle
Count inReadings in a rowCompte les échantillons, pas les secondes.
Raise after this many readings in a row3Un seul relevé isolé n’ouvre pas l’alarme.
Clear after this many readings in a row3Un seul bon relevé ne ferme pas l’alarme.
Hysteresis (clear margin)3L’alarme reste active tant que la température est supérieure à 77 ; elle ne se ferme qu’à 77 ou moins.
RunbookCheck the burner and the flue sensor.Affiché à la personne qui traite l’alarme.
  1. 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 :

  1. Rouvrez la règle avec Edit et passez de Form à JSON.
  2. 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
}
  1. Sélectionnez Update the list, puis Save rules.
ChampSignification
recipientsDe 1 à 20 entrées : un utilisateur ({"kind": "user", "userId": "…"}), un rôle intégré (OWNER, ADMIN ou USER), ou une adresse e-mail.
channelsFacultatif : les canaux à utiliser, par exemple ["inapp", "mail"]. Si omis, tous les canaux autorisés par le destinataire sont utilisés.
minSeverityFacultatif : en dessous de ce niveau de gravité, l’alarme est enregistrée mais personne n’est prévenu.
repeatEverySecFacultatif : 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: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

Invite your team.