Alarmregeln gehören zu einem Gerätprofil, und jedes Gerät des Profils verwendet sie. Diese Seite fügt eine Regel hinzu: einen Hochtemperaturalarm, der nach drei Messwerten über 80 °C in Folge ausgelöst wird und sich löst, sobald die Temperatur auf 77 °C oder darunter fällt. Anschließend testet sie die Regel und fügt eine Benachrichtigung hinzu.
Was Sie benötigen
- Die Rolle Admin oder höher (Berechtigung zur Verwaltung von Alarmregeln).
- Ein Gerät, das
temperaturesendet. Siehe Connect your first device.
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 Reiter Alarm rules („Evaluated for every message of this profile’s devices by the alarm-rules step of the default flow.“).
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 automatisch ausgefüllt. |
| Severity | Major | Wie schwerwiegend er ist. |
| When: Key, Operator, Value | temperature, >, 80 | Die Bedingung. Der Wert kann auch attribute:<name> sein, um einen auf jedem Gerät gespeicherten Grenzwert zu verwenden. |
- Öffnen Sie Advanced und setzen Sie:
| Feld | Wert | Wirkung |
|---|---|---|
| Count in | Readings in a row | Zählt Messwerte, 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, sodass er erst bei 77 oder darunter gelöst wird. |
| 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, bevor Sie speichern; der Reiter zeigt an, wie viele Regeln geändert, aber nicht gespeichert sind.
Tipp
Ist temperature nicht im Reiter Telemetry keys des Profils deklariert, markiert das Formular es als Unknown key. Sie können trotzdem speichern; die Regel greift bei Geräten, 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ü,
- im Reiter Alarms des Geräts,
- in der Glocke in der oberen Leiste.
Senden Sie danach 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. Fügen Sie sie als JSON hinzu:
- Öffnen Sie die Regel erneut mit Edit und wechseln Sie von Form zu JSON.
- Fügen Sie neben den übrigen Feldern einen Block
notifyhinzu:
"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 integrierte Rolle (OWNER, ADMIN oder USER) oder eine E-Mail-Adresse. |
channels | Optional: die zu verwendenden Kanäle, zum Beispiel ["inapp", "mail"]. Wird er weggelassen, werden alle Kanäle verwendet, die der Empfänger erlaubt. |
minSeverity | Optional: Unterhalb dieser Schwere wird der Alarm zwar erfasst, aber niemand benachrichtigt. |
repeatEverySec | Optional: eine Erinnerung, solange der Alarm offen und nicht bestätigt ist, 60 Sekunden bis 7 Tage. |
Mitglieder und Rollen werden in der App erreicht (die Glocke), per Push und in verknüpften Chat-Apps. E-Mail geht nur an die Adressen, die Sie als email-Empfänger eintragen. Fügen Sie daher für jedes Postfach, das den Alarm erhalten soll, eine hinzu. Siehe Alarmbenachrichtigungen im Detail.
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 ändern (Critical alarms ignore notification preferences).
Zu Alarmsturm, Zusammenfassungen und Wiederholungen siehe Alarm notifications in depth.
5. Alarm bearbeiten
Jedes Mitglied kann einen Alarm mit Acknowledge bestätigen, optional mit einer Notiz („What did you do?“). Das manuelle Schließen (Clear) erfordert die Rolle Admin. Die meisten Alarme werden automatisch gelöst, sobald 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 eigener Grenzwert pro Gerät: Setzen Sie den Wert auf
attribute:maxTempund speichern SiemaxTempals Server-Attribut auf jedem Gerät. Siehe Attributes. - Ein Profil kann bis zu 50 Alarmregeln enthalten. Siehe Alarm rules on device profiles.

