Alarme – Hermetry

Ein Alarm zeigt an, dass mit einem Gerät etwas nicht stimmt. Er hat einen Typ (zum Beispiel high_temperature), eine Schwere, einen Status, einen Titel, das Gerät, zu dem er gehört, und eine Zeitleiste aller Ereignisse, die ihn betroffen haben. Alarme werden durch die Alarmregeln eines Geräteprofils, durch eine Regel der Rules-Karte, durch einen Flow-Block geöffnet und durch dieselben Quellen oder durch eine Person geschlossen.

Schweregrade

Von der höchsten zur niedrigsten Stufe. Die Oberfläche zeigt die Bezeichnung; die API und die Alarmregeln verwenden den Code.

Code	Bezeichnung	Typische Verwendung
`CRITICAL`	Kritisch	Unmittelbare Gefahr oder Verlust. Jetzt handeln.
`MAJOR`	Major	Ernsthafte Störung. Bald handeln.
`MINOR`	Minor	Eine Störung mit begrenzter Auswirkung.
`WARNING`	Warnung	Etwas driftet in Richtung einer Störung.
`INFO`	Info	Wissenswert; keine Maßnahme nötig.

Es gibt genau fünf. Benachrichtigungen behandeln CRITICAL besonders: Standardmäßig erreicht sie Personen auch dann, wenn diese diese Art von Benachrichtigung deaktiviert haben. Siehe Alarmbenachrichtigungen im Detail.

Status und Lebenszyklus

Status	Bezeichnung	Bedeutung
`OPEN`	Offen	Die Bedingung ist erfüllt und noch niemand hat den Alarm übernommen.
`ACKNOWLEDGED`	Quittiert	Jemand hat ihn gesehen und kümmert sich darum. Die Bedingung kann noch immer erfüllt sein.
`RESOLVED`	Behoben	Abgeschlossen. Ein behobener Alarm wird nie wieder geöffnet; ein neues Auftreten erzeugt einen neuen Alarm.

(no alarm) --condition true--> OPEN
OPEN --someone acknowledges--> ACKNOWLEDGED
OPEN or ACKNOWLEDGED --condition clears--> RESOLVED (automatically)
OPEN or ACKNOWLEDGED --someone clears it--> RESOLVED (by hand)

Regeln des Lebenszyklus:

Ein aktiver Alarm pro Gerät und Typ. Tritt die Bedingung erneut ein, während der Alarm offen oder quittiert ist, zählt Hermetry ein weiteres Auftreten, statt einen zweiten Alarm zu erzeugen. Die Alarmseite zeigt Ausgelöst n-mal.
Die Schwere folgt der höchsten erfüllten Bedingung. Sie steigt, wenn eine höhere Bedingung erfüllt wird, und sinkt erst, wenn die höhere Bedingung nicht mehr erfüllt ist. Siehe Alarmregeln auf Geräteprofilen.
Eskalation wird erneut gemeldet. Ein Anstieg der Schwere wird benachrichtigt, auch wenn der Alarm quittiert war. Ein Absinken nicht.
Manuelles Beheben hält. Wenn Sie einen Alarm schließen, während seine Bedingung noch erfüllt ist, öffnet ihn die Regel nicht erneut, bis die Bedingung mindestens einmal nicht mehr erfüllt war. Die Zeitleiste zeigt einmalig Wiedereröffnung nach manuellem Schließen zurückgehalten.
Alarme können nicht verriegelt werden. Es gibt keine Option „muss quittiert werden, bevor er geschlossen werden kann“. Ein Alarm, dessen Bedingung nicht mehr erfüllt ist, wird behoben, auch wenn ihn niemand quittiert hat. Um diese zu prüfen, filtern Sie die Alarmseite nach Behoben und suchen Sie nach Zeilen ohne Quittierung in ihrer Zeitleiste.
Flattern. Öffnet und schließt sich ein Alarm zu oft, wird sein Schließen zurückgehalten und er wird als Flattern markiert. Siehe Entprellung, Hysterese und Dämpfung.
Nachträglich erfasst. Ein Alarm, der aus verspätet eingetroffenen Messwerten (nach einem Ausfall) geöffnet wurde, trägt das Abzeichen Nachträglich erfasst und ist nach den Messwerten datiert. Siehe Abschlussbedingungen und verspätete Messwerte.

