Estado del sitio y clave de estado

Cada lugar de Hermetry Twin tiene un estado: Crítico, Aviso, OK o Desconocido. Las tablas de sitios y los mapas colorean los sitios según este estado, las tablas de desglose colorean plantas y salas, y las escenas 3D tiñen salas y áreas con él. Esta página explica de dónde procede el estado.

El estado de un dispositivo

El estado de un dispositivo es el peor de tres datos:

1. 
   Su clave de estado. El último valor de una clave de telemetría, por defecto status:

   Último valor (cualquier mayúscula o minúscula, los espacios se ignoran)	Estado
   critical, alarm, error, fault, danger, 2, true	Crítico
   warning, warn, 1	Aviso
   cualquier otro valor, por ejemplo ok, normal, 0, running	OK
   sin valor	(nada conocido por la clave)

2. 
   Sus alarmas activas. Cualquier alarma abierta o reconocida hace que el dispositivo sea como mínimo Aviso; una alarma CRITICAL lo convierte en Crítico. Las alarmas solo cuentan para las personas que pueden ver alarmas.
3. 
   Su conexión. Cuando ninguno de los anteriores dice nada, un dispositivo que está en línea, o que estuvo activo en los últimos 10 minutos, es OK.

Un dispositivo del que no se sabe nada (sin valor de estado, sin alarma, sin señal de vida) es Desconocido. El orden de peor a mejor es Crítico, Aviso, OK, Desconocido.

Agregación

El estado de un lugar es el peor estado de los dispositivos situados en él o en cualquier nivel inferior. Una sala toma su estado de sus dispositivos, una planta de sus salas, un edificio de sus plantas y un sitio de todo lo que hay debajo. Un sensor crítico en una sala hace que la sala, la planta, el edificio y el sitio sean críticos.

Los dispositivos que no puede leer no cuentan. Un lugar sin dispositivos, o sin ninguno que pueda leer, es Desconocido.

Dónde se muestra

Dónde	Qué
Plantilla de Sitios	La insignia de Estado de la tabla de sitios, el color de los marcadores del mapa, la cabecera de la página del sitio
Tablas de desglose (Estado bajo un activo)	Una fila por cada hijo con su estado, dispositivos y alarmas abiertas, del peor al mejor
Escenas 3D	Los elementos cuya clave coincide con el código de un activo Room o Area se tiñen con el estado de ese activo; si es crítico, pulsa
Tabla de Valores en vivo en la página de un sitio	El estado propio de cada dispositivo

La página Sitios y activos y su mapa muestran alarmas, no este estado: el mapa se colorea según la peor alarma activa.

Usar otra clave

Cada tabla de estado, mapa y cabecera de sitio lee una clave, por defecto status. En los ajustes de datos de la tarjeta, Clave de estado de los dispositivos permite usar otra clave, por ejemplo state o health, con el mismo vocabulario. Una clave tiene hasta 64 letras, dígitos, _, . o -.

Generar el estado en un flujo

La mayoría de los dispositivos no envían una clave status. Calcule una a partir de lo que envían, en el flujo raíz del dispositivo, y guárdela con Guardar telemetría:

1. 
   Abra el flujo raíz del perfil (o el flujo raíz del host IoT).
2. 
   Después del mensaje entrante, añada un bloque Calcular con target msg.payload.status y una expresión, por ejemplo para una cámara frigorífica:

   msg.payload.temperature > 8 ? "critical" : (msg.payload.temperature > 6 ? "warning" : "ok")

3. 
   Asegúrese de que la rama termina en Guardar telemetría, para que status se almacene junto con las lecturas.
4. 
   Despliegue el flujo.

Consejos:

• Genere el estado en el mismo mensaje que las lecturas de las que procede, para que ambos coincidan siempre. Véase Valores derivados.
• Almacene texto (ok, warning, critical) para los colores de los sitios. Para los gráficos, almacene también un número (status_code: 0, 1, 2), porque los gráficos leen números.
• Un estado calculado a partir de varios dispositivos (por ejemplo «alguna bomba de la estación parada») pertenece a un dispositivo que representa la estación, o a una regla de alarma: las alarmas abiertas elevan por sí mismas el estado del lugar.
• Si una regla de alarma ya cubre la condición, quizá no necesite una clave de estado: la alarma eleva el lugar a Aviso o Crítico mientras esté abierta.

Comparación de estado, alarmas y colores

	Clave de estado	Alarma
Procede de	El último valor de la clave en el dispositivo	Una regla, un flujo o un operador
Permanece	Hasta el siguiente valor	Hasta que se resuelve
Notifica	No	Sí, si la regla lo indica
Necesita permiso de alarmas para verla	No	Sí
Ideal para	Colorear lugares según la propia visión del dispositivo de sí mismo	Condiciones en las que las personas deben actuar

Diagnóstico de problemas

Problema	Causa
Un lugar aparece como Desconocido	Ningún dispositivo bajo él envía la clave, tiene una alarma abierta o estuvo activo en los últimos 10 minutos; o los dispositivos no están situados bajo él
Un lugar aparece en rojo aunque todo esté bien	Un dispositivo envía true, 1, 2 o una palabra como error en su clave de estado; o hay una alarma CRITICAL abierta
Un compañero ve verde donde usted ve rojo	Puede que no vea alarmas, así que las alarmas abiertas no cuentan para él
Una sala de la escena 3D no aparece teñida	La clave del elemento no coincide con el código de la sala, o el tipo del activo no es Room o Area