Notifications
À quoi ça sert. Les paramètres de notification décident quels événements vous atteignent, sur quel canal, et à quel volume. Chaque préférence est une ligne motif d’événement × canal. Ainsi les alertes de budget, événements d’agents et similaires arrivent dans la cloche, par e-mail, Telegram ou webhook — sans vous réveiller pour du bruit. La gravité Critique contourne toujours les heures calmes et le regroupement.
Quand l’utiliser
Section intitulée « Quand l’utiliser »- Vous voulez la cloche in-app pour certains événements et Telegram ou E-mail pour d’autres.
- Vous ne voulez que Avertissement et au-dessus, pas chaque Info.
- Vous voulez une fenêtre calme (y compris la nuit), sauf pour Critique.
- Vous voulez un résumé plutôt qu’une rafale d’e-mails ou de POST webhook.
- Vous avez besoin d’un webhook HTTPS signé pour l’automatisation (n8n, Zapier, Home Assistant et similaires).
Déroulement typique
Section intitulée « Déroulement typique »- Ouvrez dans la barre latérale Paramètres → groupe Modules → Notifications (
/notifications-settings). - Sous Ajouter une préférence, saisissez un Motif d’événement (par exemple
agent.*,budget.warningou*). - Choisissez Canal, Gravité minimale et Mode de livraison.
- Éventuellement Silence de et Silence jusqu’à. Les plages de nuit du type 22:00–07:00 fonctionnent.
- Ajouter. La ligne apparaît sous Préférences actives.
- Si le canal est Webhook, renseignez le Point de terminaison webhook puis Enregistrer le webhook.
Vous devez voir la nouvelle ligne avec le motif, le canal, ≥ gravité, et éventuellement les badges résumé / silence.
Fonctions
Section intitulée « Fonctions »Une ligne par motif d’événement × canal. Les motifs sont des globs par segment : * correspond à tout ; agent.* un segment après agent ; budget.warning uniquement cet événement.
Canal : Web (in-app / WebSocket), E-mail, Telegram, Webhook. E-mail et Telegram ne livrent que si l’intégration est réellement configurée (SMTP dans les Secrets / bot Telegram apparié). Choisir le canal ici ne crée pas cette intégration.
Immédiat envoie maintenant. Regroupé met un résumé en file (e-mail et webhook ; fenêtre par défaut cinq minutes). Web et Telegram sautent le regroupement. Critique part toujours tout de suite et ignore les heures calmes.
Les heures calmes utilisent HH:MM et traversent minuit.
Un POST webhook est du JSON (event, severity, title, body, data, createdAt, notificationId). Un secret partagé optionnel ajoute X-EYAS-Signature: sha256=… (HMAC-SHA256). Des en-têtes HTTP supplémentaires peuvent être stockés sur le point de terminaison (API) ; le formulaire a URL, secret et Activé. L’indication de la page : uniquement les URL https ; les hôtes loopback et de métadonnées (169.254.169.254, .internal) sont bloqués.
Les envois en échec vont dans la file de nouvelles tentatives (trois essais, backoff exponentiel à partir de 30 secondes). Ensuite Échoués (lettre morte). File de nouvelles tentatives s’affiche lorsque les retries sont activés.
La cloche de l’en-tête liste les notifications et le marquer comme lu. Cette page n’est que les préférences.
Champs et commandes
Section intitulée « Champs et commandes »Préférences actives
| Commande | Signification |
|---|---|
| Préférences actives | Lignes existantes. Vide : Aucune préférence pour le moment. Ajoutez-en une ci-dessous. |
| Badge de motif | Glob qui a correspondu, p. ex. agent.* |
| Badge de canal | Web / E-mail / Telegram / Webhook |
| ≥ gravité | Gravité minimale de cette ligne |
| résumé | Quand Mode de livraison est Regroupé |
silence de–jusqu'à | Heures calmes de cette ligne |
| Corbeille | Supprimer cette ligne motif × canal |
Ajouter une préférence
| Commande | Signification |
|---|---|
| Motif d’événement | Espace réservé : agent.* ou budget.warning ou * |
| Canal | Web, E-mail, Telegram, Webhook |
| Gravité minimale | Info, Avertissement, Erreur, Critique |
| Mode de livraison | Immédiat ou Regroupé |
| Silence de / Silence jusqu’à | Champs heure. Les deux sont requis pour enregistrer le silence ; vide = aucun |
| Ajouter | Enregistrer la ligne (désactivé si le motif est vide) |
Point de terminaison webhook
| Commande | Signification |
|---|---|
| URL | Destination. Espace réservé https://hooks.example.com/eyas |
| Secret partagé (facultatif — active les signatures HMAC-SHA256) | Champ mot de passe. Si un secret existe déjà : (inchangé — laissez vide pour conserver l’existant) |
| Activé | Décoché, le webhook est stocké mais inutilisé |
| Enregistrer le webhook | Persister URL / secret / activé (désactivé sans URL) |
| Retirer | Supprimer le webhook stocké (seulement s’il en existe un) |
File de nouvelles tentatives
| Commande | Signification |
|---|---|
| En attente | Retries encore planifiés |
| Échoués (lettre morte) | Tentatives épuisées |
| Actualiser | Recharger préférences, webhook et stats de retry |