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

Los datos no llegan

Encuentre por qué las lecturas de un dispositivo conectado no se almacenan o faltan algunas claves: flujos raíz, forma del payload, reglas de claves, límites de frecuencia, cuarentena y cuotas.

Esta página sirve cuando un dispositivo está conectado (o lo está su pasarela), pero sus lecturas no aparecen en su pestaña Telemetry, o solo aparecen algunas. Si el dispositivo no se conecta en absoluto, empieza por A device does not connect.

Cómo se almacena una lectura

Device → broker or HTTP API (rate limits, size, quarantine)
       → the device's root flow (profile root, or the organisation's root)
            → Alarm rules → Save telemetry (key rules, time rules, key cap)
       → the telemetry store → Telemetry tab, dashboards, API

Una lectura puede perderse en cada paso. Las comprobaciones siguientes siguen ese orden.

No se almacena nada en absoluto

ComprobaciónCómoSolución
El dispositivo no está en cuarentenaLa lista de dispositivos muestra QuarantinedUn dispositivo en cuarentena se conecta, pero su telemetría y sus atributos se confirman y descartan hasta que un administrador seleccione Activate. Consulte Quarantine.
El dispositivo no está deshabilitadoPágina del dispositivoHabilítalo
Publica en el tema correctoLa pestaña Log del dispositivo; la referencia de temasLa telemetría va a v1/telemetry (o a los temas personalizados de tu perfil). Un tema desconocido bajo v1/ se rechaza como unknown_reserved_topic. Consulta MQTT topics and payload reference.
Hay un flujo raíz en ejecución en el host IoTAutomation, filtro IoTUn raíz debe estar en Running. Un aviso «No worker is running the IoT host right now…» significa que el procesamiento está caído: contacta con soporte.
La parada de emergencia está desactivadaAviso en Automation «Emergency stop: n flows are paused…»Reanuda los flujos
El perfil del dispositivo tiene su propio raízLa lista de flujos muestra insignias Root con el nombre del perfilEse raíz, no el de la organización, gestiona el dispositivo: debe contener Save telemetry
Los mensajes llegan a Save telemetryEl panel Activity del raíz: Debug, Errors, los recuentos de mensajes en los cablesCorrige la ruta; mantén Alarm rules, Save telemetry y Save client attributes en ella
La automatización IoT está disponible para tu organizaciónSin ella, no se almacena ningún dato de dispositivosContacta con soporte

Consulta Hosts, the root flow and profile root flows.

Faltan algunas claves o algunas lecturas

Save telemetry indica por qué dejó fuera un valor. Abre Activity > Runs o Errors del flujo raíz:

CódigoCausaSolución
key_invalidUn carácter fuera de A–Z a–z 0–9 _ . -, o una clave vacíaRenombra la clave en el dispositivo o en el flujo
key_too_longMás de 64 caracteres, también después de un prefijo de temaClaves más cortas
key_reservedEmpieza por _, fw_, current_fw_ o cfg.Estos prefijos pertenecen a los atributos y a la plataforma. Consulta Reserved keys and attributes.
string_too_longTexto de más de 1.024 caracteresEnvía un texto más corto, o guárdalo como atributo
value_too_largeJSON de más de 4 KiB, raw por encima de su límite, o un número que no es finito (NaN, Infinity)Divide el valor; envía números
bad_formNo es una forma que el almacén lea, o más de 1.000 puntos clave-valor en un mensajeEnvía un objeto plano, {"ts": …, "values": {…}} o un array de ellos; divide los lotes grandes
bad_tsUna marca de tiempo que no está en milisegundos epoch, más de 10 minutos en el futuro, o más antigua que Oldest accepted reading (days)Consulta Wrong times and gaps
too_oldMás antiguo que su clase de retención de datos brutos (de 7 a 90 días)Envíe los datos almacenados en búfer antes
key_limitUna clave nueva por encima del límite de claves de telemetría de tu plan (250, 400 o 2.050 según el nivel)Elimina las claves innecesarias antes de Save telemetry, o cambia el plan
no_valuesNo se pudo almacenar nada del registroConsulta los códigos de sus valores

