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ón | Cómo | Solución |
|---|---|---|
| El dispositivo no está en cuarentena | La lista de dispositivos muestra Quarantined | Un 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á deshabilitado | Página del dispositivo | Habilítalo |
| Publica en el tema correcto | La pestaña Log del dispositivo; la referencia de temas | La 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 IoT | Automation, filtro IoT | Un 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á desactivada | Aviso en Automation «Emergency stop: n flows are paused…» | Reanuda los flujos |
| El perfil del dispositivo tiene su propio raíz | La lista de flujos muestra insignias Root con el nombre del perfil | Ese raíz, no el de la organización, gestiona el dispositivo: debe contener Save telemetry |
| Los mensajes llegan a Save telemetry | El panel Activity del raíz: Debug, Errors, los recuentos de mensajes en los cables | Corrige la ruta; mantén Alarm rules, Save telemetry y Save client attributes en ella |
| La automatización IoT está disponible para tu organización | Sin ella, no se almacena ningún dato de dispositivos | Contacta 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ódigo | Causa | Solución |
|---|---|---|
key_invalid | Un carácter fuera de A–Z a–z 0–9 _ . -, o una clave vacía | Renombra la clave en el dispositivo o en el flujo |
key_too_long | Más de 64 caracteres, también después de un prefijo de tema | Claves más cortas |
key_reserved | Empieza por _, fw_, current_fw_ o cfg. | Estos prefijos pertenecen a los atributos y a la plataforma. Consulta Reserved keys and attributes. |
string_too_long | Texto de más de 1.024 caracteres | Envía un texto más corto, o guárdalo como atributo |
value_too_large | JSON 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_form | No es una forma que el almacén lea, o más de 1.000 puntos clave-valor en un mensaje | Envía un objeto plano, {"ts": …, "values": {…}} o un array de ellos; divide los lotes grandes |
bad_ts | Una 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_old | Má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_limit | Una 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_values | No se pudo almacenar nada del registro | Consulta 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íntoma | Causa |
|---|---|
Todo se almacena bajo una única clave raw | El 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 Text | El 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 anidado | La opción Prefix keys with the topic del perfil guarda los datos de un tema personalizado como <topic>.<key> |
| Nada para un hijo de pasarela | La 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ímite | Por defecto | Qué ocurre | Dónde mirar |
|---|---|---|---|
| Mensajes de telemetría por dispositivo | 10 por segundo y 300 por minuto | Se confirman y descartan; los propietarios y administradores reciben un aviso por dispositivo y hora | Limits del perfil |
| Puntos de datos por dispositivo | 200 por segundo y 6.000 por minuto | Igual | Igual |
| Actualizaciones de atributos por dispositivo | 5 por segundo y 60 por minuto | Igual | Igual |
| Tamaño del mensaje | 64 KiB | El mensaje se descarta completo; la conexión se mantiene | Max message payload (bytes) del perfil |
| Lecturas reproducidas (en búfer) | La mitad del recuento de telemetría por segundo | Los registros antiguos enviados tras una caída deben caber en Replay messages per second | Limits del perfil |
| Organización completa | 10, 15 o 70 mensajes por segundo y 6.000, 9.000 o 42.000 puntos de datos por minuto, según el nivel | Se confirma y descarta; HTTP responde 429 con Retry-After; un aviso por hora | Planes y el complemento IoT |
| Hijos de pasarela | Por hijo y para el mensaje completo de la pasarela | Un 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íntoma | Causa |
|---|---|
| La pestaña Telemetry lo muestra, un panel no | Consulta A dashboard shows no data |
| Una tarjeta de valor lo muestra, un gráfico dice No values in this window | La 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 retraso | Las ventanas de más de 24 horas leen resúmenes por minuto, que se rellenan cada minuto |
| El último valor no cambia | Las nuevas lecturas tienen una marca de tiempo anterior o igual a la almacenada |
Por tipo de conexión
| Conexión | Más comprobaciones |
|---|---|
| LoRaWAN | Troubleshooting uplinks and downlinks, el Frames log y el codec |
| SNMP y otros dispositivos sondeados | Polling devices over SNMP: cada sondeo escribe un mensaje; un dispositivo que falla se espacia |
| API HTTP del dispositivo | 400 carga no válida, 413 cuerpo demasiado grande, 429 límite de frecuencia. Consulta Device HTTP API. |

