Alarmes – Hermetry

Une alarme signale qu’un problème affecte un appareil. Elle possède un type (par exemple high_temperature), une gravité, un statut, un titre, l’appareil auquel elle appartient, et une chronologie de tout ce qui lui est arrivé. Les alarmes sont ouvertes par les règles d’alarme d’un profil d’appareil, par une règle de la carte Règles, par un bloc de flux, et sont fermées par les mêmes sources ou par une personne.

Gravités

De la plus haute à la plus basse. L’interface affiche le libellé ; l’API et les règles d’alarme utilisent le code.

Code	Libellé	Usage typique
`CRITICAL`	Critique	Danger ou perte immédiate. Agir maintenant.
`MAJOR`	Majeure	Défaut sérieux. Agir rapidement.
`MINOR`	Mineure	Un défaut à effet limité.
`WARNING`	Avertissement	Quelque chose dérive vers un défaut.
`INFO`	Info	Bon à savoir ; aucune action requise.

Il y en a exactement cinq. Les notifications traitent CRITICAL de façon particulière : par défaut, elle atteint les personnes même lorsqu’elles ont désactivé ce type de notification. Voir Alarm notifications in depth.

Statuts et cycle de vie

Statut	Libellé	Signification
`OPEN`	Ouverte	La condition est vraie et personne ne l’a encore prise en charge.
`ACKNOWLEDGED`	Acquittée	Quelqu’un l’a vue et s’en occupe. La condition peut encore être vraie.
`RESOLVED`	Résolue	Terminée. Une alarme résolue ne se rouvre jamais ; une nouvelle occurrence crée une nouvelle alarme.

(no alarm) --condition true--> OPEN
OPEN --someone acknowledges--> ACKNOWLEDGED
OPEN or ACKNOWLEDGED --condition clears--> RESOLVED (automatically)
OPEN or ACKNOWLEDGED --someone clears it--> RESOLVED (by hand)

Règles du cycle de vie :

Une seule alarme active par appareil et par type. Si la condition se déclenche à nouveau alors que l’alarme est ouverte ou acquittée, Hermetry compte une occurrence au lieu de créer une seconde alarme. La page de l’alarme affiche Déclenchée n fois.
La gravité suit la condition vraie la plus haute. Elle augmente lorsqu’une condition plus élevée devient vraie, et ne baisse que lorsque cette condition plus élevée a cessé. Voir Alarm rules on device profiles.
Une escalade est à nouveau notifiée. Une hausse de gravité est notifiée, même si l’alarme avait été acquittée. Une baisse ne l’est pas.
Une résolution manuelle est maintenue. Si vous effacez une alarme alors que sa condition est encore vraie, la règle ne la rouvre pas tant que la condition n’a pas été fausse au moins une fois. La chronologie affiche une fois Réouverture retenue après un effacement manuel.
Les alarmes ne peuvent pas être verrouillées. Il n’existe aucune option « doit être acquittée avant de pouvoir être effacée ». Une alarme dont la condition cesse est résolue même si personne ne l’a acquittée. Pour les examiner, filtrez la page Alarmes sur Résolue et recherchez les lignes sans acquittement dans leur chronologie.
Oscillation. Si une alarme s’ouvre et se ferme trop souvent, sa fermeture est retenue et elle est marquée Oscillation. Voir Debounce, hysteresis and dampening.
Rétroactive. Une alarme ouverte à partir de mesures arrivées en retard (après une coupure) porte un badge Rétroactive et est datée d’après les mesures. Voir Clear conditions and late readings.

Ce qui résout une alarme

Cause	Enregistré comme
Sa condition de règle a cessé (ou sa condition d’effacement est devenue vraie)	Effacée par la règle
Le bloc Clear alarm d’un flux, ou une action Raise or clear an alarm de la carte Règles	Modifiée par un flux
Une personne a cliqué sur Clear	Effacée à la main, avec la personne et la note facultative
Sa règle d’alarme a été retirée du profil et les règles ont été enregistrées	Effacée, règle supprimée
Son appareil a été supprimé	Résolue parce que l’appareil n’existe plus

Où apparaissent les alarmes

Alarms dans le menu IoT : la liste de toutes les alarmes de votre organisation. Voir Working with alarms.
L’onglet Alarms de la page de l’appareil : la même liste, pour un seul appareil.
La cloche dans la barre supérieure : les dernières alarmes ouvertes et un badge comptant toutes les alarmes ouvertes. Voir The bell.
Tableaux de bord : la carte Alarm table et les compteurs d’alarmes. Voir Tables and lists.
Sites et vues de sites, à travers les appareils qui y sont rattachés.
Notifications, webhooks et flux.

Autorisations

Action	Autorisation	Rôle par défaut
Consulter les alarmes et les règles d’alarme	View alarms and alarm rules	Utilisateur
Acquitter les alarmes et ajouter des notes	Acknowledge alarms and add notes	Utilisateur
Effacer les alarmes à la main	Resolve (clear) alarms by hand	Administrateur
Mettre en sourdine les alarmes d’un appareil	Mute the alarms of a device	Administrateur
Modifier les règles d’alarme	Edit the alarm rules of device profiles	Administrateur

Les autorisations se trouvent dans le groupe IoT Alarms. Un administrateur peut les accorder à d’autres rôles ou groupes. Voir Users and roles.

Ce qui est audité

Chaque acquittement et chaque effacement manuel par une personne écrit une entrée d’audit (qui, quelle alarme, son type et sa gravité ; jamais la note).
Effacer à la main une alarme CRITICAL écrit une entrée d’audit supplémentaire.
Chaque modification des règles d’alarme d’un profil est une entrée d’audit, et chaque règle modifiée reçoit une nouvelle version.
Les mises en sourdine et la levée des mises en sourdine sont auditées.

Voir Audit log.

Historique et conservation

Les alarmes résolues, avec leurs chronologies et leurs notes, sont conservées 365 jours par défaut, puis supprimées par un nettoyage quotidien. Un administrateur règle cela dans Alarms > icône d’engrenage (Alarm settings) > Keep resolved alarms (days). 0 les conserve indéfiniment. Les alarmes ouvertes et acquittées ne sont jamais supprimées par la conservation.

Événements webhook

Événement	Envoyé quand
`alarm.created`	Une alarme s’ouvre.
`alarm.acknowledged`	Quelqu’un l’acquitte.
`alarm.cleared`	Elle est résolue, par sa règle, un flux ou une personne.

Un changement de gravité n’envoie aucun événement webhook. Voir Webhooks.