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 fila | Contiene |
|---|---|
| Dispositivo y tiempo | El id del dispositivo y la marca de tiempo del registro (milisegundos, UTC) |
| Números | Todos los valores numéricos, almacenados por id de clave |
| Otros valores | Booleanos, texto y valores JSON, almacenados por nombre de clave |
| Huella del mensaje | Un 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:
| Nivel | Contenido | Se rellena con |
|---|---|---|
| Agregados de 1 minuto | Por clave numérica y minuto: suma, recuento, mínimo, máximo y el último valor | Un trabajo que se ejecuta cada minuto |
| Resúmenes por hora | Las mismas cinco cifras por hora | Derivados de los agregados por minuto |
| Resúmenes por día | Las 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 tiempo | Se lee desde |
|---|---|
| Hasta 24 horas | Las filas de mensajes sin procesar (cada lectura) |
| Más largas | El 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
| Contador | Significado |
|---|---|
| Mensajes IoT | Mensajes de telemetría y de atributos aceptados de los dispositivos, contados al llegar, se almacenen o no mediante un flujo |
| Puntos de datos IoT almacenados | Los 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.

