Une règle d’alarme informe les personnes par son bloc notify. Sans ce bloc, l’alarme est enregistrée et affichée, mais personne n’est notifié. Cette page décrit le bloc, le moment où les notifications partent et les paramètres de l’organisation qui protègent les personnes contre les inondations de notifications.
Le bloc notify
Le bloc se définit dans le mode JSON de la règle (le formulaire le conserve lorsque vous modifiez d’autres champs). Les règles de seuil et la règle Appareil hors ligne acceptent le même bloc.
"notify": {
"recipients": [
{ "kind": "role", "role": "ADMIN" },
{ "kind": "user", "userId": "6f1c2a9e-…" },
{ "kind": "email", "email": "oncall@example.com" }
],
"channels": ["inapp", "mail"],
"minSeverity": "MAJOR",
"repeatEverySec": 1800
}| Champ | Signification | Limites |
|---|---|---|
recipients | Les personnes informées. Obligatoire dans le bloc. | De 1 à 20 entrées |
channels | Limite les notifications à ces identifiants de canal. Absent : chaque canal autorisé par chaque destinataire. | jusqu’à 8 |
minSeverity | En dessous de cette gravité, l’alarme est enregistrée mais personne n’est informé. Absent : toutes les gravités. | une gravité |
repeatEverySec | Rappel tant que l’alarme reste Ouverte et non acquittée. Absent : aucun rappel. | de 60 s à 7 jours |
Destinataires
| Type | Exemple | Atteint |
|---|---|---|
user | { "kind": "user", "userId": "…" } | Un membre actif de votre organisation. Un utilisateur qui n’est pas membre actif est ignoré. |
role | { "kind": "role", "role": "OWNER" } | Chaque membre actif ayant ce rôle intégré (OWNER, ADMIN, USER), déterminé au moment où l’alarme se déclenche. |
email | { "kind": "email", "email": "noc@example.com" } | Cette adresse uniquement, par exemple une boîte aux lettres partagée d’astreinte. Aucune préférence ni plage de silence ne s’applique. |
- Les membres et les rôles sont atteints dans la cloche, par notification push et dans leurs applications de messagerie liées. Les e-mails ne partent que vers les destinataires
email: ajoutez l’adresse explicitement si vous voulez un courriel. - Les règles d’alarme ne peuvent pas désigner d’équipes, de rôles personnalisés ni de numéros de téléphone. Pour les SMS, utilisez un flux (voir Notifications SMS).
- Une notification atteint au plus 100 personnes après l’expansion des rôles ; une même personne désignée deux fois n’est informée qu’une fois.
- Il n’existe ni rotations d’astreinte ni chaînes d’escalade pour les alarmes IoT. Utilisez les rôles, les rappels et la hausse de gravité.
Canaux
Identifiants de canal : inapp, mail, push, sms, et un identifiant par plateforme de messagerie connectée. Indiquer sms n’a aucun effet pour les destinataires d’alarmes, qui n’ont pas de numéro de téléphone dans une règle.
Moment d’envoi des notifications
| Changement d’alarme | Notification | Titre |
|---|---|---|
| Ouverte (non rétroactive) | Oui, si gravité égale ou supérieure à minSeverity | « Alarme Gravité : titre« |
| Gravité en hausse | Oui | « Escaladée à Gravité : titre« |
| Gravité en baisse | Non | |
| Déclenchée à nouveau avec la même gravité | Non | |
| Acquittée | Non | |
| Résolue | Oui, si son ouverture a été notifiée | « Résolue : titre » (« … résolue après n min. ») |
| Toujours ouverte et non acquittée | Un rappel toutes les repeatEverySec | « Toujours ouverte : titre« |
| Ouverte à partir de mesures tardives | Pas immédiatement ; annoncée une fois si elle est toujours ouverte lorsque les données en direct reviennent | comme Ouverte |
| Appareil mis en sourdine | Non ; la chronologie indique Mis en sourdine : personne n’a été notifié |
Les rappels cessent lorsqu’une personne acquitte ou résout l’alarme. Le premier rappel arrive repeatEverySec après l’ouverture de l’alarme.
Chaque notification envoyée ajoute une ligne Notifiée à la chronologie de l’alarme, avec le nombre de destinataires et les canaux.
Filtres, dans l’ordre
- Gravité minimale : en dessous, rien.
- Sourdine : un appareil en sourdine n’informe personne. Voir Mettre un appareil en sourdine pour maintenance.
- Fenêtre de répétition : le même changement de la même condition d’alarme sur le même appareil (ouverture, résolution, escalade vers une gravité donnée, un rappel donné) n’est signalé qu’au plus une fois par fenêtre, 300 secondes par défaut. Cela empêche un appareil instable de déclencher une alerte à chaque cycle, même si chaque réouverture est une nouvelle alarme. Les notifications retenues affichent Notification retenue (limitation) dans la chronologie.
- Garde-fou de tempête : voir ci-dessous.
- Canaux et préférences de chaque destinataire : voir Vos préférences de notification.
Tempêtes d’alarmes
Lorsque de nombreuses alarmes se déclenchent en même temps (une coupure de courant sur un site, une panne réseau), les notifications individuelles noieraient les importantes.
- L’organisation envoie au plus 20 notifications d’alarme par minute, une à une (le seuil de tempête).
- Au-delà, les notifications d’alarme sont regroupées dans un condensé. Cinq minutes après la première notification regroupée, chaque personne qui aurait été informée reçoit un seul condensé : titre « n nouvelles alarmes », texte « n nouvelles alarmes : 12 CRITICAL, 25 MAJOR. », avec un lien vers les alarmes ouvertes.
- Les alarmes CRITICAL partent toujours une à une pendant une tempête, jusqu’à 60 par minute ; au-delà, elles rejoignent aussi le condensé.
- Un condensé qui contient une alarme critique est envoyé comme critique.
Le contournement critique
Lorsque Les alarmes critiques ignorent les préférences de notification est activé (par défaut), une notification concernant une alarme CRITICAL (ainsi que ses rappels, escalades et résolution) atteint les destinataires même s’ils ont désactivé ce canal ou sont en plage de silence. Elle n’atteint pas les canaux désactivés par l’organisation, les adresses bloquées ni les canaux sans adresse. Le contournement critique global du service de notification doit également être activé (il l’est par défaut).
Paramètres des alarmes
Les administrateurs ouvrent Alarmes > icône d’engrenage > Paramètres des alarmes (« Tempêtes de notifications, répétitions et durée de conservation des alarmes résolues ») :
| Groupe | Paramètre | Défaut | Plage |
|---|---|---|---|
| Notifications | Les alarmes critiques ignorent les préférences de notification | Activé | |
| Notifications | Fenêtre de répétition (secondes) | 300 | 60 à 86 400 |
| Tempêtes d’alarmes | Seuil de tempête (par minute) | 20 | 1 à 10 000 |
| Tempêtes d’alarmes | Alarmes critiques envoyées pendant une tempête (par minute) | 60 | 1 à 10 000 |
| Historique | Conserver les alarmes résolues (jours) | 365 | 0 (illimité) à 36 500 |
Les modifications sont auditées et s’appliquent dans environ une minute. La page exige le droit de lire les paramètres de l’organisation ; l’enregistrement exige le droit de les modifier.
Alarmes des flux
Les alarmes déclenchées par le bloc Déclencher une alarme d’un flux utilisent les paramètres propres à ce bloc : notify_to (identifiants d’utilisateurs, adresses e-mail, OWNER / ADMIN / USER), notify_channels, notify_min_severity et notify_repeat_sec. Elles passent par les mêmes filtres. Les alarmes déclenchées par une action de la carte Règles n’ont pas de bloc notify ; utilisez à côté une action Prévenir les personnes. Voir Notifications depuis les règles et les flux.
Exemples
| Besoin | Bloc |
|---|---|
| Administrateurs pour Major et plus, rappels toutes les 30 minutes | { "recipients": [ { "kind": "role", "role": "ADMIN" } ], "minSeverity": "MAJOR", "repeatEverySec": 1800 } |
| Une boîte partagée pour tout | { "recipients": [ { "kind": "email", "email": "alarms@example.com" } ] } |
| Propriétaires dans la cloche uniquement | { "recipients": [ { "kind": "role", "role": "OWNER" } ], "channels": ["inapp"] } |
| Critique uniquement, pour toute l’équipe | { "recipients": [ { "kind": "role", "role": "USER" }, { "kind": "role", "role": "ADMIN" } ], "minSeverity": "CRITICAL" } |