Cada dispositivo tiene un estado de conexión que las listas, los tableros, las reglas y las alarmas leen: si está en línea, cuándo se supo de él por última vez y si ha dejado de dar señales. Hermetry lo deriva de lo que hace el dispositivo (conectar, desconectar, enviar mensajes) según la regla de en línea del perfil del dispositivo. Esta página explica las reglas, las marcas de tiempo, la pestaña Registro del dispositivo y los webhooks.
La regla de en línea
La regla se define en la pestaña Estado en línea del perfil y nunca se deriva del transporte. Consulte Perfiles de dispositivo.
| Regla | En línea | Fuera de línea | Uso |
|---|---|---|---|
| Conexión en vivo | Cuando el dispositivo se conecta por MQTT. | Cuando termina su sesión MQTT (desconexión, tiempo de espera de keepalive, toma de control sin una nueva sesión, rechazo). | Dispositivos que mantienen MQTT abierto. |
| Mensaje reciente | Cuando el dispositivo se conecta o envía cualquier cosa. | Cuando no llega nada durante Intervalo esperado × Factor (por ejemplo, 3.600 s × 3 = 3 horas). Una desconexión por sí sola no lo pone fuera de línea mientras su último mensaje siga siendo reciente. | Dispositivos que informan y se desconectan, dispositivos HTTP, sensores LoRaWAN. |
| Solo última señal | Nunca se muestra como en línea ni fuera de línea. | — | Dispositivos sondeados, dispositivos cuyo ritmo se desconoce. |
Detalles:
- Una petición HTTP es actividad, no una conexión. En un perfil con Conexión en vivo, un dispositivo HTTP nunca está en línea.
- Los eventos que llegan desordenados nunca hacen retroceder el estado: una conexión antigua nunca pone en línea a un dispositivo tras una desconexión más reciente.
- Una comprobación cada minuto marca como fuera de línea los dispositivos cuya ventana ha terminado o cuya concesión de sesión ha expirado, y aplica una regla de en línea modificada.
- Los dispositivos hijos de una pasarela siguen sus mensajes
v1/gw/connectyv1/gw/disconnect, y pasan a fuera de línea cuando lo hace la pasarela.
Lo que muestran las listas
| Se muestra | Significado |
|---|---|
| En línea | Según la regla del perfil, el dispositivo está en línea ahora. |
| Fuera de línea | Estuvo en línea y ahora no lo está. La vista rápida añade Última desconexión: motivo. |
| Última señal hora | El perfil usa Solo última señal. |
| Nunca conectado | Todavía no se ha recibido nada del dispositivo. |
| Obsoleto: sin datos desde hace tiempo | En una tarjeta de tabla de dispositivos con Obsoleto tras (segundos) configurado: en línea, pero sin datos durante más tiempo que ese. |
La pestaña Overview del dispositivo muestra Last activity, Last connected y Last disconnected. IP address es la dirección de la conexión más reciente; para un dispositivo que nunca se conecta (HTTP, por polling) es la dirección de su actividad más reciente.
Inactividad: en línea pero sin actividad
Un dispositivo puede mantener su conexión y no enviar nada. El Tiempo de espera por inactividad (segundos) del perfil (600 por defecto, de 10 a 604.800) marca un dispositivo como inactivo cuando no ha enviado nada durante ese tiempo. Inactivo no es lo mismo que fuera de línea.
Úselo en el disparador de la tarjeta Reglas Un dispositivo se conecta o desconecta > deja de enviar datos. Las alarmas para un dispositivo que deja de informar se configuran con una Regla de dispositivo fuera de línea en las reglas de alarma del perfil, que tiene su propio tiempo (Abrir tras (segundos fuera de línea)). Consulte Alarmas de fuera de línea.
La pestaña Registro
La pestaña Registro del dispositivo muestra su historial de conexión y los cambios realizados en él en una única línea temporal, de más reciente a más antiguo. Mostrar filtra por Todo, Conexiones o Cambios; Cargar más retrocede en el tiempo.
Eventos de conexión
| Evento | Detalle |
|---|---|
| Conectado | por el transporte (por ejemplo mqtts), desde la dirección del cliente |
| Desconectado | Motivo: motivo |
| Tomado por una nueva sesión | Una segunda conexión del mismo dispositivo tomó el control. |
| Cambiado a solo última señal | La regla del perfil cambió a Solo última señal. |
Motivos de desconexión: client_disconnect, keepalive_timeout, takeover, auth_revoked, rate_limit, server_shutdown, uplink_window_expired (terminó la ventana de Mensaje reciente) y online_rule_changed. Un inicio de sesión rechazado (CONNACK 5) también se registra con su motivo, que nunca se envía al dispositivo.
Los Cambios son los cambios auditados: Dispositivo creado, Dispositivo editado (con los campos modificados), Dispositivo activado, Dispositivo en cuarentena, Dispositivo deshabilitado, Credencial reemplazada, Credencial rotada, Credencial revocada, Atributos guardados, Atributos eliminados, comandos enviados, cancelados, rechazados y finalizados, y alarmas reconocidas y borradas, cada uno por una persona o por el sistema.
El historial de conexión se conserva durante 30 días. Los dispositivos con Solo última señal no escriben filas de conexión ni de desconexión.
Webhooks
Dos eventos de webhook informan a otros sistemas de los cambios de conexión:
| Evento | Se envía cuando |
|---|---|
device.connected | El dispositivo se puso en línea y permaneció en línea durante el tiempo de retención. |
device.disconnected | El dispositivo pasó a fuera de línea y permaneció fuera de línea durante el tiempo de retención. |
{ "deviceId": "…", "name": "router-17", "profileId": "…", "transport": "mqtts", "connectedAt": "2026-11-03T10:00:00.000Z", "remoteIpPrefix": "203.0.113.0/24" }
{ "deviceId": "…", "name": "router-17", "profileId": "…", "reason": "timeout", "disconnectedAt": "2026-11-03T12:00:00.000Z", "lastSeenAt": "2026-11-03T11:59:40.000Z", "onlineSeconds": 7200 }
Dos ajustes en Dispositivos > ⋯ > Ajustes (grupo Webhooks) los controlan:
| Ajuste | Valor por defecto | Rango |
|---|---|---|
| Webhooks de conexión: tiempo de retención (segundos) | 30 | De 5 a 3.600. Un dispositivo que oscila no envía nada. |
| Webhooks de dispositivo por espacio de trabajo y minuto | 600 | De 1 a 100.000. El resto del minuto se descarta y sus administradores son notificados una vez. Los webhooks del ciclo de vida de los dispositivos tienen su propio contador con el mismo límite. |
La dirección en device.connected es solo un prefijo de red. Cada evento incluye una clave de idempotencia, para que su receptor pueda ignorar los repetidos. Consulte Webhooks.
Contar dispositivos
Los paneles pueden mostrar Dispositivos, Dispositivos en línea, Dispositivos fuera de línea y Dispositivos nunca conectados como contadores, y la tarjeta de tabla de dispositivos muestra el estado de conexión en vivo de cada fila. Consulte Tablas y listas.
API
| Llamada | Devuelve |
|---|---|
GET /tenant/{tenantId}/api/iot/devices/{deviceId}/connections?page=1&pageSize=50 | El registro de conexiones, de más reciente a más antiguo (hasta 100 por página). |
GET …/devices/{deviceId}/log?source=connection | El registro de la pestaña Registro; source es connection o audit, con un máximo de 1.000 entradas de profundidad. |
GET …/devices/{deviceId}/connection | Dónde se conecta el dispositivo: broker, base HTTPS, temas y claves. Nada secreto. |
Solución de problemas
| Síntoma | Causa |
|---|---|
| Un dispositivo HTTP nunca está en línea | Su perfil usa Conexión en vivo. Use Mensaje reciente. |
| Un dispositivo alterna entre en línea y fuera de línea | Dos dispositivos comparten una credencial (busque Tomado por una nueva sesión), o el keepalive es demasiado corto para la red. |
| Fuera de línea mucho tiempo después de dejar de informar | El Intervalo esperado × Factor es demasiado largo. Acórtelo o añada una alarma de fuera de línea con su propio tiempo. |
| En línea pero sin valores | El dispositivo no envía nada, o sus datos se descartan (dispositivo en cuarentena, límite de frecuencia, carga útil incorrecta). Consulte Los datos no llegan. |

