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. # Vorlagen und 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](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) Eine Variable ist ein Platzhalter für einen Wert. Sie können Variablen in metrischen Abfragen und in Paneltiteln verwenden. Variablen bieten Ihnen die Möglichkeit, 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. Wenn Sie den Wert mithilfe der Dropdownliste oben im Dashboard ändern, spiegeln die Metrikabfragen Ihres Panels den neuen Wert wider. Diese können besonders für Administratoren nützlich sein, die es Zuschauern ermöglichen möchten, Visualisierungen schnell anzupassen, ihnen aber keine vollständigen Bearbeitungsberechtigungen geben möchten. Grafana-Zuschauer können Variablen verwenden. Durch die Verwendung von Variablen und Vorlagen können Sie Dashboards aus einer Hand 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. Dies vereinfacht Wartung und Instandhaltung. Eine Liste der unterstützten Variablentypen und Anweisungen zum Hinzufügen der einzelnen Variablentypen finden Sie unter [Typen von Variablen](variables-types.md) ## -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 Panels mit Vorlagenabfragen verwenden, wie im folgenden Beispiel gezeigt. ``` wmi_system_threads{instance=~"$server"} ``` Variablenwerte werden immer mithilfe der Syntax `var-=value` mit der URL synchronisiert. ## Bewährte Methoden für Variablen 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. ## Syntax der Variablen Bei Panel-Titeln und metrischen Abfragen können Variablen mithilfe von zwei verschiedenen Syntaxen erkannt werden: + `$varname`Diese Syntax ist einfacher zu lesen, wie im folgenden Beispiel:`apps.frontend.$server.requests.count`. Sie können jedoch keine Variable in der Mitte eines Wortes verwenden. + `${var_name}`Verwenden Sie diese Syntax, wenn Sie eine Variable in der Mitte eines Ausdrucks interpolieren möchten. + `${var_name:}`Dieses Format gibt Ihnen mehr Kontrolle darüber, wie Grafana Werte interpoliert. Weitere Informationen finden Sie unter [Erweiterte Optionen für das Variablenformat](#advanced-variable-format-options). 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 Prometheus-Abfrage verwendet wird, mit Regex-Escapes versehen. Einzelheiten zur Umgehung von Werten bei der Interpolation finden Sie in der datenquellenspezifischen Dokumentation. Informationen zur erweiterten Syntax zum Überschreiben der Standardformatierung von Datenquellen finden Sie unter. [Erweiterte Optionen für das Variablenformat](#advanced-variable-format-options) # 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](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) Grafana verwendet verschiedene Arten von Variablen. | Variablentyp | Description | | --- | --- | | Query | Durch eine Abfrage generierte Werteliste wie Metriknamen, Servernamen IDs, Sensoren, Rechenzentren usw. Weitere Informationen finden Sie unter [Hinzufügen einer Abfragevariablen](#add-a-query-variable). | | Benutzerdefiniert | Definieren Sie die Variablenoptionen manuell mithilfe einer durch Kommas getrennten Liste. Weitere Informationen finden Sie unter [Eine benutzerdefinierte Variable hinzufügen](#add-a-custom-variable). | | Text box (Textfeld) | Zeigt ein Texteingabefeld mit einem optionalen Standardwert an. Weitere Informationen finden Sie unter [Eine Textfeld-Variable hinzufügen](#add-a-text-box-variable). | | Konstante | Definieren Sie eine versteckte Konstante. Weitere Informationen finden Sie unter [Eine konstante Variable hinzufügen](#add-a-constant-variable). | | Datenquelle | Ändern Sie schnell die Datenquelle für ein gesamtes Dashboard. Weitere Informationen finden Sie unter [Eine Datenquellenvariable hinzufügen](#add-a-data-source-variable). | | Intervall | Intervallvariablen stellen Zeitspannen dar. Weitere Informationen finden Sie unter [Eine Intervallvariable hinzufügen](#add-an-interval-variable). | | Ad-hoc-Filter | Key/value Filter, die automatisch zu allen metrischen Abfragen für eine Datenquelle hinzugefügt werden (InfluxDB, Prometheus und nur). OpenSearch Weitere Informationen finden Sie unter [Hinzufügen von Ad-hoc-Filtern](#add-ad-hoc-filters). | | Globale Variablen | Integrierte Variablen, die in Ausdrücken im Abfrage-Editor verwendet werden können. Weitere Informationen finden Sie unter [Globale Variablen](#global-variables). | | Verkettete Variablen | Variablenabfragen können andere Variablen enthalten. Weitere Informationen finden Sie unter [Verkettete Variablen](#chained-variables). | ## 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 IDs, Sensoren 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 unter[Verbinden zu Datenquellen](AMG-data-sources.md). ### 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 für **Dashboard-Einstellungen** (Zahnrad) aus. 1. Wählen Sie auf der Registerkarte **Variablen** die Option **Neu** aus. 1. Geben Sie einen **Namen** für Ihre Variable ein. 1. Wählen Sie in der Liste **Typ** die Option **Abfrage** aus. 1. (Optional) Geben Sie unter **Label** 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 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 unter[Verbinden zu Datenquellen](AMG-data-sources.md). 1. 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. 1. 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. 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 [Variablen mit Regex filtern](templates-and-variables.md#filter-variables-with-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** ein. Weitere Informationen finden Sie unter [Variablenauswahloptionen eingeben](templates-and-variables.md#enter-variable-selection-options). 1. 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. 1. 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](#chained-variables) ### 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. 1. Wählen Sie auf der Registerkarte **Variablen** die Option **Neu** aus. 1. Geben Sie einen **Namen** für Ihre Variable ein. 1. Wählen Sie in der Liste **Typ** die Option **Benutzerdefiniert** aus. 1. (Optional) Geben Sie unter **Label** 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 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. 1. (Optional) Geben Sie **Auswahloptionen** ein. Weitere Informationen finden Sie unter [Variablenauswahloptionen eingeben](templates-and-variables.md#enter-variable-selection-options). 1. 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. 1. 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. 1. Wählen Sie auf der Registerkarte **Variablen** die Option **Neu** aus. 1. Geben Sie einen **Namen** für Ihre Variable ein. 1. Wählen Sie in der Liste **Typ** die Option **Textfeld** aus. 1. (Optional) Geben Sie unter **Label** 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 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. 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**, 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 haben`i-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 für **Dashboard-Einstellungen** (Zahnrad) aus. 1. Wählen Sie auf der Registerkarte **Variablen** die Option **Neu** aus. 1. Geben Sie einen **Namen** für Ihre Variable ein. 1. Wählen Sie in der Liste **Typ** die Option **Konstante** aus. 1. (Optional) Geben Sie unter **Label** 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**: + **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](templates-and-variables.md#advanced-variable-format-options). 1. In **der Vorschau der Werte** zeigt der Grafana-Workspace den aktuellen Variablenwert an. Überprüfen Sie es, um sicherzustellen, dass es Ihren Erwartungen entspricht. 1. 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 für **Dashboard-Einstellungen** (Zahnrad) aus. 1. Wählen Sie auf der Registerkarte **Variablen** die Option **Neu** aus. 1. Geben Sie einen **Namen** für Ihre Variable ein. 1. Wählen Sie in der Liste **Typ** die Option **Datenquelle** aus. 1. (Optional) Geben Sie unter **Label** 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 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 unter[Verbinden zu Datenquellen](AMG-data-sources.md). 1. (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. 1. (Optional) Geben Sie **Auswahloptionen** ein. Weitere Informationen finden Sie unter [Variablenauswahloptionen eingeben](templates-and-variables.md#enter-variable-selection-options). 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**, um die Variable zum Dashboard hinzuzufügen. ## Eine Intervallvariable hinzufügen Verwenden Sie eine *Intervallvariable* zur Darstellung von Zeitspannen wie`1m`,`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. 1. Wählen Sie auf der Registerkarte **Variablen** die Option **Neu** aus. 1. Geben Sie einen **Namen** für Ihre Variable ein. 1. Wählen Sie in der Liste **Typ** die Option **Intervall** aus. 1. (Optional) Geben Sie **unter Label** 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 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)`, 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 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 ist`2m`, gruppiert Grafana die Daten in 15-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**, 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 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 Ihre Variable ein. 1. Wählen Sie in der Liste **Typ** die Option **Ad-hoc-Filter** aus. 1. (Optional) Geben Sie unter **Label** 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 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 unter[Verbinden zu Datenquellen](AMG-data-sources.md). 1. 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 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 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. ### \$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 | | --- | --- | --- | | \$1\$1\$1\$1from\$1 | 1594671549254 | Unix-Millisekunden-Epoche | | \$1\$1\$1\$1from:date\$1 | 2020-07-13T 20:19:09.254 Z | Keine Argumente, standardmäßig ISO 8601/RFC 3339 | | \$1\$1\$1\$1from:date:iso\$1 | 2020-07-13T 20:19:09,254 Z | ISO 8601/RFC 3339 | | \$1\$1\$1\$1from:date:seconds\$1 | 1594671549 | Unix-Sekunden-Epoche | | \$1\$1\$1\$1from:date:YYYY-MM\$1 | 2020-07 | Jedes benutzerdefinierte Datenformat. Weitere Informationen finden Sie unter [Anzeige](https://momentjs.com/docs/#/displaying/). | Die obige Syntax funktioniert `${__to}` auch mit. Sie können diese Variable URLs auch in 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-nach Hause spielen? ViewPanel=2&orgid=1? von=jetzt-6h&bis=jetzt ### \$1\$1\$1intervall *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 werden`2m`; 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 Legacy-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` ### \$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\$1name **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. ### \$1\$1\$1org Diese Variable ist die ID der aktuellen Organisation. Die Variable `${__org.name}` ist der Name der aktuellen Organisation. ### \$1\$1\$1user 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. ### \$1\$1\$1range 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 von`to - from`. Es hat Millisekunden- und Sekundendarstellungen, die als und bezeichnet werden. `$__range_ms` `$__range_s` ### \$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`. 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. ## Andere Variablenoptionen In diesem Abschnitt werden die anderen verfügbaren Variablenoptionen erläutert. ### Variablenauswahloptionen eingeben Sie können die **Auswahloptionen** verwenden, um die Auswahl variabler Optionen zu verwalten. Alle Auswahloptionen sind optional und standardmäßig deaktiviert. #### Mehrwertig Wenn Sie diese Option aktivieren, unterstützt die Dropdownliste für Variablen die gleichzeitige Auswahl mehrerer Optionen. Weitere Informationen finden Sie unter [Formatieren von Variablen mit mehreren Werten](#formatting-multi-value-variables). #### Option „Alle einbeziehen“ Der Grafana-Arbeitsbereich fügt der Variablen-Dropdownliste eine `All` Option hinzu. Wenn ein Endbenutzer diese Option auswählt, werden alle variablen Optionen ausgewählt. #### Benutzerdefinierter Wert für alle Diese Option ist nur sichtbar, wenn die **Option Alle einbeziehen** ausgewählt ist. Um den Wert der `All` Option zu definieren, geben Sie Regex-, Glob- oder Lucene-Syntax in das Feld Alle Werte **anpassen** ein. Standardmäßig umfasst der `All` Wert alle Optionen im 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. Wenn Sie eine benutzerdefinierte Regex-, Glob- oder Lucene-Syntax in der Option **Alle Werte anpassen verwenden, wird diese nie maskiert. Sie müssen also überlegen, welcher Wert** für Ihre Datenquelle gültig ist. ### 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` Verwenden Sie dazu die folgenden erweiterten Formatierungsoptionen für Variablen. #### Allgemeine Syntax Syntax: `${var_name:option}` Wenn eine ungültige Formatierungsoption angegeben wurde, `glob` ist dies die Standard- oder Ausweichoption. #### 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 Variablen mit einem und mehreren Werten 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 - OpenSearch Formatiert Variablen mit mehreren Werten im Lucene-Format für. OpenSearch ``` servers = ['test1', 'test2'] String to interpolate: '${servers:lucene}' Interpolation result: '("test1" OR "test2")' ``` #### Prozentualer Code Formatiert Variablen mit einem und mehreren Werten zur Verwendung in URL-Parametern. ``` servers = ['foo()bar BAZ', 'test2'] String to interpolate: '${servers:percentencode}' Interpolation result: 'foo%28%29bar%20BAZ%2Ctest2' ``` #### Pipe Formatiert Variablen mit mehreren Werten in eine durch Leerzeichen getrennte Zeichenfolge. ``` servers = ['test1.', 'test2'] String to interpolate: '${servers:pipe}' Interpolation result: 'test1.|test2' ``` #### Raw Deaktiviert datenquellenspezifische Formatierungen, z. B. einfache Anführungszeichen in einer SQL-Abfrage. ``` servers = ['test1.', '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 Variablen mit einem und mehreren Werten 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 Variablen mit einem und mehreren Werten 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 Variablen mit einem und mehreren Werten 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" ``` ### Formatieren von Variablen mit mehreren Werten Das Interpolieren 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 ermöglicht, 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 Sie das Feld leer lassen, verkettet (addiert) Grafana alle Werte in der Abfrage. Etwas wie. `value1,value2,value3` Wenn ein benutzerdefinierter `all` Wert verwendet wird, lautet der Wert stattdessen etwa `*` 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.** #### Mehrwertige Variablen 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 Amazon OpenSearch 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-Steuerwörter und Anführungszeichen enthält. #### Problembehandlung beim Formatieren Automatisches Escapen und Formatieren können zu Problemen führen. Es kann schwierig sein, die Logik hinter einem Problem 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 „Alle einbeziehen“ **mit mehreren Werten**.** + Verwenden Sie das [unformatierte Variablenformat] (\$1\$1< relref "advanced-variable-format-options.md \$1raw" >\$1\$1). ### Variablen mit Regex filtern Mithilfe der Regex-Abfrageoption können Sie die Liste der von der Variablenabfrage zurückgegebenen Optionen filtern oder die zurückgegebenen Optionen ändern. In diesem Abschnitt wird gezeigt, wie Sie Regex verwenden, um Werte in der Variablen-Dropdownliste zu filtern und 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 unter [Reguläre](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions) Ausdrücke. Beispiele für das Filtern anhand der folgenden Liste von Optionen: ``` backend_01 backend_02 backend_03 backend_04 ``` #### Filterung, sodass nur die Optionen zurückgegeben `02` werden, die mit `01` oder enden Regex: ``` /.*[01|02]/ ``` Ergebnis: ``` backend_01 backend_02 ``` #### Filtern und Ändern der Optionen mithilfe einer Regex-Capture-Gruppe, um einen Teil des Textes zurückzugeben Regex: ``` /.*(01|02)/ ``` Ergebnis: ``` 01 02 ``` #### Filtern und Ändern - 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 mithilfe von benannten Text- und Werterfassungsgruppen Mithilfe benannter Erfassungsgruppen können Sie separate Teile von „Text“ und „Wert“ aus den von der Variablenabfrage zurückgegebenen Optionen erfassen. Die Dropdownliste für Variablen kann 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 freundlicher als der Wert. `chip` Beginnen Sie mit dem folgenden variablen 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 ``` Übergeben Sie es durch den folgenden Regex. ``` /chip_name="(?[^"]+)|chip="(?[^"]+)/g ``` Die folgende Drop-down-Liste wird erstellt. ``` 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 ``` **Hinweis:** Nur Gruppennamen `text` und `value` Capture-Namen werden unterstützt. ### Wiederholte Panels oder Zeilen Sie können dynamische Dashboards mithilfe von *Vorlagenvariablen* erstellen. Alle Variablen in Ihren Abfragen werden auf den aktuellen Wert der Variablen erweitert, bevor die Abfrage an die Datenbank gesendet wird. Mit Variablen können Sie ein einziges Dashboard für all Ihre Dienste wiederverwenden. Vorlagenvariablen können sehr nützlich sein, um Ihre Abfragen in einem gesamten Dashboard dynamisch zu ändern. Wenn Sie möchten, dass Grafana dynamisch neue Panels oder Zeilen basierend auf den von Ihnen ausgewählten Werten erstellt, können Sie die *Wiederholungsfunktion* verwenden. #### Wiederholte Panels Wenn Sie eine Variable mit `Multi-value` aktivierten `Include all value` Optionen oder aktiviert haben, können Sie ein Panel auswählen und Grafana dieses Panel für jeden ausgewählten Wert wiederholen lassen. Sie finden die *Wiederholungsfunktion* auf der *Registerkarte Allgemein* im Panel-Bearbeitungsmodus. Sie `direction` steuert, wie die Bedienfelder angeordnet sind. Wenn Sie möchten`horizontal`, werden die Bedienfelder angeordnet side-by-side. Grafana passt die Breite jedes wiederholten Panels automatisch an, sodass die gesamte Zeile gefüllt ist. Derzeit ist es nicht möglich, andere Panels in einer Reihe mit einem sich wiederholenden Panel zu mischen. Stellen `Max per row` Sie ein, dass Grafana mitteilt, wie viele Panels pro Zeile Sie maximal haben möchten. *Die Standardeinstellung ist 4.* Wenn Sie wählen`vertical`, werden die Bereiche von oben nach unten in einer Spalte angeordnet. Die Breite der wiederholten Panels entspricht der des ersten Panels (der Originalvorlage), das wiederholt wird. Nehmen Sie nur Änderungen am ersten Bedienfeld (der Originalvorlage) vor. Damit die Änderungen in allen Bereichen wirksam werden, müssen Sie ein dynamisches Dashboard neu erstellen. Sie können dies tun, indem Sie entweder den Variablenwert (d. h. die Grundlage für die Wiederholung) ändern oder das Dashboard neu laden. **Anmerkung** Bei wiederholten Bedienfeldern müssen für Variablen ein oder mehrere Elemente ausgewählt sein. Sie können ein Panel nicht null Mal wiederholen, um es auszublenden. #### Zeilen wiederholen Wie oben bei den Panels gezeigt, können Sie Zeilen auch wiederholen, wenn Sie Variablen mit `Multi-value` oder eine `Include all value` Auswahloption gesetzt haben. Um diese Funktion zu aktivieren, müssen Sie zunächst über das Menü „*Bereich hinzufügen“ eine neue *Zeile* hinzufügen*. Halten Sie dann beim Zeilentitel inne und wählen Sie die Zahnradtaste, um das `Row Options` Konfigurationsfenster aufzurufen. Sie können dann die Variable auswählen, für die Sie die Zeile wiederholen möchten. Es hat sich bewährt, eine Variable auch im Zeilentitel zu verwenden.