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

Marcas de tiempo, lecturas tardías y duplicadas

Qué hora se asigna a una lectura, lecturas desde el futuro o el pasado, los ajustes de marca de tiempo, los duplicados y las lecturas retrasadas por una interrupción.

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 dispositivoAlmacenada 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 formasCada 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):

AjustePor defectoRango
Future timestamp tolerance (minutes)101 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ónSe rechaza una lectura cuando es más antigua que
7 días7 días
30 días7 días
90 días30 días
365 días90 días
1,095 días90 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:

  1. 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 ni ts nunca se trata como repetida: el mismo valor dos veces son dos lecturas.
  2. 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 sea send), 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íntomaCausa probable
Falta una lectura, pero las demás del mismo dispositivo estánSu 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 desfasadasEl 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 nuevasLas nuevas lecturas llevan un ts anterior o igual al almacenado.
Una corrección de valor no apareceSe 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.