Une alarme hors ligne vous indique qu’un appareil a cessé de communiquer. Il s’agit d’une règle d’alarme distincte sur le profil d’appareil, la règle Appareil hors ligne, avec le type fixe device_offline. Le fait qu’un appareil soit considéré comme en ligne est déterminé par la règle de statut en ligne du profil ; l’alarme ne fait que réagir à celle-ci.
Ajouter la règle
- Ouvrez Device Profiles, ouvrez le profil, puis l’onglet Alarm rules.
- Cliquez sur Add rule > Device offline rule.
- Définissez Open after (seconds offline) (10 à 604 800 ; par défaut 600), la Severity (par défaut Warning), le Alarm title (par défaut
{{device.name}} is offline) et un Runbook. - Cliquez sur Add to list, puis sur Save rules.
Un profil ne peut comporter qu’une seule règle Appareil hors ligne au maximum.
{
"type": "device_offline",
"title": "{{device.name}} is offline",
"inactivity": { "afterSec": 900, "severity": "MAJOR" },
"notify": { "recipients": [ { "kind": "role", "role": "ADMIN" } ] },
"runbook": "Check power and the network at the site. The device's Log tab shows the last disconnect reason.",
"enabled": true
}Le titre peut utiliser {{device.name}}, {{severity}} et {{type}}.
Quand elle s’ouvre
Deux événements ouvrent l’alarme :
| Événement | Moment d’ouverture de l’alarme |
|---|---|
| L’appareil passe hors ligne selon la règle de statut en ligne du profil (une déconnexion, un dépassement du délai de keepalive, ou la fin de la fenêtre Recent message) | Open after (seconds offline) plus tard, si l’appareil n’est pas revenu entre-temps. |
| L’appareil devient silencieux : il n’a rien envoyé pendant le délai Inactivity timeout (seconds) du profil | Immédiatement. Le délai d’inactivité a déjà été écoulé. |
Le délai est vérifié toutes les quelques secondes, de sorte que l’alarme s’ouvre à environ 5 secondes près de son échéance. La vérification du silence s’exécute une fois par minute.
Quand elle se désactive
L’alarme se désactive automatiquement lorsque l’appareil repasse en ligne (il se connecte) ou redevient actif après une période de silence (il envoie quelque chose). Sa vérification en attente est annulée au même moment.
Articulation avec la règle de statut en ligne
| Paramètre du profil (onglet Online status) | Effet sur l’alarme hors ligne |
|---|---|
| Live connection | Hors ligne lorsque la session MQTT se termine. L’alarme s’ouvre afterSec plus tard. Les reconnexions brèves, plus courtes que afterSec, ne l’ouvrent jamais. |
| Recent message | Hors ligne lorsque rien n’est arrivé pendant Expected interval × Factor. L’alarme s’ouvre afterSec après ce délai, donc le silence total avant l’alarme vaut intervalle × facteur + afterSec. |
| Last seen only | Jamais hors ligne. Seule la vérification du silence (délai d’inactivité) peut ouvrir l’alarme. |
| Inactivity timeout (seconds) | Par défaut 600 (10 à 604 800). Lorsque ce délai s’écoule sans activité, l’alarme s’ouvre immédiatement. |
Voir Connection status and activity et Device profiles.
Choisir les durées
- Pour un appareil en Live connection susceptible de perdre sa session brièvement (réseaux mobiles), réglez afterSec plus long qu’une reconnexion normale, par exemple de 300 à 900.
- Pour un appareil qui transmet toutes les heures en Recent message, un intervalle de 3 600 × facteur 2 plus afterSec de 600 signifie que l’alarme s’ouvre 2 heures et 10 minutes après le dernier message.
- Si vous voulez que l’alarme se déclenche exactement lorsqu’un appareil manque ses transmissions, gardez l’Inactivity timeout un peu plus long que l’intervalle de transmission : la vérification du silence ouvre alors l’alarme immédiatement.
Ce qu’elle ne fait pas
- Elle n’examine pas le contenu des données de télémétrie. Un appareil qui reste connecté mais n’envoie que des données vides ou erronées n’est pas hors ligne. Utilisez une règle de seuil ou un watchdog de flux pour ce cas.
- Une message de déconnexion ou de silence arrivant en retard (après une panne du traitement de la plateforme) n’est pas évalué ; le décompte part de maintenant.
- Mettre l’appareil en sourdine arrête les notifications, pas l’alarme. Voir Muting a device for maintenance.
Notifications
La règle hors ligne possède le même bloc notify que les règles de seuil : destinataires, canaux, gravité minimale et rappels. Voir Alarm notifications in depth.
Alarmes hors ligne depuis la carte Rules
La carte Rules possède son propre déclencheur A device connects or disconnects avec goes offline et goes quiet. Utilisez-le lorsque vous voulez déclencher une action (envoyer une commande à une unité de secours, prévenir une équipe) plutôt qu’ouvrir une alarme. La règle prête à l’emploi Tell people when a device stays offline attend 10 minutes et n’informe les administrateurs que si l’appareil est toujours hors ligne. Voir Rules card cookbook.