Ersten Alarm einrichten

Alarmregeln gehören zu einem Geräteprofil, und jedes Gerät des Profils verwendet sie. Diese Seite fügt eine Regel hinzu: einen Alarm für hohe Temperatur, der nach drei Messwerten über 80 °C in Folge ausgelöst wird und sich löscht, wenn die Temperatur auf 77 °C oder darunter fällt. Danach wird die Regel getestet und eine Benachrichtigung hinzugefügt.

Was Sie benötigen

Die Rolle Admin oder höher (Berechtigung zur Verwaltung von Alarmregeln).
Ein Gerät, das temperature sendet. Siehe Erstes Gerät verbinden.

1. Alarmregeln des Profils öffnen

Öffnen Sie Device Profiles im IoT-Menü.
Öffnen Sie das Profil, das Ihr Gerät verwendet (bei einer neuen Organisation Default).
Wählen Sie den Tab Alarm rules („Wird für jede Nachricht der Geräte dieses Profils durch den Schritt Alarmregeln des Standard-Flows ausgewertet.“).

2. Regel hinzufügen

Wählen Sie Add rule und dann Threshold rule.
Füllen Sie das Formular aus:

Feld	Wert	Wirkung
Type	`high_temperature`	Der Name dieser Alarmart. Buchstaben, Ziffern und `_ . : -`, eindeutig im Profil. Ein Gerät hat höchstens einen offenen Alarm pro Typ.
Alarm title	`{{device.name}}: temperature {{value}} °C`	Der Text, den Personen sehen. `{{device.name}}`, `{{value}}`, `{{key}}`, `{{threshold}}`, `{{severity}}` und `{{type}}` werden ausgefüllt.
Severity	Major	Wie schwerwiegend er ist.
When: Key, Operator, Value	`temperature`, `>`, `80`	Die Bedingung. Der Wert kann auch `attribute:<name>` sein, um ein Limit zu verwenden, das auf jedem Gerät gespeichert ist.

Öffnen Sie Advanced und setzen Sie:

Feld	Wert	Wirkung
Count in	Readings in a row	Messwerte zählen, nicht Sekunden.
Raise after this many readings in a row	`3`	Ein einzelner Ausreißer löst den Alarm nicht aus.
Clear after this many readings in a row	`3`	Ein einzelner guter Messwert schließt ihn nicht.
Hysteresis (clear margin)	`3`	Der Alarm bleibt aktiv, solange die Temperatur über 77 liegt, daher wird er erst bei 77 oder darunter gelöscht.
Runbook	`Check the burner and the flue sensor.`	Wird der Person angezeigt, die den Alarm bearbeitet.

Wählen Sie Add to list und dann Save rules. Nichts wird angewendet, bis Sie speichern; der Tab zeigt an, wie viele Regeln geändert und nicht gespeichert sind.

Tipp

Wenn temperature nicht im Tab Telemetry keys des Profils deklariert ist, markiert das Formular es als Unknown key. Sie können trotzdem speichern; die Regel wird auf Geräten ausgelöst, die den Schlüssel senden.

3. Testen

Senden Sie drei Nachrichten in Folge mit einer Temperatur über 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

Nach der dritten Nachricht öffnet sich ein Alarm mit Severity Major und Status Open. Sie sehen ihn:

auf der Seite Alarms im IoT-Menü,
auf dem Tab Alarms des Geräts,
in der Glocke in der oberen Leiste.

Senden Sie dann drei Nachrichten mit 77 oder darunter. Der Alarm wird automatisch aufgelöst und zeigt Resolved an.

4. Personen informieren

Eine Regel benachrichtigt niemanden, bis Sie Empfänger hinzufügen. Das Formular zeigt die Benachrichtigungseinstellungen noch nicht an, daher fügen Sie sie als JSON hinzu:

Öffnen Sie die Regel erneut mit Edit und wechseln Sie von Form zu JSON.
Fügen Sie einen notify-Block neben den anderen Feldern hinzu:

"notify": {
  "recipients": [
    { "kind": "role", "role": "ADMIN" },
    { "kind": "email", "email": "maintenance@example.com" }
  ],
  "minSeverity": "MAJOR",
  "repeatEverySec": 3600
}

Wählen Sie Update the list und dann Save rules.

Feld	Bedeutung
`recipients`	1 bis 20 Einträge: ein Benutzer (`{"kind": "user", "userId": "…"}`), eine eingebaute Rolle (`OWNER`, `ADMIN` oder `USER`) oder eine E-Mail-Adresse.
`channels`	Optional: die zu verwendenden Kanäle, zum Beispiel `["inapp", "mail"]`. Wird es weggelassen, wird jeder Kanal verwendet, den der Empfänger erlaubt.

Mitglieder und Rollen werden in der App (der Glocke) und in verbundenen Chat-Apps erreicht. E-Mails gehen nur an die Adressen, die Sie als email-Empfänger angeben; fügen Sie daher einen Eintrag für jedes Postfach hinzu, das den Alarm erhalten soll. Siehe Alarm notifications in depth. | minSeverity | Optional: Unterhalb dieser Schwere wird der Alarm protokolliert, aber niemand wird benachrichtigt. | | repeatEverySec | Optional: eine Erinnerung, solange der Alarm offen und nicht bestätigt bleibt, 60 Sekunden bis 7 Tage. |

Hinweis

Standardmäßig erreicht ein Critical-Alarm seine Empfänger auch dann, wenn sie diese Art von Benachrichtigung stummgeschaltet haben. Ein Administrator kann dies unter Alarms > Alarm settings (Critical alarms ignore notification preferences) ändern.

Siehe Alarm notifications in depth für Alarmstürme, Zusammenfassungen und Wiederholungen.

5. Alarm bearbeiten

Jedes Mitglied kann einen Alarm mit Acknowledge bestätigen, optional mit einer Notiz („What did you do?“). Das manuelle Löschen (Clear) erfordert die Rolle Admin. Die meisten Alarme werden automatisch gelöscht, wenn die Bedingung endet. Siehe Working with alarms.

Außerdem nützlich

Ein Alarm, wenn ein Gerät still wird: Fügen Sie eine Device offline rule hinzu (Open after (seconds offline), 10 Sekunden bis 7 Tage). Siehe Offline alarms.
Ein anderer Grenzwert pro Gerät: Setzen Sie den Wert auf attribute:maxTemp und speichern Sie maxTemp als Serverattribut auf jedem Gerät. Siehe Attribute.
Ein Profil kann bis zu 50 Alarmregeln enthalten. Siehe Alarm rules on device profiles.

Nächster Schritt

Team einladen.