Wie konfiguriere ich Alarmregeln und Benachrichtigungen?

Ab Tarif Pro

Kurzantwort

Im Abschnitt Alarmregeln des Monitorings legst du über „Regel hinzufügen” fest, wann Notory alarmiert: ein Messwert (CPU %, Arbeitsspeicher %, Festplatte %, Last (1 Min) oder Status online/offline), ein Vergleich mit Schwellenwert, eine optionale Dauer („Für (Sekunden)”) und der Schweregrad. Die Regel gilt für ein bestimmtes System oder für Alle Systeme. Bei Verletzung entsteht ein Alarm und eine Benachrichtigung.

Voraussetzungen

Monitoring gehört zum Modul Operations und ist ab Tarif Pro verfügbar.

Alarmregeln öffnen. Scrolle im Modul Monitoring zum Abschnitt Alarmregeln. Die Tabelle zeigt je Regel Regelname, Bedingung (z. B. CPU % > 90), Schweregrad, Ziel und ob sie Aktiviert ist.

Screenshot ausstehend monitoring-alarmregeln-01 Abschnitt Alarmregeln mit Tabelle aus Regelname, Bedingung, Schweregrad, Ziel und Aktiviert-Status

Der Abschnitt 'Alarmregeln' mit bestehenden Regeln.
Regel anlegen. Klicke „Regel hinzufügen” und fülle den Dialog:
- Regelname (Pflicht): z. B. „CPU dauerhaft über 90 %”.
- Messwert: CPU %, Arbeitsspeicher %, Festplatte %, Last (1 Min) oder Status (online/offline).
- Vergleich: >, >=, <, <= oder ==.
- Schwellenwert (Pflicht): z. B. 90.
- Für (Sekunden): wie lange die Bedingung ununterbrochen bestehen muss, bevor der Alarm auslöst (0 = sofort).
- Schweregrad: Info, Warnung oder Kritisch.
- Ziel: ein bestimmtes System oder Alle Systeme.
- Aktiviert: nur aktivierte Regeln werden ausgewertet.
Screenshot ausstehend monitoring-alarmregeln-02 Dialog 'Regel hinzufügen' mit Messwert, Vergleich, Schwellenwert, Dauer, Schweregrad und Ziel

Eine Alarmregel: Messwert, Vergleich, Schwellenwert, Dauer und Schweregrad.
Alarme verfolgen. Ausgelöste Alarme erscheinen unter Letzte Alarme (Zustand Aktiv/Behoben) und erzeugen eine Benachrichtigung, sichtbar am Glocken-Symbol und im Bereich Betrieb.

Tipp zum Offline-Alarm: Der Messwert Status liefert 1 (online) bzw. 0 (offline). Eine Regel Status == 0 mit z. B. Für 300 Sekunden meldet Systeme, die fünf Minuten nicht erreichbar sind.

Regel anlegen ist ein POST auf /api/v1/monitoring/alert-rules (Scope write). host_id: null bedeutet „alle Systeme”:

curl -X POST https://demo.notory.io/api/v1/monitoring/alert-rules \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "CPU dauerhaft über 90 %",
    "metric": "cpu_pct",
    "comparator": ">",
    "threshold": 90,
    "for_seconds": 300,
    "severity": "critical",
    "host_id": null,
    "enabled": true
  }'

{
  "id": "rl_1c2d…",
  "tenant_id": "3d9b0c12-…",
  "name": "CPU dauerhaft über 90 %",
  "metric": "cpu_pct",
  "comparator": ">",
  "threshold": 90.0,
  "for_seconds": 300,
  "severity": "critical",
  "host_id": null,
  "enabled": true,
  "created_at": "2026-07-08T11:00:00Z"
}

Erlaubte metric-Werte: cpu_pct, mem_pct, disk_pct, load1, status. Andere Werte lehnt die API mit 400 ab. comparator ∈ > | >= | < | <= | ==; severity ∈ info | warning | critical.

Regeln verwalten und Alarme lesen:

curl -H "Authorization: Bearer inv_dein_token" \
  https://demo.notory.io/api/v1/monitoring/alert-rules

curl -X PUT https://demo.notory.io/api/v1/monitoring/alert-rules/rl_1c2d... \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": false }'

curl -X DELETE https://demo.notory.io/api/v1/monitoring/alert-rules/rl_1c2d... \
  -H "Authorization: Bearer inv_dein_token"

curl -H "Authorization: Bearer inv_dein_token" \
  "https://demo.notory.io/api/v1/monitoring/alerts?limit=50"

Mögliche Fehler: 400 (unbekannter Messwert), 401, 403 (Modul Operations nicht im Tarif oder kein Schreibrecht), 404 (Regel nicht gefunden), 422 (Validierung, z. B. negatives for_seconds).

Was passiert dabei?

Auswertung gegen die letzten Messwerte: Notory prüft aktivierte Regeln laufend gegen die aktuellsten Werte der Zielsysteme. Erst wenn die Bedingung für die konfigurierte Dauer (for_seconds) ununterbrochen verletzt ist, löst die Regel aus.
Alarm-Lebenszyklus: Beim Auslösen entsteht ein Alarm-Ereignis im Zustand Aktiv (firing) mit dem gemessenen Wert; normalisiert sich der Messwert, wird er als Behoben (resolved) markiert, inklusive Zeitstempeln.
Benachrichtigung inklusive: Zu jedem ausgelösten Alarm erzeugt Notory eine Benachrichtigung. Der Ungelesen-Zähler an der Glocke steigt.
Regel löschen entfernt Historie: Mit einer Regel werden auch ihre Alarm-Ereignisse gelöscht (Kaskade). Deaktivieren (enabled: false) stoppt die Auswertung, behält aber die Historie.
Audit & Mandant: Regeln gehören deinem Mandanten; Anlegen/Ändern/Löschen wird protokolliert.