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

Telemetría y datos

Cómo Hermetry almacena las lecturas de los dispositivos: últimos valores, historial, agregados, retención, exportación, la API de historial y el recuento mensual de mensajes.

La telemetría es lo que tus dispositivos miden y notifican a lo largo del tiempo: temperaturas, niveles, contadores, estados. Esta sección explica qué ocurre con una lectura una vez que llega, cuánto tiempo se conserva cada nivel de detalle, cómo se consulta de nuevo (en la consola, en los paneles, a través de la API) y cómo cuentan las lecturas frente a tu plan.

El recorrido de una lectura

  1. Un dispositivo envía un mensaje (MQTT, HTTP, LoRaWAN, una pasarela o un poller). El mensaje se contabiliza en tu cupo mensual de mensajes.
  2. El mensaje entra en tu flujo raíz, se divide en registros (uno por marca de tiempo), y las claves y los valores se comprueban según las reglas de claves.
  3. El bloque Alarm rules evalúa las reglas de alarma del perfil del dispositivo.
  4. El bloque Save telemetry escribe el registro. Solo este bloque almacena telemetría: una rama sin él no almacena nada.
  5. El almacén guarda el mensaje, actualiza el último valor de cada clave del dispositivo, y el trabajo por minuto agrupa los números en agregados de 1 minuto; después se generan los resúmenes por hora y por día.
  6. Los paneles, la pestaña Telemetry del dispositivo, los flujos y la API leen los últimos valores, las filas en bruto o los resúmenes, según la ventana temporal.

Consulta Cómo se almacenan las lecturas y Hosts, el flujo raíz y los flujos raíz de perfil.

Datos clave

TemaDato
ClavesHasta 64 caracteres de A-Z a-z 0-9 _ . -, distinguen mayúsculas y minúsculas. Los prefijos _, fw_, current_fw_ y cfg. están reservados.
ValoresNúmeros, true/false, texto de hasta 1.024 caracteres, objetos o arrays JSON de hasta 4 KiB. Solo los números se representan en gráficos y se agregan.
Marcas de tiempoMilisegundos desde la época, en UTC. Lo que esté más de 10 minutos en el futuro se descarta (ajustable).
DuplicadosLos mismos valores en el mismo instante para el mismo dispositivo se almacenan una sola vez.
Último valorSolo se actualiza con una marca de tiempo estrictamente posterior.
AgregadosSuma, recuento, mínimo, máximo y último de cada clave numérica en intervalos de 1 minuto, y después resúmenes por hora y por día.
RetenciónUna clase de 7, 30, 90, 365 o 1,095 días según su plan. Las filas brutas se conservan como máximo 90 días.
Cupo de mensajesSe cuenta por mes. Superarlo nunca detiene tus dispositivos.

En esta sección

PáginaQué cubre
Cómo se almacenan las lecturasFilas de mensajes, el diccionario de claves, últimos valores, resúmenes
Claves de telemetríaReglas de claves, prefijos reservados, raw, el límite de claves, ajustes de claves del perfil
Marcas de tiempo, lecturas tardías y duplicadasHora del dispositivo y hora de recepción, lecturas futuras y antiguas, duplicados, cortes
Números, texto y valores true/falseQué leen los gráficos y cómo almacenar los estados
Agregados y resúmenesIntervalos, las siete funciones de agregado, increase para contadores
Cuánto tiempo se conservan los datosClases de retención y lo que conserva cada nivel de detalle
La pestaña Telemetry del dispositivoÚltimos valores y el gráfico de tendencia en la página del dispositivo
Exportación de datosDescargas en CSV y Excel, la API, la exportación de la organización
La API de historialGET /api/telemetry/series y latest, con ejemplos
Valores derivadosCálculo y almacenamiento de nuevas claves en un flujo
Cupo y uso de mensajesQué cuenta como mensaje, cupos del plan, avisos

Secciones relacionadas