Esta página explica qué escribe Hermetry cuando un flujo guarda una lectura, y por qué. Conocer esto le 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 elimina el bloque (o la rama que conduce a él), las lecturas dejan de almacenarse. El dispositivo sigue mostrándose 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.
Consulte 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 su organización recibe un número pequeño en un diccionario por organización la primera vez que se almacena. El diccionario es compartido por todos sus dispositivos: temperature es una sola clave tanto si la envía un dispositivo como 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 nueva clave 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 mantiene 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 leen de él.
El último valor solo se actualiza con una marca de tiempo estrictamente más reciente:
- Una lectura con una marca de tiempo anterior (un retraso almacenado en búfer que llega después de una más reciente) se guarda 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.
Así, 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 con rapidez:
| Nivel | Contenido | Generado por |
|---|---|---|
| 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. 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. Consulte Agregados y resúmenes.
Qué fuente usa una lectura
| Ventana de tiempo | Se lee de |
|---|---|
| Hasta 24 horas | Las filas de mensajes sin procesar (cada lectura) |
| Más larga | El resumen más fino que se mantiene por debajo de 10.000 intervalos: minutos, luego horas, luego días |
También puede pedir una resolución específica en la API. Consulte La API de historial.
Retención
Cada nivel se conserva durante su propio periodo. Las filas sin procesar 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
Tras confirmar un guardado, 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
Eliminar un dispositivo borra 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. |
Consulte Cuota de mensajes y uso.