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

Reconexión y backoff

Para autores de firmware: cuándo Hermetry rechaza o finaliza una conexión, qué recibe el dispositivo y cuánto debe esperar antes de volver a intentarlo.

Esta página es para personas que escriben el firmware de dispositivos o el software de pasarelas. Reúne en un solo lugar lo que Hermetry hace cuando rechaza o finaliza una conexión y cómo debe volver a conectarse un dispositivo. Los ajustes de conexión, los inicios de sesión y los motivos de desconexión que se muestran en la pestaña Log están en MQTT; las reglas generales de los dispositivos están en Protocol versions and device rules.

Los códigos CONNACK que envía Hermetry

CódigoCuándo lo envía HermetryCalendario
0El inicio de sesión es aceptadoSe restablece tras 60 segundos conectado (más abajo)
1El CONNECT es para un nivel de protocolo que Hermetry no admite, como MQTT 5Detenerse. Corregir el cliente.
3El servicio se está iniciando, deteniendo o está ocupado; la dirección del dispositivo queda bloqueada durante un breve tiempo tras inicios de sesión fallidos; un nombre de usuario MQTT se retiene tras contraseñas incorrectas repetidas; el dispositivo se retiene tras una disputa por la toma de control; la plataforma está bajo carga y retiene a su organizaciónNormal
4Token de acceso desconocido, nombre de usuario o contraseña MQTT incorrectos, o un CONNECT sin nombre de usuarioLargo
5No autorizado: el dispositivo está deshabilitado, su certificado está revocado o caducado, la organización está suspendida o ha alcanzado su límite de dispositivos o de dispositivos conectados, o el perfil no permite el tipo de inicio de sesión, la red o el puertoLargo

Hermetry no envía CONNACK 2 con MQTT 3.1.1. El ID de cliente nunca es motivo para rechazar un inicio de sesión: se acepta cualquier ID de cliente y la sesión se registra con el número de serie del dispositivo (o con su ID de dispositivo si no tiene número de serie). El motivo de un código nunca se envía al dispositivo; se escribe en la pestaña Log del dispositivo.

Conexiones cerradas sin CONNACK

Algunas conexiones se cierran antes de que pueda enviarse un CONNACK. El dispositivo solo ve un socket cerrado y sigue el calendario normal.

SituaciónPredeterminado
El handshake TLS y el CONNECT no se completan a tiempo5 segundos desde la conexión TCP
Demasiadas conexiones desde la misma dirección pública inician sesión en el mismo momento64 por dirección en cada nodo del broker
La dirección se bloquea tras inicios de sesión fallidosMás de 10 inicios de sesión fallidos en 5 minutos bloquean la dirección durante 60 segundos

Sesiones que Hermetry finaliza

Hermetry no envía un código de motivo en una desconexión: el dispositivo ve que la conexión se cierra. Qué debe hacer a continuación:

Por qué terminó la sesiónQué hacer
No llegó nada durante 1,5 veces el keepaliveVolver a conectar según el calendario normal. Compruebe que el dispositivo envía PINGREQ cuando está inactivo.
Otra conexión del mismo dispositivo tomó el controlVolver a conectar según el calendario normal. Si se repite, dos dispositivos comparten una misma credencial.
La credencial fue rotada o revocada, el dispositivo fue deshabilitado o eliminado, o la organización fue suspendida (se vuelve a comprobar aproximadamente cada 60 segundos)Volver a conectar según el calendario normal. El siguiente CONNACK (4 o 5) pasa el dispositivo al calendario largo.
El dispositivo superó repetidamente su límite de tasaVolver a conectar según el calendario normal y, después, enviar menos. Consulte Device profiles.
Un nodo del broker se reiniciaSus conexiones se cierran durante unos 30 segundos en orden aleatorio. Volver a conectar según el calendario normal; un CONNECT que llega a un nodo que se está apagando recibe CONNACK 3.
Un mensaje no pudo ponerse en cola (no recibió PUBACK)La sesión se cierra unos 5 segundos después. Volver a conectar y, después, enviar de nuevo los mensajes no confirmados.

Keepalive

  • Conecte con un keepalive de 60 segundos y envíe PINGREQ cuando no tenga nada más que enviar.
  • Hermetry cierra una sesión cuando no llega nada durante 1,5 veces el keepalive: 90 segundos con 60.
  • Un keepalive de 0, o uno superior al máximo del broker (300 segundos por defecto), se atiende con el máximo.
  • Un mensaje Will se acepta y se ignora. Hermetry decide por sí mismo el estado de la conexión.

