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 baja a 77 °C o menos. Después prueba la regla y añade una notificación.
Lo que necesitas
- El rol Admin o superior (permiso para gestionar reglas de alarma).
- Un dispositivo que envíe
temperature. Consulta Conecta tu primer dispositivo.
1. Abre las reglas de alarma del perfil
- Abre Device Profiles en el menú IoT.
- Abre el perfil que usa tu dispositivo (en una organización nueva, Default).
- Selecciona la pestaña Alarm rules («Evaluada para cada mensaje de los dispositivos de este perfil por el paso de reglas de alarma del flujo por defecto.»).
2. Añade la regla
- Selecciona Add rule y elige Threshold rule.
- Rellena el formulario:
| Campo | Valor | Qué hace |
|---|---|---|
| Type | 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. |
| Alarm title | {{device.name}}: temperature {{value}} °C | El texto que ven las personas. {{device.name}}, {{value}}, {{key}}, {{threshold}}, {{severity}} y {{type}} se rellenan automáticamente. |
| Severity | Major | Lo grave que es. |
| When: Key, Operator, Value | temperature, >, 80 | La condición. El valor también puede ser attribute:<name> para usar un límite almacenado en cada dispositivo. |
- Abre Advanced y configura:
| Campo | Valor | Qué hace |
|---|---|---|
| Count in | Readings in a row | Cuenta muestras, no segundos. |
| Raise after this many readings in a row | 3 | Una lectura aislada no activa la alarma. |
| Clear after this many readings in a row | 3 | Una lectura buena no la cierra. |
| Hysteresis (clear margin) | 3 | La alarma se mantiene mientras la temperatura esté por encima de 77, así que se desactiva solo en 77 o menos. |
| Runbook | Check the burner and the flue sensor. | Se muestra a la persona que gestiona la alarma. |
- Selecciona Add to list y luego Save rules. Nada se aplica hasta que guardes; la pestaña indica cuántas reglas están cambiadas y sin guardar.
Consejo
Si temperature no está declarada en la pestaña Telemetry keys del perfil, el formulario la marca como Unknown key. Aun así puedes guardar; la regla se activa en los dispositivos que envíen la clave.
3. Pruébala
Envía 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}"
doneTras el tercer mensaje se abre una alarma con severidad Major y estado Open. La verás:
- en la página Alarms del menú IoT,
- en la pestaña Alarms del dispositivo,
- en la campana de la barra superior.
Después envía tres mensajes con 77 o menos. La alarma se resuelve automáticamente y muestra Resolved.
4. Avisa a las personas
Una regla no notifica a nadie hasta que añades destinatarios. El formulario todavía no muestra los ajustes de notificación, así que añádelos como JSON:
- Vuelve a abrir la regla con Edit y cambia de Form a JSON.
- Añade un bloque
notifyjunto a los demás campos:
"notify": {
"recipients": [
{ "kind": "role", "role": "ADMIN" },
{ "kind": "email", "email": "maintenance@example.com" }
],
"minSeverity": "MAJOR",
"repeatEverySec": 3600
}- Selecciona Update the list y luego Save rules.
| 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 usar, por ejemplo ["inapp", "mail"]. Si se omite, se usa cada canal que permita el destinatario. |
Los miembros y roles se alcanzan en la aplicación (la campana) y en las aplicaciones de chat vinculadas. El correo electrónico solo llega a las direcciones que enumeres como destinatarios email, así que añade una para cada bandeja que deba recibir la alarma. Consulta Notificaciones de alarma en detalle.
| minSeverity | Opcional: por debajo de esta severidad 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. |
Nota
Por defecto, una alarma Critical llega a sus destinatarios aunque hayan silenciado ese tipo de notificación. Un administrador puede cambiarlo en Alarms > Alarm settings (Critical alarms ignore notification preferences).
Consulta Notificaciones de alarma en detalle para tormentas, resúmenes y repeticiones.
5. Gestiona la alarma
Cualquier miembro puede Acknowledge una alarma, opcionalmente con una nota («What did you do?»). Desactivarla a mano (Clear) requiere el rol Admin. La mayoría de las alarmas se desactivan por sí solas cuando termina la condición. Consulta Trabajar con alarmas.
También útil
- Una alarma cuando un dispositivo deja de enviar datos: añade una Device offline rule (Open after (seconds offline), de 10 segundos a 7 días). Consulta Alarmas de desconexión.
- Un límite distinto por dispositivo: define el valor como
attribute:maxTempy almacenamaxTempcomo atributo de servidor en cada dispositivo. Consulta Atributos. - Un perfil puede contener hasta 50 reglas de alarma. Consulta Reglas de alarma en perfiles de dispositivo.