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
- Un dispositivo envía un mensaje (MQTT, HTTP, LoRaWAN, una pasarela o un poller). El mensaje se contabiliza en tu cupo mensual de mensajes.
- 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.
- 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 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.
- 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. Lo que esté más de 10 minutos en el futuro se descarta (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 posterior. |
| Agregados | Suma, 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ón | Una 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 mensajes | Se cuenta por mes. Superarlo 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 los estados |
| Agregados y resúmenes | Intervalos, las siete funciones de agregado, 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 |
| Cupo y uso de mensajes | Qué cuenta como mensaje, cupos 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.