Los dos calendarios de reintento

Calendario normalCalendario largo
Se usa trasUna red caída, un socket cerrado, CONNACK 3El primer CONNACK 4 o 5
Primera espera1 segundo (un dispositivo puede empezar hasta a los 5 segundos)5 minutos (un dispositivo puede empezar hasta a los 15 minutos)
Esperas siguientesSe duplica en cada intentoSe duplica en cada intento
Espera más larga5 minutos (hasta 30 minutos mientras el enlace activo del dispositivo es medido)1 hora
JitterCada espera multiplicada por un factor aleatorio entre 0,5 y 1,5Igual

Reglas que acompañan a los calendarios:

  • Restablezca el calendario tras una conexión que haya durado al menos 60 segundos. Una conexión que se cae antes no lo restablece, así que un dispositivo que el servidor cierra continuamente no se reconecta en un bucle cerrado.
  • El calendario normal también vuelve a empezar cuando el dispositivo cambia su enlace activo, por ejemplo de Ethernet a datos móviles.
  • Tras un arranque o una actualización de firmware, espere entre 0 y 30 segundos aleatorios antes del primer intento. Así, una oleada de dispositivos actualizados no se reconecta en un pico único.
  • Deténgase ante CONNACK 1 hasta que el cliente se corrija.

El calendario largo devuelve un dispositivo a la conexión en unos 90 minutos tras corregir el problema, por ejemplo después de volver a habilitar el dispositivo o de subir el plan.

/* Wait before reconnect attempt n (n = 0, 1, 2 ...), in seconds. */
double backoff_s(int n, int long_schedule)
{
    double first = long_schedule ? 300.0 : 1.0;
    double cap   = long_schedule ? 3600.0 : 300.0;
    double wait  = first * pow(2.0, n);
    if (wait > cap)
        wait = cap;
    return wait * (0.5 + (double)rand() / RAND_MAX);   /* factor 0.5 to 1.5 */
}

Consejo

Inicialice el generador aleatorio de forma distinta en cada dispositivo, por ejemplo a partir de su número de serie y de una fuente de aleatoriedad de hardware. Los dispositivos que comparten semilla eligen las mismas esperas y siguen llegando a la vez.

Contraseñas incorrectas repetidas

Tras más de 5 inicios de sesión fallidos (CONNACK 4) para un mismo nombre de usuario MQTT desde una misma red en 15 minutos, a ese nombre de usuario se le responde CONNACK 3 durante 15 segundos, duplicándose con cada nuevo fallo hasta 5 minutos. Un dispositivo que ha recibido un CONNACK 4 y después recibe CONNACK 3 suele seguir usando la contraseña incorrecta: manténgalo en el calendario largo hasta que una conexión tenga éxito.

Mediante la API HTTP del dispositivo

EstadoSignificadoQué hacer
429 rate_limitedSe supera la tasa del dispositivo o de la organización, o la tasa de peticiones de la dirección del cliente (50 por segundo, con ráfagas de 200, por defecto)La petición no se guardó. Espere los segundos indicados en Retry-After y envíela de nuevo.
429 blockedLa dirección se bloquea tras inicios de sesión fallidosEspere los segundos indicados en Retry-After (el resto del bloqueo). Corrija el token.
503El servicio está ocupado, no está listo o se está apagando, o retiene a su organizaciónEspere los segundos indicados en Retry-After (30) y después siga el calendario normal.
401Sin token, o un token desconocidoCalendario largo. Compruebe el token.
403No autorizado: dispositivo deshabilitado, organización suspendida, fuera de las redes permitidas por el perfil, o una regla del perfil (tls_required, quarantined)Calendario largo, o corrija la configuración.
400, 413El propio mensaje es incorrecto o demasiado grandeNo vuelva a enviar el mismo mensaje.

Cuando el dispositivo vuelve a estar disponible

Siga el orden de conexión de MQTT: suscribirse, enviar hello, pedir los atributos compartidos y, después, enviar las lecturas almacenadas antes que las lecturas en vivo. Dos puntos son importantes tras una interrupción larga:

  • Las lecturas almacenadas deben ajustarse a la tasa de reenvío que el dispositivo encuentra en el atributo compartido session_limits. No envíe todo el buffer tan rápido como permita el enlace.
  • Tras una interrupción, muchos dispositivos piden sus ajustes al mismo tiempo, y Hermetry los regula. Las secciones de ajustes que falten en la respuesta pueden llegar momentos después por v1/attributes/set, con la misma forma. Aplíquelas en cuanto lleguen.