Novedad: el cortafuegos de IA supervisa toda la plataforma y explica cada incidente con palabras sencillas. Vea cómo funciona

Estado de conexión y actividad

Cómo decide Hermetry si un dispositivo está en línea o fuera de línea, la última señal y la inactividad, el registro del dispositivo con 30 días de historial y los webhooks de conexión.

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.

ReglaEn líneaFuera de líneaUso
Conexión en vivoCuando 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 recienteCuando 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ñalNunca 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/connect y v1/gw/disconnect, y pasan a fuera de línea cuando lo hace la pasarela.

Lo que muestran las listas

Se muestraSignificado
En líneaSegún la regla del perfil, el dispositivo está en línea ahora.
Fuera de líneaEstuvo en línea y ahora no lo está. La vista rápida añade Última desconexión: motivo.
Última señal horaEl perfil usa Solo última señal.
Nunca conectadoTodavía no se ha recibido nada del dispositivo.
Obsoleto: sin datos desde hace tiempoEn 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

EventoDetalle
Conectadopor el transporte (por ejemplo mqtts), desde la dirección del cliente
DesconectadoMotivo: motivo
Tomado por una nueva sesiónUna segunda conexión del mismo dispositivo tomó el control.
Cambiado a solo última señalLa 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:

EventoSe envía cuando
device.connectedEl dispositivo se puso en línea y permaneció en línea durante el tiempo de retención.
device.disconnectedEl 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:

AjusteValor por defectoRango
Webhooks de conexión: tiempo de retención (segundos)30De 5 a 3.600. Un dispositivo que oscila no envía nada.
Webhooks de dispositivo por espacio de trabajo y minuto600De 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

LlamadaDevuelve
GET /tenant/{tenantId}/api/iot/devices/{deviceId}/connections?page=1&pageSize=50El registro de conexiones, de más reciente a más antiguo (hasta 100 por página).
GET …/devices/{deviceId}/log?source=connectionEl registro de la pestaña Registro; source es connection o audit, con un máximo de 1.000 entradas de profundidad.
GET …/devices/{deviceId}/connectionDónde se conecta el dispositivo: broker, base HTTPS, temas y claves. Nada secreto.

Solución de problemas

SíntomaCausa
Un dispositivo HTTP nunca está en líneaSu perfil usa Conexión en vivo. Use Mensaje reciente.
Un dispositivo alterna entre en línea y fuera de líneaDos 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 informarEl 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 valoresEl 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.