Gerät für Wartungsarbeiten stummschalten

Stummschalten stoppt die Alarmbenachrichtigungen eines Geräts für eine Weile, zum Beispiel während Wartung oder Inbetriebnahme. Die Alarme werden weiterhin geöffnet, eskaliert und zurückgesetzt, 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 den Schweregrad und werden zurückgesetzt.
Alarmseite, Glockenzähler, Dashboards	Alarme wie üblich anzeigen.
Benachrichtigungen zum Öffnen und zur Eskalation	Werden nicht gesendet. Im Zeitverlauf des Alarms erscheint eine Zeile Muted: nobody was notified.
Erinnerungen	Werden nicht gesendet, solange die Stummschaltung dauert.
Benachrichtigung über die Zurücksetzung	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 weiter. Eine Regel, die auf den Alarm reagiert, handelt weiterhin. Um Regeln anzuhalten, verwenden Sie den manuellen Modus (siehe Manueller und automatischer Modus).

Eine Stummschaltung kann umfassen:

• jeden Alarm des Geräts, einschließlich Alarmen aus Flows und Regeln, oder
• eine Alarmregel des Geräteprofils.

Eine Stummschaltung dauert bis zu ihrem Endzeitpunkt. Die längste Stummschaltung beträgt 90 Tage, damit eine vergessene Stummschaltung ein Gerät nicht dauerhaft lahmlegen kann. Eine neue Stummschaltung wirkt innerhalb von etwa 10 Sekunden.

Stummschaltung setzen

Stummschaltungen werden über die API gesetzt; in dieser Version gibt es dafür keine Schaltfläche in der App. Sie benötigen das Recht Mute the alarms of a device (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	Pflichtfeld. Zeitpunkt, zu dem 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 sie null: jeder Alarm des Geräts.
reason	Optional, bis zu 500 Zeichen.

Antworten:

Meldung	Ursache
„A mute must end in the future.“	until liegt jetzt oder in der Vergangenheit.
„A mute may last at most 90 days.“	until liegt zu weit entfernt.
„Device not found.“	Das Gerät existiert nicht in Ihrer Organisation oder ist gelöscht.
„Alarm rule not found.“	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 lists the mutes in force with muteId, ruleId, until, reason, who set it and when. DELETE without muteId lifts every mute of the device; with it, only that one.

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 schreibt einen Audit-Eintrag zum 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 deaktivieren (und später wieder aktivieren). Alarme werden dann auch nicht protokolliert.
Die Regelkarte-Regeln eines Standorts anhalten, während Personen dort arbeiten	Manuell-Modus am Standort. Alarme laufen weiter.
Leisere Alarme, aber nicht stumme	Den minimalen Schweregrad der Regel erhöhen oder Debounce hinzufügen. Siehe Debounce, Hysterese und Dämpfung.