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

Cómo se almacenan las lecturas

Lo que el almacén de telemetría guarda para cada mensaje de dispositivo: filas de mensajes, el diccionario de claves, los últimos valores y los resúmenes por minuto, hora y día.

Esta página explica qué escribe Hermetry cuando un flujo guarda una lectura, y por qué. Conocer esto te ayuda a predecir lo que devuelve un gráfico o la API, y por qué algunos valores aparecen en un lugar pero no en otro.

Solo los flujos almacenan datos

Un mensaje de dispositivo se almacena porque un flujo lo indica. Cada organización empieza con un flujo raíz predeterminado que recibe todos los mensajes de dispositivo y guarda la telemetría y los atributos de cliente. El bloque Guardar telemetría es la única forma en que se escribe la telemetría:

  • Si eliminas el bloque (o la rama que lleva a él), las lecturas dejan de almacenarse. El dispositivo sigue apareciendo como en línea, porque la conexión se controla por separado.
  • Solo se almacena msg.payload. Los metadatos del mensaje (el topic, el transporte, el nombre del dispositivo) nunca se almacenan.
  • Una ejecución de prueba de un flujo nunca almacena nada.

Consulta Hosts, el flujo raíz y los flujos raíz de perfil.

Una fila por mensaje

Cuando el bloque Guardar telemetría escribe un registro, el almacén añade una fila para todo el registro, no una fila por clave:

Parte de la filaContiene
Dispositivo y tiempoEl id del dispositivo y la marca de tiempo del registro (milisegundos, UTC)
NúmerosTodos los valores numéricos, almacenados por id de clave
Otros valoresBooleanos, texto y valores JSON, almacenados por nombre de clave
Huella del mensajeUn hash de los valores, usado para reconocer el mismo mensaje entregado dos veces

Un registro con 8 claves es una sola fila. Esto mantiene el almacenamiento compacto y permite que la API devuelva un mensaje completo de una vez.

El diccionario de claves

Cada clave que usa tu organización recibe un número pequeño en un diccionario por organización la primera vez que se almacena. El diccionario lo comparten todos tus dispositivos: temperature es una sola clave, ya la envíe un dispositivo o diez mil.

  • Las claves nunca se renombran ni se reutilizan. Una clave permanece en el diccionario después de que se eliminen los dispositivos que la enviaron.
  • Su plan puede limitar el número de claves distintas. Una clave nueva por encima del límite no se almacena, mientras que las demás claves del mismo registro sí. Consulte Claves de telemetría.

Últimos valores

Junto al historial, el almacén guarda un último valor por dispositivo y clave, con su marca de tiempo. Las tarjetas de valor de los paneles, la pestaña Telemetría del dispositivo y el bloque de flujo Últimos valores lo leen.

El último valor solo cambia con una marca de tiempo estrictamente más reciente:

  • Una lectura con una marca de tiempo anterior (un retraso en búfer que llega después de una más reciente) se almacena en el historial, pero no reemplaza el último valor.
  • Un reenvío corregido con la misma marca de tiempo se almacena como mensaje propio si sus valores difieren, pero el último valor conserva el primero.

De este modo, el historial, los últimos valores y la vista en directo siempre coinciden.

Agregados y resúmenes

Los números también se resumen para que las ventanas de tiempo largas se lean rápido:

NivelContenidoSe rellena con
Agregados de 1 minutoPor clave numérica y minuto: suma, recuento, mínimo, máximo y el último valorUn trabajo que se ejecuta cada minuto
Resúmenes por horaLas mismas cinco cifras por horaDerivados de los agregados por minuto
Resúmenes por díaLas mismas cinco cifras por día (UTC)Derivados de los agregados por minuto

El texto, los booleanos y los valores JSON no se agregan. Una lectura que llega tarde para un minuto ya resumido marca ese minuto para una nueva pasada, de modo que los datos tardíos se incorporan. Consulta Agregados y resúmenes.

Desde qué fuente lee una consulta

Ventana de tiempoSe lee desde
Hasta 24 horasLas filas de mensajes sin procesar (cada lectura)
Más largasEl resumen más fino que se mantiene por debajo de 10.000 bloques: minutos, luego horas, luego días

También puedes pedir una resolución específica en la API. Consulta La API de historial.

Retención

Cada nivel se conserva durante su propio tiempo. Las filas brutas se conservan como máximo 90 días, los agregados por minuto como máximo 31 días, y los resúmenes por hora y por día durante toda la clase de retención de su plan. Consulte Cuánto tiempo se conservan los datos.

Valores en directo

Una vez confirmado el almacenamiento, los nuevos valores se envían a los paneles abiertos y a las páginas de dispositivo que observan el dispositivo. Un valor que no se guardó (por ejemplo, una clave que el flujo raíz filtra) nunca aparece en directo. La entrega en directo es de como máximo cuatro actualizaciones por segundo y por clave; los valores intermedios se almacenan igualmente.

Cuando se elimina un dispositivo

Al eliminar un dispositivo se borran en segundo plano sus lecturas, agregados por minuto, resúmenes y últimos valores, un día de datos cada vez. Las claves que usó permanecen en el diccionario.

Recuento

ContadorSignificado
Mensajes IoTMensajes de telemetría y de atributos aceptados de los dispositivos, contados al llegar, se almacenen o no mediante un flujo
Puntos de datos IoT almacenadosLos valores que el almacén insertó realmente. Un duplicado descartado por el almacén no se cuenta. Sin cuota.

Consulta Cuota de mensajes y uso.