Notifications et événements¶
NGX Ops dispose de trois mécanismes complémentaires.
| Mécanisme | Pour qui | Contenu |
|---|---|---|
| Cloche d'en-tête | L'opérateur connecté | Ce qui mérite son attention, avec un niveau et un état lu ou non lu |
| Journal des événements | L'audit | Toute action, y compris administrative |
| Courriel | Les destinataires configurés | Une sélection d'événements |
Les webhooks, décrits dans API REST et webhooks, sont déclenchés par le journal des événements.
La cloche¶
La cloche se trouve dans l'en-tête, entre le sélecteur de langue et l'utilisateur courant. Elle remonte par exemple :
- un certificat qui arrive à expiration ou qui a expiré ;
- un certificat obtenu, renouvelé ou en échec avec Certbot ;
- une cible supervisée qui tombe, puis qui remonte ;
- un comportement anormal détecté par l'analyseur ;
- un rechargement ou un redémarrage planifié de Nginx, réussi ou en échec.
Chaque entrée a un niveau (info, success, warning, error) et un état lu ou non lu. Un badge indique le nombre de notifications non lues. Le navigateur interroge le dashboard toutes les 5 secondes par défaut (NOTIF_POLL_INTERVAL_SEC).
- Le fil est partagé entre tous les utilisateurs : l'état lu ou non lu n'est pas propre à chacun.
- Les trois rôles y ont accès, y compris
viewer. - Les notifications sont conservées 90 jours (
NOTIF_CENTER_RETENTION_DAYS).
Le journal des événements¶
La page Events liste chronologiquement les actions : démarrage d'un conteneur, sauvegarde manuelle, modification d'une règle d'analyse, connexion MFA, approbation d'un agent… Chaque événement a un type (backup.manual, agents.approve, auth.mfa.failed…), un auteur et des données associées.
Le journal est conservé 30 jours par défaut (EVENTS_RETENTION_DAYS).
Les courriels¶
L'envoi de courriels se configure dans deux fichiers de config/. Ils sont relus à chaque envoi : une modification n'impose pas de redémarrer.
Le serveur SMTP : smtp.yml¶
enable: true
host: smtp.example.com
port: 587
security: tls # tls (STARTTLS), ssl (SMTPS) ou plain
ignore_ssl: false # true pour accepter un certificat auto-signé
from: [email protected]
from_name: NGX Ops
username: [email protected]
password: secret
Laissez username vide si le serveur n'exige pas d'authentification. Ce fichier contient un mot de passe : limitez ses droits et ne le publiez pas dans un dépôt Git.
Les événements envoyés : notifications.yml¶
Chaque section peut être activée avec enable, et possède sa liste de destinataires.
| Section | Événement | Réglages |
|---|---|---|
cert_expiry |
Certificat qui arrive à expiration | days_before (30), urgent_days (5) |
nginx_test_error |
Échec du test de configuration | — |
nginx_reload |
Rechargement de Nginx | — |
backup_failure |
Échec d'une sauvegarde | — |
analyzer_alert |
Alerte de l'analyseur (force brute, scan, flood, volumétrie) | — |
cert_expiry:
enable: true
days_before: 30
urgent_days: 5
recipients:
- [email protected]