Alerting einrichten
Lassen Sie eine fachliche Bedingung regelmäßig im Hintergrund prüfen und einen festgelegten Empfängerkreis benachrichtigen. Dafür wird Grafana Alerting verwendet, wenn Ihr Zugang Regeln bearbeiten darf und ein geprüfter Benachrichtigungsweg bereitsteht.
Ein Dashboard zeigt Daten, wenn es geöffnet wird. Eine Alert-Regel prüft dagegen eine Abfrage in einem festen Intervall. Bleibt eine relevante Bedingung lange genug erfüllt, wechselt die Regel in einen Alarmzustand und verwendet den dafür eingerichteten Benachrichtigungsweg.
Abweichung festlegen
Messwert, Schwelle, Zeitraum und fachliche Bedeutung eindeutig beschreiben.
Regel aufbauen
Geprüfte Abfrage, Auswertungsintervall und Mindestdauer konfigurieren.
Empfänger verbinden
Freigegebenen Kontaktpunkt und verständliche Nachricht auswählen.
Alarmweg testen
Auslösung, Nachricht und Rückkehr in den Normalzustand kontrolliert prüfen.
Ein belastbarer Alert: Die Nachricht beschreibt eine fachlich relevante Abweichung, erreicht den vorgesehenen Empfängerkreis und verweist auf einen vereinbarten nächsten Schritt.
Wofür fachliches Alerting geeignet ist
| Bedarf | Beispielbedingung | In der Nachricht erforderlich |
|---|---|---|
| Grenzwert überwachen | Ein Pegelstand liegt länger als die vereinbarte Dauer über der Meldehöhe. | Messstelle, Wert, Schwelle, Zeitpunkt und Dashboard-Link |
| Aktualität überwachen | Für eine erwartete Messreihe ist länger als zulässig kein neuer Wert eingetroffen. | Datenbestand, letzter Messzeitpunkt und erwartetes Intervall |
| Wertebereich überwachen | Eine fachliche Kennzahl verlässt einen abgestimmten plausiblen Bereich. | Kennzahl, gemessener Wert, zulässiger Bereich und betroffener Kontext |
Alerting ist nicht sinnvoll, wenn niemand auf die Nachricht reagieren soll, die Schwelle fachlich ungeklärt ist oder bereits jede kurzfristige Messspitze eine Meldung auslösen würde.
Voraussetzungen klären
Regeln bearbeitbar
Die Alerting-Oberfläche ist erreichbar und der eigene Zugang darf Regeln für die vorgesehene Datenquelle bearbeiten.
Abfrage fachlich geprüft
Zeitspalte, Messwert, Filter und Einheit liefern unabhängig vom Alert das erwartete Ergebnis.
Kontaktpunkt bereitgestellt
Ein freigegebener Empfängerweg ist eingerichtet und mit einer Testnachricht geprüft.
Nächster Schritt vereinbart
Empfänger wissen, wie sie die Abweichung prüfen und an welche Stelle sie sich wenden.
Die UDSP stellt die technische Grafana-Funktion bereit, legt aber standardmäßig keine fachlichen Alert-Regeln, Kontaktpunkte oder Benachrichtigungsrichtlinien für Ihren Anwendungsfall an. Fehlen Kontaktpunkt, Rechte oder Freischaltung, müssen diese vor der Benutzeraufgabe administrativ bereitgestellt werden.
Benachrichtigungsweg auswählen
Grafana sendet einen Alarm über einen Kontaktpunkt. Ein Kontaktpunkt kann einen oder mehrere eingerichtete Versandwege enthalten. Dadurch kann dieselbe fachliche Meldung beispielsweise per E-Mail und – bei zusätzlich angebundenem SMS-Dienst – als SMS zugestellt werden.
Eine oder mehrere Funktions- oder Empfängeradressen über den für Grafana eingerichteten SMTP-Dienst benachrichtigen.
SMS
Kurze Alarmmeldungen über einen freigegebenen externen SMS-Anbieter, Webhook-Adapter oder geeigneten Incident-Dienst versenden.
Chat oder Incident-Dienst
Abgestimmte Ziele wie Teams, Slack, PagerDuty oder einen allgemeinen Webhook als weiteren Kontaktpunkt anbinden.
Mehrere Wege
Eine Meldung parallel an mehrere Ziele senden oder je nach Regel und Dringlichkeit unterschiedlich routen.
E-Mail ist in der UDSP der direkt vorgesehene Weg, sofern für die Grafana-Instanz ein realer SMTP-Dienst mit zulässigem Absender eingerichtet wurde. Der Kontaktpunkt enthält die Empfängeradressen; SMTP-Server und Zugangsdaten werden administrativ konfiguriert und nicht von Benutzern in einer Alert-Regel hinterlegt.
SMS ist nicht standardmäßig eingerichtet. Grafana besitzt in der UDSP keinen allgemeinen SMS-Versanddienst. Soll eine SMS versendet werden, muss die Administration zuerst einen geeigneten Anbieter oder Vermittlungsdienst anbinden – beispielsweise über eine freigegebene Grafana-Integration oder einen geschützten Webhook. Dabei sind Kosten, Rufnummernverarbeitung, Datenschutz, Geheimnisse des Anbieters und Zustellgrenzen zu klären. Tragen Sie API-Schlüssel eines SMS-Dienstes nicht selbst in eine Regel ein.
Ein Kontaktpunkt kann mehrere eingerichtete Ziele enthalten. Alternativ können Benachrichtigungsrichtlinien unterschiedliche Kontaktpunkte nach Regelmerkmalen routen. Kombinieren Sie E-Mail und SMS erst, nachdem beide Wege einzeln getestet wurden. Legen Sie außerdem fest, ob auch die Rückkehr in den Normalzustand über beide Wege gemeldet werden soll.
Legen Sie für den gewünschten Versandweg mindestens Folgendes fest:
| Festlegung | Beispiel | Warum sie benötigt wird |
|---|---|---|
| Kontaktpunkt | Pegelbereitschaft E-Mail oder Pegelbereitschaft SMS | Regel und tatsächlichen Versandweg eindeutig verbinden |
| Empfänger | Funktionsadresse oder freigegebene Bereitschaftsnummern | persönliche Einzelziele und ungeklärte Verteiler vermeiden |
| Meldungsinhalt | Messstelle, Wert, Schwelle, Zeitpunkt und Dashboard-Link | Abweichung ohne Blick in Grafana einordnen |
| Auflösung | Normalzustand ebenfalls melden | Empfänger erkennen, wann die Bedingung nicht mehr besteht |
| Routing | SMS nur für freigegebene hohe Dringlichkeit | Kosten und unnötige Alarmierung begrenzen |
| Funktionstest | kontrollierte Testmeldung je Versandweg | Empfänger, Inhalt und technische Zustellung gemeinsam nachweisen |
Fehlt eine dieser Voraussetzungen, senden Sie noch keine Testalarme an einen beliebigen Empfängerkreis. Fordern Sie die Einrichtung mit folgenden Angaben an:
- Grafana-Fachinstanz und verwendete Datenquelle,
- fachlicher Zweck der Regel und gewünschter Empfängerkreis,
- benötigter Kontaktweg, beispielsweise E-Mail oder ein zusätzlich angebundener SMS-Dienst,
- vorgesehene Funktionsadresse beziehungsweise freigegebener Rufnummernkreis,
- Person oder Stelle, die eine Testnachricht abnimmt, sowie
- gewünschter Termin für den kontrollierten Funktionstest.
Nutzen Sie dafür die Anleitung Hilfe anfordern. Zugangsdaten, Tokens und vollständige personenbezogene Datensätze gehören nicht in die Anfrage.
Beispiel: Pegelstand oberhalb einer Meldehöhe
Das Beispiel erweitert den Datenbestand des Pegel-Dashboards. Die dort dargestellten Schwellen dienen der Visualisierung; ein produktiver Benachrichtigungsversand ist nicht Bestandteil des bestätigten Referenzstands. Eine konkrete Ausgestaltung mit Grenzwert- und Aktualitätsregel zeigt die Referenzseite Alerting für Pegelstände einrichten. Aktivieren Sie diese Regeln erst mit einer separat freigegebenen Meldehöhe und zulässigen Datenlücke je Messstelle.
Eine mögliche Regel lautet:
Wenn
waterleveleiner Messstelle länger als fünf Minuten über der für diese Messstelle abgestimmten Meldehöhe liegt, benachrichtige den festgelegten Empfängerkreis und verlinke das Pegel-Dashboard.
Für diese Regel werden mindestens benötigt:
dateobservedals fachlicher Messzeitpunkt,waterlevelals numerischer Messwert,- eine eindeutig zugeordnete Messstelle,
- eine freigegebene Meldehöhe je Messstelle,
- eine Mindestdauer gegen kurze Messspitzen sowie
- ein geklärtes Verhalten bei fehlenden Daten oder einer fehlerhaften Abfrage.
1. Abfrage und Bedingung getrennt prüfen
Erstellen oder verwenden Sie zuerst die zugrunde liegende Dashboardabfrage. Vergleichen Sie einen bekannten Wert und Zeitraum mit dem gespeicherten Datenbestand. Erst wenn die Abfrage stimmt, wird daraus eine Alert-Regel.
Bei einer PostgreSQL-Datenquelle muss die Alert-Abfrage eine Zeitspalte und numerische Werte im Zeitreihenformat liefern. Verlassen Sie sich in der Regel nicht auf Dashboardvariablen; die Auswertung läuft unabhängig von einer geöffneten Dashboardansicht.
Formulieren Sie die Bedingung so, dass Wert und Schwelle erkennbar sind. Ergänzen Sie eine Mindestdauer, wenn eine kurzzeitige Überschreitung noch keine relevante Abweichung darstellt.
2. No Data und Fehler bewusst behandeln
Eine ausbleibende Datenlieferung ist nicht dasselbe wie ein normaler Messwert unterhalb der Schwelle. Legen Sie ausdrücklich fest, wie die Regel mit folgenden Zuständen umgeht:
- Abfrage liefert keine Daten,
- Daten sind älter als das erwartete Aktualisierungsintervall,
- Datenquelle oder Abfrage meldet einen Fehler,
- Bedingung ist nach einer Überschreitung wieder normal.
Soll fehlende Aktualität selbst eine Benachrichtigung auslösen, verwenden Sie dafür eine eigene Regel. So bleibt in der Nachricht erkennbar, ob ein Fachwert auffällig ist oder die Datengrundlage fehlt.
3. Nachricht und Reaktionsweg festlegen
Verwenden Sie einen bereits freigegebenen Kontaktpunkt. Die Nachricht sollte ohne Blick in die Regel mindestens beantworten:
- Welche fachliche Bedingung ist eingetreten?
- Welcher Datenbestand, Ort oder Messpunkt ist betroffen?
- Welcher Wert wurde zu welchem Zeitpunkt ausgewertet?
- Wo lässt sich der Verlauf im zugehörigen Dashboard prüfen?
- Was ist der vereinbarte nächste Schritt?
Für eine E-Mail können Betreff und Nachricht diese Angaben ausführlich enthalten. Eine SMS bleibt kurz: Benennen Sie mindestens Alarmzustand, betroffenes Objekt, Zeitpunkt und einen sicheren Kurzlink zur weiteren Prüfung. Übermitteln Sie keine personenbezogenen oder anderweitig schützenswerten Fachdaten per SMS oder Chat, wenn dieser Versandweg dafür nicht ausdrücklich freigegeben ist.
Wählen Sie anschließend, ob die Regel direkt an einen Kontaktpunkt sendet oder über eine Benachrichtigungsrichtlinie geroutet wird. Eine Richtlinie ist sinnvoll, wenn mehrere Regeln denselben Empfängerkreis verwenden, unterschiedliche Dringlichkeiten getrennt werden oder E-Mail und SMS nicht bei jedem Alarm parallel ausgelöst werden sollen.
Ein Alert ohne erreichbaren Empfänger oder vereinbarten Reaktionsweg ist noch keine funktionsfähige Benachrichtigungslösung.
4. Auslösung und Normalzustand testen
Testen Sie den gesamten Weg kontrolliert, bevor die Regel regulär aktiv bleibt:
- Prüfen Sie die Regel zunächst mit einem bekannten Zeitraum oder abgestimmten Testwert.
- Kontrollieren Sie, ob die Mindestdauer kurze Ausschläge wie vorgesehen unterdrückt.
- Prüfen Sie Inhalt, Empfänger und Dashboard-Link der Nachricht.
- Stellen Sie sicher, dass eine Rückkehr in den Normalzustand erkannt und – falls vorgesehen – mitgeteilt wird.
- Dokumentieren Sie Regel, Datenquelle, Schwelle, Empfängerkreis und den fachlichen Reaktionsweg.
Diese Anleitung betrifft Bedingungen in Fachdaten der mandantenspezifischen Grafana-Instanz. Alarme zu Pods, Diensten, Datenbanken, Backups oder Clusterressourcen laufen über Prometheus und Alertmanager und gehören in die Betriebsdokumentation. Ein fachlicher Alert ersetzt außerdem keine sichtbare Aktualitätsanzeige im Dashboard.