Mettre un appareil en sourdine pour la maintenance

La mise en sourdine coupe les notifications d’alarme d’un appareil pendant un certain temps, par exemple pendant une maintenance ou une mise en service. Les alarmes continuent de s’ouvrir, de monter en gravité et de se clore, et elles sont toujours enregistrées ; personne n’en est informé avant la fin de la mise en sourdine.

Ce que fait une mise en sourdine

	Pendant une mise en sourdine
Règles d’alarme	Toujours évaluées. Les alarmes s’ouvrent, changent de gravité et se closent comme d’habitude.
Page des alarmes, compteur de la cloche, tableaux de bord	Les alarmes s’affichent comme d’habitude.
Notifications d’ouverture et d’escalade	Non envoyées. La chronologie de l’alarme reçoit une ligne Muted: nobody was notified.
Rappels	Non envoyés pendant la durée de la mise en sourdine.
Notification de la résolution	Non envoyée pour une alarme dont l’ouverture n’a jamais été signalée.
Webhooks et flux	Continuent de recevoir les changements d’alarme. Une mise en sourdine réduit au silence les personnes, pas les systèmes.
Règles de la carte Rules	Continuent de s’exécuter. Une règle qui réagit à l’alarme agit toujours. Pour arrêter les règles, utilisez le mode Manuel (voir Modes Manuel et Auto).

Une mise en sourdine peut couvrir :

• toutes les alarmes de l’appareil, y compris les alarmes levées par des flux et des règles, ou
• une règle d’alarme du profil de l’appareil.

Une mise en sourdine dure jusqu’à son heure de fin. La plus longue dure 90 jours, afin qu’une mise en sourdine oubliée ne puisse pas réduire un appareil au silence définitivement. Une nouvelle mise en sourdine s’applique en environ 10 secondes.

Définir une mise en sourdine

Les mises en sourdine se définissent via l’API ; il n’existe pas de bouton dans l’application dans cette version. Vous avez besoin du droit Mettre en sourdine les alarmes d’un appareil (Admin par défaut). Utilisez une clé API disposant de ce droit ; voir Authentification.

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"
}

Champ	Signification
until	Obligatoire. Fin de la mise en sourdine, sous forme de date et d’heure avec décalage horaire. Doit être dans le futur et au plus à 90 jours.
ruleId	Facultatif. L’identifiant d’une règle d’alarme du profil de l’appareil. Absent ou null : toutes les alarmes de l’appareil.
reason	Facultatif, jusqu’à 500 caractères.

Réponses :

Message	Cause
« A mute must end in the future. »	until est maintenant ou dans le passé.
« A mute may last at most 90 days. »	until est trop éloigné.
« Device not found. »	L’appareil n’existe pas dans votre organisation, ou il est supprimé.
« Alarm rule not found. »	ruleId n’est pas une règle du profil de l’appareil.

Consulter et lever les mises en sourdine

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.

À la fin d’une mise en sourdine, les notifications reprennent avec le prochain changement d’alarme. Une alarme ouverte pendant la mise en sourdine et toujours active n’est pas annoncée à nouveau, mais les rappels programmés pour elle partent une fois la mise en sourdine terminée.

Audit

Chaque mise en sourdine et chaque mise en sourdine levée écrit une entrée d’audit sur l’appareil : qui, quand, la règle (ou toutes), l’heure de fin. Voir Journal d’audit.

Alternatives

Besoin	Utiliser
Arrêter un type d’alarme pour chaque appareil d’un profil	Désactiver la règle dans l’onglet Règles d’alarme du profil (puis la réactiver plus tard). Les alarmes ne sont alors pas enregistrées non plus.
Arrêter les règles de la carte Rules d’un site pendant que des personnes y travaillent	Mode Manuel sur le site. Les alarmes continuent de fonctionner.
Alarmes plus discrètes, pas silencieuses	Augmenter la gravité minimale de la règle, ou ajouter un anti-rebond. Voir Anti-rebond, hystérésis et amortissement.