Verwenden der Prometheus-Datenquelle

Prometheus-Einstellungen

Name	Beschreibung
Name	Der Name der Datenquelle. So sehen Sie die Datenquelle in Bedienfeldern und Abfragen.
Default	Die Standarddatenquelle bedeutet, dass sie für neue Panels vorab ausgewählt wird.
Url	Die URL Ihres Prometheus-Servers; zum Beispiel. https://prometheus.example.org:9090
Access	Server (Standard) = Die URL muss vom Grafana-Backend/-Server aus zugänglich sein.
Basic Auth	Aktivieren Sie die Standardauthentifizierung für die Prometheus-Datenquelle.
User	Benutzername für die Standardauthentifizierung.
Password	Passwort für die Standardauthentifizierung.
Scrape interval	Stellen Sie dies auf das typische Scrape- und Evaluierungsintervall ein, das in Prometheus konfiguriert ist. Die Standardeinstellung ist 15s.
Disable metrics lookup	Wenn Sie diese Option aktivieren, werden die Metrikauswahl und die Unterstützung für Metriken/Labels bei der automatischen Vervollständigung des Abfragefelds deaktiviert. Dies ist hilfreich, wenn Sie Leistungsprobleme mit größeren Prometheus-Instanzen haben.
Custom Query Parameters	Fügen Sie der Prometheus-Abfrage-URL benutzerdefinierte Parameter hinzu. Zum Beispieltimeout, partial_responsededup, oder. max_source_resolution Mehrere Parameter sollten mit einem „&“ verkettet werden.

Prometheus-Abfrageeditor

Die folgenden Abschnitte enthalten Informationen und Optionen für den Prometheus-Abfrageeditor im Dashboard und in Explore.

Der Abfrage-Editor in Dashboards

Öffnen Sie ein Diagramm im Bearbeitungsmodus, indem Sie den Titel auswählen und dann Bearbeiten wählen (oder indem Sie die Taste E drücken, während Sie auf dem Bedienfeld eine Pause einlegen).

Name	Beschreibung
Query expression	Weitere Informationen zu Prometheus-Abfrageausdrücken finden Sie in der Prometheus-Dokumentation.
Legend format	Steuert den Namen der Zeitreihe mithilfe eines Namens oder Musters. {{hostname}}Wird beispielsweise durch den Labelwert für das Label ersetzthostname.
Min step	Eine zusätzliche Untergrenze für den stepParameter von Prometheus-Bereichsabfragen und für die Variablen $__interval und$__rate_interval. Der Grenzwert ist absolut und wird nicht durch die Einstellung Auflösung verändert.
Resolution	1/1legt sowohl die $__interval Variable als auch den stepParameter von Prometheus-Bereichsabfragen so fest, dass jedes Pixel einem Datenpunkt entspricht. Verwenden Sie niedrigere Auflösungen, um eine bessere Leistung zu erzielen. 1/2ruft nur einen Datenpunkt für jedes zweite Pixel ab und 1/10 ruft einen Datenpunkt pro 10 Pixel ab. Beachten Sie, dass sowohl das Min-Zeitintervall als auch das Min-Zeitintervall den Endwert von $__interval und begrenzen. step
Metric lookup	Suchen Sie in diesem Eingabefeld nach Metriknamen.
Format as	Wechseln Sie zwischen TableTime series, oderHeatmap. Tablefunktioniert nur im Tabellenfenster. Heatmapeignet sich für die Anzeige von Metriken vom Typ Histogramm auf einem Heatmap-Panel. Es konvertiert kumulative Histogramme in reguläre Histogramme und sortiert Serien nach dem Bucket-Band.
Instant	Führen Sie eine „sofortige“ Abfrage durch, um nur den letzten Wert zurückzugeben, den Prometheus für die angeforderte Zeitreihe abgefragt hat. Sofortige Abfragen geben Ergebnisse viel schneller zurück als normale Bereichsabfragen. Verwenden Sie sie, um nach Labelsätzen zu suchen.
Min time interval	Dieser Wert multipliziert mit dem Nenner aus der Einstellung Auflösung legt eine Untergrenze sowohl für die $__interval Variable als auch für den stepParameter von Prometheus-Bereichsabfragen fest. Standardmäßig wird das in den Datenquellenoptionen festgelegte Scrape-Intervall verwendet.

Anmerkung

Amazon Managed Grafana ändert die Anforderungsdaten für Abfragen, um sie mit dem dynamisch berechneten Schritt in Einklang zu bringen. Dadurch wird eine konsistente Anzeige der Metrikdaten gewährleistet, es kann jedoch zu einer kleinen Datenlücke am rechten Rand eines Diagramms kommen.

Sofortige Abfragen in Dashboards

