Anfragen und Bedingungen

Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die Grafana-Version 10.x unterstützen.

Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. Arbeitet in Grafana-Version 9

Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. Arbeitet in Grafana-Version 8

In Grafana spielen Abfragen eine wichtige Rolle beim Abrufen und Transformieren von Daten aus unterstützten Datenquellen, zu denen Datenbanken wie MySQL und PostgreSQL, Zeitreihendatenbanken wie Prometheus, InfluxDB und Graphite sowie Dienste wie Amazon OpenSearch CloudWatch, Azure Monitor und Google Cloud Monitoring gehören.

Weitere Informationen zu unterstützten Datenquellen finden Sie unter. Datenquellen und Grafana-Alerting

Beim Ausführen einer Abfrage müssen Sie die Datenquelle definieren, die gewünschten Daten angeben, die abgerufen werden sollen, und die entsprechenden Filter oder Transformationen anwenden. Für die Erstellung dieser Abfragen werden Abfragesprachen oder Syntaxen verwendet, die für die gewählte Datenquelle spezifisch sind.

In Alerting definieren Sie eine Abfrage, um die Daten abzurufen, die Sie messen möchten, und eine Bedingung, die erfüllt sein muss, bevor eine Warnungsregel ausgelöst wird.

Eine Warnungsregel besteht aus einer oder mehreren Abfragen und Ausdrücken, die die Daten auswählen, die Sie messen möchten.

Weitere Informationen zu Abfragen und Ausdrücken finden Sie unterDaten abfragen und transformieren.

Datenquellenabfragen

Abfragen in Grafana können je nach verwendeter Datenquelle und Abfragesprache auf verschiedene Arten angewendet werden. Der Abfrage-Editor jeder Datenquelle bietet eine maßgeschneiderte Benutzeroberfläche, mit der Sie Abfragen schreiben können, die die einzigartigen Funktionen nutzen.

Aufgrund der Unterschiede zwischen den Abfragesprachen sieht jeder Abfrage-Editor für Datenquellen anders aus und funktioniert auch anders. Abhängig von Ihrer Datenquelle bietet der Abfrage-Editor möglicherweise Funktionen zur automatischen Vervollständigung, Metriknamen, Variablenvorschläge oder eine visuelle Oberfläche zur Abfrageerstellung.

Zu den gängigen Typen von Abfragekomponenten gehören:

Metriken oder Datenfelder — Geben Sie die spezifischen Metriken oder Datenfelder an, die Sie abrufen möchten, z. B. CPU-Auslastung, Netzwerkverkehr oder Sensorwerte.

Zeitraum — Definieren Sie den Zeitraum, für den Sie Daten abrufen möchten, z. B. die letzte Stunde, einen bestimmten Tag oder einen benutzerdefinierten Zeitraum.

Filter — Wenden Sie Filter an, um die Daten anhand bestimmter Kriterien einzugrenzen, z. B. das Filtern von Daten nach einem bestimmten Tag, Host oder einer bestimmten Anwendung.

Aggregationen — Führen Sie Aggregationen der Daten durch, um Kennzahlen wie Durchschnittswerte, Summen oder Zahlen über einen bestimmten Zeitraum zu berechnen.

Gruppierung — Gruppieren Sie die Daten nach bestimmten Dimensionen oder Tags, um aggregierte Ansichten oder Aufschlüsselungen zu erstellen.

Anmerkung

Grafana unterstützt keine Warnabfragen mit Vorlagenvariablen. Weitere Informationen finden Sie hier in den Grafana Labs-Foren.

Ausdrucksabfragen

In Grafana wird ein Ausdruck verwendet, um Berechnungen, Transformationen oder Aggregationen an den abgefragten Daten der Datenquelle durchzuführen. Es ermöglicht Ihnen, benutzerdefinierte Metriken zu erstellen oder bestehende Metriken auf der Grundlage mathematischer Operationen, Funktionen oder logischer Ausdrücke zu ändern.

