Typen von Variablen

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

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

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

Grafana verwendet verschiedene Arten von Variablen.

Typ der Variablen	Beschreibung
Abfrage	Durch eine Abfrage generierte Werteliste wie Metriknamen, Servernamen, Sensor-IDs, Rechenzentren usw. Weitere Informationen finden Sie unter Hinzufügen einer Abfragevariablen.
Benutzerdefiniert	Definieren Sie die Variablenoptionen manuell mithilfe einer durch Kommas getrennten Liste. Weitere Informationen finden Sie unter Eine benutzerdefinierte Variable hinzufügen.
Text box (Textfeld)	Zeigt ein Texteingabefeld mit einem optionalen Standardwert an. Weitere Informationen finden Sie unter Eine Textfeld-Variable hinzufügen.
Konstante	Definieren Sie eine versteckte Konstante. Weitere Informationen finden Sie unter Eine konstante Variable hinzufügen.
Datenquelle	Ändern Sie schnell die Datenquelle für ein gesamtes Dashboard. Weitere Informationen finden Sie unter Eine Datenquellenvariable hinzufügen.
Intervall	Intervallvariablen stellen Zeitspannen dar. Weitere Informationen finden Sie unter Eine Intervallvariable hinzufügen.
Ad-hoc-Filter	Schlüssel-/Wertfilter, die automatisch zu allen Metrikabfragen für eine Datenquelle hinzugefügt werden (InfluxDB, Prometheus und nur). OpenSearch Weitere Informationen finden Sie unter Hinzufügen von Ad-hoc-Filtern.
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.

Hinzufügen einer Abfragevariablen

Mithilfe von Abfragevariablen können Sie eine Datenquellenabfrage schreiben, die eine Liste von Metriknamen, Tagwerten oder Schlüsseln zurückgibt. Eine Abfragevariable kann beispielsweise eine Liste von Servernamen, Sensor-IDs oder Rechenzentren zurückgeben. Die Variablenwerte ändern sich, wenn sie Optionen mit einer Datenquellenabfrage dynamisch abrufen.

Abfrageausdrücke können Verweise auf andere Variablen enthalten und somit verknüpfte Variablen erstellen. Grafana erkennt dies und aktualisiert automatisch eine Variable, wenn sich eine der verknüpften Variablen ändert.

Ausdrücke abfragen

Abfrageausdrücke sind für jede Datenquelle unterschiedlich. Weitere Informationen finden Sie in der Dokumentation zu Ihrer Datenquelle unterVerbinden zu Datenquellen.

Allgemeine Optionen eingeben

Um allgemeine Optionen für eine Abfragevariable einzugeben

1. Navigieren Sie zu dem Dashboard, für das Sie eine Variable erstellen möchten, und wählen Sie dann oben auf der Seite das Symbol Dashboard-Einstellungen (Zahnrad) aus.

2. Wählen Sie auf der Registerkarte Variablen die Option Neu aus.

3. Geben Sie einen Namen für Ihre Variable ein.

4. Wählen Sie in der Liste Typ die Option Abfrage aus.

5. (Optional) Geben Sie unter Label den Anzeigenamen der Variablen-Dropdownliste ein. Wenn Sie keinen Anzeigenamen eingeben, entspricht das Dropdown-Label dem Variablennamen.

6. Wählen Sie eine Option zum Ausblenden:

   • Keine Auswahl (leer) — In der Dropdownliste der Variablen wird der Variablenname oder der Labelwert angezeigt. Dies ist die Standardeinstellung.

   • Bezeichnung — In der Variablen-Dropdownliste werden nur der ausgewählte Variablenwert und ein Abwärtspfeil angezeigt.

   • Variabel — Auf dem Dashboard wird keine Dropdownliste für Variablen angezeigt.

Abfrageoptionen eingeben

Um Abfrageoptionen für eine Abfragevariable einzugeben

1. Wählen Sie in der Datenquellenliste die Zieldatenquelle für die Abfrage aus. Weitere Informationen zu Datenquellen finden Sie unterVerbinden zu Datenquellen.

2. Wählen Sie in der Aktualisierungsliste aus, wann die Variable die Optionen aktualisieren soll.

   • Nie — Speichert Variablenabfragen im Cache, und Werte werden nicht aktualisiert. Das ist in Ordnung, wenn sich die Werte nie ändern, aber problematisch, wenn sie dynamisch sind und sich stark ändern.

   • 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.

