La mise en sourdine suspend pendant un temps les notifications d’alarme d’un appareil, 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é tant que la mise en sourdine n’est pas terminée.
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 clôturent normalement. |
| Page des alarmes, compteur de la cloche, tableaux de bord | Affichées normalement. |
| 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 toute la durée de la mise en sourdine. |
| Notification de résolution | Non envoyée pour une alarme dont l’ouverture n’a jamais été notifiée. |
| Webhooks et flux | Continuent de recevoir les changements d’alarme. Une mise en sourdine ne réduit au silence que 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 des 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 généré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 prend effet dans un délai d’environ 10 secondes.
Définir une mise en sourdine
Les mises en sourdine se définissent via l’API. Il faut le droit Mute the alarms of a device (Admin par défaut). Utilisez une clé API disposant de ce droit ; voir Authentication.
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. Moment de 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 |
|---|---|
| « Un silence doit se terminer dans le futur. » | until est maintenant ou dans le passé. |
| « Un silence peut durer 90 jours au maximum. » | until est trop éloigné. |
| « Appareil introuvable. » | L’appareil n’existe pas dans votre organisation, ou il est supprimé. |
| « Règle d’alarme introuvable. » | 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 liste les mises en sourdine en vigueur avec muteId, ruleId, until, reason, qui l’a définie et quand. DELETE sans muteId lève toutes les mises en sourdine de l’appareil ; avec lui, seulement celle-ci.
À 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 | Solution |
|---|---|
| Arrêter un type d’alarme pour tous les appareils d’un profil | Désactivez la règle dans l’onglet Alarm rules du profil (puis réactivez-la plus tard). Les alarmes ne sont alors pas non plus enregistrées. |
| 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. |
| Des alarmes plus discrètes, pas silencieuses | Augmentez la gravité minimale de la règle, ou ajoutez un anti-rebond. Voir Anti-rebond, hystérésis et amortissement. |

