Una regla de alarma avisa a las personas a través de su bloque notify. Sin él, la alarma se registra y se muestra, pero nadie recibe aviso. Esta página trata del bloque, de cuándo salen las notificaciones y de los ajustes de toda la organización que protegen a las personas de las avalanchas de avisos.
El bloque notify
El bloque se define en el modo JSON de la regla (el formulario lo conserva al editar otros campos). Las reglas de umbral y la regla de dispositivo sin conexión usan el mismo bloque.
"notify": {
"recipients": [
{ "kind": "role", "role": "ADMIN" },
{ "kind": "user", "userId": "6f1c2a9e-…" },
{ "kind": "email", "email": "oncall@example.com" }
],
"channels": ["inapp", "mail"],
"minSeverity": "MAJOR",
"repeatEverySec": 1800
}| Campo | Significado | Límites |
|---|---|---|
recipients | Quién recibe el aviso. Obligatorio en el bloque. | De 1 a 20 entradas |
channels | Restringe a estos identificadores de canal. Si no aparece: todos los canales que permita cada destinatario. | hasta 8 |
minSeverity | Por debajo de esta severidad la alarma se registra, pero nadie recibe aviso. Si no aparece: todas las severidades. | una severidad |
repeatEverySec | Recordatorio mientras la alarma siga Abierta y sin reconocer. Si no aparece: sin recordatorios. | De 60 s a 7 días |
Destinatarios
| Tipo | Ejemplo | Llega a |
|---|---|---|
user | { "kind": "user", "userId": "…" } | Un miembro activo de tu organización. Un usuario que no sea miembro activo se omite. |
role | { "kind": "role", "role": "OWNER" } | Cada miembro activo con ese rol integrado (OWNER, ADMIN, USER), calculado en el momento en que se dispara la alarma. |
email | { "kind": "email", "email": "noc@example.com" } | Solo esa dirección, por ejemplo un buzón compartido de guardia. No se aplican preferencias ni horas de silencio. |
- Los miembros y roles reciben el aviso en la campana, por notificación push y en sus aplicaciones de chat vinculadas. El correo electrónico solo llega a los destinatarios
email: añade la dirección explícitamente si quieres correo. - Las reglas de alarma no pueden nombrar equipos, roles personalizados ni números de teléfono. Para SMS, usa un flujo (consulta Notificaciones SMS).
- Una notificación llega como máximo a 100 personas después de expandir los roles; si una misma persona aparece dos veces, se le avisa una sola vez.
- No hay guardias rotativas ni cadenas de escalado para las alarmas de IoT. Usa roles, recordatorios y el aumento de severidad.
Canales
Identificadores de canal: inapp, mail, push, sms, y un identificador por cada plataforma de chat conectada. Indicar sms no tiene efecto para los destinatarios de alarmas, que no tienen número de teléfono en una regla.
Cuándo salen las notificaciones
| Cambio de alarma | Notificación | Título |
|---|---|---|
| Abierta (no retroactiva) | Sí, con minSeverity igual o superior | «Alarma de Severidad: título« |
| La severidad aumentó | Sí | «Escalada a Severidad: título« |
| La severidad bajó | No | |
| Se dispara de nuevo con la misma severidad | No | |
| Reconocida | No | |
| Resuelta | Sí, si se avisó de su apertura | «Resuelta: título» («… resuelta tras n min.») |
| Sigue abierta y sin reconocer | Un recordatorio cada repeatEverySec | «Sigue abierta: título« |
| Abierta a partir de lecturas tardías | No de inmediato; se anuncia una vez si sigue abierta cuando vuelven los datos en directo | igual que Abierta |
| Dispositivo silenciado | No; la línea de tiempo indica Silenciada: nadie fue notificado |
Los recordatorios se detienen cuando alguien reconoce o resuelve la alarma. El primer recordatorio llega repeatEverySec después de que la alarma se abriera.
Cada notificación enviada añade una línea Notificada a la línea de tiempo de la alarma, con el número de destinatarios y los canales.
Filtros, en orden
- Severidad mínima: por debajo de ella, nada.
- Silencio: un dispositivo silenciado no notifica a nadie. Consulta Silenciar un dispositivo por mantenimiento.
- Ventana de repetición: el mismo cambio de la misma condición de alarma en el mismo dispositivo (apertura, resolución, escalada a una severidad dada, un recordatorio concreto) se avisa como máximo una vez por ventana, 300 segundos por defecto. Así se evita que un dispositivo intermitente avise en cada ciclo, aunque cada reapertura sea una alarma nueva. Las notificaciones retenidas muestran Notificación retenida (limitación) en la línea de tiempo.
- Protección contra tormentas: ver abajo.
- Canales y preferencias de cada destinatario: consulta Tus preferencias de notificación.
Tormentas de alarmas
Cuando se disparan muchas alarmas a la vez (se corta la corriente de una planta, falla una red), las notificaciones individuales sepultarían las importantes.
- La organización envía como máximo 20 notificaciones de alarma por minuto, una a una (el umbral de tormenta).
- Por encima de ese número, las notificaciones de alarma se agrupan en un resumen. Cinco minutos después de la primera agrupada, cada persona que habría sido avisada recibe un único resumen: título «n nuevas alarmas», texto «n nuevas alarmas: 12 CRITICAL, 25 MAJOR.», con un enlace a las alarmas abiertas.
- Las alarmas CRITICAL siguen saliendo una a una durante una tormenta, hasta 60 por minuto; por encima de ese número también pasan al resumen.
- Un resumen que contiene una alarma crítica se envía como crítico.
El paso crítico
Con Las alarmas críticas ignoran las preferencias de notificación activado (por defecto), una notificación sobre una alarma CRITICAL (y sus recordatorios, escalada y resolución) llega a los destinatarios aunque hayan desactivado ese canal o estén en horas de silencio. No llega a los canales que la organización desactivó, a las direcciones bloqueadas ni a los canales sin dirección. El paso crítico de todo el servicio de notificaciones también debe estar activado (lo está por defecto).
Ajustes de alarmas
Los administradores abren Alarmas > icono de engranaje > Ajustes de alarmas («Tormentas de notificaciones, repeticiones y cuánto tiempo se conservan las alarmas resueltas»):
| Grupo | Ajuste | Por defecto | Rango |
|---|---|---|---|
| Notificaciones | Las alarmas críticas ignoran las preferencias de notificación | Activado | |
| Notificaciones | Ventana de repetición (segundos) | 300 | 60 a 86.400 |
| Tormentas de alarmas | Umbral de tormenta (por minuto) | 20 | 1 a 10.000 |
| Tormentas de alarmas | Alarmas críticas enviadas durante una tormenta (por minuto) | 60 | 1 a 10.000 |
| Historial | Conservar alarmas resueltas (días) | 365 | 0 (siempre) a 36.500 |
Los cambios quedan auditados y se aplican en unos cincuenta segundos. La página requiere el permiso para leer los ajustes de la organización; guardar requiere el permiso para cambiarlos.
Alarmas de flujos
Las alarmas generadas por el bloque Generar alarma de un flujo usan los ajustes propios del bloque: notify_to (identificadores de usuario, direcciones de correo, OWNER / ADMIN / USER), notify_channels, notify_min_severity y notify_repeat_sec. Pasan los mismos filtros. Las alarmas generadas por una acción de la tarjeta Reglas no tienen bloque notify; usa junto a ella una acción Avisar a las personas. Consulta Notificaciones desde reglas y flujos.
Recetas
| Necesidad | Bloque |
|---|---|
| Administradores desde Major, recordatorios cada 30 minutos | { "recipients": [ { "kind": "role", "role": "ADMIN" } ], "minSeverity": "MAJOR", "repeatEverySec": 1800 } |
| Un buzón compartido para todo | { "recipients": [ { "kind": "email", "email": "alarms@example.com" } ] } |
| Propietarios solo en la campana | { "recipients": [ { "kind": "role", "role": "OWNER" } ], "channels": ["inapp"] } |
| Solo críticas, para todo el equipo | { "recipients": [ { "kind": "role", "role": "USER" }, { "kind": "role", "role": "ADMIN" } ], "minSeverity": "CRITICAL" } |