3. Geben Sie im Feld Abfrage eine Abfrage ein.

   • Das Abfragefeld variiert je nach Datenquelle. Einige Datenquellen verfügen über benutzerdefinierte Abfrage-Editoren.

   • Wenn Sie in einem einzelnen Eingabefeld-Abfrage-Editor mehr Platz benötigen, halten Sie an den Linien in der unteren rechten Ecke des Felds und ziehen Sie es nach unten, um es zu erweitern.

4. (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 Variablen mit Regex filtern.

5. Wählen Sie in der Sortierliste die Sortierreihenfolge für 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.

6. (Optional) Geben Sie Auswahloptionen ein. Weitere Informationen finden Sie unter Variablenauswahloptionen eingeben.

7. In der Vorschau der Werte zeigt der Grafana-Arbeitsbereich eine Liste der aktuellen Variablenwerte an. Überprüfen Sie sie, um sicherzustellen, dass sie Ihren Erwartungen entsprechen.

8. Wählen Sie Hinzufügen, um die Variable zum Dashboard hinzuzufügen.

Eine benutzerdefinierte Variable hinzufügen

Verwenden Sie eine benutzerdefinierte Variable für Werte, die sich nicht ändern. Dies können Zahlen, Zeichenketten oder sogar andere Variablen sein.

Wenn Sie beispielsweise Servernamen oder Regionsnamen haben, die sich nicht ändern, können Sie sie als benutzerdefinierte Variablen und nicht als Abfragevariablen erstellen. Da sie sich nicht ändern, können Sie sie eher in verketteten Variablen als in anderen Abfragevariablen verwenden. Dies würde die Anzahl der Abfragen reduzieren, die Grafana senden muss, wenn verkettete Variablen aktualisiert werden. Weitere Hinweise zu verketteten Variablen finden Sie unter. Verkettete Variablen

Allgemeine Optionen eingeben

Um Abfrageoptionen für eine benutzerdefinierte Variable einzugeben

1. Navigieren Sie zu dem Dashboard, für das Sie eine Variable erstellen möchten, und wählen Sie dann oben auf der Seite das Symbol Dashboard-Einstellungen (Zahnrad) aus.

2. Wählen Sie auf der Registerkarte Variablen die Option Neu aus.

3. Geben Sie einen Namen für Ihre Variable ein.

4. Wählen Sie in der Liste Typ die Option Benutzerdefiniert aus.

5. (Optional) Geben Sie unter Label den Anzeigenamen der Variablen-Dropdownliste ein. Wenn Sie keinen Anzeigenamen eingeben, entspricht das Dropdown-Label dem Variablennamen.

6. Wählen Sie eine Option zum Ausblenden:

   • Keine Auswahl (leer) — In der Dropdownliste der Variablen wird der Variablenname oder der Labelwert angezeigt. Dies ist die Standardeinstellung.

   • Bezeichnung — In der Dropdownliste der Variablen werden nur der ausgewählte Variablenwert und ein Abwärtspfeil angezeigt.

   • Variabel — Auf dem Dashboard wird keine Dropdownliste für Variablen angezeigt.

Eingabe benutzerdefinierter Optionen

Um benutzerdefinierte Optionen für eine benutzerdefinierte Variable einzugeben

1. Geben Sie in der Liste Durch Kommas getrennte Werte die Werte für diese Variable in einer durch Kommas getrennten Liste ein. Sie können Zahlen, Zeichenketten, andere Variablen oder durch einen Doppelpunkt getrennte Schlüssel-Wert-Paare angeben.

2. (Optional) Geben Sie Auswahloptionen ein. Weitere Informationen finden Sie unter Variablenauswahloptionen eingeben.

3. In der Vorschau der Werte zeigt der Grafana-Arbeitsbereich eine Liste der aktuellen Variablenwerte an. Überprüfen Sie sie, um sicherzustellen, dass sie Ihren Erwartungen entsprechen.

4. Wählen Sie Hinzufügen, um die Variable zum Dashboard hinzuzufügen.

Eine Textfeld-Variable hinzufügen

Textfeldvariablen zeigen ein Texteingabefeld 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.

Allgemeine Optionen eingeben

Um allgemeine Optionen für eine Textfeldvariable einzugeben

1. Navigieren Sie zu dem Dashboard, für das Sie eine Variable erstellen möchten, und wählen Sie dann oben auf der Seite das Symbol Dashboard-Einstellungen (Zahnrad) aus.

2. Wählen Sie auf der Registerkarte Variablen die Option Neu aus.

3. Geben Sie einen Namen für Ihre Variable ein.

4. Wählen Sie in der Liste Typ die Option Textfeld aus.

5. (Optional) Geben Sie unter Label den Anzeigenamen der Variablen-Dropdownliste ein. Wenn Sie keinen Anzeigenamen eingeben, entspricht das Dropdown-Label dem Variablennamen.

6. Wählen Sie eine Option zum Ausblenden:

   • Keine Auswahl (leer) — In der Dropdownliste der Variablen wird der Variablenname oder der Labelwert angezeigt. Dies ist die Standardeinstellung.

   • Bezeichnung — In der Variablen-Dropdownliste werden nur der ausgewählte Variablenwert und ein Abwärtspfeil angezeigt.

   • Variabel — Auf dem Dashboard wird keine Dropdownliste für Variablen angezeigt.

Textoptionen eingeben

Um Textoptionen für eine Textfeldvariable einzugeben

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 Sie Text eingeben können.

2. In der Wertevorschau zeigt Grafana eine Liste der aktuellen Variablenwerte an. Überprüfen Sie sie, um sicherzustellen, dass sie Ihren Erwartungen entsprechen.

3. Wählen Sie Hinzufügen, um die Variable zum Dashboard hinzuzufügen.

Eine konstante Variable hinzufügen

Verwenden Sie konstante Variablen, um eine versteckte Konstante zu definieren. Konstante Variablen eignen sich für metrische Pfadpräfixe für Dashboards, die Sie gemeinsam nutzen möchten. Wenn Sie ein Dashboard exportieren, werden konstante Variablen in Importoptionen konvertiert.

Konstante Variablen sind nicht flexibel. Jede konstante Variable enthält nur einen Wert. Um sie zu aktualisieren, müssen 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 einzelnen Abfrage erneut eingeben möchten. Wenn Sie beispielsweise einen Serverpfad mit dem Namen habeni-0b6a61efe2ab843gg, können Sie ihn durch eine Variable mit dem Namen $path_gg ersetzen.

Allgemeine Optionen eingeben

Um allgemeine Optionen für eine konstante Variable einzugeben

1. Navigieren Sie zu dem Dashboard, für das Sie eine Variable erstellen möchten, und wählen Sie dann oben auf der Seite das Symbol Dashboard-Einstellungen (Zahnrad) aus.

2. Wählen Sie auf der Registerkarte Variablen die Option Neu aus.

3. Geben Sie einen Namen für Ihre Variable ein.

4. Wählen Sie in der Liste Typ die Option Konstante aus.

5. (Optional) Geben Sie unter Label den Anzeigenamen der Variablen-Dropdownliste ein. Wenn Sie keinen Anzeigenamen eingeben, entspricht das Dropdown-Label dem Variablennamen.

6. Wählen Sie eine Option zum Ausblenden:

   • Variabel — Auf dem Dashboard wird keine Dropdownliste für Variablen angezeigt. Dies ist die Standardeinstellung.

   • Keine Auswahl (leer) — In der Dropdownliste der Variablen wird der Variablenname oder der Labelwert angezeigt.

   • Bezeichnung — In der Variablen-Dropdownliste werden nur der ausgewählte Variablenwert und ein Abwärtspfeil angezeigt.

Konstante Optionen eingeben

Um konstante Optionen für eine konstante Variable einzugeben

1. Geben Sie im Feld Wert den Variablenwert ein. Sie können Buchstaben, Zahlen und Symbole eingeben. Wenn Sie erweiterte Optionen für das Variablenformat verwenden, können Sie sogar Platzhalter verwenden. Weitere Informationen finden Sie unter Erweiterte Optionen für das Variablenformat.

2. In der Vorschau der Werte zeigt der Grafana-Workspace den aktuellen Variablenwert an. Überprüfen Sie es, um sicherzustellen, dass es Ihren Erwartungen entspricht.

3. Wählen Sie Hinzufügen, um die Variable zum Dashboard hinzuzufügen.

Eine Datenquellenvariable hinzufügen

Um die Datenquelle für ein ganzes Dashboard schnell zu ändern, können Sie Datenquellenvariablen verwenden. Sie sind nützlich, wenn Sie mehrere Instanzen einer Datenquelle haben, möglicherweise in unterschiedlichen Umgebungen.

Allgemeine Optionen eingeben

Um allgemeine Optionen für eine Datenquellenvariable einzugeben

1. Navigieren Sie zu dem Dashboard, für das Sie eine Variable erstellen möchten, und wählen Sie dann oben auf der Seite das Symbol Dashboard-Einstellungen (Zahnrad) aus.

2. Wählen Sie auf der Registerkarte Variablen die Option Neu aus.

3. Geben Sie einen Namen für Ihre Variable ein.

4. Wählen Sie in der Liste Typ die Option Datenquelle aus.

5. (Optional) Geben Sie unter Label den Anzeigenamen der Variablen-Dropdownliste ein. Wenn Sie keinen Anzeigenamen eingeben, entspricht das Dropdown-Label dem Variablennamen.

6. Wählen Sie eine Option zum Ausblenden:

   • Keine Auswahl (leer) — In der Dropdownliste der Variablen wird der Variablenname oder der Labelwert angezeigt. Dies ist die Standardeinstellung.

   • Bezeichnung — In der Variablen-Dropdownliste werden nur der ausgewählte Variablenwert und ein Abwärtspfeil angezeigt.

   • Variabel — Auf dem Dashboard wird keine Dropdownliste für Variablen angezeigt.

Datenquellenoptionen eingeben

Um Datenquellenoptionen für eine Datenquellenvariable einzugeben

1. Wählen Sie in der Liste Typ die Zieldatenquelle für die Variable aus. Weitere Informationen zu Datenquellen finden Sie unterVerbinden zu Datenquellen.

2. (Optional) Geben Sie für den Instanznamenfilter in der Dropdownliste für Variablenwerte einen Regex-Filter ein, für welche Datenquelleninstanzen Sie auswählen können. Lassen Sie dieses Feld leer, um alle Instanzen anzuzeigen.

3. (Optional) Geben Sie Auswahloptionen ein. Weitere Informationen finden Sie unter Variablenauswahloptionen eingeben.

4. In der Wertevorschau zeigt Grafana eine Liste der aktuellen Variablenwerte an. Überprüfen Sie sie, um sicherzustellen, dass sie Ihren Erwartungen entsprechen.

5. Wählen Sie Hinzufügen, um die Variable zum Dashboard hinzuzufügen.

Eine Intervallvariable hinzufügen

Verwenden Sie eine Intervallvariable zur Darstellung von Zeitspannen wie1m,1h,1d. Sie können sie sich als einen Befehl für das gesamte Dashboard vorstellen. group-by-time 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 zum Gruppieren nach Zeit (für InfluxDB), Datumshistogrammintervall (für OpenSearch) oder als Parameter für die Zusammenfassungsfunktion (für Graphite) verwenden.

Allgemeine Optionen eingeben

Um allgemeine Optionen für eine Intervallvariable einzugeben

1. Navigieren Sie zu dem Dashboard, für das Sie eine Variable erstellen möchten, und wählen Sie dann oben auf der Seite das Symbol Dashboard-Einstellungen (Zahnrad) aus.

2. Wählen Sie auf der Registerkarte Variablen die Option Neu aus.

3. Geben Sie einen Namen für Ihre Variable ein.

4. Wählen Sie in der Liste Typ die Option Intervall aus.

5. (Optional) Geben Sie unter Label den Anzeigenamen der Variablen-Dropdownliste ein. Wenn Sie keinen Anzeigenamen eingeben, entspricht das Dropdown-Label dem Variablennamen.

6. Wählen Sie eine Option zum Ausblenden:

   • Keine Auswahl (leer) — In der Dropdownliste der Variablen wird der Variablenname oder der Labelwert angezeigt. Dies ist die Standardeinstellung.

   • Bezeichnung — In der Variablen-Dropdownliste werden nur der ausgewählte Variablenwert und ein Abwärtspfeil angezeigt.

   • Variabel — Auf dem Dashboard wird keine Dropdownliste für Variablen angezeigt.

Intervalloptionen eingeben

Um Intervalloptionen für eine Intervallvariable einzugeben

1. Geben Sie im Feld Werte die Zeitbereichsintervalle 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), undy (years). Sie können die Standardwerte auch akzeptieren oder bearbeiten:1m,10m,30m,1h,6h,12h,1d,7d,14d,30d.