Mithilfe von Ausdrucksabfragen können Benutzer Aufgaben wie die Berechnung der prozentualen Änderung zwischen zwei Werten, die Anwendung von Funktionen wie logarithmischen oder trigonometrischen Funktionen, die Aggregation von Daten über bestimmte Zeitbereiche oder Dimensionen und die Implementierung bedingter Logik zur Behandlung verschiedener Szenarien ausführen.

In Alerting können Sie nur Ausdrücke für von Grafana verwaltete Warnungsregeln verwenden. Für jeden Ausdruck können Sie aus den Mathe-, Reduce- und Resampling-Ausdrücken wählen. Diese Regeln werden als multidimensionale Regeln bezeichnet, da sie für jede Serie eine separate Warnung generieren.

Sie können auch eine klassische Bedingung verwenden, bei der eine Warnungsregel erstellt wird, die eine einzelne Warnung auslöst, wenn ihre Bedingung erfüllt ist. Infolgedessen sendet Grafana nur eine einzige Warnung, selbst wenn die Alarmbedingungen für mehrere Serien erfüllt sind.

Anmerkung

Klassische Bedingungen existieren hauptsächlich aus Kompatibilitätsgründen und sollten nach Möglichkeit vermieden werden.

Reduzieren

Aggregiert Zeitreihenwerte im ausgewählten Zeitbereich zu einem einzigen Wert.

Math (Mathematik)

Führt mathematische Funktionen/Operationen in freier Form mit Zeitreihen- und Zahlendaten aus. Kann zur Vorverarbeitung von Zeitreihendaten oder zur Definition einer Warnbedingung für Zahlendaten verwendet werden.

Resampling

Ordnet einen Zeitbereich einem neuen Satz von Zeitstempeln neu zu. Dies ist nützlich, wenn Zeitreihendaten aus verschiedenen Datenquellen verglichen werden, bei denen die Zeitstempel sonst nicht übereinstimmen würden.

Threshold

Überprüft, ob Zeitreihendaten der Schwellenwertbedingung entsprechen.

Mit dem Schwellenwertausdruck können Sie zwei Einzelwerte vergleichen. Er kehrt zurück0, wenn die Bedingung falsch ist und 1 wenn die Bedingung wahr ist. Die folgenden Schwellenwertfunktionen sind verfügbar:

• Liegt über (x > y)

• Liegt darunter (x < y)

• Liegt darunter (x y1 UND x < y2)

• < y1 AND x >Liegt außerhalb des Bereichs (x y2)

Klassischer Zustand

Überprüft, ob Zeitreihendaten der Warnbedingung entsprechen.

Anmerkung

Klassische Abfragen mit Bedingungsausdrücken erzeugen immer nur eine Warnungsinstanz, unabhängig davon, wie viele Zeitreihen die Bedingung erfüllen. Klassische Bedingungen existieren hauptsächlich aus Kompatibilitätsgründen und sollten nach Möglichkeit vermieden werden.

Aggregationen

Grafana Alerting bietet die folgenden Aggregationsfunktionen, mit denen Sie Ihre Abfrage weiter verfeinern können.

Diese Funktionen sind nur für Bedingungsausdrücke vom Typ Reduce und Classic verfügbar.

Funktion	Expression	Was macht es
avg	Reduzieren//Klassisch	Zeigt den Durchschnitt der Werte an
min	Reduzieren//Klassisch	Zeigt den niedrigsten Wert an
max	Reduzieren//Klassisch	Zeigt den höchsten Wert an
sum	Reduzieren//Klassisch	Zeigt die Summe aller Werte an
count	Reduzieren//Klassisch	Zählt die Anzahl der Werte im Ergebnis
last	Reduzieren//Klassisch	Zeigt den letzten Wert an
median	Reduzieren//Klassisch	Zeigt den Medianwert an
diff	Classic	Zeigt den Unterschied zwischen dem neuesten und dem ältesten Wert an
diff_abs	Classic	Zeigt den absoluten Wert von diff an
percent_diff	Classic	Zeigt den prozentualen Wert der Differenz zwischen dem neuesten und dem ältesten Wert an
percent_diff_abs	Classic	Zeigt den absoluten Wert von percent_diff an
count_non_null	Classic	Zeigt die Anzahl der Werte in der Ergebnismenge an, die dies nicht sind null

