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.

Variablen hinzufügen und verwalten

In der folgenden Tabelle sind die Variablentypen aufgeführt, die mit Grafana geliefert werden.

Allgemeine Optionen eingeben

Sie müssen allgemeine Optionen für jeden Variablentyp eingeben, den Sie erstellen.

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, Sensor-IDs 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 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.

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 als in anderen Abfragevariablen verwenden. Dies würde die Anzahl der Abfragen reduzieren, die Grafana senden muss, wenn verkettete Variablen aktualisiert werden.

Eine Textfeld-Variable hinzufügen

Textfeld-Variablen 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.

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 habeni-0b6a61efe2ab843gg, können Sie ihn durch eine Variable mit dem Namen $path_gg ersetzen.

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.

Eine Intervallvariable hinzufügen

Verwenden Sie eine Intervallvariable, um Zeitspannen wie 1m1h, 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.

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.

Erstellen Sie Ad-hoc-Filter

Ad-hoc-Filter sind eine der komplexesten und flexibelsten Variablenoptionen, die es gibt. 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.

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:

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.

$__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.

Die obige Syntax funktioniert auch mit${__to}.

$__interval

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 alte Variable dieselbe Variable. $__intervalsollte 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

$__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

$__org

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

$__user

${__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.

$__range

Derzeit nur für Prometheus- und Loki-Datenquellen unterstützt. Diese Variable stellt den Bereich für das aktuelle Dashboard dar. Sie wird berechnet vonto - from. Es hat eine Millisekunde und eine zweite Darstellung namens und. $__range_ms $__range_s

$__rate_interval

Derzeit nur für Prometheus-Datenquellen unterstützt. Die $__rate_interval Variable ist für die Verwendung in der Ratenfunktion vorgesehen.

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

Dies wird an verschiedenen Stellen verwendet, unter anderem:

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

Mit den folgenden Methoden können Sie Ihre Dashboards und Variablen einfacher verwenden.

Neue verknüpfte Variablen erstellen

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.

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 und bestehende Variablen verwalten. Außerdem können Sie Variablen überprüfen 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 Sie Regex verwenden, um Werte in der Variablen-Dropdownliste zu filtern/zu ändern.

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 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-Capture-Gruppe, 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="(?<text>[ ^ " ] + ) |chip=" (?<value >[ ^ " ] + )/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.