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

Números, texto y valores verdadero/falso

Cómo se almacena cada tipo de valor, qué pueden leer los gráficos y los agregados, y cómo almacenar estados y eventos para que su historial siga siendo útil.

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

TipoEjemploÚltimo valorHistorial bruto (hasta la ventana bruta)Resúmenes por minuto, hora y díaGráficos en ventanas largas
Número21.5SíSíSí (suma, recuento, mínimo, máximo, último)Sí
true / falsetrueSí, se muestra como On / OffAlmacenadoNoNo
Texto"running"SíAlmacenadoNoNo
JSON{"x": 1, "y": 2}SíAlmacenadoNoNo

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 deEnví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:

  1. Después del conmutador Message type, en la rama de telemetría, añada un bloque Change.
  2. Añada un paso: set msg.payload.door_open a la expresión msg.payload.door ? 1 : 0.
  3. Conserve la clave original door, o añada un segundo paso delete msg.payload.door para 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_large por 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_x a msg.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íntomaCausa y solución
Una tarjeta de valor muestra un valor, pero el gráfico indica No values in this windowLa clave es de texto o booleana. Almacene una copia numérica.
Una clave aparece como Text en la pestaña Telemetry aunque contiene númerosEl 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íoEl 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.