El resto del mensaje se sigue almacenando cuando se rechaza una clave.

La carga no es lo que Hermetry espera

SíntomaCausa
Todo se almacena bajo una única clave rawEl cuerpo no es un objeto JSON (binario, texto plano, un escalar o un array en un tema personalizado). Decodifícalo en el flujo raíz, usa un codec LoRaWAN o envía JSON.
Un número aparece como TextEl dispositivo lo envía entre comillas ("21.5"). Envía un número, o conviértelo con number(...) en un bloque Calculate.
Los valores aparecen bajo un nombre anidadoLa opción Prefix keys with the topic del perfil guarda los datos de un tema personalizado como <topic>.<key>
Nada para un hijo de pasarelaLa pasarela debe enviar v1/gw/connect para el hijo y usar la forma v1/gw/telemetry. Consulta Devices behind a gateway.

Los mensajes se descartan por un límite

LímitePor defectoQué ocurreDónde mirar
Mensajes de telemetría por dispositivo10 por segundo y 300 por minutoSe confirman y descartan; los propietarios y administradores reciben un aviso por dispositivo y horaLimits del perfil
Puntos de datos por dispositivo200 por segundo y 6.000 por minutoIgualIgual
Actualizaciones de atributos por dispositivo5 por segundo y 60 por minutoIgualIgual
Tamaño del mensaje64 KiBEl mensaje se descarta completo; la conexión se mantieneMax message payload (bytes) del perfil
Lecturas reproducidas (en búfer)La mitad del recuento de telemetría por segundoLos registros antiguos enviados tras una caída deben caber en Replay messages per secondLimits del perfil
Organización completa10, 15 o 70 mensajes por segundo y 6.000, 9.000 o 42.000 puntos de datos por minuto, según el nivelSe confirma y descarta; HTTP responde 429 con Retry-After; un aviso por horaPlanes y el complemento IoT
Hijos de pasarelaPor hijo y para el mensaje completo de la pasarelaUn hijo que supera sus propios límites pierde solo sus registros (child_rate_limited)Dispositivos detrás de un gateway

Un dispositivo que sigue superando su límite (más de tres veces su cuota por minuto descartada dentro de un minuto) tiene su sesión cerrada. Consulte Device profiles.

Agrupa las lecturas en lugar de enviar un mensaje por valor: un mensaje con 50 registros con marca de tiempo es un solo mensaje.

La cuota mensual de mensajes

La cuota mensual de mensajes IoT nunca detiene los datos. Al superarla, Hermetry sigue aceptando, almacenando y procesando tus mensajes; el exceso se factura. Si los datos se detienen, busca una de las causas anteriores, no la cuota. Consulta Message quota and usage.

Se almacena, pero no lo ves

SíntomaCausa
La pestaña Telemetry lo muestra, un panel noConsulta A dashboard shows no data
Una tarjeta de valor lo muestra, un gráfico dice No values in this windowLa clave es texto o verdadero/falso: no tienen historial en gráficos. Almacena una copia numérica. Consulta Numbers, text and true/false values.
Un gráfico de ventana larga va con un minuto o dos de retrasoLas ventanas de más de 24 horas leen resúmenes por minuto, que se rellenan cada minuto
El último valor no cambiaLas nuevas lecturas tienen una marca de tiempo anterior o igual a la almacenada

Por tipo de conexión

ConexiónMás comprobaciones
LoRaWANTroubleshooting uplinks and downlinks, el Frames log y el codec
SNMP y otros dispositivos sondeadosPolling devices over SNMP: cada sondeo escribe un mensaje; un dispositivo que falla se espacia
API HTTP del dispositivo400 carga no válida, 413 cuerpo demasiado grande, 429 límite de frecuencia. Consulta Device HTTP API.

Relacionado