Alarmregeln auf Gerät-Profilen

Alarmregeln werden für ein Gerät-Profil festgelegt und gelten für jedes Gerät dieses Profils. Eine Regel öffnet einen Alarm, wenn ihre Bedingung zutrifft, und schließt ihn, wenn die Bedingung nicht mehr erfüllt ist. Die Regeln laufen im Alarmschritt des Root-Flows für jede Nachricht der Geräte des Profils.

Regeln öffnen

1. Öffnen Sie Device Profiles und öffnen Sie ein Profil.
2. Öffnen Sie den Tab Alarm rules.

Sie sehen die Regeln des Profils mit ihrem Typ, ihrer Art (Threshold oder Device offline), ihrer Bedingung in Kurzform und einem Schalter Enabled. Wer View alarms and alarm rules besitzt, sieht sie; zum Ändern wird Edit the alarm rules of device profiles benötigt (standardmäßig Admin). Ohne dieses Recht zeigt der Tab „You can view the rules but not change them.“

Regel hinzufügen oder ändern

1. Klicken Sie auf Add rule und wählen Sie Threshold rule oder Device offline rule, oder klicken Sie bei einer Regel auf Edit.
2. Füllen Sie das Drawer aus (siehe unten). Wechseln Sie oben zwischen Form und JSON.
3. Klicken Sie auf Add to list (neue Regel) oder Update the list.
4. Wiederholen Sie dies für weitere Regeln. Der Tab zeigt „n rules changed and not saved yet: nothing applies until you save.“
5. Klicken Sie auf Save rules. Discard verwirft die nicht gespeicherten Änderungen.

Beim Speichern wird der gesamte Regelsatz des Profils ersetzt. Eine Regel, deren Definition oder Schalter sich geändert hat, erhält eine neue Version; eine unveränderte Regel behält ihre Version und ihren Zustand. Die neuen Regeln erreichen jeden Worker innerhalb von etwa zwei Sekunden. Hat jemand anders dasselbe Profil im selben Moment gespeichert, erhalten Sie „The alarm rules changed at the same time; try again.“

Threshold-Regel: das Formular

Feld	Was Sie einstellen
Type	Der Name des Alarms. Buchstaben, Ziffern und _ . : -, höchstens 128 Zeichen, eindeutig im Profil. Ein offener Alarm pro Gerät und Typ. Eine neue Regel beginnt als high_value.
Alarm title	Was die Personen sehen, höchstens 300 Zeichen. Platzhalter: {{device.name}}, {{value}}, {{key}}, {{threshold}}, {{severity}}, {{type}}. Eine neue Regel beginnt mit {{device.name}}: {{value}}.
Enabled	Ein oder aus.
Severity	Eine Zeile pro Schweregrad: der Schweregrad, dann Key, Operator und Value. Add a severity fügt eine Zeile hinzu (höchstens fünf, jeder Schweregrad einmal). Die höchste zutreffende Zeile gewinnt.
Key	Ein Telemetrie-Key. Das Feld bietet die im Profil deklarierten Keys an und akzeptiert freien Text.
Operator	>, >=, <, <=, ==, !=.
Value	Eine Zahl, true oder false, ein Text oder attribute:<name> für ein gerätespezifisches Limit.
Only from topic	Unter Advanced: Nur Nachrichten aus diesem MQTT-Topic vergleichen. Leer = beliebiges Topic.
How long the condition must hold	Count in Readings in a row oder Seconds (device time), dann die Zahlen für Auslösen und Schließen (1 bis 86.400).
Hysteresis (clear margin)	Eine absolute Marge auf der Schließseite.
Runbook	Text, der mit dem Alarm angezeigt wird: was zu prüfen ist und was zu tun ist (höchstens 10.000 Zeichen).

Details zu Bedingungen, Debounce und Hysterese: Alarm conditions reference und Debounce, hysteresis and dampening.

Device-offline-Regel: das Formular

Feld	Was Sie einstellen
Alarm title	Standard {{device.name}} is offline.
Open after (seconds offline)	10 bis 604.800 (7 Tage). Standard 600.
Severity	Standard Warning.
Runbook, Enabled	Wie oben.

Der Typ ist immer device_offline, daher hat ein Profil höchstens eine. Siehe Offline alarms.

Was nur der JSON-Modus zeigt

