Alarmas – Hermetry

Una alarma indica que algo no va bien con un dispositivo. Tiene un tipo (por ejemplo high_temperature), una gravedad, un estado, un título, el dispositivo al que pertenece y una cronología de todo lo que le ha ocurrido. Las alarmas las abren las reglas de alarma de un perfil de dispositivo, una regla de la tarjeta Rules, un bloque de flujo, y las cierran las mismas fuentes o una persona.

Gravedades

De mayor a menor. La interfaz muestra la etiqueta; la API y las reglas de alarma usan el código.

Código	Etiqueta	Uso típico
`CRITICAL`	Crítica	Peligro o pérdida inmediatos. Actúe ya.
`MAJOR`	Mayor	Avería grave. Actúe pronto.
`MINOR`	Menor	Una avería con efecto limitado.
`WARNING`	Aviso	Algo se está desviando hacia una avería.
`INFO`	Información	Conviene saberlo; no requiere ninguna acción.

Son exactamente cinco. Las notificaciones tratan CRITICAL de forma especial: por defecto llega a las personas aunque hayan desactivado ese tipo de notificación. Consulte Alarm notifications in depth.

Estados y ciclo de vida

Estado	Etiqueta	Significado
`OPEN`	Abierta	La condición es verdadera y nadie la ha tomado todavía.
`ACKNOWLEDGED`	Reconocida	Alguien la ha visto y se está ocupando. La condición puede seguir siendo verdadera.
`RESOLVED`	Resuelta	Terminada. Una alarma resuelta nunca vuelve a abrirse; una nueva aparición crea una nueva alarma.

(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)

Reglas del ciclo de vida:

Una alarma activa por dispositivo y tipo. Si la condición se cumple de nuevo mientras la alarma está abierta o reconocida, Hermetry cuenta una aparición en lugar de crear una segunda alarma. La página de la alarma muestra Disparada n veces.
La gravedad sigue a la condición verdadera más alta. Sube cuando se cumple una condición más alta, y baja solo cuando dicha condición más alta se ha despejado. Consulte Alarm rules on device profiles.
Un escalado se vuelve a notificar. Un aumento de gravedad se notifica, aunque la alarma estuviera reconocida. Una bajada no se notifica.
Resolver a mano se mantiene. Si despeja una alarma mientras su condición sigue siendo verdadera, la regla no la reabre hasta que la condición haya sido falsa al menos una vez. La cronología muestra una vez Reapertura retenida tras un cierre manual.
Las alarmas no pueden bloquearse. No existe la opción de «debe reconocerse antes de poder despejarse». Una alarma cuya condición se despeja queda resuelta aunque nadie la haya reconocido. Para revisarlas, filtre la página Alarms por Resolved y busque filas sin ningún reconocimiento en su cronología.
Oscilación. Si una alarma se abre y se despeja con demasiada frecuencia, su cierre se retiene y se marca como Flapping. Consulte Debounce, hysteresis and dampening.
Retroactiva. Una alarma abierta a partir de lecturas que llegaron tarde (tras una interrupción) lleva una insignia Backfilled y se fecha según las lecturas. Consulte Clear conditions and late readings.

Qué resuelve una alarma

Causa	Registrado como
Se despejó la condición de su regla (o se cumplió su condición de cierre)	Despejada por la regla
El bloque Clear alarm de un flujo, o una acción Raise or clear an alarm de la tarjeta Rules	Modificada por un flujo
Una persona hizo clic en Clear	Despejada a mano, con la persona y la nota opcional
Su regla de alarma se eliminó del perfil y las reglas se guardaron	Cleared, rule deleted
Se eliminó su dispositivo	Resuelta porque el dispositivo ya no existe

Dónde aparecen las alarmas

Alarms en el menú IoT: la lista de todas las alarmas de su organización. Consulte Working with alarms.
La pestaña Alarms de la página del dispositivo: la misma lista, para un solo dispositivo.
La campana de la barra superior: las últimas alarmas abiertas y un distintivo con el número de alarmas abiertas. Consulte The bell.
Paneles: la tarjeta Alarm table y los contadores de alarmas. Consulte Tables and lists.
Sitios y vistas de sitio, a través de los dispositivos situados bajo ellos.
Notificaciones, webhooks y flujos.

Permisos

Acción	Permiso	Rol predeterminado
Ver alarmas y reglas de alarma	View alarms and alarm rules	Usuario
Reconocer alarmas y añadir notas	Acknowledge alarms and add notes	Usuario
Despejar alarmas a mano	Resolve (clear) alarms by hand	Administrador
Silenciar las alarmas de un dispositivo	Mute the alarms of a device	Administrador
Cambiar las reglas de alarma	Edit the alarm rules of device profiles	Administrador

Los permisos están en el grupo IoT Alarms. Un administrador puede concederlos a otros roles o grupos. Consulte Users and roles.

Qué se audita

Cada reconocimiento y cada cierre manual por parte de una persona escribe una entrada de auditoría (quién, qué alarma, su tipo y gravedad; nunca la nota).
Cerrar a mano una alarma CRITICAL escribe una entrada de auditoría adicional.
Cada cambio en las reglas de alarma de un perfil es una entrada de auditoría, y cada regla modificada recibe una nueva versión.
Los silenciamientos y su levantamiento se auditan.

Consulte Audit log.

Historial y retención

Las alarmas resueltas, con sus cronologías y notas, se conservan 365 días por defecto y después las elimina una limpieza diaria. Un administrador lo configura en Alarms > icono de engranaje (Alarm settings) > Keep resolved alarms (days). 0 las conserva para siempre. Las alarmas abiertas y reconocidas nunca las elimina la retención.

Eventos de webhook

Evento	Se envía cuando
`alarm.created`	Se abre una alarma.
`alarm.acknowledged`	Alguien la reconoce.
`alarm.cleared`	Se resuelve, por su regla, un flujo o una persona.

Un cambio de gravedad no envía ningún evento de webhook. Consulte Webhooks.