Cada tarjeta de datos lee una fuente de datos: una consulta que devuelve un valor, una serie, una tabla o un registro. Los parámetros hacen que un mismo tablero funcione para muchos dispositivos o sedes. Los filtros de clave acotan un conjunto de dispositivos según sus valores. Esta página enumera las fuentes IoT, explica cómo funcionan la ventana temporal y las agregaciones, y muestra cómo crear un tablero que siga el dispositivo o la sede que elija el usuario.
Cómo obtiene una tarjeta sus datos
Un widget declara ranuras: lo que necesita, nunca de dónde procede. Un indicador necesita un valor; un gráfico de líneas necesita una serie; una tabla necesita filas. En la pestaña Datos de la tarjeta rellena cada ranura:
- Elija la fuente y la consulta, por ejemplo Un valor de un dispositivo (en vivo).
- Complete sus campos: el dispositivo (o Tomarlo del tablero, véase abajo) y el valor.
- Seleccione Guardar.
La ranura de serie de un gráfico de líneas, barras o áreas admite hasta 8 fuentes (+ Añadir otra fuente), de modo que un mismo gráfico puede mostrar valores de varios dispositivos.
Incluir también los datos de muestra y las fuentes para desarrolladores muestra fuentes pensadas para pruebas. Déjelo desactivado en los tableros de producción.
Fuentes de datos IoT
| Consulta | Devuelve | En vivo |
|---|---|---|
| Un valor de un dispositivo (en vivo) | Una clave de un dispositivo, elegida entre los valores que envía el dispositivo | Sí |
| Lecturas de un dispositivo a lo largo del tiempo (en vivo) | Hasta 20 claves de un dispositivo en la ventana temporal, agregadas por intervalo. auto sigue los primeros números que envía el dispositivo. | Sí |
| Últimos valores de muchos dispositivos (una fila por dispositivo) | Una fila por dispositivo (todos, un perfil o los dispositivos de un parámetro) con hasta 20 claves; como máximo 500 filas | Consultado periódicamente |
| Últimos valores de un dispositivo como un único registro | Hasta 20 claves de un dispositivo como un único registro (para Atributos o un Formulario) | Consultado periódicamente |
| Todos los últimos valores de un dispositivo | Una fila por clave con su nombre y unidad (como máximo 500) | Consultado periódicamente |
| Los valores en vivo de un dispositivo, para su dibujo o vista 3D | Una fila por elemento de un dispositivo que envía claves <element>.<field> | Consultado periódicamente |
| Un elemento del diagrama de proceso de un dispositivo, Un elemento de un dispositivo a lo largo del tiempo (en vivo), Las lecturas de un elemento, con nombre para una persona | La fila de un elemento, su tendencia o sus lecturas por nombre | Mixta |
| Dispositivos (estado de conexión en vivo) | Sus dispositivos con conexión, estado, perfil y última conexión; filtros por perfil, estado y conexión; como máximo 500 filas | Sí |
| Un atributo del dispositivo en una posición de un conjunto | Un atributo de servidor o compartido, por ejemplo la dirección en vivo de una cámara | Consultado periódicamente |
| Alarmas (en vivo) | Alarmas por estado (Activa, Abierta, Reconocida, Resuelta, Todos los estados) y gravedad; como máximo 500 filas | Sí |
| Recuento de alarmas por gravedad (en vivo) | Un recuento por gravedad | Sí |
| Sedes y activos (el árbol como filas), Activos de un alias, Dispositivos bajo un activo | El árbol de activos, los activos de un parámetro, los dispositivos bajo un activo | Consultado periódicamente |
| Estado bajo un activo | Una fila por hijo: peor estado, dispositivos, alarmas abiertas | Consultado periódicamente |
| Una sede para la cabecera de una página | Nombre, lugar, estado, dispositivos, alarmas abiertas, última conexión | Consultado periódicamente |
Los nombres, unidades, decimales y rangos de valores proceden de las claves de telemetría del perfil del dispositivo. Cada consulta comprueba sus permisos: un dispositivo que no puede leer responde como vacío, igual que uno que no existe.
Ventana temporal y agregaciones
Un gráfico que sigue la ventana del tablero (Usar la ventana temporal del tablero) muestra el periodo que elige el usuario en la barra de herramientas. Una tarjeta también puede fijar su propia ventana (Fijar: últimos …) o mostrar el periodo inmediatamente anterior (misma duración) para comparar.
| Ajuste | Valores |
|---|---|
| Ventanas relativas | Últimos 5, 15 o 30 minutos; 1, 6, 12 o 24 horas; 3, 7, 14, 30, 90 o 365 días; cualquier otro «últimos N minutos, horas o días» |
| Periodos de calendario | Esta hora, Hoy, Esta semana, Esta semana (desde lunes), Este mes, Este trimestre, Este semestre, Este año, y el anterior de cada uno; Ayer, Anteayer, Este mismo día la semana pasada |
| Ventana más larga | 366 días |
| Intervalo de agrupación | auto, 1, 5, 10, 15 o 30 minutos, 1, 2, 6 o 12 horas, 1 o 7 días |
| Número máximo de intervalos en una ventana | 500 (un intervalo más fino se amplía) |
Con auto, una ventana de hasta 1 hora se agrupa por minuto, hasta 1 día por 5 minutos, hasta 7 días por hora, y las ventanas más largas por día.
La agregación de Lecturas de un dispositivo a lo largo del tiempo es una de las siguientes:
| Agregación | Por intervalo |
|---|---|
avg, min, max | Promedio, valor más bajo, valor más alto |
last | El último valor |
sum, count | Total, número de lecturas |
increase | Para contadores (energía, contadores de agua): el aumento desde el intervalo anterior. Una bajada se toma como reinicio del contador y cuenta desde cero. El primer intervalo cuenta lo que subió dentro de él. |
Las ventanas de más de 24 horas se responden con agregados almacenados, no con lecturas en bruto. Las lecturas en bruto se conservan de 7 a 90 días según la clase de retención de su organización (definida por su plan); los agregados por minuto hasta 31 días; los agregados por hora y por día para toda la clase (hasta 1.095 días). Consulte Cuánto tiempo se conservan los datos y Agregados y rollups.
Una ventana sin zona horaria usa la zona horaria del navegador del usuario. Los ajustes del tablero pueden permitir que los usuarios cambien el Intervalo de agrupación, la Agregación (Promedio, Mínimo, Máximo, Suma, Recuento, Ninguna (valores en bruto)) y la Zona horaria. Guardar como predeterminado (solo editores) mantiene la ventana para todos.
Parámetros
Un parámetro es un valor o una entidad que leen las tarjetas. Abra Gestionar parámetros… mientras personaliza. Un tablero admite hasta 16 parámetros de valor y 48 parámetros en total; la barra de filtros muestra como máximo 16.
| Tipo | Ejemplo |
|---|---|
| Valor: texto, Valor: número, Valor: fecha, Valor: sí o no, Valor: lista fija, Valor: lista desde una dirección | Un umbral, un turno, un producto |
| Entidad (un dispositivo, un activo…) | El dispositivo del que trata la página |
Para un parámetro de entidad usted elige:
| Ajuste | Opciones |
|---|---|
| Cómo se elige | El usuario elige; La página o un enlace lo define; Fijo: una entidad; Fijo: una lista; Todos del tipo; Por nombre; Por subtipo o perfil; Relacionado con otro parámetro o entidad |
| Uno o varios | Una entidad o Varias entidades |
| En la barra de filtros | Visible, el usuario puede cambiarlo, Visible, no se puede cambiar, Oculto |
La clave de un parámetro empieza por una letra minúscula y tiene como máximo 40 letras, dígitos o guiones bajos. Renombrar una clave rompe las tarjetas y los enlaces que usan la anterior. No puede eliminar un parámetro que todavía usen tarjetas, páginas, filtros u otros parámetros; la ventana los nombra.
Vincular una tarjeta a un parámetro
En el campo de datos de la tarjeta, elija Tomarlo del tablero y seleccione el parámetro, o El dispositivo que muestra esta página. Cuando una tarjeta toma un dispositivo y el parámetro contiene una sede, la tarjeta toma los dispositivos bajo la sede; si hay varios, muestra «?p.device=…), de modo que un enlace copiado abre la misma vista.
Límites: un conjunto resuelto contiene como máximo 500 entidades (las primeras 500 por nombre); una lista fija contiene como máximo 100; profundidad de relación de 1 a 10 niveles.
Filtros de clave
Un filtro de clave acota un parámetro de entidad por valores, por ejemplo «dispositivos cuyo temperature es superior a 30″. Abra Gestionar filtros de clave….
- Una clave es un campo de entidad, un atributo (ámbito any, client, shared o server) o telemetría más reciente.
- Tipos de valor: Texto, Número, Booleano, Fecha y hora.
- Operaciones: igual, distinto, mayor, mayor o igual, menor, menor o igual, entre, en, no en, está definido, no está definido, es verdadero, es falso, empieza por, termina en, contiene, no contiene.
- Una las condiciones con Y: coinciden todas o O: coincide cualquiera.
- Marque un filtro como editable para permitir que los visualizadores lo cambien.
Límites: 16 filtros por panel, 8 filtros de clave por filtro, 4 condiciones por filtro de clave.
Datos en vivo
Las tarjetas marcadas como en vivo se actualizan mientras el panel está abierto. Un panel usa una única conexión para todas sus tarjetas. Las tarjetas que no pueden actualizarse en vivo se refrescan según su intervalo; una tabla con paginación siempre se refresca según su intervalo. Cuando la conexión en vivo no está disponible, el panel muestra «Actualizaciones en vivo no disponibles — sondeo».
Lecturas en registros de negocio
Una clave de dispositivo también puede alimentar un campo de un registro de negocio, por ejemplo el contador de un activo. Configúrelo en Asignación de lecturas en el menú ⋯ de Dispositivos, o en la pestaña Feeds de un dispositivo.