Warnungszustand

Eine Warnbedingung ist die Abfrage oder der Ausdruck, der bestimmt, ob die Warnung ausgelöst wird oder nicht, je nachdem, welchen Wert sie liefert. Es kann nur eine Bedingung geben, die bestimmt, ob die Warnung ausgelöst wird.

Nachdem Sie Ihre Abfragen und/oder Ausdrücke definiert haben, wählen Sie eine davon als Bedingung für die Warnungsregel aus.

Wenn die abgefragten Daten die definierte Bedingung erfüllen, löst Grafana die zugehörige Warnung aus, die so konfiguriert werden kann, dass Benachrichtigungen über verschiedene Kanäle wie E-Mail, Slack oder gesendet werden. PagerDuty Die Benachrichtigungen informieren Sie darüber, dass die Bedingung erfüllt ist, sodass Sie geeignete Maßnahmen ergreifen oder das zugrunde liegende Problem untersuchen können.

Standardmäßig wird der zuletzt hinzugefügte Ausdruck als Warnbedingung verwendet.

Schwellenwert für die Wiederherstellung

Um das Geräusch flackernder Warnmeldungen zu reduzieren, können Sie einen Schwellenwert für die Wiederherstellung festlegen, der sich vom Schwellenwert für Warnmeldungen unterscheidet.

Flatternde Alerts treten auf, wenn eine Metrik über dem Schwellenwert liegt. Dies kann zu häufigen Statusänderungen führen, was dazu führt, dass zu viele Benachrichtigungen generiert werden.

Von Grafana verwaltete Warnregeln werden für ein bestimmtes Zeitintervall ausgewertet. Bei jeder Auswertung wird das Ergebnis der Abfrage mit dem in der Warnungsregel festgelegten Schwellenwert verglichen. Wenn der Wert einer Metrik über dem Schwellenwert liegt, wird eine Warnungsregel ausgelöst und eine Benachrichtigung gesendet. Wenn der Wert unter den Schwellenwert fällt und eine aktive Warnung für diese Metrik vorliegt, wird die Warnung behoben und eine weitere Benachrichtigung gesendet.

Es kann schwierig sein, eine Warnungsregel für eine verrauschte Metrik zu erstellen. Das heißt, wenn der Wert einer Metrik kontinuierlich einen Schwellenwert über- und unterschreitet. Dies wird als Flattern bezeichnet und führt zu einer Reihe von Benachrichtigungen über das Auslösen von Auslösen und zu einer fehlerhaften Statushistorie der Warnmeldungen.

Wenn Sie beispielsweise eine Latenzwarnung mit einem Schwellenwert von 1000 ms haben und die Zahl um 1000 schwankt (sagen wir 980 ->1010 -> 990 -> 1020 usw.), löst jede dieser Alarme eine Benachrichtigung aus.

Um dieses Problem zu lösen, können Sie einen (benutzerdefinierten) Wiederherstellungsschwellenwert festlegen, was im Grunde bedeutet, dass Sie zwei Schwellenwerte anstelle von einem haben. Eine Warnung wird ausgelöst, wenn der erste Schwellenwert überschritten wird, und sie wird erst behoben, wenn der zweite Schwellenwert überschritten wird.

Sie könnten beispielsweise einen Schwellenwert von 1000 ms und einen Wiederherstellungsschwellenwert von 900 ms festlegen. Auf diese Weise hört eine Warnregel erst auf, wenn sie unter 900 ms fällt, und das Flattern wird reduziert.