2. (Optional) Aktivieren Sie die Option Automatische Option, wenn Sie die auto Option zur Liste hinzufügen möchten. Verwenden Sie diese Option, um anzugeben, 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-minütige Beispiel fortzusetzen: Wenn das Mindestintervall auf eingestellt ist2m, gruppiert Grafana die Daten in 15-Minuten-Schritten.

3. In der Wertevorschau zeigt Grafana eine Liste der aktuellen Variablenwerte an. Überprüfen Sie sie, um sicherzustellen, dass sie Ihren Erwartungen entsprechen.

4. Wählen Sie Hinzufügen, um die Variable zum Dashboard hinzuzufügen.

Beispiele für Intervallvariablen

Beispiel für die Verwendung der Template-Variablen myinterval in einer Graphite-Funktion:

summarize($myinterval, sum, false)

Ein komplexeres Graphite-Beispiel:

groupByNode(summarize(movingAverage(apps.$app.$server.counters.requests.count, 5), '$interval', 'sum', false), 2, 'sum')

Hinzufügen von Ad-hoc-Filtern

Sie können Einmalfilter oder Ad-hoc-Filter verwenden, um Schlüssel-/Wertfilter hinzuzufügen, die automatisch zu allen Metrikabfragen hinzugefügt werden, die die angegebene Datenquelle verwenden. Im Gegensatz zu anderen Variablen verwenden Sie in Abfragen keine Einmalfilter. Stattdessen verwenden Sie sie, um Filter für bestehende Abfragen zu schreiben.

