Eine Alarmregel informiert Personen über ihren notify-Block. Ohne diesen wird der Alarm zwar erfasst und angezeigt, aber niemand wird benachrichtigt. Diese Seite behandelt den Block, wann Benachrichtigungen versendet werden und die organisationsweiten Einstellungen, die Menschen vor Alarmfluten schützen.
Der notify-Block
Der Block wird im JSON-Modus der Regel festgelegt (das Formular behält ihn bei, wenn Sie andere Felder bearbeiten). Schwellenwertregeln und die Regel „Gerät offline“ verwenden denselben Block.
"notify": {
"recipients": [
{ "kind": "role", "role": "ADMIN" },
{ "kind": "user", "userId": "6f1c2a9e-…" },
{ "kind": "email", "email": "oncall@example.com" }
],
"channels": ["inapp", "mail"],
"minSeverity": "MAJOR",
"repeatEverySec": 1800
}| Feld | Bedeutung | Grenzwerte |
|---|---|---|
recipients | Wer benachrichtigt wird. Im Block erforderlich. | 1 bis 20 Einträge |
channels | Auf diese Kanal-IDs beschränken. Fehlt das Feld: jeder Kanal, den jeder Empfänger erlaubt. | bis zu 8 |
minSeverity | Unterhalb dieser Schwere wird der Alarm erfasst, aber niemand wird benachrichtigt. Fehlt das Feld: jede Schwere. | eine Schwere |
repeatEverySec | Erinnerung, solange der Alarm Open ist und nicht bestätigt wurde. Fehlt das Feld: keine Erinnerungen. | 60 s bis 7 Tage |
Empfänger
| Art | Beispiel | Erreicht |
|---|---|---|
user | { "kind": "user", "userId": "…" } | Ein aktives Mitglied Ihrer Organisation. Ein Benutzer, der kein aktives Mitglied ist, wird übersprungen. |
role | { "kind": "role", "role": "OWNER" } | Jedes aktive Mitglied mit dieser eingebauten Rolle (OWNER, ADMIN, USER), ermittelt zum Zeitpunkt des Auslösens des Alarms. |
email | { "kind": "email", "email": "noc@example.com" } | Nur diese Adresse, zum Beispiel ein gemeinsames Bereitschafts-Postfach. Es gelten keine Einstellungen und keine Ruhezeiten. |
- Mitglieder und Rollen werden über die Glocke, per Push und in ihren verknüpften Chat-Apps erreicht. E-Mails gehen nur an
email-Empfänger: Fügen Sie die Adresse ausdrücklich hinzu, wenn Sie E-Mails wünschen. - Alarmregeln können keine Teams, benutzerdefinierten Rollen oder Telefonnummern angeben. Für SMS verwenden Sie einen Flow (siehe SMS-Benachrichtigungen).
- Eine Benachrichtigung erreicht nach dem Auflösen der Rollen höchstens 100 Personen; wer zweimal genannt wird, wird nur einmal benachrichtigt.
- Für IoT-Alarme gibt es keine Bereitschaftsrotationen oder Eskalationsketten. Verwenden Sie Rollen, Erinnerungen und den Anstieg der Schwere.
Kanäle
Kanal-IDs: inapp, mail, push, sms und eine ID pro verbundener Chat-Plattform. Die Angabe von sms hat für Alarmempfänger keine Wirkung, da sie in einer Regel keine Telefonnummer haben.
Wann Benachrichtigungen versendet werden
| Alarmänderung | Benachrichtigung | Titel |
|---|---|---|
| Geöffnet (nicht nachträglich gemeldet) | Ja, bei oder über minSeverity | „Severity-Alarm: title„ |
| Schwere gestiegen | Ja | „Eskaliert auf Severity: title„ |
| Schwere gesunken | Nein | |
| Erneut ausgelöst mit gleicher Schwere | Nein | |
| Bestätigt | Nein | |
| Behoben | Ja, wenn seine Öffnung gemeldet wurde | „Behoben: title“ („… behoben nach n Min.“) |
| Noch offen und nicht bestätigt | Eine Erinnerung alle repeatEverySec | „Noch offen: title„ |
| Geöffnet aus verspäteten Messwerten | Nicht sofort; einmal gemeldet, wenn er beim Eintreffen der Live-Daten noch offen ist | wie Geöffnet |
| Gerät stummgeschaltet | Nein; die Zeitleiste zeigt Stummgeschaltet: niemand wurde benachrichtigt |
Erinnerungen enden, sobald jemand den Alarm bestätigt oder behebt. Die erste Erinnerung kommt repeatEverySec nach dem Öffnen des Alarms.
Jede versendete Benachrichtigung fügt der Zeitleiste des Alarms eine Zeile Benachrichtigt hinzu, mit der Anzahl der Empfänger und den Kanälen.
Filter in dieser Reihenfolge
- Mindestschwere: darunter geschieht nichts.
- Stummschaltung: ein stummgeschaltetes Gerät benachrichtigt niemanden. Siehe Gerät für Wartung stummschalten.
- Wiederholungsfenster: dieselbe Änderung desselben Alarmzustands auf demselben Gerät (geöffnet, behoben, auf eine bestimmte Schwere eskaliert, eine bestimmte Erinnerung) wird höchstens einmal pro Fenster gemeldet, standardmäßig 300 Sekunden. So löst ein flackerndes Gerät nicht bei jedem Zyklus einen Alarm aus, auch wenn jedes erneute Öffnen ein neuer Alarm ist. Zurückgehaltene Benachrichtigungen zeigen Benachrichtigung zurückgehalten (Drosselung) in der Zeitleiste.
- Sturmschutz: siehe unten.
- Kanäle und Einstellungen jedes Empfängers: siehe Ihre Benachrichtigungseinstellungen.
Alarmstürme
Wenn viele Alarme gleichzeitig auslösen (ein Standort verliert Strom, ein Netzwerk fällt aus), würden einzelne Benachrichtigungen die wichtigen unter sich begraben.
- Die Organisation sendet höchstens 20 Alarmbenachrichtigungen pro Minute einzeln (der Sturmschwellenwert).
- Darüber hinaus werden Alarmbenachrichtigungen in einer Zusammenfassung gesammelt. Fünf Minuten nach der ersten gesammelten Benachrichtigung erhält jede Person, die sonst benachrichtigt worden wäre, eine Zusammenfassung: Titel „n neue Alarme“, Text „n neue Alarme: 12 CRITICAL, 25 MAJOR.“, mit einem Link zu den offenen Alarmen.
- CRITICAL-Alarme werden auch während eines Sturms einzeln versendet, bis zu 60 pro Minute; darüber hinaus werden auch sie in die Zusammenfassung aufgenommen.
- Eine Zusammenfassung, die einen kritischen Alarm enthält, wird als kritisch gesendet.
Die Umgehung für kritische Alarme
Bei aktivierter Option Kritische Alarme ignorieren Benachrichtigungseinstellungen (Standard) erreicht eine Benachrichtigung zu einem CRITICAL-Alarm (sowie seine Erinnerungen, Eskalation und Behebung) die Empfänger auch dann, wenn sie diesen Kanal ausgeschaltet haben oder sich in Ruhezeiten befinden. Sie erreicht keine Kanäle, die die Organisation abgeschaltet hat, gesperrte Adressen oder Kanäle ohne Adresse. Die organisationsweite Umgehung für kritische Alarme des Benachrichtigungsdienstes muss ebenfalls aktiviert sein (das ist sie standardmäßig).
Alarmeinstellungen
Administratoren öffnen Alarme > Zahnradsymbol > Alarmeinstellungen („Benachrichtigungsstürme, Wiederholungen und wie lange behobene Alarme aufbewahrt werden“):
| Gruppe | Einstellung | Standard | Bereich |
|---|---|---|---|
| Benachrichtigungen | Kritische Alarme ignorieren Benachrichtigungseinstellungen | Ein | |
| Benachrichtigungen | Wiederholungsfenster (Sekunden) | 300 | 60 bis 86.400 |
| Alarmstürme | Sturmschwellenwert (pro Minute) | 20 | 1 bis 10.000 |
| Alarmstürme | Während eines Sturms gesendete kritische Alarme (pro Minute) | 60 | 1 bis 10.000 |
| Verlauf | Behobene Alarme behalten (Tage) | 365 | 0 (unbegrenzt) bis 36.500 |
Änderungen werden protokolliert und wirken innerhalb von etwa einer Minute. Die Seite benötigt das Recht, Organisationseinstellungen zu lesen; zum Speichern wird das Recht benötigt, sie zu ändern.
Flow-Alarme
Alarme, die über den Block Alarm auslösen eines Flows ausgelöst werden, verwenden die eigenen Einstellungen des Blocks: notify_to (Benutzer-IDs, E-Mail-Adressen, OWNER / ADMIN / USER), notify_channels, notify_min_severity und notify_repeat_sec. Sie durchlaufen dieselben Filter. Alarme, die durch eine Aktion der Regelkarte ausgelöst werden, haben keinen notify-Block; verwenden Sie daneben eine Aktion Personen informieren. Siehe Benachrichtigungen aus Regeln und Flows.
Rezepte
| Bedarf | Block |
|---|---|
| Administratoren ab Major, Erinnerungen alle 30 Minuten | { "recipients": [ { "kind": "role", "role": "ADMIN" } ], "minSeverity": "MAJOR", "repeatEverySec": 1800 } |
| Ein gemeinsames Postfach für alles | { "recipients": [ { "kind": "email", "email": "alarms@example.com" } ] } |
| Owner nur in der Glocke | { "recipients": [ { "kind": "role", "role": "OWNER" } ], "channels": ["inapp"] } |
| Nur kritisch, an das ganze Team | { "recipients": [ { "kind": "role", "role": "USER" }, { "kind": "role", "role": "ADMIN" } ], "minSeverity": "CRITICAL" } |