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, empiece 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, APIUna 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 se descartan hasta que un administrador seleccione Activate. Consulte Quarantine. |
| El dispositivo no está deshabilitado | Página del dispositivo | Habilítelo |
| 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 su perfil). Un tema desconocido bajo v1/ se rechaza como unknown_reserved_topic. Consulte MQTT topics and payload reference. |
| Hay un flujo raíz en ejecución en el host IoT | Automation, filtro IoT | Un flujo raíz debe estar Running. Un aviso «No worker is running the IoT host right now…» significa que el procesamiento está caído: contacte con soporte. |
| La parada de emergencia está desactivada | Aviso de Automation «Emergency stop: n flows are paused…» | Reanude los flujos |
| El perfil del dispositivo tiene su propio flujo raíz | La lista de flujos muestra insignias Root con el nombre del perfil | Ese flujo raíz, y no el de la organización, gestiona el dispositivo: debe contener Save telemetry |
| Los mensajes llegan a Save telemetry | El panel Activity del flujo raíz: Debug, Errors, los recuentos de mensajes en los cables | Corrija la ruta; mantenga en ella Alarm rules, Save telemetry y Save client attributes |
| La automatización IoT está disponible para su organización | Sin ella, no se almacena ningún dato de dispositivos | Contacte con soporte |
Consulte Hosts, the root flow and profile root flows.
Faltan algunas claves o algunas lecturas
Save telemetry indica por qué omitió un valor. Abra 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 | Renombre 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. Consulte Reserved keys and attributes. |
string_too_long | Texto de más de 1.024 caracteres | Envíe un texto más corto, o guárdelo 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) | Divida el valor; envíe números |
bad_form | Una forma que el almacén no lee, o más de 1.000 puntos clave-valor en un mensaje | Envíe un objeto plano, {"ts": …, "values": {…}} o un array de estos; divida 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) | Consulte Wrong times and gaps |
too_old | Más antiguo de lo que su clase de retención conserva en datos sin procesar (de 7 a 90 días) | Envíe antes los datos almacenados en búfer |
key_limit | Una clave nueva por encima del límite de claves de telemetría de su plan (250, 400 o 2.050 según el nivel) | Elimine las claves innecesarias antes de Save telemetry, o cambie de plan |
no_values | No se pudo almacenar nada del registro | Consulte 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íquelo en el flujo raíz, use un códec LoRaWAN, o envíe JSON. |
| Un número aparece como Text | El dispositivo lo envía entre comillas ("21.5"). Envíe un número, o convierta con number(...) en un bloque Calculate. |
| Los valores aparecen con un nombre anidado | La opción Prefix keys with the topic del perfil almacena 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. Consulte 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 se descartan; los propietarios y administradores reciben un aviso por dispositivo y hora | Los 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 | El 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 interrupción deben caber en Replay messages per second | Los 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 confirman y se descartan; HTTP responde 429 con Retry-After; un aviso por hora | Plans and the IoT add-on |
| 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) | Devices behind a gateway |
Un dispositivo que sigue superando su límite (más de tres veces su cupo por minuto descartado en un minuto) tiene su sesión cerrada. Consulte Device profiles.
Batch las lecturas en lugar de enviar un mensaje por valor: un mensaje con 50 registros con marca de tiempo es un único mensaje.
La cuota mensual de mensajes
La cuota mensual de mensajes IoT nunca detiene los datos. Al superarla, Hermetry sigue aceptando, almacenando y procesando sus mensajes; el exceso se factura. Si los datos se detienen, busque una de las causas anteriores, no la cuota. Consulte Message quota and usage.
Se almacena, pero no lo ve
| Síntoma | Causa |
|---|---|
| La pestaña Telemetry lo muestra, un panel no | Consulte A dashboard shows no data |
| Una tarjeta de valor lo muestra, un gráfico indica No values in this window | La clave es texto o verdadero/falso: no tienen historial en gráficos. Almacene una copia numérica. Consulte Numbers, text and true/false values. |
| Un gráfico de ventana larga va retrasado uno o dos minutos | Las ventanas de más de 24 horas leen resúmenes por minuto, que se completan cada minuto |
| El último valor no cambia | Las nuevas lecturas llevan 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 códec |
| SNMP y otros dispositivos sondeados | Polling devices over SNMP: cada sondeo escribe un mensaje; un dispositivo que falla se retrasa progresivamente |
| API HTTP de dispositivos | 400 carga no válida, 413 cuerpo demasiado grande, 429 límite de frecuencia. Consulte Device HTTP API. |