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. # Hinzufügen und Verwalten von Dashboard-Variablen **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) Eine Variable ist ein Platzhalter für einen Wert. Sie können Variablen in metrischen Abfragen und in Paneltiteln verwenden. Wenn Sie also den Wert mithilfe der Dropdownliste oben im Dashboard ändern, ändern sich die metrischen Abfragen Ihres Panels entsprechend dem neuen Wert. Variablen ermöglichen es Ihnen, interaktivere und dynamischere Dashboards zu erstellen. Anstatt Dinge wie Server-, Anwendungs- und Sensornamen in Ihren metrischen Abfragen fest zu codieren, können Sie stattdessen Variablen verwenden. Variablen werden als Dropdownlisten oben im Dashboard angezeigt. Diese Dropdowns machen es einfach, die in Ihrem Dashboard angezeigten Daten zu ändern. Diese können besonders für Administratoren nützlich sein, die Grafana-Viewern ermöglichen möchten, Visualisierungen schnell anzupassen, ihnen aber keine vollen Bearbeitungsberechtigungen geben möchten. Grafana-Viewer können Variablen verwenden. Variablen und Vorlagen ermöglichen es Ihnen auch, Dashboards aus einer Hand zu beziehen. Wenn Sie über mehrere identische Datenquellen oder Server verfügen, können Sie ein Dashboard erstellen und Variablen verwenden, um zu ändern, was Sie gerade sehen. Das vereinfacht Wartung und Instandhaltung enorm. **Vorlagen** Eine Vorlage ist jede Abfrage, die eine Variable enthält. Wenn Sie beispielsweise ein Dashboard zur Überwachung mehrerer Server verwalten würden, könnten Sie für jeden Server ein Dashboard erstellen, oder Sie könnten ein Dashboard erstellen und Bereiche mit Vorlagenabfragen verwenden, z. B. die folgenden. ``` wmi_system_threads{instance=~"$server"} ``` Variablenwerte werden immer mit der Syntax var- =value mit der URL synchronisiert. **Beispiele** Variablen werden in Dropdownlisten oben auf dem Bildschirm aufgeführt. Wählen Sie verschiedene Variablen aus, um zu sehen, wie sich die Visualisierungen ändern. Um die Variableneinstellungen zu sehen, navigieren Sie zu **Dashboard-Einstellungen >** Variablen. Klicken Sie in der Liste auf eine Variable, um ihre Einstellungen zu sehen.
 Variablen können in Titeln, Beschreibungen, Textfeldern und Abfragen verwendet werden. Abfragen mit Text, der mit 1 beginnt, `$` sind Vorlagen. Nicht alle Panels werden über Vorlagenabfragen verfügen. **Verschiedene bewährte Methoden** + Variablen-Dropdownlisten werden in der Reihenfolge angezeigt, in der sie in der Variablenliste in den **Dashboard-Einstellungen** aufgeführt sind. + Platzieren Sie die Variablen, die Sie häufig ändern werden, ganz oben, sodass sie zuerst angezeigt werden (ganz links im Dashboard). # Variablen hinzufügen und verwalten **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) In der folgenden Tabelle sind die Variablentypen aufgeführt, die mit Grafana geliefert werden. | Variablentyp | Description | | --- | --- | | Query | Durch eine Abfrage generierte Werteliste wie Metriknamen, Servernamen IDs, Sensoren, Rechenzentren usw. Fügen Sie eine Abfragevariable hinzu. | | Benutzerdefiniert | Definieren Sie die Variablenoptionen manuell mithilfe einer durch Kommas getrennten Liste. Fügen Sie eine benutzerdefinierte Variable hinzu. | | Text box (Textfeld) | Zeigt ein Freitexteingabefeld mit einem optionalen Standardwert an. Fügen Sie eine Textfeld-Variable hinzu. | | Konstante | Definieren Sie eine versteckte Konstante. Fügen Sie eine konstante Variable hinzu. | | Datenquelle | Ändern Sie schnell die Datenquelle für ein gesamtes Dashboard. Fügen Sie eine Datenquellenvariable hinzu. | | Intervall | Intervallvariablen stellen Zeitspannen dar. Fügen Sie eine Intervallvariable hinzu. | | Ad-hoc-Filter | Schlüsselwertfilter, die automatisch zu allen Metrikabfragen für eine Datenquelle hinzugefügt werden (nur Prometheus, Loki, InfluxDB und Elasticsearch). Fügen Sie Ad-hoc-Filter hinzu. | | Globale Variablen | Integrierte Variablen, die in Ausdrücken im Abfrage-Editor verwendet werden können. Weitere Informationen finden Sie unter Globale Variablen. | | Verkettete Variablen | Variablenabfragen können andere Variablen enthalten. Weitere Informationen finden Sie unter Verkettete Variablen. | ## Allgemeine Optionen eingeben Sie müssen allgemeine Optionen für jeden Variablentyp eingeben, den Sie erstellen. **Um allgemeine Optionen einzugeben** 1. Navigieren Sie zu dem Dashboard, für das Sie eine Variable erstellen möchten, und wählen Sie oben auf der Seite das Symbol für die **Dashboard-Einstellungen** (Zahnrad) aus. 1. Wählen Sie auf der Registerkarte **Variablen** die Option **Neu** aus. 1. Geben Sie einen **Namen** für die Variable ein. 1. Wählen Sie in der Liste **Typ** die Option **Abfrage** aus. 1. (Optional) Geben Sie im Feld **Bezeichnung** den Anzeigenamen der Variablen-Dropdownliste ein. Wenn Sie keinen Anzeigenamen eingeben, entspricht das Dropdown-Label dem Variablennamen. 1. Wählen Sie eine Option zum **Ausblenden**: + **Keine Auswahl (leer):** In der Variablen-Dropdownliste wird der **Variablenname** oder der **Labelwert** angezeigt. + **Bezeichnung:** In der Variablen-Dropdownliste werden nur der ausgewählte Variablenwert und ein Abwärtspfeil angezeigt. + **Variabel:** Auf dem Dashboard wird kein Variablen-Dropdown angezeigt. ## Eine Abfragevariable hinzufügen Mit Abfragevariablen können Sie eine Datenquellenabfrage schreiben, die eine Liste von Metriknamen, Tagwerten oder Schlüsseln zurückgeben kann. Eine Abfragevariable kann beispielsweise eine Liste von Servernamen IDs, Sensoren oder Rechenzentren zurückgeben. Die Variablenwerte ändern sich, wenn sie Optionen mit einer Datenquellenabfrage dynamisch abrufen. Abfragevariablen werden im Allgemeinen nur für Zeichenfolgen unterstützt. Wenn Ihre Abfrage Zahlen oder einen anderen Datentyp zurückgibt, müssen Sie diese möglicherweise in Zeichenfolgen konvertieren, um sie als Variablen verwenden zu können. Für die Azure-Datenquelle können Sie zu diesem Zweck beispielsweise die [tostring-Funktion](https://docs.microsoft.com/en-us/azure/data-explorer/kusto/query/tostringfunction) verwenden. Abfrageausdrücke können Verweise auf andere Variablen enthalten und tatsächlich verknüpfte Variablen erstellen. Grafana erkennt dies und aktualisiert automatisch eine Variable, wenn sich eine der verknüpften Variablen ändert. **Anmerkung** Abfrageausdrücke sind für jede Datenquelle unterschiedlich. Weitere Informationen finden Sie in der Dokumentation zu Ihrer [Datenquelle](AMG-data-sources.md). **Um eine Abfragevariable hinzuzufügen** 1. Geben Sie allgemeine Optionen wie oben ein. 1. Wählen Sie in der **Datenquellenliste** die Zieldatenquelle für die Abfrage aus. 1. Wählen Sie in der **Aktualisierungsliste** aus, wann die Variable die Optionen aktualisieren soll. + **Beim Laden des Dashboards:** Fragt bei jedem Laden des Dashboards die Datenquelle ab. Dadurch wird das Laden des Dashboards verlangsamt, da die Variablenabfrage abgeschlossen werden muss, bevor das Dashboard initialisiert werden kann. + **Bei Änderung des Zeitbereichs: Fragt** die Datenquelle ab, wenn sich der Zeitbereich des Dashboards ändert. Verwenden Sie diese Option nur, wenn Ihre Abfrage mit variablen Optionen einen Zeitbereichsfilter enthält oder vom Zeitbereich des Dashboards abhängig ist. 1. Geben Sie im Feld **Abfrage** eine Abfrage ein. + Das Abfragefeld variiert je nach Datenquelle. Einige Datenquellen verfügen über benutzerdefinierte Abfrageeditoren. + Wenn Sie mehr Platz in einem Abfrage-Editor für ein einzelnes Eingabefeld benötigen, bewegen Sie den Mauszeiger über die Linien in der unteren rechten Ecke des Felds und ziehen Sie es nach unten, um es zu erweitern. 1. (Optional) Geben Sie im Feld **Regex** einen Regex-Ausdruck ein, um bestimmte Teile der von Ihrer Datenquellenabfrage zurückgegebenen Namen zu filtern oder zu erfassen. Beispiele finden Sie unter [Filtern](#v9-dash-variable-add-filter) von Variablen mit Regex. 1. Wählen Sie in der **Sortierliste** die Sortierreihenfolge für die Werte aus, die in der Dropdownliste angezeigt werden sollen. Die Standardoption **Deaktiviert** bedeutet, dass die Reihenfolge der Optionen verwendet wird, die von Ihrer Datenquellenabfrage zurückgegeben wurde. 1. (Optional) Geben Sie [Auswahloptionen](#v9-dash-variable-add-selection) ein. 1. In **der Wertevorschau** zeigt Grafana eine Liste der aktuellen Variablenwerte an. Überprüfen Sie sie, um sicherzustellen, dass sie Ihren Erwartungen entsprechen. 1. Wählen Sie **Hinzufügen** aus, um die Variable zum Dashboard hinzuzufügen. ## Eine benutzerdefinierte Variable hinzufügen Verwenden Sie eine *benutzerdefinierte* Variable für einen Wert, der sich nicht ändert, z. B. eine Zahl oder eine Zeichenfolge. Wenn Sie beispielsweise Servernamen oder Regionsnamen haben, die sich nie ändern, möchten Sie sie möglicherweise als benutzerdefinierte Variablen und nicht als Abfragevariablen erstellen. Da sie sich nicht ändern, können Sie sie eher in [verketteten Variablen](#v9-dash-variable-add-chained) als in anderen Abfragevariablen verwenden. Dies würde die Anzahl der Abfragen reduzieren, die Grafana senden muss, wenn verkettete Variablen aktualisiert werden. **Um eine benutzerdefinierte Variable hinzuzufügen** 1. Geben Sie allgemeine Optionen wie oben ein. 1. Im **Werte, getrennt durch Kommas**, geben Sie die Werte für diese Variable in eine kommagetrennte Liste ein. Sie können Zahlen, Zeichenketten oder Schlüssel-Wert-Paare angeben, die durch ein Leerzeichen und einen Doppelpunkt getrennt sind. Beispiel, `key1 : value1,key2 : value2`. 1. (Optional) Geben Sie [Auswahloptionen](#v9-dash-variable-add-selection) ein. 1. In **der Wertevorschau** zeigt Grafana eine Liste der aktuellen Variablenwerte an. Überprüfen Sie sie, um sicherzustellen, dass sie Ihren Erwartungen entsprechen. 1. Wählen Sie **Hinzufügen** aus, um die Variable zum Dashboard hinzuzufügen. ## Eine Textfeld-Variable hinzufügen *Textfeldvariablen* zeigen ein Freitexteingabefeld mit einem optionalen Standardwert an. Dies ist die flexibelste Variable, da Sie einen beliebigen Wert eingeben können. Verwenden Sie diesen Variablentyp, wenn Sie Metriken mit hoher Kardinalität haben oder wenn Sie mehrere Bereiche in einem Dashboard gleichzeitig aktualisieren möchten. **Um eine Textfeld-Variable hinzuzufügen** 1. Geben Sie allgemeine Optionen wie oben ein. 1. (Optional) Wählen Sie im Feld **Standardwert** den Standardwert für die Variable aus. Wenn Sie in dieses Feld nichts eingeben, zeigt Grafana ein leeres Textfeld an, in das Benutzer Text eingeben können. 1. In **der Wertevorschau** zeigt Grafana eine Liste der aktuellen Variablenwerte an. Überprüfen Sie sie, um sicherzustellen, dass sie Ihren Erwartungen entsprechen. 1. Wählen Sie **Hinzufügen** aus, um die Variable zum Dashboard hinzuzufügen. ## Eine konstante Variable hinzufügen *Konstante* Variablen ermöglichen es Ihnen, eine versteckte Konstante zu definieren. Dies ist nützlich für metrische Pfadpräfixe für Dashboards, die Sie teilen möchten. Wenn Sie ein Dashboard exportieren, werden konstante Variablen in Importoptionen umgewandelt. Konstante Variablen sind *nicht* flexibel. Jede konstante Variable enthält nur einen Wert und kann nur aktualisiert werden, wenn Sie die Variableneinstellungen aktualisieren. Konstante Variablen sind nützlich, wenn Sie komplexe Werte haben, die Sie in Abfragen einbeziehen müssen, aber nicht bei jeder Abfrage erneut eingeben möchten. Wenn Sie beispielsweise einen Serverpfad mit dem Namen haben`i-0b6a61efe2ab843gg`, können Sie ihn durch eine Variable mit dem Namen `$path_gg` ersetzen. **Um eine konstante Variable hinzuzufügen** 1. Geben Sie allgemeine Optionen wie oben ein. 1. Geben Sie im Feld **Wert** den Variablenwert ein. Sie können Buchstaben, Zahlen und Symbole eingeben. Sie können sogar Platzhalter verwenden, wenn Sie das [Rohformat](https://grafana.com/docs/grafana/latest/dashboards/variables/variable-syntax/#raw) verwenden. 1. In **der Wertevorschau** zeigt Grafana eine Liste der aktuellen Variablenwerte an. Überprüfen Sie sie, um sicherzustellen, dass sie Ihren Erwartungen entsprechen. 1. Wählen Sie **Hinzufügen** aus, um die Variable zum Dashboard hinzuzufügen. ## Eine Datenquellenvariable hinzufügen *Datenquellenvariablen* ermöglichen es Ihnen, die Datenquelle für ein gesamtes Dashboard schnell zu ändern. Sie sind nützlich, wenn Sie mehrere Instanzen einer Datenquelle haben, möglicherweise in unterschiedlichen Umgebungen. **Um eine Datenquellenvariable hinzuzufügen** 1. Geben Sie allgemeine Optionen wie oben ein. 1. Wählen Sie in der Liste **Typ** die Zieldatenquelle für die Variable aus. 1. (Optional) Geben Sie im Feld **Instanznamenfilter** einen Regex-Filter ein, für die Datenquelleninstanzen Sie in der Dropdownliste mit Variablenwerten auswählen können. Lassen Sie dieses Feld leer, um alle Instanzen anzuzeigen. 1. (Optional) Geben Sie [Auswahloptionen](#v9-dash-variable-add-selection) ein. 1. In **der Wertevorschau** zeigt Grafana eine Liste der aktuellen Variablenwerte an. Überprüfen Sie sie, um sicherzustellen, dass sie Ihren Erwartungen entsprechen. 1. Wählen Sie **Hinzufügen** aus, um die Variable zum Dashboard hinzuzufügen. ## Eine Intervallvariable hinzufügen Verwenden Sie eine *Intervallvariable*, um Zeitspannen wie `1m``1h`, oder `1d` darzustellen. Sie können sie sich als eine *Gruppe* von Zeitbefehlen für das gesamte Dashboard vorstellen. Intervallvariablen ändern, wie die Daten in der Visualisierung gruppiert werden. Sie können auch die Option Auto verwenden, um eine festgelegte Anzahl von Datenpunkten pro Zeitspanne zurückzugeben. Sie können eine Intervallvariable als Parameter für die Gruppierung nach Zeit (für InfluxDB), Datumshistogrammintervall (für Elasticsearch) oder als Parameter für die Zusammenfassungsfunktion (für Graphite) verwenden. **Um eine Intervallvariable hinzuzufügen** 1. Geben Sie allgemeine Optionen wie oben ein. 1. Geben Sie im Feld **Werte** die Zeitintervalle ein, die in der Dropdownliste der Variablen angezeigt werden sollen. Die folgenden Zeiteinheiten werden unterstützt: `s (seconds)``m (minutes)`,`h (hours)`,`d (days)`, `w (weeks)``M (months)`, und`y (years)`. Sie können die Standardwerte auch akzeptieren oder bearbeiten:`1m,10m,30m,1h,6h,12h,1d,7d,14d,30d`. 1. (Optional) Aktivieren Sie die **Option Automatisch**, wenn Sie die `auto` Option zur Liste hinzufügen möchten. Mit dieser Option können Sie angeben, wie oft der aktuelle Zeitraum geteilt werden soll, um den aktuellen `auto` Zeitraum zu berechnen. Wenn Sie es einschalten, werden zwei weitere Optionen angezeigt: + **Schrittanzahl —** Wählen Sie aus, wie oft der aktuelle Zeitraum geteilt werden soll, um den Wert zu berechnen, ähnlich wie bei der Abfrageoption **Max. Datenpunkte**. Wenn der aktuell sichtbare Zeitraum beispielsweise 30 Minuten beträgt, gruppiert das `auto` Intervall die Daten in 30 Ein-Minuten-Schritten. Der Standardwert ist 30 Schritte. + **Minimales Intervall —** Der Mindestschwellenwert, unter dem die Intervalle zur Schrittzählung die Zeit nicht unterteilen. Um das 30-Minuten-Beispiel fortzusetzen: Wenn das Mindestintervall auf 2 m festgelegt ist, gruppiert Grafana die Daten in 15 Zwei-Minuten-Schritten. 1. In **der Wertevorschau** zeigt Grafana eine Liste der aktuellen Variablenwerte an. Überprüfen Sie sie, um sicherzustellen, dass sie Ihren Erwartungen entsprechen. 1. Wählen Sie **Hinzufügen** aus, um die Variable zum Dashboard hinzuzufügen. **Beispiele für Intervallvariablen** Das folgende Beispiel zeigt eine Template-Variable `myinterval` in einer Graphite-Funktion: ``` summarize($myinterval, sum, false) ``` ## Hinzufügen von Ad-hoc-Filtern Mit *Ad-hoc-Filtern* können Sie Schlüsselwertfilter hinzufügen, die automatisch zu allen Metrikabfragen hinzugefügt werden, die die angegebene Datenquelle verwenden. Im Gegensatz zu anderen Variablen verwenden Sie in Abfragen keine Ad-hoc-Filter. Stattdessen verwenden Sie Ad-hoc-Filter, um Filter für bestehende Abfragen zu schreiben. **Anmerkung** Ad-hoc-Filtervariablen funktionieren nur mit Prometheus-, Loki-, InfluxDB- und Elasticsearch-Datenquellen. 1. Geben Sie allgemeine Optionen wie oben ein. 1. Wählen Sie in der **Datenquellenliste** die Zieldatenquelle aus. 1. Wählen Sie **Hinzufügen** aus, um die Variable zum Dashboard hinzuzufügen. **Erstellen Sie Ad-hoc-Filter** Ad-hoc-Filter sind eine der komplexesten und flexibelsten verfügbaren Variablenoptionen. Anstatt einer regulären Liste von Variablenoptionen können Sie mit dieser Variablen eine Ad-hoc-Abfrage für das gesamte Dashboard erstellen. Filter, die Sie auf diese Weise anwenden, werden auf alle Bereiche im Dashboard angewendet. ## Konfigurieren Sie variable Auswahloptionen **Auswahloptionen** sind eine Funktion, mit der Sie die Auswahl variabler Optionen verwalten können. Alle Auswahloptionen sind optional und standardmäßig deaktiviert. ### Variablen mit mehreren Werten Die Interpolation einer Variablen mit mehreren ausgewählten Werten ist schwierig, da es nicht einfach ist, die mehreren Werte in eine Zeichenfolge zu formatieren, die in dem angegebenen Kontext, in dem die Variable verwendet wird, gültig ist. Grafana versucht, dieses Problem zu lösen, indem es jedem Datenquellen-Plugin erlaubt, der Templating-Interpolationsengine mitzuteilen, welches Format für mehrere Werte verwendet werden soll. **Anmerkung** Die Option **Benutzerdefiniert für alle Werte** für die Variable muss leer sein, damit Grafana alle Werte in einer einzigen Zeichenfolge formatieren kann. Wenn es leer gelassen wird, verkettet (addiert) Grafana alle Werte in der Abfrage. Beispiel, `value1,value2,value3`. Wenn ein benutzerdefinierter `all` Wert verwendet wird, lautet der Wert stattdessen oder. `*` `all` **Variablen mit mehreren Werten und einer Graphite-Datenquelle** Graphite verwendet Glob-Ausdrücke. **Eine Variable mit mehreren Werten würde in diesem Fall so interpoliert werden, als `{host1,host2,host3}` ob der aktuelle Variablenwert *host1, host2 und host3* wäre.** **Variablen mit mehreren Werten mit einer Prometheus- oder InfluxDB-Datenquelle** InfluxDB und Prometheus verwenden Regex-Ausdrücke, sodass dieselbe Variable interpoliert würde als. `(host1|host2|host3)` Jeder Wert würde auch mit Regex-Escapes versehen werden. Andernfalls würde ein Wert mit einem Regex-Steuerzeichen den Regex-Ausdruck unterbrechen. **Variablen mit mehreren Werten und einer Elastic-Datenquelle** Elasticsearch verwendet die Lucene-Abfragesyntax, sodass dieselbe Variable als formatiert würde. `("host1" OR "host2" OR "host3")` In diesem Fall muss jeder Wert maskiert werden, sodass der Wert nur Lucene-Kontrollwörter und Anführungszeichen enthält. **Problembehandlung bei Variablen mit mehreren Werten** Automatisches Escapen und Formatieren können zu Problemen führen, und es kann schwierig sein, die Logik dahinter zu verstehen. Insbesondere für InfluxDB und Prometheus, wo die Verwendung der Regex-Syntax erfordert, dass die Variable im Regex-Operator-Kontext verwendet wird. Wenn Sie nicht möchten, dass Grafana dieses automatische Regex-Escaping und Formatieren durchführt, müssen Sie einen der folgenden Schritte ausführen: + **Deaktivieren Sie die Optionsoptionen **Mehrere Werte oder Alle** einbeziehen.** + Verwenden Sie das [unformatierte Variablenformat](https://grafana.com/docs/grafana/latest/dashboards/variables/variable-syntax/#raw). ### Option „Alle einbeziehen“ Grafana fügt der Variablen-Dropdownliste eine `All` Option hinzu. Wenn ein Benutzer diese Option auswählt, werden alle Variablenoptionen ausgewählt. ### Benutzerdefinierter Wert für alle Diese Option ist nur sichtbar, wenn die **Option Alle einbeziehen** ausgewählt ist. Geben Sie Regex-, Globs- oder Lucene-Syntax in das Feld **Alle Werte anpassen ein, um den Wert** der Option zu definieren. `All` Standardmäßig umfasst der `All` Wert alle Optionen in einem kombinierten Ausdruck. Dies kann sehr lang werden und zu Leistungseinbußen führen. Manchmal kann es besser sein, einen benutzerdefinierten All-Wert anzugeben, z. B. einen Platzhalter-Regex. Um eine benutzerdefinierte Regex-, Globs- oder Lucene-Syntax in der Option **Alle Werte anpassen zu haben, wird sie nie maskiert, sodass Sie sich überlegen müssen, welcher Wert** für Ihre Datenquelle gültig ist. ## Globale Variablen Grafana verfügt über globale integrierte Variablen, die in Ausdrücken im Abfrage-Editor verwendet werden können. Dieses Thema listet sie in alphabetischer Reihenfolge auf und definiert sie. Diese Variablen eignen sich für Abfragen, Dashboard-Links, Bereichsverknüpfungen und Datenverknüpfungen. **\$1\$1\$1dashboard** Diese Variable ist der Name des aktuellen Dashboards. **\$1\$1\$1from und \$1\$1\$1to** Grafana hat zwei eingebaute Zeitbereichsvariablen: `$__from` und`$__to`. Sie werden derzeit standardmäßig immer als Epochen-Millisekunden interpoliert, aber Sie können die Datumsformatierung steuern. | Syntax | Beispielergebnis | Description | | --- | --- | --- | | `${__from}` | 1594671549254 | Unix-Millisekunden-Epoche | | `${__from:date}` | 2020-07-13T 20:19:09.254 Z | Keine Argumente, standardmäßig ISO 8601/RFC 3339 | | `${__from:date:iso}` | 2020-07-13T 20:19:09,254 Z | ISO 8601/RFC 3339 | | `${__from:date:seconds}` | 1594671549 | Unix-Sekunden-Epoche | | `${__from:date:YYYY-MM}` | 2020-07 | Jedes benutzerdefinierte Datumsformat, das das Zeichen: nicht enthält | Die obige Syntax funktioniert auch mit`${__to}`. **\$1\$1\$1interval** *Sie können die `$__interval` Variable als Parameter für die Gruppierung nach Zeit (für InfluxDB, MySQL, Postgres, MSSQL), Datumshistogrammintervall (für Elasticsearch) oder als Parameter für die Zusammenfassungsfunktion (für Graphite) verwenden.* Grafana berechnet automatisch ein Intervall, das zur Gruppierung nach Zeit in Abfragen verwendet werden kann. Wenn es mehr Datenpunkte gibt, als in einem Diagramm dargestellt werden können, können die Abfragen effizienter gestaltet werden, indem sie nach einem größeren Intervall gruppiert werden. Wenn Sie sich beispielsweise ein Diagramm mit Daten aus 3 Monaten ansehen, sind Sie möglicherweise nicht in der Lage, Details auf Minutenebene zu erkennen. Durch die Gruppierung nach Stunden oder Tagen wird die Abfrage effizienter, ohne dass sich dies auf die Darstellung im Diagramm auswirkt. Das `$__interval` wird anhand des Zeitbereichs und der Breite des Diagramms (Anzahl der Pixel) berechnet. Ungefähre Berechnung: `(to - from) / resolution` Wenn der Zeitraum beispielsweise 1 Stunde beträgt und das Diagramm im Vollbildmodus angezeigt wird, kann das Intervall wie folgt berechnet werden: Punkte werden in Intervallen von 2 Minuten gruppiert. `2m` Wenn der Zeitraum 6 Monate umfasst und das Diagramm im Vollbildmodus angezeigt wird, könnte das Intervall `1d` (1 Tag) sein. Die Punkte werden nach Tagen gruppiert. In der InfluxDB-Datenquelle `$interval` ist die Legacy-Variable dieselbe Variable. `$__interval`sollte stattdessen verwendet werden. Die InfluxDB- und Elasticsearch-Datenquellen haben `Group by time interval` Felder, die verwendet werden, um das Intervall fest zu codieren oder das Mindestlimit für die `$__interval` Variable festzulegen (mithilfe der `>` Syntax ->). `>10m` **\$1\$1\$1interval\$1ms** Diese Variable ist die `$__interval` Variable in Millisekunden, keine Zeichenfolge im Zeitintervallformat. Zum Beispiel, wenn der `$__interval` ist, dann ist `20m` der. `$__interval_ms` `1200000` **\$1\$1\$1org** Diese Variable ist die ID der aktuellen Organisation. `${__org.name}`ist der Name der aktuellen Organisation. **\$1\$1\$1user** `${__user.id}`ist die ID des aktuellen Benutzers. `${__user.login}`ist das Login-Handle des aktuellen Benutzers. `${__user.email}`ist die E-Mail für den aktuellen Benutzer. **\$1\$1\$1range** Derzeit nur für Prometheus- und Loki-Datenquellen unterstützt. Diese Variable stellt den Bereich für das aktuelle Dashboard dar. Sie wird berechnet von`to - from`. Es hat eine Millisekunde und eine zweite Darstellung namens und. `$__range_ms` `$__range_s` **\$1\$1\$1rate\$1interval** Derzeit nur für Prometheus-Datenquellen unterstützt. Die `$__rate_interval` Variable ist für die Verwendung in der Ratenfunktion vorgesehen. **\$1timeFilter oder \$1\$1\$1timeFilter** Die `$timeFilter` Variable gibt den aktuell ausgewählten Zeitraum als Ausdruck zurück. Der `Last 7 days` Ausdruck für das Zeitbereichsintervall lautet beispielsweise`time > now() - 7d`. Dies wird an verschiedenen Stellen verwendet, unter anderem: + Die WHERE-Klausel für die InfluxDB-Datenquelle. Grafana fügt es im Abfrage-Editor-Modus automatisch zu InfluxDB-Abfragen hinzu. Sie können es manuell im Texteditor-Modus hinzufügen:. `WHERE $timeFilter` + Loggen Sie Analytics-Abfragen in der Azure Monitor-Datenquelle. + SQL-Abfragen in MySQL, Postgres und MSSQL. + Die `$__timeFilter` Variable wird in der MySQL-Datenquelle verwendet. ## Verkettete Variablen *Verkettete Variablen*, auch *verknüpfte Variablen* oder *verschachtelte Variablen* genannt, sind Abfragevariablen mit einer oder mehreren anderen Variablen in ihrer Variablenabfrage. In diesem Abschnitt wird erklärt, wie verkettete Variablen funktionieren, und es werden Links zu Beispiel-Dashboards bereitgestellt, die verkettete Variablen verwenden. Verkettete Variablenabfragen sind für jede Datenquelle unterschiedlich, aber die Prämisse ist für alle dieselbe. Sie können verkettete Variablenabfragen in jeder Datenquelle verwenden, die sie zulässt. Extrem komplexe verknüpfte Dashboards mit Vorlagen sind möglich, die 5 oder 10 Ebenen tief sind. Technisch gesehen gibt es keine Begrenzung dafür, wie tief oder komplex Sie gehen können, aber je mehr Links Sie haben, desto größer ist die Abfragelast. **Bewährte Methoden und Tipps** Die folgenden Methoden erleichtern die Verwendung Ihrer Dashboards und Variablen. **Neue verknüpfte Variablen erstellen** + Durch das Verketten von Variablen entstehen parent/child Abhängigkeiten. Sie können sie sich als Leiter oder Baum vorstellen. + Der einfachste Weg, eine neue verkettete Variable zu erstellen, besteht darin, die Variable zu kopieren, auf der die neue Variable basieren soll. Klicken Sie in der Variablenliste auf das Symbol „**Variable duplizieren**“ rechts neben dem Variableneintrag, um eine Kopie zu erstellen. Anschließend können Sie der Abfrage für die übergeordnete Variable etwas hinzufügen. + Neue Variablen, die auf diese Weise erstellt wurden, werden am Ende der Liste angezeigt. Möglicherweise müssen Sie sie an eine andere Position in der Liste ziehen, um sie in eine logische Reihenfolge zu bringen. **Variable Reihenfolge** Sie können die Reihenfolge der Variablen in der Variablenliste des Dashboards ändern, indem Sie auf die Aufwärts- und Abwärtspfeile auf der rechten Seite jedes Eintrags klicken. Grafana listet gemäß dieser Liste Variablen-Dropdowns von links nach rechts auf, wobei die Variable ganz links oben steht. + Listet Variablen, die keine Abhängigkeiten haben, ganz oben vor ihren untergeordneten Variablen auf. + Jede Variable sollte der Variablen folgen, von der sie abhängig ist. + Denken Sie daran, dass es in der Benutzeroberfläche keinen Hinweis darauf gibt, welche Variablen Abhängigkeitsbeziehungen haben. Listen Sie die Variablen in einer logischen Reihenfolge auf, um es anderen Benutzern (und Ihnen) zu erleichtern. **Berücksichtigung der Komplexität** Je mehr Abhängigkeitsebenen Sie von Variablen haben, desto länger dauert es, Dashboards zu aktualisieren, nachdem Sie Variablen geändert haben. Wenn Sie beispielsweise eine Reihe von vier verknüpften Variablen (Land, Region, Server, Metrik) haben und Sie einen Stammvariablenwert (Land) ändern, muss Grafana Abfragen für alle abhängigen Variablen ausführen, bevor die Visualisierungen im Dashboard aktualisiert werden. ## Variablen verwalten Auf der Variablenseite können Sie Variablen [hinzufügen](https://grafana.com/docs/grafana/latest/dashboards/variables/add-template-variables/) und bestehende Variablen verwalten. Außerdem können Sie Variablen [überprüfen](https://grafana.com/docs/grafana/latest/dashboards/variables/inspect-variable/) und feststellen, ob eine Variable in anderen Variablen oder im Dashboard referenziert (oder verwendet) wird. **Verschieben:** Sie können eine Variable per Drag-and-Drop in der Liste nach oben oder unten verschieben. **Klonen:** Um eine Variable zu klonen, klicken Sie in der Symbolgruppe auf der rechten Seite auf das Klonsymbol. Dadurch wird eine Kopie der Variablen mit dem Präfix des Namens der ursprünglichen Variablen erstellt. `copy_of_` **Löschen: Um** eine Variable zu löschen, klicken Sie in der Gruppe von Symbolen auf der rechten Seite auf das Papierkorbsymbol. ## Filtern Sie Variablen mit Regex Mithilfe der Regex-Abfrageoption filtern Sie die Liste der von der Variablenabfrage zurückgegebenen Optionen oder ändern die zurückgegebenen Optionen. Auf dieser Seite wird gezeigt, wie Regex für filter/modify Werte in der Variablen-Dropdownliste verwendet wird. Mithilfe der Regex-Abfrageoption filtern Sie die Liste der von der Variablenabfrage zurückgegebenen Optionen oder ändern die zurückgegebenen Optionen. Weitere Informationen finden Sie im Mozilla-Leitfaden zu [regulären](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions) Ausdrücken. Die folgenden Beispiele zeigen das Filtern anhand der folgenden Liste von Optionen ``` backend_01 backend_02 backend_03 backend_04 ``` **Filtern Sie so, dass nur die Optionen zurückgegeben `02` werden, die mit `01` oder enden** Regex: ``` / ( 01|02 ) $/ ``` Ergebnis: ``` backend_01 backend_02 ``` **Filtern und ändern Sie die Optionen mithilfe einer Regex-Erfassungsgruppe, um einen Teil des Textes zurückzugeben** Regex: ``` /.* ( 01|02 ) / ``` Ergebnis: ``` 01 02 ``` **Filtern und modifizieren - Prometheus-Beispiel** Liste der Optionen: ``` up{instance="demo.robustperception.io:9090",job="prometheus"} 1 1521630638000 up{instance="demo.robustperception.io:9093",job="alertmanager"} 1 1521630638000 up{instance="demo.robustperception.io:9100",job="node"} 1 1521630638000 ``` Regex: ``` /. *instance=" ( [^"]* ) .*/ ``` Ergebnis: ``` demo.robustperception.io:9090 demo.robustperception.io:9093 demo.robustperception.io:9100 ``` **Filtern und ändern Sie mithilfe benannter Text- und Werterfassungsgruppen** Mithilfe benannter Erfassungsgruppen können Sie separate Teile von „Text“ und „Wert“ aus den von der Variablenabfrage zurückgegebenen Optionen erfassen. Auf diese Weise kann die Variablen-Dropdownliste für jeden auswählbaren Wert einen benutzerfreundlichen Namen enthalten. Wenn Sie beispielsweise die `node_hwmon_chip_names` Prometheus-Metrik abfragen, `chip_name` ist der viel freundlicher als der Wert. `chip` Also das folgende variable Abfrageergebnis: ``` node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_0",chip_name="enp216s0f0np0"} 1 node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_1",chip_name="enp216s0f0np1"} 1 node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_2",chip_name="enp216s0f0np2"} 1 node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_3",chip_name="enp216s0f0np3"} 1 ``` Hat den folgenden Regex durchlaufen: ``` /chip_name="(?[ ^ " ] + ) |chip=" (?[ ^ " ] + )/g ``` Würde die folgende Drop-down-Liste erzeugen: ``` Display Name Value ------------ ------------------------- enp216s0f0np0 0000:d7:00_0_0000:d8:00_0 enp216s0f0np1 0000:d7:00_0_0000:d8:00_1 enp216s0f0np2 0000:d7:00_0_0000:d8:00_2 enp216s0f0np3 0000:d7:00_0_0000:d8:00_3 ``` Nur Gruppennamen `text` und `value` Capture-Namen werden unterstützt. ## Auf der Variablenseite können Sie leicht erkennen, ob auf eine Variable in anderen Variablen oder im Dashboard verwiesen (oder verwendet) wird. Neben jeder Variablen, auf die verwiesen wird oder die verwendet wird, ist ein grünes Häkchen markiert, während bei Variablen, auf die nicht verwiesen wird, ein orangefarbenes Warnsymbol angezeigt wird. Darüber hinaus sind alle referenzierten Variablen mit einem Abhängigkeitssymbol neben dem grünen Häkchen gekennzeichnet. Sie können das Symbol auswählen, um die Abhängigkeitsübersicht anzuzeigen. Die Abhängigkeitsübersicht kann verschoben werden. Sie können die Ansicht mit dem Mausrad oder etwas Ähnlichem vergrößern oder verkleinern. # Syntax von Variablen **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) Paneltitel und metrische Abfragen können sich auf Variablen beziehen, die zwei unterschiedliche Syntaxen verwenden. + `$varname`— Diese Syntax ist leicht zu lesen, erlaubt es Ihnen jedoch nicht, eine Variable in der Mitte eines Wortes zu verwenden. **Beispiel**: `apps.frontend.$server.requests.count` + `${var_name}`— Verwenden Sie diese Syntax, wenn Sie eine Variable in der Mitte eines Ausdrucks verwenden möchten. + `${var_name:}`— Dieses Format gibt Ihnen mehr Kontrolle darüber, wie Grafana Werte interpretiert. Weitere Informationen finden Sie unter *Erweiterte Optionen für das Variablenformat*. + `[[varname]]`— Nicht verwenden. Diese Syntax ist alt und veraltet. Es wird in einer future Version entfernt. Bevor Abfragen an Ihre Datenquelle gesendet werden, wird die Abfrage *interpoliert*, was bedeutet, dass die Variable durch ihren aktuellen Wert ersetzt wird. Während der Interpolation kann der Variablenwert maskiert *werden*, um der Syntax der Abfragesprache und dem Verwendungszweck zu entsprechen. Beispielsweise wird eine Variable, die in einem Regex-Ausdruck in einer InfluxDB- oder Prometheus-Abfrage verwendet wird, mit Regex-Escapes versehen. **Erweiterte Optionen für das Variablenformat** Die Formatierung der Variableninterpolation hängt von der Datenquelle ab, es gibt jedoch Situationen, in denen Sie möglicherweise die Standardformatierung ändern möchten. Die Standardeinstellung für die MySQL-Datenquelle besteht beispielsweise darin, mehrere Werte durch Kommas getrennt durch Anführungszeichen zu verbinden:. `'server01','server02'` In einigen Fällen möchten Sie vielleicht eine durch Kommas getrennte Zeichenfolge ohne Anführungszeichen verwenden:. `server01,server02` Sie können dies mit den unten aufgeführten erweiterten Optionen zur Formatierung von Variablen erreichen. **Allgemeine Syntax** Syntax: `${var_name:option}` Wenn eine ungültige Formatierungsoption angegeben ist, `glob` ist dies die default/fallback Option. **CSV** Formatiert Variablen mit mehreren Werten als kommagetrennte Zeichenfolge. ``` servers = [ 'test1', 'test2' ] String to interpolate: '${servers:csv}' Interpolation result: 'test1,test2' ``` **Verteilt - OpenTSDB** Formatiert Variablen mit mehreren Werten in einem benutzerdefinierten Format für OpenTSDB. ``` servers = [ 'test1', 'test2' ] String to interpolate: '${servers:distributed}' Interpolation result: 'test1,servers=test2' ``` **Doppeltes Anführungszeichen** Formatiert ein- und mehrwertige Variablen in eine durch Kommas getrennte Zeichenfolge, maskiert jeden Wert mit `\"` und setzt jeden Wert mit `"` in Anführungszeichen. `"` ``` servers = [ 'test1', 'test2' ] String to interpolate: '${servers:doublequote}' Interpolation result: '"test1","test2"' ``` **Glob - Graphit** Formatiert Variablen mit mehreren Werten in einen Glob (für Graphite-Abfragen). ``` servers = [ 'test1', 'test2' ] String to interpolate: '${servers:glob}' Interpolation result: '{test1,test2}' ``` **JSON** Formatiert Variablen mit mehreren Werten als kommagetrennte Zeichenfolge. ``` servers = [ 'test1', 'test2' ] String to interpolate: '${servers:json}' Interpolation result: '["test1", "test2"]' ``` **Lucene - Elasticsearch** Formatiert Variablen mit mehreren Werten im Lucene-Format für Elasticsearch. ``` servers = [ 'test1', 'test2' ] String to interpolate: '${servers:lucene}' Interpolation result: '("test1" OR "test2")' ``` **Prozentualer Code** Formatiert ein- und mehrwertige Variablen zur Verwendung in URL-Parametern. ``` servers = [ 'foo()bar BAZ', 'test2' ] String to interpolate: '${servers:percentencode}' Interpolation result: 'foo%28%29bar%20BAZ%2Ctest2' ``` **Pfeife** Formatiert Variablen mit mehreren Werten in eine durch Pipe getrennte Zeichenfolge. ``` servers = [ 'test1.', 'test2' ] String to interpolate: '${servers:pipe}' Interpolation result: 'test1.|test2' ``` **Roh** Deaktiviert datenquellenspezifische Formatierungen, z. B. einfache Anführungszeichen in einer SQL-Abfrage. ``` servers = [ 'test.1', 'test2' ] String to interpolate: '${var_name:raw}' Interpolation result: 'test.1,test2' ``` **Regex** Formatiert Variablen mit mehreren Werten in eine Regex-Zeichenfolge. ``` servers = [ 'test1.', 'test2' ] String to interpolate: '${servers:regex}' Interpolation result: '(test1\.|test2)' ``` **Einfaches Anführungszeichen** Formatiert ein- und mehrwertige Variablen in eine durch Kommas getrennte Zeichenfolge, maskiert jeden Wert mit und setzt jeden Wert mit `'` in `\'` Anführungszeichen. `'` ``` servers = [ 'test1', 'test2' ] String to interpolate: '${servers:singlequote}' Interpolation result: "'test1','test2'" ``` **SQL-String** Formatiert ein- und mehrwertige Variablen in eine durch Kommas getrennte Zeichenfolge, maskiert jeden Wert mit `''` und setzt jeden Wert mit `'` in Anführungszeichen. `'` ``` servers = [ "test'1", "test2" ] String to interpolate: '${servers:sqlstring}' Interpolation result: "'test''1','test2'" ``` **Text** Formatiert ein- und mehrwertige Variablen in ihre Textdarstellung. Für eine einzelne Variable wird nur die Textdarstellung zurückgegeben. Bei Variablen mit mehreren Werten wird die Textdarstellung in Kombination mit `+` zurückgegeben. ``` servers = [ "test1", "test2" ] String to interpolate: '${servers:text}' Interpolation result: "test1 + test2" ``` **Abfrageparameter** Formatiert ein- und mehrwertige Variablen in ihre Darstellung der Abfrageparameter. Beispiel: `var-foo=value1&var-foo=value2` ``` servers = [ "test1", "test2" ] String to interpolate: '${servers:queryparam}' Interpolation result: "var-servers=test1&var-servers=test2" ```