Stummschalten beendet für eine Weile die Alarmbenachrichtigungen eines Geräts, zum Beispiel während Wartung oder Inbetriebnahme. Die Alarme werden weiterhin geöffnet, eskaliert und geschlossen, und sie werden weiterhin protokolliert; niemand wird über sie informiert, bis die Stummschaltung endet.
Was eine Stummschaltung bewirkt
| Während einer Stummschaltung | |
|---|---|
| Alarmregeln | Werden weiterhin ausgewertet. Alarme werden wie üblich geöffnet, ändern die Schwere und werden geschlossen. |
| Alarmseite, Glockenzähler, Dashboards | Alarme wie üblich anzeigen. |
| Benachrichtigungen für Öffnung und Eskalation | Werden nicht gesendet. Der Verlauf des Alarms erhält eine Zeile Stummgeschaltet: Niemand wurde benachrichtigt. |
| Erinnerungen | Werden nicht gesendet, solange die Stummschaltung läuft. |
| Benachrichtigung über die Auflösung | Wird nicht gesendet für einen Alarm, dessen Öffnung nie gemeldet wurde. |
| Webhooks und Flows | Erhalten weiterhin die Alarmänderungen. Eine Stummschaltung schaltet Personen stumm, nicht Systeme. |
| Regeln aus der Regelkarte | Laufen weiterhin. Eine Regel, die auf den Alarm reagiert, handelt weiterhin. Um Regeln anzuhalten, den manuellen Modus verwenden (siehe Manueller und automatischer Modus). |
Eine Stummschaltung kann Folgendes umfassen:
- jeden Alarm des Geräts, einschließlich der von Flows und Regeln ausgelösten Alarme, oder
- eine Alarmregel des Geräteprofils.
Eine Stummschaltung gilt bis zu ihrem Endzeitpunkt. Die längste Stummschaltung dauert 90 Tage, damit eine vergessene Stummschaltung ein Gerät nicht dauerhaft stummschalten kann. Eine neue Stummschaltung wirkt innerhalb von etwa 10 Sekunden.
Stummschaltung setzen
Stummschaltungen werden über die API gesetzt. Sie benötigen das Recht Alarme eines Geräts stummschalten (standardmäßig Admin). Verwenden Sie einen API-Schlüssel mit diesem Recht; siehe Authentifizierung.
POST /tenant/{tenantId}/api/iot/devices/{deviceId}/alarm-mute
Content-Type: application/json
{
"until": "2026-11-20T18:00:00+01:00",
"reason": "Pump overhaul, ticket 4711"
}
| Feld | Bedeutung |
|---|---|
until | Erforderlich. Wann die Stummschaltung endet, als Datum und Uhrzeit mit Offset. Muss in der Zukunft liegen und höchstens 90 Tage entfernt sein. |
ruleId | Optional. Die ID einer Alarmregel des Geräteprofils. Fehlt sie oder ist null: jeder Alarm des Geräts. |
reason | Optional, bis zu 500 Zeichen. |
Antworten:
| Meldung | Ursache |
|---|---|
| „Eine Stummschaltung muss in der Zukunft enden.“ | until ist jetzt oder liegt in der Vergangenheit. |
| „Eine Stummschaltung darf höchstens 90 Tage dauern.“ | until liegt zu weit in der Zukunft. |
| „Gerät nicht gefunden.“ | Das Gerät existiert nicht in Ihrer Organisation oder wurde gelöscht. |
| „Alarmregel nicht gefunden.“ | ruleId ist keine Regel des Geräteprofils. |
Stummschaltungen anzeigen und aufheben
GET /tenant/{tenantId}/api/iot/devices/{deviceId}/alarm-mute
DELETE /tenant/{tenantId}/api/iot/devices/{deviceId}/alarm-mute
DELETE /tenant/{tenantId}/api/iot/devices/{deviceId}/alarm-mute?muteId={muteId}
GET listet die aktiven Stummschaltungen mit muteId, ruleId, until, reason sowie wer sie wann gesetzt hat. DELETE ohne muteId hebt alle Stummschaltungen des Geräts auf, mit ihr nur diese eine.
Wenn eine Stummschaltung endet, werden Benachrichtigungen mit der nächsten Alarmänderung wieder gesendet. Ein Alarm, der während der Stummschaltung geöffnet wurde und noch offen ist, wird nicht erneut angekündigt; für ihn geplante Erinnerungen werden aber nach Ende der Stummschaltung gesendet.
Audit
Jede Stummschaltung und jede aufgehobene Stummschaltung erzeugt einen Audit-Eintrag am Gerät: wer, wann, die Regel (oder alle), der Endzeitpunkt. Siehe Audit-Protokoll.
Alternativen
| Bedarf | Verwenden |
|---|---|
| Einen Alarmtyp für jedes Gerät eines Profils stoppen | Die Regel auf dem Reiter Alarmregeln des Profils ausschalten (und später wieder einschalten). Alarme werden dann auch nicht protokolliert. |
| Die Regelkarte-Regeln eines Standorts anhalten, während dort Menschen arbeiten | Manuell-Modus am Standort. Alarme laufen weiter. |
| Leisere Alarme, nicht stumme | Die minimale Schwere der Regel erhöhen oder Entprellung hinzufügen. Siehe Entprellung, Hysterese und Dämpfung. |

