La telemetría es lo que tus dispositivos miden e informan a lo largo del tiempo: temperaturas, niveles, contadores, estados. Esta sección explica qué ocurre con una lectura después de llegar, cuánto tiempo se conserva cada nivel de detalle, cómo puedes consultarla (en la consola, en paneles, a través de la API) y cómo cuentan las lecturas contra tu plan.
El recorrido de una lectura
- Un dispositivo envía un mensaje (MQTT, HTTP, LoRaWAN, una pasarela o un poller). El mensaje se cuenta dentro de tu cuota mensual de mensajes.
- El mensaje entra en tu flujo raíz, dividido en registros (uno por marca de tiempo), con las claves y los valores comprobados según las reglas de claves.
- El bloque Alarm rules evalúa las reglas de alarma del perfil del dispositivo.
- El bloque Save telemetry escribe el registro. Solo este bloque almacena telemetría: una rama sin él no almacena nada.
- El almacén guarda el mensaje, actualiza el último valor de cada clave del dispositivo, y el proceso de cada minuto agrupa los números en agregados de 1 minuto; después siguen los resúmenes por hora y por día.
- 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
| Tema | Dato |
|---|---|
| Claves | Hasta 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. |
| Valores | Nú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 tiempo | Milisegundos desde la época, en UTC. Las que estén más de 10 minutos en el futuro se descartan (ajustable). |
| Duplicados | Los mismos valores en el mismo instante para el mismo dispositivo se almacenan una sola vez. |
| Último valor | Solo se actualiza con una marca de tiempo estrictamente más reciente. |
| Agregados | Suma, recuento, mínimo, máximo y último de 1 minuto por clave numérica, y después resúmenes por hora y por día. |
| Retención | Una clase de 7, 30, 90, 365 o 1.095 días según tu plan. Las filas en bruto se conservan como máximo 90 días. |
| Cuota de mensajes | Se cuenta por mes. Superarla nunca detiene tus dispositivos. |
En esta sección
| Página | Qué cubre |
|---|---|
| Cómo se almacenan las lecturas | Filas de mensajes, el diccionario de claves, últimos valores, resúmenes |
| Claves de telemetría | Reglas de claves, prefijos reservados, raw, el límite de claves, ajustes de claves del perfil |
| Marcas de tiempo, lecturas tardías y duplicadas | Hora del dispositivo y hora de recepción, lecturas futuras y antiguas, duplicados, cortes |
| Números, texto y valores true/false | Qué leen los gráficos y cómo almacenar estados |
| Agregados y resúmenes | Intervalos, las siete funciones de agregación, increase para contadores |
| Cuánto tiempo se conservan los datos | Clases 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 datos | Descargas en CSV y Excel, la API, la exportación de la organización |
| La API de historial | GET /api/telemetry/series y latest, con ejemplos |
| Valores derivados | Cálculo y almacenamiento de nuevas claves en un flujo |
| Cuota y uso de mensajes | Qué cuenta como mensaje, asignaciones del plan, avisos |
Secciones relacionadas
- Dispositivos: conexión de dispositivos y los formatos de carga que envían. Consulta Referencia de temas y cargas MQTT.
- Paneles: gráficos, tablas y tarjetas de valor. Consulta Fuentes de datos y parámetros.
- Flujos: el flujo raíz que almacena los datos, y los flujos que calculan nuevos valores.