Una alarma de desconexión te avisa de que un dispositivo ha dejado de comunicarse. Es una regla de alarma independiente en el perfil del dispositivo, la regla de dispositivo desconectado, con el tipo fijo device_offline. Si un dispositivo se considera en línea lo decide la regla de estado en línea del perfil; la alarma solo reacciona a ella.
Añadir la regla
- Abre Perfiles de dispositivo, abre el perfil y luego la pestaña Reglas de alarma.
- Haz clic en Añadir regla > Regla de dispositivo desconectado.
- Define Abrir tras (segundos sin conexión) (de 10 a 604.800; por defecto 600), la Gravedad (por defecto Advertencia), el Título de la alarma (por defecto
{{device.name}} is offline) y un Runbook. - Haz clic en Añadir a la lista y después en Guardar reglas.
Un perfil tiene como máximo una regla de dispositivo desconectado.
{
"type": "device_offline",
"title": "{{device.name}} is offline",
"inactivity": { "afterSec": 900, "severity": "MAJOR" },
"notify": { "recipients": [ { "kind": "role", "role": "ADMIN" } ] },
"runbook": "Check power and the network at the site. The device's Log tab shows the last disconnect reason.",
"enabled": true
}El título puede usar {{device.name}}, {{severity}} y {{type}}.
Cuándo se abre
Dos eventos abren la alarma:
| Evento | Cuándo se abre la alarma |
|---|---|
| El dispositivo pasa a desconectado según la regla de estado en línea del perfil (una desconexión, un tiempo de espera de keepalive o el final de la ventana de Último mensaje) | Abrir tras (segundos sin conexión) más tarde, si el dispositivo no ha vuelto mientras tanto. |
| El dispositivo pasa a silencioso: no ha enviado nada durante el Tiempo de inactividad (segundos) del perfil | Inmediatamente. El tiempo de inactividad ya ha transcurrido. |
El retardo se comprueba cada pocos segundos, así que la alarma se abre en unos 5 segundos como máximo desde su hora prevista. La comprobación de silencio se ejecuta una vez por minuto.
Cuándo se cierra
La alarma se cierra automáticamente cuando el dispositivo vuelve a estar en línea (se conecta) o vuelve a estar activo tras un periodo de silencio (envía algo). Su comprobación pendiente se cancela en ese mismo momento.
Cómo encaja con la regla de estado en línea
| Ajuste del perfil (pestaña Estado en línea) | Efecto en la alarma de desconexión |
|---|---|
| Conexión en directo | Desconectado cuando termina la sesión MQTT. La alarma se abre afterSec después. Las reconexiones breves, más cortas que afterSec, nunca la abren. |
| Último mensaje | Desconectado cuando no llega nada durante Intervalo esperado × Factor. La alarma se abre afterSec después de eso, por lo que el silencio total antes de la alarma es intervalo × factor + afterSec. |
| Solo última conexión vista | Nunca desconectado. Solo la comprobación de silencio (tiempo de inactividad) puede abrir la alarma. |
| Tiempo de inactividad (segundos) | Por defecto 600 (de 10 a 604.800). Cuando transcurre sin actividad, la alarma se abre inmediatamente. |
Consulta Estado de conexión y actividad y Perfiles de dispositivo.
Elegir los tiempos
- Para un dispositivo con Conexión en directo que puede perder la sesión brevemente (redes móviles), define afterSec más largo que una reconexión normal, por ejemplo de 300 a 900.
- Para un dispositivo que informa cada hora con Último mensaje, intervalo 3.600 × factor 2 más afterSec 600 significa que la alarma se abre 2 horas y 10 minutos después del último mensaje.
- Si quieres que la alarma salte exactamente cuando un dispositivo deja de enviar sus informes, deja el Tiempo de inactividad un poco más largo que el intervalo de envío: la comprobación de silencio abre la alarma inmediatamente.
Qué no hace
- No analiza el contenido de la telemetría. Un dispositivo que sigue conectado pero envía solo datos vacíos o erróneos no está desconectado. Para eso usa una regla de umbral o un watchdog de flujo.
- Una desconexión o un mensaje de silencio que llega tarde (tras una interrupción del procesamiento de la plataforma) no se evalúa; la comprobación cuenta desde ahora.
- Silenciar el dispositivo detiene las notificaciones, no la alarma. Consulta Silenciar un dispositivo por mantenimiento.
Notificaciones
La regla de desconexión tiene el mismo bloque notify que las reglas de umbral: destinatarios, canales, gravedad mínima y recordatorios. Consulta Notificaciones de alarma en detalle.
Alarmas de desconexión desde la tarjeta de Reglas
La tarjeta de Reglas tiene su propio disparador Un dispositivo se conecta o desconecta con se desconecta y queda en silencio. Úsalo cuando quieras hacer algo (enviar un comando a una unidad de respaldo, avisar a un equipo) en lugar de abrir una alarma. La regla predefinida Avisar a las personas cuando un dispositivo sigue desconectado espera 10 minutos y avisa a los administradores solo si el dispositivo sigue desconectado. Consulta Recetario de la tarjeta de Reglas.