Un valor de telemetría puede ser un número, true/false, texto o un objeto o arreglo JSON. Los cuatro se almacenan, pero no son igual de útiles después: solo los números tienen un historial representable en gráficos y resúmenes. Decida el tipo de cada clave antes de que sus dispositivos entren en producción.
Qué aporta cada tipo
| Tipo | Ejemplo | Último valor | Historial bruto (hasta la ventana bruta) | Resúmenes por minuto, hora y día | Gráficos en ventanas largas |
|---|---|---|---|---|---|
| Número | 21.5 | Sí | Sí | Sí (suma, recuento, mínimo, máximo, último) | Sí |
true / false | true | Sí, se muestra como On / Off | Almacenado | No | No |
| Texto | "running" | Sí | Almacenado | No | No |
| JSON | {"x": 1, "y": 2} | Sí | Almacenado | No | No |
Los números escritos como texto ("21.5") se almacenan como texto, no como números. Envíe los números como números JSON.
Por qué los valores no numéricos no se grafican
- Los resúmenes son numéricos. El proceso por minuto suma, cuenta y compara números. Los textos, booleanos y valores JSON no tienen resumen por minuto, hora ni día.
- Las ventanas largas leen resúmenes. Un gráfico o una lectura de la API de más de 24 horas lee los resúmenes, por lo que una clave de texto o booleana no tiene puntos allí.
- Las ventanas cortas leen filas sin procesar, pero la pestaña Telemetry del dispositivo y los gráficos de líneas dibujan solo puntos numéricos; un punto no numérico no se dibuja.
Así, una clave de texto o booleana se ve bien en una tarjeta de valor (último valor), pero deja un hueco en una tendencia, y un increase, promedio o recuento sobre ella queda vacío.
Almacenar estados como números
Cuando quiera el historial de un estado, envíe (o derive) un número:
| En lugar de | Envíe |
|---|---|
"door": true / false | "door_open": 1 / 0 |
"state": "running" / "stopped" / "fault" | "state_code": 1 / 0 / 2, y mantenga "state": "running" para mostrarlo si lo desea |
"zone": "Hall B" | "zone_id": 12 |
"event": "sos" | "event_code": 3 |
Con valores 0/1:
- el promedio de una hora es la proporción de muestras que valieron 1 (por ejemplo, la proporción de muestras con la bomba en marcha; un dispositivo que informa a intervalo constante convierte esto en la proporción del tiempo);
- el máximo de un día indica si ocurrió alguna vez;
- la suma de una clave de 1 por evento cuenta los eventos.
Nombre los códigos en la Label del perfil de dispositivo y en las asignaciones de valores de su panel para que las personas vean palabras, no números.
Conversión en un flujo
Si no puede cambiar el dispositivo, convierta en el flujo raíz antes de Save telemetry. Por ejemplo, para añadir door_open a partir del booleano door:
- Después del conmutador Message type, en la rama de telemetría, añada un bloque Change.
- Añada un paso: set
msg.payload.door_opena la expresiónmsg.payload.door ? 1 : 0. - Conserve la clave original
door, o añada un segundo paso deletemsg.payload.doorpara almacenar solo el número.
Para estados de texto, use un Switch sobre msg.payload.state con una regla por estado, cada una seguida de un Change que establece msg.payload.state_code, y luego una las ramas en Save telemetry. Consulte Derived values.
Booleanos en el perfil
Establezca el Type de la clave en Yes / no en el perfil de dispositivo. Los paneles mostrarán entonces el valor como un indicador (en tarjetas de valor, interruptores y lámparas de estado). Esto cambia cómo se muestra el último valor, no cómo se almacena el historial.
Límites de texto
- Texto: hasta 1,024 caracteres. Un texto más largo elimina la clave (
string_too_long). - JSON: hasta 4 KiB cuando se escribe como JSON (
value_too_largepor encima de ese valor). - Un valor JSON se almacena completo. Si necesita uno de sus campos como tendencia, almacene ese campo como clave numérica propia, por ejemplo con un bloque Change que establece
msg.payload.pos_xamsg.payload.position.x.
Posiciones
Una tarjeta de mapa lee la latitud y la longitud de claves numéricas (por ejemplo lat y lng). Envíelas como números. Una posición dentro de un objeto JSON no puede graficarse ni usarse para reproducir rutas.
Solución de problemas
| Síntoma | Causa y solución |
|---|---|
| Una tarjeta de valor muestra un valor, pero el gráfico indica No values in this window | La clave es de texto o booleana. Almacene una copia numérica. |
| Una clave aparece como Text en la pestaña Telemetry aunque contiene números | El dispositivo envía números como texto ("21.5"). No tienen resúmenes y no pueden marcarse para la tendencia. Envíe números JSON, o conviértalos con number(msg.payload.key) en un flujo. |
| Un recuento o promedio de eventos siempre está vacío | El evento es texto. Almacene un 1 por evento (o un código de evento) como número. |
Consulte también A dashboard shows no data.

