Ein Offline-Alarm meldet, dass ein Gerät nicht mehr sendet. Er ist eine eigene Alarmregel im Geräteprofil, die Device offline rule, mit dem festen Typ device_offline. Ob ein Gerät als online gilt, entscheidet die Online-Regel des Profils; der Alarm reagiert nur darauf.
Regel hinzufügen
- Öffnen Sie Device Profiles, dann das Profil und anschließend den Reiter Alarm rules.
- Klicken Sie auf Add rule > Device offline rule.
- Legen Sie Open after (seconds offline) fest (10 bis 604,800; Standard 600), den Severity (Standard Warning), den Alarm title (Standard
{{device.name}} is offline) und ein Runbook. - Klicken Sie auf Add to list und danach auf Save rules.
Ein Profil hat höchstens eine Device-offline-Regel.
{
"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
}Der Titel darf {{device.name}}, {{severity}} und {{type}} verwenden.
Wann er auslöst
Zwei Ereignisse lösen den Alarm aus:
| Ereignis | Wann der Alarm auslöst |
|---|---|
| Das Gerät wird offline laut der Online-Regel des Profils (eine Trennung, ein Keepalive-Timeout oder das Ende des Fensters Recent message) | Open after (seconds offline) später, wenn sich das Gerät in der Zwischenzeit nicht wieder gemeldet hat. |
| Das Gerät wird ruhig: Es hat für die Inactivity timeout (seconds) des Profils nichts gesendet | Sofort. Das Inaktivitäts-Timeout hat bereits gewartet. |
Die Verzögerung wird alle paar Sekunden geprüft, daher öffnet sich der Alarm innerhalb von etwa 5 Sekunden nach seinem Fälligkeitszeitpunkt. Die Prüfung auf Ruhe läuft einmal pro Minute.
Wann er sich schließt
Der Alarm schließt sich automatisch, wenn das Gerät wieder comes online (verbindet sich) oder nach einer Ruhephase wieder active wird (etwas sendet). Die ausstehende Prüfung wird im selben Moment abgebrochen.
Zusammenspiel mit der Online-Regel
| Profileinstellung (Reiter Online status) | Auswirkung auf den Offline-Alarm |
|---|---|
| Live connection | Offline, wenn die MQTT-Sitzung endet. Der Alarm öffnet sich afterSec später. Kurze Wiederverbindungen, die kürzer als afterSec sind, lösen ihn nie aus. |
| Recent message | Offline, wenn für Expected interval × Factor nichts eingegangen ist. Der Alarm öffnet sich afterSec danach, daher beträgt die gesamte Stille vor dem Alarm Intervall × Faktor + afterSec. |
| Last seen only | Nie offline. Nur die Prüfung auf Ruhe (Inaktivitäts-Timeout) kann den Alarm auslösen. |
| Inactivity timeout (seconds) | Standard 600 (10 bis 604,800). Wenn diese Zeit ohne Aktivität verstreicht, öffnet sich der Alarm sofort. |
Siehe Connection status and activity und Device profiles.
Die Zeiten wählen
- Für ein Gerät mit Live connection, das seine Sitzung kurzzeitig verlieren kann (Mobilfunknetze), setzen Sie afterSec länger als eine normale Wiederverbindung, zum Beispiel 300 bis 900.
- Für ein Gerät, das stündlich auf Recent message meldet, bedeutet Intervall 3,600 × Faktor 2 plus afterSec 600, dass sich der Alarm 2 Stunden und 10 Minuten nach der letzten Nachricht öffnet.
- Wenn der Alarm genau dann auslösen soll, wenn ein Gerät seine Meldungen verpasst, halten Sie das Inactivity timeout etwas länger als das Meldeintervall: Die Prüfung auf Ruhe öffnet den Alarm sofort.
Was er nicht tut
- Er prüft keine Telemetrieinhalte. Ein Gerät, das verbunden bleibt, aber nur leere oder falsche Daten sendet, gilt nicht als offline. Dafür verwenden Sie eine Schwellenwertregel oder einen Flow-Watchdog.
- Eine Trennungs- oder Ruhemeldung, die verspätet eintrifft (nach einem Ausfall der Verarbeitung der Plattform), wird nicht ausgewertet; die Prüfung zählt ab jetzt.
- Das Stummschalten eines Geräts unterdrückt die Benachrichtigungen, nicht den Alarm. Siehe Muting a device for maintenance.
Benachrichtigungen
Die Offline-Regel hat denselben notify-Block wie Schwellenwertregeln: Empfänger, Kanäle, minimale Severity und Erinnerungen. Siehe Alarm notifications in depth.
Offline-Alarme aus der Rules-Karte
Die Rules-Karte hat einen eigenen Auslöser A device connects or disconnects mit goes offline und goes quiet. Verwenden Sie ihn, wenn Sie etwas auslösen möchten (einen Befehl an ein Ersatzgerät senden, ein Team informieren), statt einen Alarm zu öffnen. Die fertige Regel Tell people when a device stays offline wartet 10 Minuten und informiert die Administratoren nur, wenn das Gerät immer noch offline ist. Siehe Rules card cookbook.