Cada lectura se almacena con una hora. Esta página explica qué hora es esa, qué lecturas se rechazan por su hora, cómo se gestionan los duplicados y qué ocurre con las lecturas que llegan tarde.
Hora del dispositivo o hora de recepción
| Lo que envía el dispositivo | Almacenada en |
|---|---|
Un objeto plano, por ejemplo {"temperature": 21.5} | La hora en que la plataforma recibió el mensaje |
{"ts": 1759572000000, "values": {...}} | ts: la hora propia del dispositivo |
| Un array con las dos formas | Cada elemento con su propia hora |
ts es un entero en milisegundos desde el 1 de enero de 1970, UTC. Cualquier otro ts (segundos, una cadena o un número negativo) descarta ese registro como bad_ts. Consulte MQTT topics and payload reference.
Envíe ts solo cuando el reloj del dispositivo esté sincronizado. Un dispositivo sin reloj fiable debe enviar objetos planos y dejar que la plataforma les asigne la hora. Un reloj que se desvía produce lecturas en el lugar equivocado de los gráficos y puede ser rechazado.
En un flujo, la hora del registro es msg.metadata.recordTs y la hora de recepción msg.metadata.ts. El bloque Save telemetry almacena la hora del registro por defecto; su ajuste ts puede cambiarlo a la hora de recepción, y ts_path puede reasignar la hora de un registro a partir de un valor del mensaje.
Lecturas desde el futuro
Un registro con marca de tiempo más de 10 minutos por delante de la hora en que llega se descarta como bad_ts. Nunca se corrige a «ahora». Para cambiar la tolerancia, vaya a Settings > Telemetry (IoT Telemetry Settings):
| Ajuste | Por defecto | Rango |
|---|---|---|
| Future timestamp tolerance (minutes) | 10 | 1 a 1.440 |
| Oldest accepted reading (days) | 0 (cualquier antigüedad) | 0 a 36.500 |
Un registro anterior a Oldest accepted reading (days) antes de su llegada se descarta como bad_ts. Sirve para impedir que un dispositivo reproduzca datos antiguos almacenados en búfer. La página requiere los permisos View IoT telemetry settings y Change IoT telemetry settings (Admin por defecto). Los cambios llegan a la ingesta en un minuto.
Lecturas del pasado
La tienda rechaza como too_old una lectura más antigua que su clase de retención de datos brutos, independientemente de lo que indiquen los ajustes anteriores:
| Clase de retención | Se rechaza una lectura cuando es más antigua que |
|---|---|
| 7 días | 7 días |
| 30 días | 7 días |
| 90 días | 30 días |
| 365 días | 90 días |
| 1,095 días | 90 días |
Las lecturas dentro de la ventana de datos brutos se almacenan aunque sean antiguas, y se agregan en los resúmenes por minuto, hora y día. Consulte How long data is kept.
Duplicados
Un dispositivo, una pasarela o un reintento pueden enviar la misma lectura dos veces. Hermetry gestiona esto en dos puntos:
- Antes del flujo. Un mensaje de dispositivo cuyo id de mensaje ya se vio en los últimos 60 segundos, o, cuando no tiene id pero sí lleva su propio
ts, cuyo contenido ya se vio, se confirma sin ejecutar el flujo. Una lectura sin id nitsnunca se trata como repetida: el mismo valor dos veces son dos lecturas. - En el almacén. Un mensaje con los mismos valores, a la misma hora, para el mismo dispositivo se almacena una sola vez. Un mensaje reentregado o reproducido no cambia nada.
Dos mensajes distintos con la misma marca de tiempo se conservan ambos. Cuando la API lee valores brutos, devuelve un punto por marca de tiempo. El último valor conserva el primero que vio para esa marca de tiempo.
Lecturas fuera de orden
Un dispositivo que almacena lecturas sin conexión y las envía después las entrega tras datos más recientes. Se guardan en el histórico con sus propias horas. No sustituyen un último valor más reciente. Las reglas de alarma tratan los registros más antiguos que la última evaluada como carga diferida: no se evalúan en directo, y una regla con carga diferida activada genera alarmas a partir de ellos sin notificar a nadie. Consulte Clear conditions and late readings.
Lecturas retrasadas por una interrupción
Los mensajes esperan en una cola mientras un worker de procesamiento está caído. Cuando la plataforma se recupera, un mensaje de dispositivo que esperó más que su time-to-live (5 minutos por defecto) es un mensaje tardío:
- Sigue pasando por su flujo raíz y se almacena. Un retraso acumulado son sus datos, por lo que nunca se descarta allí.
- Se marca como tardío (
msg.metadata.late). Los bloques que actúan fuera de la plataforma lo omiten: sin notificación, sin comando al dispositivo, sin llamada HTTP ni publicación MQTT (salvo que el ajuste late del bloque seasend), y sin evento emitido. - El bloque Alarm rules lo evalúa como carga diferida: las alarmas se escriben en el histórico, marcadas como Backfilled, y nadie es avisado por el pasado. Una alarma que siga abierta cuando se reanuden las lecturas en directo se anuncia entonces.
- Otros flujos que reaccionarían a ella (por ejemplo, un receptor
alarm) la descartan y la cuentan como Too old.
Consulte Protections and failed messages.
Zonas horarias
Todo se almacena en UTC. La consola, los paneles y las exportaciones muestran las horas en la zona del usuario que las consulta. Los resúmenes diarios van de medianoche a medianoche en UTC; consulte Aggregates and rollups para leer días locales.
Resolución de problemas
| Síntoma | Causa probable |
|---|---|
| Falta una lectura, pero las demás del mismo dispositivo están | Su ts estaba en el futuro o fuera de rango (bad_ts), o es más antigua que la ventana de datos brutos (too_old). Revise los registros de ejecución del flujo raíz. |
| Las lecturas aparecen horas o un día desfasadas | El dispositivo envía ts en hora local o en segundos. Envíe milisegundos UTC, o bien objetos planos. |
| El último valor no cambia aunque lleguen lecturas nuevas | Las nuevas lecturas llevan un ts anterior o igual al almacenado. |
| Una corrección de valor no aparece | Se envió con el mismo ts que el original; el último valor conserva el primero. Envíe la corrección con un ts nuevo. |
Consulte también Wrong times and gaps.

