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.
URL-Variablen für das Dashboard
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
Grafana kann Variablenwerte anwenden, die als Abfrageparameter in Dashboard-URLs übergeben werden. Weitere Informationen finden Sie unter Dashboard-Links verwalten und Vorlagen und Variablen.
Variablen als Abfrageparameter übergeben
Grafana interpretiert Abfragezeichenfolgenparameter mit dem Präfix var-
als Variablen im angegebenen Dashboard.
Zum Beispiel in dieser URL:
https://${your-domain}/path/to/your/dashboard?var-example=value
Der Abfrageparameter var-example=value
steht für das Beispiel einer Dashboard-Variablen mit dem Wertvalue
.
Übergeben mehrerer Werte für eine Variable
Um mehrere Werte zu übergeben, wiederholen Sie den Variablenparameter einmal für jeden Wert.
https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2
Grafana interpretiert var-example=value1&var-example=value2
als Beispiel für eine Dashboard-Variable mit zwei Werten: value1
und. value2
Hinzufügen von Variablen zu Dashboard-Links
Grafana kann Variablen zu Dashboard-Links hinzufügen, wenn Sie sie aus den Einstellungen eines Dashboards generieren. Weitere Informationen und Schritte zum Hinzufügen von Variablen finden Sie unter Dashboard-Links verwalten.
Übergabe von Ad-hoc-Filtern
Ad-hoc-Filter wenden Schlüssel- oder Wertfilter auf alle Metrikabfragen an, die eine angegebene Datenquelle verwenden. Weitere Informationen finden Sie unter Ad-hoc-Filter.
Um einen Ad-hoc-Filter als Abfrageparameter zu übergeben, verwenden Sie die Variablensyntax, um die Ad-hoc-Filtervariable zu übergeben, und geben Sie auch den Schlüssel, den Operator als Wert und den Wert als durch Leerzeichen getrennte Liste an.
Zum Beispiel in dieser URL:
https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value
Der Abfrageparameter var-adhoc=key|=|value
wendet den als Adhoc-Dashboard-Variable konfigurierten Ad-hoc-Filter unter Verwendung des example_key
Schlüssels, des =
Operators und des example_value
Werts an.
Anmerkung
Denken Sie beim Teilen von URLs mit Ad-hoc-Filtern daran, die URL zu codieren. Ersetzen Sie im obigen Beispiel die Pipes (|
) durch %7C
und den Gleichheitsoperator (=
) durch%3D
.
Steuern des Zeitbereichs mithilfe der URL
Um den Zeitraum eines Dashboards festzulegen, verwenden Sie die time.window
Abfrageparameter from
to
time
,, und. Da es sich nicht um Variablen handelt, ist für sie kein var-
Präfix erforderlich.