Anmerkung

Hinweis: Einmalige oder Ad-hoc-Filtervariablen funktionieren nur mit InfluxDB, Prometheus und Datenquellen. OpenSearch

Allgemeine Optionen eingeben

Um allgemeine Optionen für einen Ad-hoc-Filter einzugeben

1. Navigieren Sie zu dem Dashboard, für das Sie eine Variable erstellen möchten, und wählen Sie dann oben auf der Seite das Symbol Dashboard-Einstellungen (Zahnrad) aus.

2. Wählen Sie auf der Registerkarte Variablen die Option Neu aus.

3. Geben Sie einen Namen für Ihre Variable ein.

4. Wählen Sie in der Liste Typ die Option Ad-hoc-Filter aus.

5. (Optional) Geben Sie unter Label den Anzeigenamen der Variablen-Dropdownliste ein. Wenn Sie keinen Anzeigenamen eingeben, entspricht das Dropdown-Label dem Variablennamen.

6. Wählen Sie eine Option zum Ausblenden:

   • Keine Auswahl (leer) — In der Dropdownliste der Variablen wird der Variablenname oder der Labelwert angezeigt. Dies ist die Standardeinstellung.

   • Bezeichnung — In der Variablen-Dropdownliste werden nur der ausgewählte Variablenwert und ein Abwärtspfeil angezeigt.

   • Variabel — Auf dem Dashboard wird keine Dropdownliste für Variablen angezeigt.

