Notifications d'administration¶
Les super-admins reçoivent une liste de notifications d'administration, distincte de la boîte personnelle (notify.web) qui reste inchangée.
Niveaux¶
| Niveau | Sens | Exemples |
|---|---|---|
info |
rien à faire | mise à jour automatique d'un plugin appliquée |
todo |
une action humaine est attendue | mise à jour en attente (politique « notify »), secret manquant, CI rouge |
warning |
quelque chose est cassé | worker en échec, synchronisation en échec, repli de modèle (model.fallback) |
Où les voir¶
- Pastille numérotée dans l'en-tête de l'administration (nombre de notifications non lues).
- Page Notifications (
/notifications) : section d'administration, boutons « Acquitter » et « Tout acquitter ». - API :
GET /api/v1/notifications?scope=admin[&unread_only=true](sansscope, la boîte personnelle). - Opérations :
core.notification.list,core.notification.ack(ids),core.notification.ack_all. Réservées aux super-admins.
Dédoublonnage¶
Chaque notification porte une clé (dedup_key). Tant qu'une notification de même clé est non lue, aucune autre n'est créée. Après acquittement, la même clé ne peut être recréée qu'au bout d'une heure : un problème qui revient se revoit, une boucle de plantages ne noie pas la liste.
Depuis un plugin¶
await self.notify("warning", "Quota presque atteint", "92 % utilisés", action_url="/admin/plugins/mon-plugin", dedup_key="quota")
Le niveau est info, todo ou warning. La source est forcée au nom du plugin, la clé est préfixée par le plugin, 20 notifications par minute au plus. Le texte est expurgé des secrets et tronqué ; action_url doit être un chemin de l'instance (/…) ou une URL https://.
E-mail des warnings¶
Chaque nouvelle notification warning (pas les doublons tant qu'elle n'est pas acquittée) est envoyée par e-mail à tous les super-administrateurs actifs dont l'adresse est vérifiée, par la file d'envoi de l'instance (voir Envoi d'e-mails). Sans SMTP configuré, rien ne part. Les niveaux info et todo restent dans l'interface seulement.