Was einen Alarm behebt

Ursache	Erfasst als
Die Bedingung seiner Regel ist nicht mehr erfüllt (oder seine Abschlussbedingung ist erfüllt)	Durch die Regel geschlossen
Der Block Alarm schließen eines Flows oder eine Aktion Alarm auslösen oder schließen der Rules-Karte	Durch einen Flow geändert
Eine Person hat auf Schließen geklickt	Von Hand geschlossen, mit der Person und der optionalen Notiz
Seine Alarmregel wurde aus dem Profil entfernt und die Regeln wurden gespeichert	Geschlossen, Regel gelöscht
Sein Gerät wurde gelöscht	Behoben, weil das Gerät nicht mehr existiert

Wo Alarme erscheinen

Alarme im IoT-Menü: die Liste aller Alarme Ihrer Organisation. Siehe Mit Alarmen arbeiten.
Der Reiter Alarme der Geräteseite: dieselbe Liste, für ein Gerät.
Die Glocke in der oberen Leiste: die neuesten offenen Alarme und ein Abzeichen, das alle offenen Alarme zählt. Siehe Die Glocke.
Dashboards: die Karte Alarmtabelle und Alarmzähler. Siehe Tabellen und Listen.
Standorte und Standortansichten, über die diesen zugeordneten Geräte.
Benachrichtigungen, Webhooks und Flows.

Berechtigungen

Aktion	Berechtigung	Standardrolle
Alarme und Alarmregeln ansehen	Alarme und Alarmregeln ansehen	Benutzer
Alarme quittieren und Notizen hinzufügen	Alarme quittieren und Notizen hinzufügen	Benutzer
Alarme von Hand schließen	Alarme von Hand beheben (schließen)	Administrator
Alarme eines Geräts stummschalten	Die Alarme eines Geräts stummschalten	Administrator
Alarmregeln ändern	Die Alarmregeln von Geräteprofilen bearbeiten	Administrator

Die Berechtigungen befinden sich in der Gruppe IoT Alarms. Ein Administrator kann sie anderen Rollen oder Gruppen zuweisen. Siehe Benutzer und Rollen.

Was protokolliert wird

Jede Quittierung und jedes Schließen durch eine Person schreibt einen Audit-Eintrag (wer, welcher Alarm, sein Typ und seine Schwere; niemals die Notiz).
Das Schließen eines CRITICAL-Alarms von Hand schreibt einen zusätzlichen Audit-Eintrag.
Jede Änderung an den Alarmregeln eines Profils ist ein Audit-Eintrag, und jede geänderte Regel erhält eine neue Version.
Stummschaltungen und das Aufheben von Stummschaltungen werden protokolliert.

Siehe Audit-Protokoll.

Verlauf und Aufbewahrung

Behobene Alarme samt ihren Zeitleisten und Notizen werden standardmäßig 365 Tage aufbewahrt und danach durch einen täglichen Durchlauf gelöscht. Ein Administrator legt dies unter Alarme > Zahnradsymbol (Alarmeinstellungen) > Behobene Alarme aufbewahren (Tage) fest. 0 bewahrt sie für immer auf. Offene und quittierte Alarme werden durch die Aufbewahrung nie gelöscht.

Webhook-Ereignisse

Ereignis	Gesendet, wenn
`alarm.created`	Ein Alarm wird geöffnet.
`alarm.acknowledged`	Jemand quittiert ihn.
`alarm.cleared`	Er wird behoben, durch seine Regel, einen Flow oder eine Person.

Eine Änderung der Schwere sendet kein Webhook-Ereignis. Siehe Webhooks.