Neu: Die KI-Firewall überwacht die gesamte Plattform und erklärt jeden Vorfall in einfachen Worten. So funktioniert es

Ersten Alarm einrichten

Fügen Sie einem Geräteprofil eine Schwellenwert-Alarmregel hinzu, testen Sie sie mit einigen Nachrichten und fügen Sie Empfänger hinzu, damit die richtigen Personen informiert werden.

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 temperature sendet. Siehe Connect your first device.

1. Alarmregeln des Profils öffnen

  1. Öffnen Sie Device Profiles im IoT-Menü.
  2. Öffnen Sie das Profil, das Ihr Gerät verwendet (bei einer neuen Organisation Default).
  3. 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

  1. Wählen Sie Add rule und dann Threshold rule.
  2. Füllen Sie das Formular aus:
FeldWertWirkung
Typehigh_temperatureDer 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}} °CDer Text, den Personen sehen. {{device.name}}, {{value}}, {{key}}, {{threshold}}, {{severity}} und {{type}} werden automatisch ausgefüllt.
SeverityMajorWie schwerwiegend er ist.
When: Key, Operator, Valuetemperature, >, 80Die Bedingung. Der Wert kann auch attribute:<name> sein, um einen auf jedem Gerät gespeicherten Grenzwert zu verwenden.
  1. Öffnen Sie Advanced und setzen Sie:
FeldWertWirkung
Count inReadings in a rowZählt Messwerte, nicht Sekunden.
Raise after this many readings in a row3Ein einzelner Ausreißer löst den Alarm nicht aus.
Clear after this many readings in a row3Ein einzelner guter Messwert schließt ihn nicht.
Hysteresis (clear margin)3Der Alarm bleibt aktiv, solange die Temperatur über 77 liegt, sodass er erst bei 77 oder darunter gelöst wird.
RunbookCheck the burner and the flue sensor.Wird der Person angezeigt, die den Alarm bearbeitet.
  1. 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:

  1. Öffnen Sie die Regel erneut mit Edit und wechseln Sie von Form zu JSON.
  2. Fügen Sie neben den übrigen Feldern einen Block notify hinzu:
"notify": {
  "recipients": [
    { "kind": "role", "role": "ADMIN" },
    { "kind": "email", "email": "maintenance@example.com" }
  ],
  "minSeverity": "MAJOR",
  "repeatEverySec": 3600
}
  1. Wählen Sie Update the list und dann Save rules.
FeldBedeutung
recipients1 bis 20 Einträge: ein Benutzer ({"kind": "user", "userId": "…"}), eine integrierte Rolle (OWNER, ADMIN oder USER) oder eine E-Mail-Adresse.
channelsOptional: die zu verwendenden Kanäle, zum Beispiel ["inapp", "mail"]. Wird er weggelassen, werden alle Kanäle verwendet, die der Empfänger erlaubt.
minSeverityOptional: Unterhalb dieser Schwere wird der Alarm zwar erfasst, aber niemand benachrichtigt.
repeatEverySecOptional: 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:maxTemp und speichern Sie maxTemp als Server-Attribut auf jedem Gerät. Siehe Attributes.
  • Ein Profil kann bis zu 50 Alarmregeln enthalten. Siehe Alarm rules on device profiles.

Nächster Schritt

Invite your team.