Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Verwenden der Prometheus-Datenquelle
## Prometheus-Einstellungen
| Name | Description |
| --- | --- |
| 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 metric/label Unterstützung für die automatische 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\$1responsededup, oder. max\$1source\$1resolution 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 | Description |
| --- | --- |
| Query expression | Weitere Informationen zu Prometheus-Abfrageausdrücken finden Sie in der [Prometheus-Dokumentation](https://prometheus.io/docs/querying/basics/). |
| Legend format | Steuert den Namen der Zeitreihe mithilfe eines Namens oder Musters. \$1\$1hostname\$1\$1Wird beispielsweise durch den Labelwert für das Label ersetzthostname. |
| Min step | Eine zusätzliche Untergrenze für den [`step`Parameter von Prometheus-Bereichsabfragen](https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries) und für die Variablen \$1\$1\$1interval und\$1\$1\$1rate\$1interval. Der Grenzwert ist absolut und wird nicht durch die Einstellung Auflösung verändert. |
| Resolution | 1/1legt sowohl die \$1\$1\$1interval Variable als auch den [`step`Parameter von Prometheus-Bereichsabfragen](https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries) 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 \$1\$1\$1interval 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 \$1\$1\$1interval Variable als auch für den [`step`Parameter von Prometheus-Bereichsabfragen](https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries) 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](graph-panel.md#graph-panel-series-overrides).
### Abfrage-Editor in Explore
| Name | Description |
| --- | --- |
| Query expression | Weitere Informationen zum Prometheus-Abfrageausdruck finden Sie in der [Prometheus-Dokumentation](https://prometheus.io/docs/querying/basics/). |
| Step | [`Step`Parameter von Prometheus-Bereichsabfragen](https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries). 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\$1name 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 (...) [\$1\$1\$1interval] 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](templates-and-variables.md)
### 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 | Description |
| --- | --- |
| label\$1names() | Gibt eine Liste von Labelnamen zurück. |
| label\$1values(label) | Gibt eine Liste von Labelwerten für jede Metrik zurück. label |
| label\$1values(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\$1result(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](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels).
#### 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](variables-types.md#global-variables). 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 ist`On 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([${__range_s}s]) != )
Regex:
```
### Verwenden einer Variablen `$__rate_interval`
Die `$__rate_interval` Variable soll in der Ratenfunktion verwendet werden. Sie ist definiert als max (`$__interval`\$1 *Scrape-Intervall*, 4 \$1 *Scrape-Intervall*). Das *Scrape-Intervall* ist die Mindestschritteinstellung (auch bekannt als query\$1interval, 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:
+ `$`Beispiel: rate (http\$1requests\$1total \$1job=\$1"\$1job "\$1 [5m])
+ `[[varname]]`Beispiel: rate (http\$1requests\$1total \$1job=\$1 "[[job]]"\$1 [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](dashboard-annotations.md).
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](https://prometheus.io/docs/prometheus/latest/configuration/alerting_rules/#inspecting-alerts-during-runtime)).
Die Option Schritt ist nützlich, um die Anzahl der Ereignisse zu begrenzen, die von Ihrer Abfrage zurückgegeben werden.