Das Formular deckt die übliche Form ab. Diese Teile gibt es nur im JSON-Modus:

Teil	JSON-Feld	Seite
Kombinierte Bedingungen (mehrere Vergleiche mit all/any)	severities[].condition mit all / any	Alarm conditions reference
Eine explizite Schließbedingung	clear	Clear conditions and late readings
Dampening-Einstellungen	dampening	Debounce, hysteresis and dampening
Benachrichtigungen: Empfänger, Kanäle, minimaler Schweregrad, Erinnerungen	notify	Alarm notifications in depth
Verarbeitung verspätet eintreffender Messwerte	evaluateBackfill	Clear conditions and late readings

Das Formular behält diese Teile, wenn Sie andere Felder bearbeiten. Eine Regel mit kombinierten Bedingungen öffnet sich im JSON-Modus mit dem Hinweis „This rule uses combined conditions or other settings the form does not show: edit it as JSON.“ Der JSON-Modus ist streng: Ein Feld, das Hermetry nicht kennt, wird abgelehnt, sodass eine gespeicherte Regel nie eine ignorierte Einstellung enthält.

Eine vollständige Regel

{
  "type": "high_temperature",
  "title": "{{device.name}}: {{value}} °C",
  "severities": [
    { "severity": "CRITICAL", "condition": { "key": "temperature", "op": ">", "value": 90 } },
    { "severity": "MAJOR", "condition": { "key": "temperature", "op": ">", "value": { "attribute": "max_temp" } } }
  ],
  "debounce": { "mode": "duration", "raise": 60, "clear": 120 },
  "hysteresis": 2,
  "notify": {
    "recipients": [ { "kind": "role", "role": "ADMIN" }, { "kind": "email", "email": "oncall@example.com" } ],
    "minSeverity": "MAJOR",
    "repeatEverySec": 1800
  },
  "runbook": "Check the cooling fan and the door seal. Clear with a note when fixed.",
  "enabled": true
}

Keys, die die Regeln prüfen

Beim Speichern muss jeder Bedingungs-Key ein Telemetrie-Key sein: ohne Leerzeichen und keine bloße Zahl („A key names a telemetry key: no spaces and not a number.“). Ein Key, der wie eine Zahl aussieht, etwa eine Registernummer 40001, wird akzeptiert, wenn das Profil ihn deklariert. Ein Key, den das Profil nicht deklariert, ist nur eine Warnung: „Not a telemetry key of this profile: … The rule fires only on devices that send these keys; save is still possible.“

Entfernen, Deaktivieren und Umbenennen

• Remove fragt „Remove type?“ und warnt „When you save, its open alarms are resolved.“ Sie werden beim Speichern geschlossen.
• Eine ausgeschaltete Regel beendet ihre Auswertung. Ein Alarm, den sie bereits geöffnet hat, bleibt offen, bis Sie ihn von Hand schließen oder die Regel wieder einschalten.
• Wenn Sie einen Telemetrie-Key im Profil umbenennen, listet das Profil die Alarmregeln auf, die den alten Key lesen, und kann sie in einem Schritt auf den neuen Key umschreiben. Jede umgeschriebene Regel erhält eine neue Version.
• Ein Profil, dessen Alarmregeln existieren, kann erst gelöscht werden, wenn die Regeln entfernt sind; das Löschen listet sie auf.

Limits

Limit	Wert
Regeln pro Profil	50
Schweregrade pro Regel	5 (jeder einmal)
Vergleiche pro Bedingung	16
Verschachtelung von all/any-Gruppen	4 Ebenen
Typ	128 Zeichen, A-Z a-z 0-9 _ . : -
Titel	300 Zeichen
Runbook	10.000 Zeichen
Key	128 Zeichen
Textwert	256 Zeichen
Debounce beim Auslösen und Schließen	1 bis 86.400
Empfänger	20
Offline-Verzögerung	10 s bis 7 Tage

Jenseits von Schwellwerten

Alarmregeln vergleichen einen Wert mit einer festen Zahl oder einem Geräteattribut. Sie können nichts berechnen (kein „Sollwert + 10“), keinem Zeitplan folgen oder zwei Geräte vergleichen. Dafür verwenden Sie eine Rules-card-Regel oder einen Flow, die beide Alarme mit demselben Lebenszyklus auslösen und schließen können. Fertige Beispiele: Alarm rule cookbook.