Las reglas de alarma pertenecen a un perfil de dispositivo, y todos los dispositivos del perfil las usan. Esta página añade una regla: una alarma de temperatura alta que se activa tras tres lecturas seguidas por encima de 80 °C y se desactiva cuando la temperatura vuelve a 77 °C o menos. Después prueba la regla y añade una notificación.
Lo que necesita
- El rol Admin o superior (permiso para gestionar reglas de alarma).
- Un dispositivo que envíe
temperature. Consulte Conecte su primer dispositivo.
1. Abra las reglas de alarma del perfil
- Abra Perfiles de dispositivo en el menú IoT.
- Abra el perfil que usa su dispositivo (en una organización nueva, Default).
- Seleccione la pestaña Reglas de alarma («Evaluadas para cada mensaje de los dispositivos de este perfil por el paso de reglas de alarma del flujo predeterminado.»).
2. Añada la regla
- Seleccione Añadir regla y elija Regla de umbral.
- Complete el formulario:
| Campo | Valor | Qué hace |
|---|---|---|
| Tipo | high_temperature | El nombre de este tipo de alarma. Letras, dígitos y _ . : -, único en el perfil. Un dispositivo tiene como máximo una alarma abierta por tipo. |
| Título de la alarma | {{device.name}}: temperature {{value}} °C | El texto que ven las personas. {{device.name}}, {{value}}, {{key}}, {{threshold}}, {{severity}} y {{type}} se rellenan automáticamente. |
| Gravedad | Major | Lo grave que es. |
| Cuándo: Clave, Operador, Valor | temperature, >, 80 | La condición. El valor también puede ser attribute:<name> para usar un límite almacenado en cada dispositivo. |
- Abra Avanzado y configure:
| Campo | Valor | Qué hace |
|---|---|---|
| Contar en | Lecturas seguidas | Cuenta muestras, no segundos. |
| Activar tras este número de lecturas seguidas | 3 | Una lectura aislada no activa la alarma. |
| Desactivar tras este número de lecturas seguidas | 3 | Una lectura buena no la cierra. |
| Histéresis (margen de desactivación) | 3 | La alarma se mantiene mientras la temperatura esté por encima de 77, así que solo se desactiva en 77 o menos. |
| Manual de actuación | Check the burner and the flue sensor. | Se muestra a la persona que gestiona la alarma. |
- Seleccione Añadir a la lista y, después, Guardar reglas. Nada se aplica hasta que guarde; la pestaña indica cuántas reglas están modificadas y sin guardar.
Consejo
Si temperature no está declarada en la pestaña Claves de telemetría del perfil, el formulario la marca como Clave desconocida. Aun así puede guardar; la regla se activa en los dispositivos que envíen la clave.
3. Pruébela
Envíe tres mensajes seguidos con una temperatura superior a 80:
for t in 85 86 87; do
mosquitto_pub -h <broker host> -p 8883 --capath /etc/ssl/certs \
-u "<ACCESS_TOKEN>" -q 1 -t v1/telemetry -m "{\"temperature\": $t}"
done
Tras el tercer mensaje se abre una alarma con gravedad Major y estado Open. Podrá verla:
- en la página Alarmas del menú IoT,
- en la pestaña Alarmas del dispositivo,
- en la campana de la barra superior.
Después envíe tres mensajes con 77 o menos. La alarma se resuelve automáticamente y muestra Resolved.
4. Avise a las personas
Una regla no notifica a nadie hasta que añada destinatarios. Añádalos en JSON:
- Abra de nuevo la regla con Editar y cambie de Formulario a JSON.
- Añada un bloque
notifyjunto a los demás campos:
"notify": {
"recipients": [
{ "kind": "role", "role": "ADMIN" },
{ "kind": "email", "email": "maintenance@example.com" }
],
"minSeverity": "MAJOR",
"repeatEverySec": 3600
}
- Seleccione Actualizar la lista y, después, Guardar reglas.
| Campo | Significado |
|---|---|
recipients | De 1 a 20 entradas: un usuario ({"kind": "user", "userId": "…"}), un rol integrado (OWNER, ADMIN o USER), o una dirección de correo electrónico. |
channels | Opcional: los canales a utilizar, por ejemplo ["inapp", "mail"]. Si se omite, se usa cada canal que permita el destinatario. |
minSeverity | Opcional: por debajo de esta gravedad la alarma se registra, pero nadie es avisado. |
repeatEverySec | Opcional: un recordatorio mientras la alarma siga abierta y sin reconocer, de 60 segundos a 7 días. |
Los miembros y los roles se contactan en la aplicación (la campana), por notificación push y en las aplicaciones de chat vinculadas. El correo electrónico se envía solo a las direcciones que indiques como destinatarios de email, así que añade una para cada bandeja de entrada que deba recibir la alarma. Consulta Notificaciones de alarma en detalle.
Nota
De forma predeterminada, una alarma Critical llega a sus destinatarios aunque hayan silenciado ese tipo de notificación. Un administrador puede cambiarlo en Alarmas > Configuración de alarmas (Critical alarms ignore notification preferences).
Consulte Notificaciones de alarma en detalle para tormentas, resúmenes y repeticiones.
5. Gestione la alarma
Cualquier miembro puede Acknowledge una alarma, opcionalmente con una nota («What did you do?»). Desactivarla manualmente (Clear) requiere el rol Admin. La mayoría de las alarmas se desactivan por sí solas cuando termina la condición. Consulte Trabajar con alarmas.
También útil
- Una alarma cuando un dispositivo deja de enviar datos: añada una Device offline rule (Open after (seconds offline), de 10 segundos a 7 días). Consulte Alarmas por desconexión.
- Un límite distinto por dispositivo: establezca el valor en
attribute:maxTempy almacenemaxTempcomo atributo de servidor en cada dispositivo. Consulte Atributos. - Un perfil puede contener hasta 50 reglas de alarma. Consulte Reglas de alarma en perfiles de dispositivo.