Optionen eingeben

Um Optionen für einen Ad-hoc-Filter einzugeben

1. Wählen Sie in der Datenquellenliste die Zieldatenquelle aus. Weitere Informationen zu Datenquellen finden Sie unterVerbinden zu Datenquellen.

2. Wählen Sie Hinzufügen, um die Variable zum Dashboard hinzuzufügen.

Ad-hoc-Filter erstellen

Ad-hoc-Filter sind eine der komplexesten und flexibelsten Variablenoptionen, die es gibt. Anstatt einer regulären Liste von Variablenoptionen ermöglicht diese Variable die Erstellung einer Ad-hoc-Abfrage für das gesamte Dashboard. Filter, die Sie auf diese Weise anwenden, werden auf alle Bereiche im Dashboard angewendet.

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 unterstützt.

Sie können komplexe verknüpfte Dashboards mit Vorlagen mit einer Tiefe von 5 oder 10 Ebenen erstellen. Technisch gesehen gibt es keine Begrenzung, 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 verkettete Variablen erstellen

• Durch das Verketten von Variablen entstehen Abhängigkeiten zwischen Eltern und Kindern. Sie können sie sich als Leiter oder Baum vorstellen.

• Der schnellste Weg, eine neue verkettete Variable zu erstellen, besteht darin, die Variable zu kopieren, auf der die neue Variable basieren soll. Wählen Sie in der Variablenliste 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 verkettete Variablen, die Sie auf diese Weise erstellen, werden am Ende der Liste angezeigt. Um der Liste eine logische Reihenfolge zu geben, ziehen Sie die Variable an eine andere Position in der Liste.