Mit der Prometheus-Datenquelle können Sie Sofortabfragen ausführen, bei denen nur der neueste Wert abgefragt wird. Sie können die Ergebnisse in einem Tabellenfenster visualisieren, um alle verfügbaren Beschriftungen einer Zeitreihe zu sehen.

Sofortige Abfrageergebnisse bestehen nur aus einem Datenpunkt pro Reihe. Sie können mithilfe von Reihenüberschreibungen im Grafikfenster angezeigt werden. Um sie im Diagramm als aktuellen Wertpunkt anzuzeigen, fügen Sie eine Reihenüberschreibung hinzu und wählen Sie Points > true sie aus. Um eine horizontale Linie im gesamten Diagramm anzuzeigen, fügen Sie eine Reihenüberschreibung hinzu und wählen Sie aus. Transform > constant Weitere Informationen zu Reihenüberschreibungen finden Sie unterÜberschreibungen von Serien.

Abfrage-Editor in Explore

Name	Beschreibung
Query expression	Weitere Informationen zum Prometheus-Abfrageausdruck finden Sie in der Prometheus-Dokumentation.
Step	StepParameter von Prometheus-Bereichsabfragen. Zeiteinheiten können hier verwendet werden, zum Beispiel: 5s, 1m, 3h, 1d, 1y. Die Standardeinheit, wenn keine Einheit angegeben ist, ist s (Sekunden).
Query type	Range, Instant, oder Both. Wenn Sie die Bereichsabfrage ausführen, wird das Ergebnis der Abfrage in einem Diagramm und einer Tabelle angezeigt. Die Sofortabfrage gibt nur den letzten Wert zurück, den Prometheus für die angeforderte Zeitreihe ermittelt hat, und er wird in der Tabelle angezeigt. Wenn Beide ausgewählt ist, werden sowohl die Sofortabfrage als auch die Bereichsabfrage ausgeführt. Das Ergebnis der Bereichsabfrage wird im Diagramm und das Ergebnis der Sofortabfrage in der Tabelle angezeigt.

Browser für Metriken

Mit dem Metrik-Browser können Sie schnell Metriken finden und relevante Labels auswählen, um grundlegende Abfragen zu erstellen. Wenn Sie den Browser öffnen, werden Ihnen alle verfügbaren Metriken und Labels angezeigt. Falls von Ihrer Prometheus-Instanz unterstützt, zeigt jede Metrik ihre HELP und TYPE als Tooltip an.

Wenn Sie eine Metrik auswählen, schränkt der Browser die verfügbaren Labels ein, sodass nur diejenigen angezeigt werden, die für die Metrik relevant sind. Sie können dann ein oder mehrere Labels auswählen, für die die verfügbaren Labelwerte in Listen im unteren Bereich angezeigt werden. Wählen Sie einen oder mehrere Werte für jedes Label aus, um den Abfragebereich einzuschränken.

Anmerkung

Wenn Sie sich zunächst nicht an einen Metriknamen erinnern können, können Sie auch zuerst einige Labels auswählen, um die Liste einzugrenzen und dann die relevanten Labelwerte zu finden.

Über allen Listen im Metrik-Browser befindet sich ein Suchfeld, mit dem Sie schnell nach Metriken oder Labels filtern können, die einer bestimmten Zeichenfolge entsprechen. Der Wertebereich hat nur ein Suchfeld. Die Filterung gilt für alle Labels, sodass Sie Werte für alle Labels finden können, sobald sie ausgewählt wurden. Beispielsweise kann unter Ihren Labels app, job, job_name nur eines den Wert haben, nach dem Sie suchen.

Wenn Sie mit Ihrer Abfrage zufrieden sind, klicken Sie auf „Abfrage verwenden“, um die Abfrage auszuführen. Die Schaltfläche Als Preisabfrage verwenden fügt eine Rate hinzu (...) [$__interval] rund um Ihre Abfrage, um das Schreiben von Abfragen für Zählermetriken zu erleichtern. Die Schaltfläche „Selektor validieren“ überprüft bei Prometheus, wie viele Zeitreihen für diesen Selektor verfügbar sind.

Einschränkungen

Der Metrik-Browser hat ein festes Limit von 10.000 Labels (Schlüsseln) und 50.000 Labelwerten (einschließlich Metriknamen). Wenn Ihre Prometheus-Instanz mehr Ergebnisse zurückgibt, funktioniert der Browser weiterhin. Bei Überschreitung dieser Höchstgrenzen werden die Ergebnismengen jedoch abgeschnitten.

Erstellung von Vorlagen

Anstatt Dinge wie Server-, Anwendungs- und Sensornamen in Ihren metrischen Abfragen fest zu codieren, können Sie stattdessen Variablen verwenden. Variablen werden als Drop-down-Auswahlfelder oben im Dashboard angezeigt. Sie können diese Dropdown-Felder verwenden, um die in Ihrem Dashboard angezeigten Daten zu ändern.

