Benachrichtigungen
Wozu das dient. Unter Benachrichtigungseinstellungen entscheidest du, welche Ereignisse dich erreichen, auf welchem Kanal und in welcher Lautstärke. Jede Einstellung ist eine Zeile Ereignismuster × Kanal. So landen Budgetwarnungen, Agentenereignisse und Ähnliches in der Glocke, per E-Mail, Telegram oder Webhook — ohne dich mit Rauschen zu wecken. Kritisch umgeht immer Ruhezeiten und Bündelung.
Wann du es nutzt
Abschnitt betitelt „Wann du es nutzt“- Manche Ereignisse sollen in die In-App-Glocke, andere nach Telegram oder E-Mail.
- Du willst nur Warnung und höher, nicht jedes Info.
- Du willst ein Ruhefenster (auch über Nacht), außer für Kritisch.
- Du willst eine Zusammenfassung statt einer Flut von Mails oder Webhook-POSTs.
- Du brauchst einen signierten HTTPS-Webhook für Automatisierung (n8n, Zapier, Home Assistant und ähnliche).
Typischer Ablauf
Abschnitt betitelt „Typischer Ablauf“- Öffne in der Seitenleiste Einstellungen → Gruppe Module → Benachrichtigungen (
/notifications-settings). - Unter Einstellung hinzufügen ein Ereignismuster eingeben (z. B.
agent.*,budget.warningoder*). - Kanal, Mindest-Schweregrad und Zustellungsmodus wählen.
- Optional Ruhig ab und Ruhig bis. Über-Nacht-Bereiche wie 22:00–07:00 funktionieren.
- Hinzufügen. Die Zeile erscheint unter Aktive Einstellungen.
- Ist der Kanal Webhook, Webhook-Endpunkt ausfüllen und Webhook speichern.
Du solltest die neue Zeile mit Muster, Kanal, ≥ Schweregrad und optional Zusammenfassung / Ruhe-Badges sehen.
Funktionen
Abschnitt betitelt „Funktionen“Eine Zeile pro Ereignismuster × Kanal. Muster sind Segment-Globs: * trifft alles; agent.* ein Segment nach agent; budget.warning nur dieses Ereignis.
Kanal: Web (In-App / WebSocket), E-Mail, Telegram, Webhook. E-Mail und Telegram liefern nur, wenn die Integration wirklich konfiguriert ist (SMTP aus Secrets / gekoppelter Telegram-Bot). Die Kanalwahl hier legt die Integration nicht an.
Sofort sendet jetzt. Gebündelt stellt eine Zusammenfassung in die Warteschlange (E-Mail und Webhook; Standardfenster fünf Minuten). Web und Telegram überspringen die Bündelung. Kritisch geht immer sofort und ignoriert Ruhezeiten.
Ruhezeiten nutzen HH:MM und können über Mitternacht laufen.
Ein Webhook-POST ist JSON (event, severity, title, body, data, createdAt, notificationId). Optionales gemeinsames Geheimnis setzt X-EYAS-Signature: sha256=… (HMAC-SHA256). Zusätzliche HTTP-Header können am Endpunkt gespeichert werden (API); das Formular hat URL, Geheimnis und Aktiviert. Hinweis der Seite: nur https-URLs; Loopback- und Metadaten-Hosts (169.254.169.254, .internal) sind blockiert.
Fehlgeschlagene Sends gehen in die Wiederholungswarteschlange (drei Versuche, exponentielles Backoff ab 30 Sekunden). Danach Fehlgeschlagen (Dead Letter). Wiederholungswarteschlange erscheint, wenn Retries aktiv sind.
Die Glocke in der Kopfzeile listet Benachrichtigungen und Gelesen-Markierung. Diese Seite sind nur die Einstellungen.
Felder und Steuerelemente
Abschnitt betitelt „Felder und Steuerelemente“Aktive Einstellungen
| Steuerung | Bedeutung |
|---|---|
| Aktive Einstellungen | Vorhandene Zeilen. Leer: Noch keine Einstellungen. Füge unten eine hinzu. |
| Ereignismuster-Badge | Getroffenes Glob, z. B. agent.* |
| Kanal-Badge | Web / E-Mail / Telegram / Webhook |
| ≥ Schweregrad | Mindestschwere dieser Zeile |
| Zusammenfassung | Wenn Zustellungsmodus Gebündelt ist |
ruhig ab–bis | Ruhezeiten dieser Zeile |
| Papierkorb | Zeile Muster × Kanal löschen |
Einstellung hinzufügen
| Steuerung | Bedeutung |
|---|---|
| Ereignismuster | Platzhalter: agent.* oder budget.warning oder * |
| Kanal | Web, E-Mail, Telegram, Webhook |
| Mindest-Schweregrad | Info, Warnung, Fehler, Kritisch |
| Zustellungsmodus | Sofort oder Gebündelt |
| Ruhig ab / Ruhig bis | Zeitfelder. Beide nötig, um Ruhezeiten zu speichern; leer = keine |
| Hinzufügen | Zeile speichern (deaktiviert bei leerem Muster) |
Webhook-Endpunkt
| Steuerung | Bedeutung |
|---|---|
| URL | Ziel. Platzhalter https://hooks.example.com/eyas |
| Gemeinsames Geheimnis (optional — aktiviert HMAC-SHA256-Signaturen) | Passwortfeld. Wenn schon eines existiert: (unverändert — leer lassen, um das bestehende zu behalten) |
| Aktiviert | Ungehakt: Webhook gespeichert, aber ungenutzt |
| Webhook speichern | URL / Geheimnis / Aktiviert persistieren (deaktiviert ohne URL) |
| Entfernen | Gespeicherten Webhook löschen (nur wenn einer existiert) |
Wiederholungswarteschlange
| Steuerung | Bedeutung |
|---|---|
| Ausstehend | Noch geplante Retries |
| Fehlgeschlagen (Dead Letter) | Versuche erschöpft |
| Aktualisieren | Einstellungen, Webhook und Retry-Statistik neu laden |