Reihenfolge der Variablen

Um die Reihenfolge der Variablen in der Variablenliste des Dashboards zu ändern, wählen Sie die Aufwärts- und Abwärtspfeile auf der rechten Seite jedes Eintrags. Der Grafana-Arbeitsbereich listet gemäß dieser Liste Variablen-Dropdownlisten von links nach rechts auf, wobei die Variable ganz oben in der Liste ganz links angezeigt wird.

• Listet Variablen ohne Abhängigkeiten ganz oben vor ihren untergeordneten Variablen auf.

• Jede Variable sollte der Variablen folgen, von der sie abhängig ist.

• Die Benutzeroberfläche gibt nicht an, welche Variablen Abhängigkeitsbeziehungen haben. Listen Sie die Variablen in einer logischen Reihenfolge auf, um sie den Endbenutzern (und Ihnen selbst) klarer zu machen.

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 der Grafana-Workspace Abfragen für alle abhängigen Variablen ausführen, bevor er die Visualisierungen im Dashboard aktualisiert.

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.

$__dashboard

Diese Variable ist der Name des aktuellen Dashboards.

$__from und $__to

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	Beispiel für ein Ergebnis	Beschreibung
${__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 Datenformat. Weitere Informationen finden Sie unter Anzeige.

Die obige Syntax funktioniert ${__to} auch mit.

Sie können diese Variable auch in URLs verwenden. Um beispielsweise einen Endbenutzer zu einem Dashboard weiterzuleiten, das einen Zeitraum von vor sechs Stunden bis heute anzeigt, verwenden Sie die folgende URL: https://play.grafana.org/d/000000012/grafana-play-home? viewPanel=2&orgid=1? von=jetzt-6h&bis=jetzt

$__intervall

Sie können die $__interval Variable als Parameter zum Gruppieren nach Zeit (für InfluxDB, Myself, Postgres, MSSQL), Datumshistogramm-Intervall (für) oder als Zusammenfassungsfunktionsparameter (für OpenSearch Graphite) verwenden.

Der Grafana-Workspace 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 Abfragen effizienter gestaltet werden, indem sie nach einem größeren Intervall gruppiert werden. Bei der Betrachtung von Daten aus 3 Monaten ist es beispielsweise effizienter, nach einem Tag zu gruppieren als nach 10 Sekunden. Das Diagramm wird genauso aussehen und die Abfrage wird schneller sein. Das $__interval wird anhand des Zeitbereichs und der Breite des Diagramms (Anzahl der Pixel) berechnet.

Ungefähre Berechnung: (from - to) / resolution

Wenn der Zeitraum beispielsweise 1 Stunde beträgt und das Diagramm im Vollbildmodus angezeigt wird, kann das Intervall wie folgt berechnet werden2m; Punkte werden in Intervallen von 2 Minuten gruppiert. 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 alte Variable dieselbe Variable. Verwenden Sie stattdessen $__interval.

Die InfluxDB und die OpenSearch Datenquellen haben Group by time interval Felder, die verwendet werden, um das Intervall fest zu codieren oder um die Mindestgrenze für die $__interval Variable mithilfe der Syntax -> festzulegen. > >10m

$__interval_ms

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

$__name

Diese Variable ist nur im Bereich Singlestat verfügbar und kann in den Präfix- oder Suffixfeldern auf der Registerkarte Optionen verwendet werden. Die Variable wird durch den Seriennamen oder Alias ersetzt.

$__org

Diese Variable ist die ID der aktuellen Organisation. Die Variable ${__org.name} ist der Name der aktuellen Organisation.

$__user

Die Variable ${__user.id} ist die ID des aktuellen Benutzers. Die Variable ${__user.login} ist das Login-Handle des aktuellen Benutzers. Die Variable ${__user.email} ist die E-Mail für den aktuellen Benutzer.

$__range

Diese Variable wird derzeit nur für Prometheus-Datenquellen unterstützt. Diese Variable stellt den Bereich für das aktuelle Dashboard dar. Sie wird berechnet vonto - from. Es hat Millisekunden- und Sekundendarstellungen, die als und bezeichnet werden. $__range_ms $__range_s

$timeFilter oder $__timeFilter

Die $timeFilter Variable gibt den aktuell ausgewählten Zeitraum als Ausdruck zurück. Der Last 7 days Ausdruck für das Zeitbereichsintervall lautet beispielsweisetime > now() - 7d.

Diese Variable 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.