Weitere Informationen zu Vorlagen und Vorlagenvariablen finden Sie unter. Vorlagen und Variablen

Variable abfragen

Mit einer Variablen vom Typ Query können Sie Prometheus nach einer Liste von Metriken, Labels oder Labelwerten abfragen. Das Prometheus-Datenquellen-Plugin bietet die folgenden Funktionen, die Sie im Query-Eingabefeld verwenden können.

Name	Beschreibung
label_names()	Gibt eine Liste von Labelnamen zurück.
label_values(label)	Gibt eine Liste von Labelwerten für jede Metrik zurück. label
label_values(metric, label)	Gibt eine Liste von Labelwerten für die label in der angegebenen Metrik enthaltenen Werte zurück.
metrics(metric)	Gibt eine Liste von Metriken zurück, die der angegebenen metric Regex entsprechen.
query_result(query)	Gibt eine Liste von Prometheus-Abfrageergebnissen für die zurück. query

Informationen darüber, was Metriknamen, Labelnamen und Labelwerte sind, finden Sie in der Prometheus-Dokumentation.

Verwendung von Intervall- und Bereichsvariablen

Anmerkung

Support für $__range$__range_s, und $__range_ms ist nur ab Grafana v5.3 verfügbar.

Sie können einige globale Variablen in Abfragevariablen verwenden:$__interval,, $__interval_ms $__range$__range_s, und. $__range_ms Weitere Informationen finden Sie unter Globale Variablen. Diese können bequem zusammen mit der query_result Funktion verwendet werden, wenn Sie Variablenabfragen filtern müssen, da die label_values Funktion keine Abfragen unterstützt.

Um beim Ändern des Zeitbereichs im Dashboard die richtigen Instanzen zu erhalten, stellen Sie sicher, dass der refresh Trigger der Variablen auf A eingestellt istOn Time Range Change.

Das folgende Codebeispiel zeigt, wie eine Variable mit den fünf am stärksten frequentierten Anforderungsinstanzen gefüllt wird, basierend auf dem durchschnittlichen QPS über den im Dashboard angezeigten Zeitraum.

Query: query_result(topk(5, sum(rate(http_requests_total[$__range])) by (instance)))
Regex: /"([^"]+)"/

Das folgende Codebeispiel zeigt, wie eine Variable mit den Instanzen gefüllt wird, die über den im Dashboard angezeigten Zeitraum einen bestimmten Status haben. Verwenden Sie dazu. $__range_s

Query: query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
Regex:

Verwenden einer Variablen $__rate_interval

Die $__rate_interval Variable soll in der Ratenfunktion verwendet werden. Sie ist definiert als max ($__interval+ Scrape-Intervall, 4 * Scrape-Intervall). Das Scrape-Intervall ist die Mindestschritteinstellung (auch bekannt als query_interval, eine Einstellung pro PromQL-Abfrage), falls vorhanden, und andernfalls das Scrape-Intervall, wie es in der Prometheus-Datenquelle festgelegt ist (wobei jedoch alle Mindestintervall-Einstellungen im Panel ignoriert werden, da letzteres durch die Auflösungseinstellung geändert wird).

Verwenden von Variablen in Abfragen

Es gibt zwei Syntaxen:

• $<varname>Beispiel: rate (http_requests_total {job=~"$job "} [5m])

• [[varname]]Beispiel: rate (http_requests_total {job=~ "[[job]]"} [5m])

Warum zwei Möglichkeiten? Die erste Syntax ist einfacher zu lesen und zu schreiben, erlaubt es Ihnen jedoch nicht, eine Variable in der Mitte eines Wortes zu verwenden. Wenn die Optionen Mehrwert oder Alle Werte einbeziehen aktiviert sind, konvertiert Grafana die Beschriftungen von Klartext in eine Regex-kompatible Zeichenfolge. Was bedeutet, dass Sie anstelle von verwenden müssen. =~ =

Anmerkungen

Sie können Anmerkungen verwenden, um umfangreiche Ereignisinformationen über Grafiken zu legen. Sie fügen mithilfe des Dashboard-Menüs oder der Ansicht Anmerkungen Anmerkungen hinzu. Weitere Informationen finden Sie unter Anmerkungen.

Prometheus unterstützt zwei Möglichkeiten, Anmerkungen abzufragen.

• Eine reguläre metrische Abfrage

• Eine Prometheus-Abfrage für ausstehende und ausgelöste Benachrichtigungen. Weitere Informationen finden Sie unter Überprüfen von Warnmeldungen während der Laufzeit).

Die Option Schritt ist nützlich, um die Anzahl der Ereignisse zu begrenzen, die von Ihrer Abfrage zurückgegeben werden.