

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.

# Dashboards in Grafana-Version 9
<a name="v9-dashboards"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Ein Dashboard besteht aus einem oder mehreren [Bedienfeldern](v9-panels.md), die in einer oder mehreren Zeilen organisiert und angeordnet sind. Grafana wird mit einer Vielzahl von Panels geliefert, die es einfach machen, die richtigen Abfragen zu erstellen und die Visualisierung so anzupassen, dass Sie das perfekte Dashboard für Ihre Bedürfnisse erstellen können. Jedes Panel kann mit Daten aus jeder Konfiguration [Verbinden zu Datenquellen](AMG-data-sources.md) interagieren.

Dashboard-Schnappschüsse sind statisch. Abfragen und Ausdrücke können nicht anhand von Snapshots erneut ausgeführt werden. Wenn Sie also Variablen in Ihrer Abfrage oder Ihrem Ausdruck aktualisieren, werden Ihre Dashboard-Daten dadurch nicht geändert.

**Topics**
+ [Verwenden von Dashboards](v9-dash-using-dashboards.md)
+ [Dashboards erstellen](v9-dash-building-dashboards.md)
+ [Verwaltung von Dashboards](v9-dash-managing-dashboards.md)
+ [Dashboards und Panels teilen](v9-dash-sharing.md)
+ [Playlisten verwalten](v9-dash-managing-playlists.md)
+ [Hinzufügen und Verwalten von Dashboard-Variablen](v9-dash-variables.md)
+ [Bewertung der Dashboard-Nutzung](v9-dash-assess-dashboard-usage.md)
+ [Durchsuchen von Dashboards in Grafana-Version 9](v9-search.md)

# Verwenden von Dashboards
<a name="v9-dash-using-dashboards"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Dieses Thema bietet einen Überblick über Dashboard-Funktionen und Tastenkombinationen und beschreibt, wie die Dashboard-Suche verwendet wird.

## Features
<a name="v9-dash-features"></a>

Mithilfe von Dashboards können Sie die Darstellung Ihrer Daten auf folgende Weise anpassen.


|  Feature  |  Description  | 
| --- | --- | 
| **1. Home** | Klicken Sie auf das Grafana-Home-Symbol, um zu der in der Grafana-Instanz konfigurierten Startseite weitergeleitet zu werden. | 
| **2. Titel** | Wenn Sie auf den Dashboard-Titel klicken, können Sie nach dem Dashboard suchen, das sich im aktuellen Ordner befindet. | 
| **3. Ein Dashboard teilen** | Verwenden Sie diese Option, um das aktuelle Dashboard per Link oder Snapshot zu teilen. Sie können die Dashboard-Definition auch aus dem Share-Modal exportieren. | 
| **4. Ein neues Panel hinzufügen** | Verwenden Sie diese Option, um dem aktuellen Dashboard einen Bereich, eine Dashboard-Zeile oder einen Bibliotheksbereich hinzuzufügen. | 
| **5. Einstellungen des Dashboards** | Verwenden Sie diese Option, um den Namen, den Ordner und die Tags des Dashboards zu ändern und Variablen und Annotationsabfragen zu verwalten. Weitere Informationen zu den Dashboard-Einstellungen finden Sie unter[Dashboard-Einstellungen ändern](v9-dash-modify-settings.md). | 
| **6. Drop-down-Menü für die Zeitauswahl** |  Klicken Sie hier, um Optionen für den relativen Zeitbereich auszuwählen und benutzerdefinierte absolute Zeitbereiche festzulegen. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/v9-dash-using-dashboards.html)  | 
| **7. Zeitbereich verkleinern**  | Klicken Sie hier, um den Zeitraum zu verkleinern. Weitere Informationen zur Verwendung der Steuerelemente für den Zeitbereich finden Sie unter[Zeitbereich für das Dashboard einstellen](#v9-dash-setting-dashboard-time-range).  | 
| **8. Das Dashboard wird aktualisiert** | Klicken Sie hier, um sofort Abfragen auszulösen und die Dashboard-Daten zu aktualisieren. | 
| **9. Das Dashboard-Zeitintervall wird aktualisiert** | Klicken Sie hier, um ein Zeitintervall für die auto Aktualisierung des Dashboards auszuwählen. | 
| **10. Modus anzeigen**  | Klicken Sie hier, um das Dashboard auf einem großen Bildschirm wie einem Fernseher oder einem Kiosk anzuzeigen. Im Anzeigemodus werden irrelevante Informationen wie Navigationsmenüs ausgeblendet.  | 
| **11. Armaturenbrett** |  Der Hauptbaustein eines Dashboards ist das Panel. Um einen neuen Bereich, eine neue Dashboard-Zeile oder einen neuen Bibliotheksbereich hinzuzufügen, klicken Sie auf **Bereich hinzufügen**. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/v9-dash-using-dashboards.html)  | 
| **12. Legende des Diagramms** | Ändern Sie die Serienfarben, die Y-Achse und die Sichtbarkeit der Serie direkt in der Legende. | 
| **13. Suche im Dashboard** | Klicken Sie auf **Suchen**, um anhand des Namens oder des Panel-Titels nach Dashboards zu suchen. | 
| **14. Dashboard-Zeile** | Eine Dashboard-Zeile ist eine logische Unterteilung innerhalb eines Dashboards, die Bereiche gruppiert. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/v9-dash-using-dashboards.html)  | 

## Tastenkombinationen
<a name="v9-dash-keyboard-shortcuts"></a>

In Grafana stehen eine Reihe von Tastenkombinationen zur Verfügung. **Um alle verfügbaren Tastenkombinationen anzuzeigen, drücken Sie?** oder **h** auf Ihrer Tastatur.
+ `Ctrl+S`speichert das aktuelle Dashboard. 
+ `f`öffnet den Dashboard-Finder/die Suche. 
+  `d+k`schaltet den Kioskmodus um (blendet das Menü aus). 
+ `d+e`erweitert alle Zeilen. 
+ `d+s`öffnet die Dashboard-Einstellungen. 
+ `Ctrl+K`öffnet die Befehlspalette.
+ `Esc`beendet das Bedienfeld in der Vollbildansicht oder im Bearbeitungsmodus. Bringt Sie auch von den Dashboard-Einstellungen zum Dashboard zurück.

**Fokussiertes Panel**

Um Tastenkombinationen zu verwenden, die auf ein bestimmtes Fenster abzielen, bewegen Sie den Mauszeiger über ein Fenster.
+ `e`schaltet die Bedienfeld-Bearbeitungsansicht um 
+ `v`schaltet die Vollbildansicht des Bedienfelds um 
+ `ps`öffnet die Funktion zum Teilen von Panels 
+ `pd`dupliziert das Panel 
+ `pr`entfernt das Panel 
+ `pl`schaltet die Legende des Bedienfelds um 

## Zeitbereich für das Dashboard einstellen
<a name="v9-dash-setting-dashboard-time-range"></a>

Grafana bietet verschiedene Möglichkeiten, die Zeitbereiche der visualisierten Daten für Dashboards, Panels und auch für Benachrichtigungen zu verwalten.

In diesem Abschnitt werden die unterstützten Zeiteinheiten und relativen Bereiche, die gängigen Zeitsteuerungen, die Zeiteinstellungen für das gesamte Dashboard und die panelspezifischen Zeiteinstellungen beschrieben.

**Zeiteinheiten und relative Bereiche**

Grafana unterstützt die folgenden Zeiteinheiten:`s (seconds)`,`m (minutes)`,`h (hours)`,`d (days)`,`w (weeks)`, `M (months)``Q (quarters)`, und`y (years)`. 

Mit dem Minus-Operator können Sie im Vergleich zur Gegenwart in die Vergangenheit reisen. Wenn Sie den gesamten Zeitraum der Einheit (Tag, Woche oder Monat) anzeigen möchten, fügen Sie den Wert `/<time unit>` an das Ende an. Um Geschäftsperioden, Nutzungs `fQ (fiscal quarter)` - und `fy (fiscal year)` Zeiteinheiten anzuzeigen.

Mit dem Plus-Operator können Sie im Vergleich zur aktuellen Zeit einen Schritt vorwärts machen. Sie können diese Funktion beispielsweise verwenden, um sich die prognostizierten Daten für die future anzusehen.

Die folgende Tabelle enthält Beispiele für relative Bereiche.


| Beispiel für einen relativen Bereich | Aus | Bis | 
| --- | --- | --- | 
| Letzte 5 Minuten |  `now-5m`  |  `now`  | 
| Der Tag bis jetzt |  `now/d`  |  `now`  | 
| Diese Woche |  `now/w`  |  `now/w`  | 
| Diese Woche bis jetzt |  `now/w`  |  `now`  | 
| In diesem Monat |  `now/M`  |  `now/M`  | 
| Bisher in diesem Monat |  `now/M`  |  `now`  | 
| Voriger Monat |  `now-1M/M`  |  `now-1M/M`  | 
| Bisher in diesem Jahr |  `now/Y`  |  `now`  | 
| Dieses Jahr |  `now/Y`  |  `now/Y`  | 
| Vorheriges Geschäftsjahr |  `now-1y/fy`  |  `now-1y/fy`  | 

**Anmerkung**  
 Grafana Alerting unterstützt `now+n` keine future Zeitstempel und keinen *Start von n bis `now-1n/n` zum Ende von n* Zeitstempeln. 

**Allgemeine Steuerungen für den Zeitbereich**

Die Zeitsteuerungen im Dashboard und im Bedienfeld haben eine gemeinsame Benutzeroberfläche. Im Folgenden werden allgemeine Steuerelemente für den Zeitbereich beschrieben.
+ Der aktuelle Zeitraum, auch *Zeitauswahl genannt, zeigt den Zeitraum* an, der aktuell in dem Dashboard oder Panel angezeigt wird, das Sie gerade betrachten. Bewegen Sie den Mauszeiger über das Feld, um die genauen Zeitstempel im Bereich und deren Quelle (z. B. den lokalen Browser) zu sehen. Klicken Sie auf den *aktuellen Zeitraum*, um ihn zu ändern. Sie können die aktuelle Uhrzeit anhand eines *relativen Zeitbereichs*, z. B. der letzten 15 Minuten, oder eines absoluten Zeitbereichs, z. B. `2020-05-14 00:00:00` bis, ändern`2020-05-15 23:59:59`.
+ Der **relative Zeitraum** kann aus der Liste **Relative Zeitbereiche** ausgewählt werden. Sie können die Liste mithilfe des Eingabefeldes oben filtern. Einige Beispiele für Zeiträume sind *Letzte 30 Minuten*, *Letzte 12 Stunden*, *Letzte 7 Tage*, *Letzte 2 Jahre*, *Gestern*, *Vorgestern*, Heute *letzte Woche*, *Heute bis jetzt*, *Diese Woche bis* jetzt und *Dieser Monat bisher*.
+ Der **absolute Zeitraum** kann auf zwei Arten festgelegt werden: Geben Sie exakte Zeitwerte oder relative Zeitwerte in die Felder **Von** und Bis ein und klicken Sie **auf** **Zeitbereich übernehmen**, oder klicken Sie auf ein Datum oder einen Datumsbereich aus dem Kalender, der angezeigt wird, wenn Sie auf das Feld **Von** oder **Bis** klicken. Um Ihre Auswahl zu übernehmen, klicken Sie auf **Zeitbereich übernehmen**.

*Weitere Funktionen für den Zeitbereich*

1. **Um die Ansicht zu verkleinern, klicken Sie auf **Cmd\$1Z oder Strg\$1Z**.** Klicken Sie auf das Symbol, um einen größeren Zeitraum im Dashboard oder in der Panel-Visualisierung anzuzeigen.

1. Um die Funktion zum Vergrößern zu verwenden, klicken und ziehen Sie, um den Zeitraum in der Visualisierung auszuwählen, den Sie anzeigen möchten.

**Anmerkung**  
Das Vergrößern ist nur für Grafikvisualisierungen verfügbar. 

*Dashboards aktualisieren*

Klicken Sie auf das Symbol „**Dashboard aktualisieren**“, um sofort jede Abfrage im Dashboard auszuführen und die Visualisierungen zu aktualisieren. Grafana storniert alle ausstehenden Anfragen, wenn Sie eine Aktualisierung auslösen.

Standardmäßig aktualisiert Grafana das Dashboard nicht automatisch. Abfragen werden gemäß den Panel-Einstellungen nach ihrem eigenen Zeitplan ausgeführt. Wenn Sie das Dashboard jedoch regelmäßig aktualisieren möchten, klicken Sie auf den Abwärtspfeil neben dem Symbol „**Dashboard aktualisieren**“ und wählen Sie dann ein Aktualisierungsintervall aus.

**Steuern Sie den Zeitraum mithilfe einer URL**

Sie können den Zeitraum eines Dashboards steuern, indem Sie die folgenden Abfrageparameter in der Dashboard-URL angeben.
+ `from`definiert die Untergrenze des Zeitbereichs, angegeben in ms, Epoche oder [relativer Zeit](#v9-dash-setting-dashboard-time-range).
+ `to`definiert die Obergrenze des Zeitbereichs, angegeben in ms Epoche oder relativer Zeit.
+ `time`und `time.window` definiert einen Zeitbereich von `time-time.window/2` bis`time+time.window/2`. Beide Parameter sollten in ms angegeben werden. Zum Beispiel `?time=1500000000000&time.window=10000` ergibt sich ein 10s-Zeitbereich von 1499999995000 bis 1500000005000.

# Dashboards erstellen
<a name="v9-dash-building-dashboards"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Nachdem Sie einen Grafana-Workspace erstellt und sich angemeldet haben, können Sie Dashboards erstellen und Einstellungen an Ihre Bedürfnisse anpassen. 

**Topics**
+ [Dashboards erstellen](v9-dash-creating.md)
+ [Panels hinzufügen oder bearbeiten](v9-dash-edit-panels.md)
+ [Dashboard-Einstellungen ändern](v9-dash-modify-settings.md)
+ [URL-Variablen für das Dashboard](v9-dash-dashboard-url-variables.md)
+ [Hinzufügen eines Bibliotheksfensters zu Ihrem Dashboard](v9-dash-manage-library-panels.md)
+ [Versionsverlauf des Dashboards verwalten](v9-dash-manage-version-history.md)
+ [Dashboard-Links verwalten](v9-dash-manage-dashboard-links.md)
+ [Dashboard-JSON-Modell](v9-dash-dashboard-json-model.md)

# Dashboards erstellen
<a name="v9-dash-creating"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

**Ein Dashboard erstellen**

Dashboards und Panels ermöglichen es Ihnen, Ihre Daten mit Grafana in visueller Form darzustellen. Jedes Panel benötigt mindestens eine Abfrage, um eine Visualisierung anzuzeigen. Bevor Sie beginnen, müssen Sie die folgenden Voraussetzungen erfüllen.
+ Stellen Sie sicher, dass Sie über die richtigen Berechtigungen verfügen. Weitere Informationen zu Berechtigungen finden Sie unter [Benutzer, Teams und Berechtigungen](Grafana-administration-authorization.md).
+ Identifizieren Sie das Dashboard, zu dem Sie das Panel hinzufügen möchten.
+ Verstehen Sie die Abfragesprache der Zieldatenquelle.
+ Stellen Sie sicher, dass die Datenquelle, für die Sie eine Abfrage schreiben, hinzugefügt wurde.

 Um ein Dashboard zu erstellen:

1. Melden Sie sich bei Grafana an, bewegen Sie den Mauszeiger über das **Dashboard** und klicken Sie auf **\$1 Neues** Dashboard.

1. Klicken Sie auf **Neues Panel hinzufügen**.

1. Klicken Sie in der ersten Zeile der Registerkarte „**Abfrage**“ auf die Dropdownliste und wählen Sie eine Datenquelle aus.

1. Schreiben oder erstellen Sie eine Abfrage in der Abfragesprache Ihrer Datenquelle.

1. Wählen Sie in der **Visualisierungsliste** einen Visualisierungstyp aus. Grafana zeigt eine Vorschau Ihrer Abfrageergebnisse mit angewendeter Visualisierung an. Weitere Informationen finden Sie unter [Visualisierungsoptionen](v9-panels-viz.md).

1. Passen Sie die Bedienfeldeinstellungen wie folgt an.
   + [Konfigurieren Sie Wertezuordnungen](v9-panels-configure-value-mappings.md)
   + [Visualisierungsspezifische Optionen](v9-panels-viz.md)
   + [Feldwerte überschreiben](v9-panels-configure-overrides.md)
   + [Schwellenwerte konfigurieren](v9-panels-configure-thresholds.md)
   + [Konfigurieren Sie Standardoptionen](v9-panels-configure-standard-options.md)
**Anmerkung**  
Bei den meisten Visualisierungen müssen einige Anpassungen vorgenommen werden, bevor die benötigten Informationen korrekt angezeigt werden.

1. Fügen Sie eine Notiz hinzu, um die Visualisierung zu beschreiben (oder Ihre Änderungen zu beschreiben), und klicken Sie dann in der oberen rechten Ecke der Seite auf **Speichern**.
**Anmerkung**  
Hinweise sind hilfreich, wenn Sie das Dashboard auf eine frühere Version zurücksetzen müssen.

**Konfiguration sich wiederholender Zeilen**

Sie können Grafana so konfigurieren, dass einem Dashboard basierend auf dem Wert einer Variablen dynamisch Panels oder Zeilen hinzugefügt werden. Variablen ändern Ihre Abfragen dynamisch in allen Zeilen in einem Dashboard. Weitere Informationen zu sich wiederholenden Bereichen finden [Sie unter Konfigurieren von sich wiederholenden Bereichen]().

Sie können Zeilen auch wiederholen, wenn Sie Variablen mit gesetzt `Multi-value` oder `Include all values` ausgewählt haben.

Bevor Sie beginnen, stellen Sie sicher, dass die Abfrage eine Variable mit mehreren Werten enthält. Anschließend sollten Sie die folgenden Schritte ausführen.

1. Klicken Sie auf der Dashboard-Startseite auf **Bereich hinzufügen**.

1. Klicken **Sie im Dialogfeld Bereich** **hinzufügen auf Neue Zeile** hinzufügen.

1. Zeigen Sie mit der Maus auf den Zeilentitel und klicken Sie auf das Zahnradsymbol.

1. Fügen Sie im Dialogfeld **Zeilenoptionen** einen Titel hinzu und wählen Sie die Variable aus, für die Sie sich wiederholende Zeilen hinzufügen möchten.
**Anmerkung**  
 Um den Dashboard-Benutzern Kontext bereitzustellen, fügen Sie die Variable dem Zeilentitel hinzu. 

**Um ein Panel zu verschieben**

1. Öffnen Sie das -Dashboard.

1. Klicken Sie auf den Titel des Bedienfelds und ziehen Sie das Bedienfeld an die neue Position. Sie können ein Panel an einer beliebigen Stelle auf einem Dashboard platzieren.

**Um die Größe eines Panels zu ändern**

1. Öffnen Sie das -Dashboard.

1. Um die Größe des Bedienfelds anzupassen, klicken Sie auf die untere rechte Ecke des Bedienfelds und ziehen Sie es. Sie können die Größe eines Dashboard-Panels an Ihre Bedürfnisse anpassen.

# Panels hinzufügen oder bearbeiten
<a name="v9-dash-edit-panels"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Nachdem Sie ein Dashboard erstellt haben, können Sie jederzeit Panels hinzufügen, bearbeiten oder entfernen.
+ **Dashboard anzeigen**: Um ein Dashboard anzuzeigen, wählen Sie im **Hauptmenü** **Dashboards** und dann das Dashboard aus, das Sie anzeigen möchten. Möglicherweise müssen Sie den Ordner erweitern, der das Dashboard enthält.
+ **Panel hinzufügen**: Um ein Panel zu einem Dashboard **hinzuzufügen, wählen Sie in der Menüleiste oben auf der Seite das Symbol Panel hinzufügen**.
+ **Bereich bearbeiten** Um ein vorhandenes Panel in einem Dashboard zu bearbeiten, wählen Sie das Menüsymbol, das angezeigt wird, wenn Sie den Mauszeiger über das Panel bewegen, und wählen Sie dann **Bearbeiten**.
+ **Bereich entfernen** **Um ein vorhandenes Bedienfeld in einem Dashboard zu entfernen, wählen Sie das Menüsymbol, das angezeigt wird, wenn Sie den Mauszeiger über das Panel bewegen, und wählen Sie dann Entfernen.**

# Dashboard-Einstellungen ändern
<a name="v9-dash-modify-settings"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Auf der Seite mit den Dashboard-Einstellungen können Sie:
+ Allgemeine Dashboard-Eigenschaften bearbeiten, einschließlich der Zeiteinstellungen.
+ Fügen Sie Annotationsabfragen hinzu.
+ Fügen Sie Dashboard-Variablen hinzu.
+ Fügen Sie Links hinzu.
+ Das JSON-Modell des Dashboards anzeigen

So greifen Sie auf die Seite mit den Dashboard-Einstellungen zu:

1. Öffnen Sie ein Dashboard im Bearbeitungsmodus.

1. Klicken Sie oben auf der Seite auf **Dashboard-Einstellungen** (Zahnradsymbol).

**Ändern der Zeiteinstellungen im Dashboard**

Passen Sie die Dashboard-Zeiteinstellungen an, wenn Sie die Dashboard-Zeitzone und die lokale Browserzeit ändern und Zeitintervalle für automatische Aktualisierungen angeben möchten.

**Um die Zeiteinstellungen des Dashboards zu ändern**

1. Wählen Sie auf der Seite mit den **Dashboard-Einstellungen** **die Option Allgemein** aus.

1. Navigieren Sie zum Abschnitt **Zeitoptionen**.

1. Geben Sie die Zeiteinstellungen gemäß den folgenden Beschreibungen an.

1. Timezone gibt die lokale Zeitzone des Dienstes oder Systems an, das Sie überwachen. Dies kann hilfreich sein, wenn Sie ein System oder einen Dienst überwachen, der in mehreren Zeitzonen betrieben wird.
   + Grafana verwendet die *standardmäßig* ausgewählte Zeitzone für das Benutzerprofil, das Team oder die Organisation. Wenn für das Benutzerprofil, ein Team, dem der Benutzer angehört, oder die Organisation keine Zeitzone angegeben ist, verwendet Grafana die lokale Browserzeit.
   + Die für den betrachtenden Benutzerbrowser konfigurierte Zeitzone, die *lokale Browserzeit*, wird verwendet. Dies ist normalerweise dieselbe Zeitzone, die auf dem Computer eingestellt ist.
   + Verwenden Sie die [Standard-Zeitzonen nach ISO 8601](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), einschließlich UTC.
+ **Automatische Aktualisierung** passt die angezeigten Optionen für die relative Zeit und die Optionen für die automatische Aktualisierung an. Die Einträge sind durch Kommas getrennt und akzeptieren jede gültige Zeiteinheit.
+ **Jetzt überschreibt die Verzögerung** die Zeit, indem eine `now` Zeitverzögerung eingegeben wird. Verwenden Sie diese Option, um bekannten Verzögerungen bei der Datenaggregation Rechnung zu tragen und Nullwerte zu vermeiden.
+ **Hide Time Picker** entfernt die Grafana-Zeitauswahl-Anzeige.

**Anmerkung**  
Um die Zeit kontrollieren zu können, müssen Ihre Daten eine Zeitspalte enthalten. Weitere Informationen zum Hinzufügen einer Zeitspalte finden Sie in der Dokumentation zu Ihrer spezifischen [Datenquelle](AMG-data-sources.md).

**Hinzufügen einer Annotationsabfrage**

Eine Annotationsabfrage ist eine Abfrage, die nach Ereignissen fragt. Diese Ereignisse können in Diagrammen im Dashboard als vertikale Linien zusammen mit einem kleinen Symbol dargestellt werden, über das Sie den Mauszeiger bewegen können, um die Ereignisinformationen zu sehen.

**Um eine Annotationsabfrage hinzuzufügen**

1. Wählen Sie auf der Seite mit den **Dashboard-Einstellungen** die Option **Anmerkungen** aus.

1. Wählen Sie **Annotationsabfrage hinzufügen** aus. 

1. Geben Sie einen Namen ein und wählen Sie eine Datenquelle aus.

1. Füllen Sie den Rest des Formulars aus, um eine Abfrage und eine Anmerkung zu erstellen.

Die Benutzeroberfläche des Abfrage-Editors ändert sich je nach der ausgewählten Datenquelle. Einzelheiten zum Erstellen einer Abfrage finden Sie in der [Datenquellendokumentation](AMG-data-sources.md).

**Eine Variable hinzufügen**

Variablen ermöglichen es Ihnen, interaktivere und dynamischere Dashboards zu erstellen. Anstatt Dinge wie Server-, Anwendungs- und Sensornamen in Ihren metrischen Abfragen fest zu codieren, können Sie stattdessen Variablen verwenden. Variablen werden als Dropdownlisten oben im Dashboard angezeigt. Diese Dropdowns machen es einfach, die in Ihrem Dashboard angezeigten Daten zu ändern.

Weitere Informationen zu Variablen finden Sie unter [Variablen](v9-dash-variables.md).

1. Klicken Sie auf der Seite mit den **Dashboard-Einstellungen** im linken Abschnittsmenü auf **Variable** und dann auf die Schaltfläche **Variable hinzufügen**.

1. Geben Sie im Abschnitt **Allgemein** den Namen der Variablen ein. Dies ist der Name, den Sie später in Abfragen verwenden werden.

1. Wählen Sie einen **Variablentyp** aus.
**Anmerkung**  
Der Variablentyp, den Sie auswählen, wirkt sich darauf aus, welche Felder Sie auf der Seite ausfüllen.

1. Definieren Sie die Variable und klicken Sie auf **Aktualisieren**.

**Einen Link hinzufügen**

Mit Dashboard-Links können Sie Links zu anderen Dashboards und Websites direkt unter der Dashboard-Kopfzeile platzieren. Links ermöglichen eine einfache Navigation zu anderen, verwandten Dashboards und Inhalten. 

1.  Klicken Sie auf der Seite mit den **Dashboard-Einstellungen** im linken Abschnittsmenü auf **Links** und dann auf die Schaltfläche **Link hinzufügen**. 

1.  Geben Sie Titel und und in das Feld **Typ** ein und wählen Sie **Dashboard** oder **Link** aus. 

1.  Um einen Dashboard-Link hinzuzufügen, fügen Sie ein optionales Tag hinzu, wählen Sie eine der Optionen für den Dashboard-Link aus und klicken Sie auf **Anwenden**. 
**Anmerkung**  
Tags sind nützlich, um ein dynamisches Drop-down-Menü mit Dashboards zu erstellen, die alle über ein bestimmtes Tag verfügen. 

1.  Um einen Link hinzuzufügen, fügen Sie eine URL und einen Tooltip-Text hinzu, der angezeigt wird, wenn der Benutzer den Mauszeiger über den Link bewegt, wählen Sie ein Symbol aus, das neben dem Link angezeigt wird, und wählen Sie eine der Linkoptionen im Dashboard aus. 

**JSON-Modell des Dashboards anzeigen** 

Ein Dashboard in Grafana wird durch ein JSON-Objekt dargestellt, das Metadaten seines Dashboards speichert. Zu den Dashboard-Metadaten gehören Dashboard-Eigenschaften, Metadaten aus Panels, Vorlagenvariablen, Panel-Abfragen usw. 

Um ein Dashboard-JSON-Modell anzuzeigen, klicken Sie auf der Seite mit den **Dashboard-Einstellungen** auf **JSON**.

Weitere Informationen zu den JSON-Feldern finden Sie unter [JSON-Felder](v9-dash-dashboard-json-model.md).

# URL-Variablen für das Dashboard
<a name="v9-dash-dashboard-url-variables"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Grafana kann Variablenwerte anwenden, die als Abfrageparameter im Dashboard URLs übergeben wurden. Weitere Informationen finden Sie unter [Dashboard-Links verwalten](v9-dash-manage-dashboard-links.md) und [Vorlagen und Variablen](v9-dash-variables.md).

**Variablen als Abfrageparameter übergeben**

Grafana interpretiert Abfragezeichenfolgenparameter mit dem Präfix `var-` als Variablen im angegebenen Dashboard.

Zum Beispiel in dieser URL: 

```
https://${your-domain}/path/to/your/dashboard?var-example=value
```

Der Abfrageparameter `var-example=value` steht für das Beispiel einer Dashboard-Variablen mit dem Wert`value`.

**Übergabe mehrerer Werte für eine Variable**

Um mehrere Werte zu übergeben, wiederholen Sie den Variablenparameter einmal für jeden Wert.

```
https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2
```

Grafana interpretiert `var-example=value1&var-example=value2` als Beispiel für eine Dashboard-Variable mit zwei Werten: `value1` und. `value2`

**Hinzufügen von Variablen zu Dashboard-Links**

Grafana kann Variablen zu Dashboard-Links hinzufügen, wenn Sie sie aus den Einstellungen eines Dashboards generieren. Weitere Informationen und Schritte zum Hinzufügen von Variablen finden Sie unter [Dashboard-Links verwalten](v9-dash-manage-dashboard-links.md).

**Übergabe von Ad-hoc-Filtern**

Ad-hoc-Filter wenden Schlüssel- oder Wertfilter auf alle Metrikabfragen an, die eine angegebene Datenquelle verwenden. Weitere Informationen finden Sie unter [Ad-hoc-Filter]().

Um einen Ad-hoc-Filter als Abfrageparameter zu übergeben, verwenden Sie die Variablensyntax, um die Ad-hoc-Filtervariable zu übergeben, und geben Sie auch den Schlüssel, den Operator als Wert und den Wert als durch Leerzeichen getrennte Liste an.

Zum Beispiel in dieser URL:

`https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value` 

Der Abfrageparameter `var-adhoc=key|=|value` wendet den als Adhoc-Dashboard-Variable konfigurierten Ad-hoc-Filter unter Verwendung des `example_key` Schlüssels, des `=` Operators und des `example_value` Werts an.

**Anmerkung**  
Denken Sie beim Teilen URLs mit Ad-hoc-Filtern daran, die URL zu codieren. Ersetzen Sie im obigen Beispiel die Pipes `(|)` durch `%7C` und den Gleichheitsoperator `(=)` durch` %3D`.

**Steuern des Zeitbereichs mithilfe der URL**

Um den Zeitraum eines Dashboards festzulegen, verwenden Sie die `time.window` Abfrageparameter `from` `to``time`,, und. Da es sich nicht um Variablen handelt, ist für sie kein `var-` Präfix erforderlich.

# Hinzufügen eines Bibliotheksfensters zu Ihrem Dashboard
<a name="v9-dash-manage-library-panels"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Ein Bibliotheksfenster ist ein wiederverwendbares Bedienfeld, das Sie in jedem Dashboard verwenden können. Wenn Sie ein Bibliotheksfenster ändern, wird die Änderung auf alle Instanzen übertragen, in denen das Bedienfeld verwendet wird. Mithilfe von Bibliotheksfenstern wird die Wiederverwendung von Bedienfeldern in mehreren Dashboards optimiert.

Sie können ein Bibliotheksfenster zusammen mit gespeicherten Dashboards in einem Ordner speichern.

**Ein Bibliotheksfenster erstellen**

Wenn Sie ein Bibliotheksfenster erstellen, wird das Bedienfeld auf dem Quell-Dashboard ebenfalls in ein Bibliotheksfenster umgewandelt. Sie müssen das ursprüngliche Dashboard speichern, nachdem ein Panel konvertiert wurde.

1. Öffnen Sie ein Panel im Bearbeitungsmodus.

1. Klicken Sie in den Anzeigeoptionen des Bedienfelds auf die Option mit dem Abwärtspfeil, um die Änderungen an der Visualisierung vorzunehmen.

1. Um das Dialogfeld „**Erstellen**“ zu öffnen, klicken Sie auf die Option „**Bibliotheksfenster**“ und dann auf das **Bedienfeld „Bibliothek erstellen“**.

1. Geben Sie im **Feld Name des Bibliotheksfensters** den Namen ein.

1. Wählen **Sie unter Im Ordner speichern** den Ordner aus, in dem das Bedienfeld „Bibliothek“ gespeichert werden soll.

1. Um Ihre Änderungen zu speichern, klicken Sie auf **Bedienfeld „Bibliothek erstellen“**.

1. Um das Dashboard zu speichern, klicken Sie auf **Speichern**.

Nachdem ein Bibliotheksfenster erstellt wurde, können Sie das Bedienfeld mithilfe eines beliebigen Dashboards ändern, auf dem es angezeigt wird. Nachdem Sie die Änderungen gespeichert haben, spiegeln sich diese Änderungen in allen Instanzen des Bibliotheksfensters wider.

**Hinzufügen eines Bibliotheksfensters zu einem Dashboard**

Fügen Sie einem Dashboard ein Grafana-Bibliotheksfenster hinzu, wenn Sie anderen Dashboard-Benutzern Visualisierungen zur Verfügung stellen möchten.

1. Bewegen Sie den Mauszeiger über die Option **Dashboards** im linken Menü und wählen Sie dann **Neues Dashboard** aus den Drop-down-Optionen aus. Das Dialogfeld „**Bereich hinzufügen**“ wird geöffnet.

1. Klicken Sie auf die Option **Ein Panel aus der Panel-Bibliothek hinzufügen**. Sie sehen eine Liste Ihrer Bibliotheks-Panels.

1. Filtern Sie die Liste oder suchen Sie nach dem Panel, das Sie hinzufügen möchten.

1. Klicken Sie auf ein Panel, um es dem Dashboard hinzuzufügen.

**Die Verknüpfung eines Bibliotheksfensters aufheben**

Trennen Sie die Verknüpfung eines Bibliotheksfensters, wenn Sie eine Änderung am Bedienfeld vornehmen möchten, ohne dass sich dies auf andere Instanzen des Bibliotheksfensters auswirkt.

1. Bewegen Sie den Mauszeiger im linken Menü über das **Dashboard** und klicken Sie dann auf **Bibliotheksfenster**.

1. Wählen Sie ein Bibliotheksfenster aus, das in verschiedenen Dashboards verwendet wird.

1. Wählen Sie das Panel aus, dessen Verknüpfung Sie aufheben möchten.

1. Klicken Sie auf den Titel des Fensters und dann auf **Bearbeiten**. Das Panel wird im Bearbeitungsmodus geöffnet.

1. Klicken Sie oben rechts auf der Seite auf die Option **Verknüpfung aufheben**.

**Eine Liste von Bibliotheksfenstern anzeigen**

Trennen Sie die Verknüpfung eines Bibliotheksfensters, wenn Sie eine Änderung am Bedienfeld vornehmen möchten, ohne dass sich dies auf andere Instanzen des Bibliotheksfensters auswirkt.

1. Bewegen Sie den Mauszeiger im linken Menü über die Option **Dashboard** und klicken Sie dann auf **Bibliotheks-Panels**. Sie können eine Liste der zuvor definierten Bibliotheksfenster sehen.

1. Suchen Sie nach einem bestimmten Bibliotheksfenster, wenn Sie dessen Namen kennen. Sie können die Bedienfelder auch nach Ordner oder Typ filtern.

**Löschen eines Bibliotheksfensters**

Löschen Sie ein Bibliotheksfenster, wenn Sie es nicht mehr benötigen.

1. Bewegen Sie den Mauszeiger im linken Menü über das **Dashboard** und wählen Sie **Bibliotheksfenster aus.**

1. Wählen Sie das Panel aus, das Sie löschen möchten.

1. Klicken Sie auf das Löschsymbol neben dem Namen der Bibliothek.

# Versionsverlauf des Dashboards verwalten
<a name="v9-dash-manage-version-history"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Immer wenn Sie eine Version Ihres Dashboards speichern, wird eine Kopie dieser Version gespeichert, sodass frühere Versionen Ihres Dashboards niemals verloren gehen. Eine Liste dieser Versionen ist verfügbar, indem Sie die Dashboard-Einstellungen aufrufen und dann im Menü auf der linken Seite **Versionen** auswählen.

Mit der Funktion zum Versionsverlauf im Dashboard können Sie zuvor gespeicherte Dashboard-Versionen vergleichen und wiederherstellen.

**Vergleich von zwei Dashboard-Versionen**

Um zwei Dashboard-Versionen zu vergleichen, wählen Sie die beiden Versionen aus der Liste aus, die Sie vergleichen möchten. Klicken Sie auf **Versionen vergleichen**, um den Unterschied zwischen den beiden Versionen zu sehen.

Wenn Sie auf die Schaltfläche klicken, werden Sie zur Vergleichsansicht weitergeleitet. Standardmäßig wird eine Zusammenfassung der Änderungen in Textform angezeigt.

Wenn Sie den Unterschied der unformatierten JSON-Datei, die Ihr Dashboard darstellt, anzeigen möchten, können Sie dies auch tun, indem Sie unten auf die Schaltfläche **JSON-Diff anzeigen** klicken.

Wenn Sie die Version wiederherstellen möchten, mit der Sie den Vergleich durchführen, können Sie dies tun, indem Sie <x>oben rechts auf die Schaltfläche „In **Version wiederherstellen**“ klicken.

**Eine zuvor gespeicherte Dashboard-Version wiederherstellen**

Wenn Sie eine zuvor gespeicherte Dashboard-Version wiederherstellen möchten, können Sie entweder auf die Schaltfläche **Wiederherstellen** rechts neben einer Zeile in der Liste der Dashboard-Versionen klicken oder auf die <x>Schaltfläche In Version **wiederherstellen** klicken, die in der Vergleichsansicht angezeigt wird. Wenn Sie auf die Schaltfläche klicken, wird das folgende Popup-Fenster geöffnet, in dem Sie aufgefordert werden, die Wiederherstellung zu bestätigen.

Nach der Wiederherstellung auf eine frühere Version wird eine neue Version erstellt, die genau dieselben Daten wie die vorherige Version enthält, nur mit einer anderen Versionsnummer. Dies wird in der **Spalte „Hinweise“** für die Zeile in der neuen Dashboard-Version angezeigt. Dies geschieht lediglich, um sicherzustellen, dass Ihre vorherigen Dashboard-Versionen von der Änderung nicht betroffen sind.

# Dashboard-Links verwalten
<a name="v9-dash-manage-dashboard-links"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Sie können Links verwenden, um zwischen häufig verwendeten Dashboards zu navigieren oder andere mit Ihren Visualisierungen zu verbinden. Mithilfe von Links können Sie Verknüpfungen zu anderen Dashboards, Panels und sogar externen Websites erstellen.

Grafana unterstützt Dashboard-Links, Panel-Links und Datenlinks. Dashboard-Links werden oben im Dashboard angezeigt. Panel-Links sind zugänglich, indem Sie auf ein Symbol in der oberen linken Ecke des Panels klicken.

**Wählen Sie aus, welchen Link Sie verwenden möchten**

Finden Sie zunächst heraus, wie Sie derzeit zwischen den Dashboards navigieren. Wenn Sie häufig zwischen mehreren Dashboards hin- und herspringen und Schwierigkeiten haben, in jedem den gleichen Kontext zu finden, können Links Ihnen helfen, Ihren Arbeitsablauf zu optimieren.

Im nächsten Schritt müssen Sie herausfinden, welcher Linktyp für Ihren Workflow geeignet ist. Obwohl alle Linktypen in Grafana verwendet werden, um Verknüpfungen zu anderen Dashboards oder externen Websites zu erstellen, funktionieren sie in unterschiedlichen Kontexten.
+ Wenn sich der Link auf die meisten, wenn nicht alle Bereiche im Dashboard bezieht, verwenden Sie Dashboard-Links.
+ Wenn Sie sich bestimmte Bereiche genauer ansehen möchten, verwenden Sie Panel-Links.
+ Wenn Sie auf eine externe Site verlinken möchten, können Sie entweder einen Dashboard-Link oder einen Panel-Link verwenden.
+ Wenn Sie eine bestimmte Serie oder sogar eine einzelne Messung genauer untersuchen möchten, verwenden Sie Datenlinks.

**Steuern des Zeitbereichs mithilfe der URL**

Um den Zeitraum eines Panels oder Dashboards zu steuern, können Sie Abfrageparameter in der Dashboard-URL angeben:
+ `from`definiert die untere Grenze des Zeitbereichs, angegeben in ms epoch.
+ `to`definiert die Obergrenze des Zeitbereichs, angegeben in ms epoch.
+ `time`und `time.window` definiert einen Zeitbereich von `time-time.window/2` bis`time+time.window/2`. Beide Parameter sollten in ms angegeben werden. Dies `?time=1500000000000&time.window=10000` ergibt zum Beispiel einen Zeitbereich von 10 Sekunden zwischen 1499999995000 und 1500000005000.

**Links zum Dashboard**

Wenn Sie einen Dashboard-Link erstellen, können Sie den Zeitraum und die aktuellen Vorlagenvariablen angeben, um direkt zum gleichen Kontext in einem anderen Dashboard zu springen. Auf diese Weise müssen Sie sich keine Gedanken darüber machen, ob die Person, an die Sie den Link senden, sich die richtigen Daten ansieht. Weitere Linktypen finden Sie unter [Datenverknüpfungsvariablen]().

Dashboard-Links können auch als Verknüpfungen zu externen Systemen verwendet werden, z. B. um [ein GitHub Problem mit dem aktuellen Dashboard-Namen](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests) einzureichen.

Nachdem Sie einen Dashboard-Link hinzugefügt haben, wird dieser in der oberen rechten Ecke Ihres Dashboards angezeigt.

**Hinzufügen von Links zu Dashboards**

Fügen Sie oben in Ihrem aktuellen Dashboard Links zu anderen Dashboards hinzu.

1. Klicken Sie beim Anzeigen des Dashboards, das Sie verknüpfen möchten, auf das Zahnrad oben auf dem Bildschirm, um die **Dashboard-Einstellungen** zu öffnen.

1. Klicken Sie auf **Links** und dann auf **Dashboard-Link hinzufügen** oder **Neu**.

1. Wählen Sie unter **Typ** die Option **Dashboards** aus.

1. Wählen Sie aus den folgenden Linkoptionen aus.
   + **Mit Tags**: Geben Sie Tags ein, um die verknüpften Dashboards auf diejenigen zu beschränken, die die von Ihnen eingegebenen Tags enthalten. Ansonsten enthält Grafana Links zu allen anderen Dashboards.
   + **Als Dropdown**: Wenn Sie auf viele Dashboards verlinken, möchten Sie wahrscheinlich diese Option auswählen und dem Dropdown einen optionalen Titel hinzufügen. Andernfalls zeigt Grafana die Dashboard-Links nebeneinander oben in Ihrem Dashboard an.
   + **Zeitraum**: Wählen Sie diese Option, um den Dashboard-Zeitraum in den Link aufzunehmen. Wenn der Benutzer auf den Link klickt, wird das verknüpfte Dashboard geöffnet, wobei der angegebene Zeitraum bereits festgelegt ist.
   + **Variablenwerte**: Wählen Sie diese Option, um Vorlagenvariablen, die derzeit als Abfrageparameter verwendet werden, in den Link aufzunehmen. Wenn der Benutzer auf den Link klickt, werden alle passenden Vorlagen im verknüpften Dashboard auf die Werte aus dem Link gesetzt. Weitere Informationen finden Sie unter [URL-Variablen für das Dashboard](v9-dash-dashboard-url-variables.md).
   + **In neuem Tab öffnen**: Wählen Sie diese Option, wenn der Dashboard-Link in einem neuen Tab oder Fenster geöffnet werden soll.

1. Klicken Sie auf **Add (Hinzufügen)**.

**Einen URL-Link zu einem Dashboard hinzufügen**

Fügen Sie oben in Ihrem aktuellen Dashboard einen Link zu einer URL hinzu. Sie können auf jede verfügbare URL verlinken, einschließlich Dashboards, Panels oder externen Websites. Sie können sogar den Zeitbereich steuern, um sicherzustellen, dass der Benutzer auf die richtigen Daten in Grafana herangezoomt wird.

1. Klicken Sie beim Anzeigen des Dashboards, das Sie verknüpfen möchten, auf das Zahnrad oben auf dem Bildschirm, um die **Dashboard-Einstellungen** zu öffnen.

1. Klicken Sie auf **Links** und dann auf **Dashboard-Link hinzufügen** oder **Neu**.

1. Wählen Sie unter Typ die Option **Link** aus.

1. Wählen Sie aus den folgenden Linkoptionen aus.
   + **URL**: Geben Sie die URL ein, zu der Sie verlinken möchten. Je nach Ziel möchten Sie möglicherweise Feldwerte einbeziehen. Weitere Informationen finden Sie in diesem [Github-Beispiel](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests).
   + **Titel**: Geben Sie den Titel ein, den der Link anzeigen soll.
   + **Tooltip**: Geben Sie den Tooltip ein, der für den Link angezeigt werden soll.
   + **Symbol**: Wählen Sie das Symbol aus, das zusammen mit dem Link angezeigt werden soll.
   + **Zeitraum**: Wählen Sie diese Option, um den Dashboard-Zeitraum in den Link aufzunehmen. Wenn der Benutzer auf den Link klickt, wird das verknüpfte Dashboard mit dem angegebenen Zeitraum geöffnet.
     + `from`definiert die untere Grenze des Zeitbereichs, angegeben in ms Epoch.
     + `to`definiert die Obergrenze des Zeitbereichs, angegeben in ms epoch.
     + `time`und `time.window` definiert einen Zeitbereich von `time-time.window/2` bis`time+time.window/2`. Beide Parameter sollten in ms angegeben werden. Dies `?time=1500000000000&time.window=10000` ergibt zum Beispiel einen Zeitbereich von 10 Sekunden zwischen 1499999995000 und 1500000005000.
   + **Variablenwerte**: Wählen Sie diese Option, um Vorlagenvariablen, die derzeit als Abfrageparameter verwendet werden, in den Link aufzunehmen. Wenn der Benutzer auf den Link klickt, werden alle passenden Vorlagen im verknüpften Dashboard auf die Werte aus dem Link gesetzt. 

     Das Variablenformat lautet wie folgt: 

     `https://${you-domain}/path/to/your/dashboard?var-${template-varable1}=value1&var-{template-variable2}=value2`
   + **In einer neuen Registerkarte öffnen**: Wählen Sie diese Option, wenn der Dashboard-Link in einem neuen Tab oder Fenster geöffnet werden soll

1. Klicken Sie auf **Add (Hinzufügen)**.

**Einen Dashboard-Link aktualisieren**

Gehen Sie wie folgt vor, um einen vorhandenen Dashboard-Link zu ändern oder zu aktualisieren.

1. Klicken Sie in den **Dashboard-Einstellungen** auf der Registerkarte **Links** auf den vorhandenen Link, den Sie bearbeiten möchten.

1. Ändern Sie die Einstellungen und klicken Sie dann auf **Aktualisieren**.

**Einen Dashboard-Link duplizieren**

Um einen vorhandenen Dashboard-Link zu duplizieren, klicken Sie auf das Duplikatsymbol neben dem vorhandenen Link, den Sie duplizieren möchten.

**Löschen eines Dashboard-Links**

Um einen vorhandenen Dashboard-Link zu löschen, klicken Sie auf das Papierkorbsymbol neben dem doppelten Symbol, das Sie löschen möchten.

**Links zu Bedienfeldern**

Jedes Panel kann seinen eigenen Linksatz haben, der in der oberen linken Ecke des Panels angezeigt wird. Sie können auf jede verfügbare URL verlinken, einschließlich Dashboards, Panels oder externen Websites. Sie können sogar den Zeitbereich steuern, um sicherzustellen, dass der Benutzer auf die richtigen Daten in Grafana herangezoomt wird.

Um die verfügbaren Panel-Links zu sehen, klicken Sie auf das Symbol in der oberen linken Ecke eines Panels.
+ **Hinzufügen eines Panel-Links**: Jedes Panel kann seinen eigenen Linksatz haben, der in der oberen linken Ecke des Panels angezeigt wird. Sie können auf jede verfügbare URL verlinken, einschließlich Dashboards, Panels oder externen Websites. Sie können sogar den Zeitbereich steuern, um sicherzustellen, dass der Benutzer auf die richtigen Daten in Grafana herangezoomt wird. Klicken Sie auf das Symbol in der oberen linken Ecke eines Panels, um die verfügbaren Panel-Links anzuzeigen.

  1. Bewegen Sie den Mauszeiger über das Fenster, zu dem Sie einen Link hinzufügen möchten, und drücken Sie `e` dann. **Oder klicken Sie auf den Dropdown-Pfeil neben dem Titel des Bedienfelds und dann auf Bearbeiten.**

  1. Scrollen Sie auf der Registerkarte **Panel** nach unten zum Abschnitt **Links**. 

  1. Erweitern Sie **Links** und klicken Sie dann auf **Link hinzufügen**.

  1. Geben Sie einen **Titel** ein. **Der Titel** ist eine für Menschen lesbare Bezeichnung für den Link, der auf der Benutzeroberfläche angezeigt wird.

  1. Geben Sie die **URL** ein, auf die Sie verlinken möchten. Sie können sogar eine der im Dashboard definierten Vorlagenvariablen hinzufügen. Drücken Sie `Ctrl+Space` oder `Cmd+Space` und klicken Sie in das URL-Feld, um die verfügbaren Variablen zu sehen. Durch das Hinzufügen von Vorlagenvariablen zu Ihrem Panel-Link leitet der Link den Benutzer zum richtigen Kontext weiter, in dem die entsprechenden Variablen bereits festgelegt sind.

     Sie können auch Zeitvariablen verwenden.
     + `from`definiert die Untergrenze des Zeitbereichs, angegeben in ms Epoch.
     + `to`definiert die Obergrenze des Zeitbereichs, angegeben in ms epoch.
     + `time`und `time.window` definiert einen Zeitbereich von `time-time.window/2` bis`time+time.window/2`. Beide Parameter sollten in ms angegeben werden. Zum Beispiel `?time=1500000000000&time.window=10000` ergibt sich ein 10s-Zeitbereich von 1499999995000 bis 1500000005000.
+ **Aktualisierung eines Panel-Links**

  1. Suchen Sie auf der Registerkarte **Bedienfeld** nach dem Link, an dem Sie Änderungen vornehmen möchten.

  1. Klicken Sie auf das Symbol **Bearbeiten** (Stift), um das Fenster Link bearbeiten zu öffnen.

  1. Nehmen Sie nach Bedarf Änderungen vor.

  1. Klicken Sie auf **Speichern**, um die Änderungen zu speichern und das Fenster zu schließen.

  1. Klicken Sie oben rechts auf **Speichern**, um Ihre Änderungen im Dashboard zu speichern.
+ **Löschen eines Panel-Links**

  1. Suchen Sie auf der Registerkarte **Bedienfeld** nach dem Link, an dem Sie Änderungen vornehmen möchten.

  1. Klicken Sie auf das **X-Symbol** neben dem Link, den Sie löschen möchten.

  1. Klicken Sie oben rechts auf **Speichern**, um Ihre Änderungen im Dashboard zu speichern.

# Dashboard-JSON-Modell
<a name="v9-dash-dashboard-json-model"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Ein Dashboard in Grafana wird durch ein JSON-Objekt dargestellt, das Metadaten seines Dashboards speichert. Zu den Dashboard-Metadaten gehören Dashboard-Eigenschaften, Metadaten aus Panels, Vorlagenvariablen und Panel-Abfragen.

Um das JSON eines Dashboards anzuzeigen.

1. Navigieren Sie zu einem Dashboard.

1. Klicken Sie im oberen Navigationsmenü auf das Symbol **Dashboard-Einstellungen** (Zahnrad).

1. Klicken Sie auf **JSON-Modell**.

**JSON-Felder**

Wenn ein Benutzer ein neues Dashboard erstellt, wird ein neues Dashboard-JSON-Objekt mit den folgenden Feldern initialisiert.

**Anmerkung**  
In der folgenden JSON-Datei wird id als Null angezeigt. Dies ist der Standardwert, der ihr zugewiesen wird, bis ein Dashboard gespeichert wird. Nach dem Speichern eines Dashboards wird dem `id` Feld ein ganzzahliger Wert zugewiesen.

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "style": "dark",
  "timezone": "browser",
  "editable": true,
  "graphTooltip": 1,
  "panels": [],
  "time": {
    "from": "now-6h",
    "to": "now"
  },
  "timepicker": {
    "time_options": [],
    "refresh_intervals": []
  },
  "templating": {
    "list": []
  },
  "annotations": {
    "list": []
  },
  "refresh": "5s",
  "schemaVersion": 17,
  "version": 0,
  "links": []
}
```

Im Folgenden wird jedes Feld im Dashboard-JSON beschrieben.


| Name | Usage | 
| --- | --- | 
| **id** | eindeutiger numerischer Bezeichner für das Dashboard (generiert von der Datenbank) | 
| **uid** | eindeutige Dashboard-ID, die von jedem generiert werden kann. string (8-40) | 
| **Titel** | aktueller Titel des Dashboards | 
| **Tags** | mit dem Dashboard verknüpfte Tags, eine Reihe von Zeichenketten | 
| **Stil** | Thema des Armaturenbretts, z. B. *dunkel* oder *hell* | 
| **Zeitzone** | *Zeitzone des Dashboards, z. B. *UTC* oder Browser* | 
| **editierbar** | ob ein Dashboard editierbar ist oder nicht | 
| **Tooltip für ein Diagramm** | 0 für kein gemeinsames Fadenkreuz oder Tooltip (Standard), 1 für gemeinsames Fadenkreuz, 2 für gemeinsames Fadenkreuz und gemeinsamen Tooltip | 
| **variieren** | *Zeitbereich für das Dashboard, z. B. *letzte 6 Stunden oder letzte 7 Tage** | 
| **Timepicker** | [Timepicker-Metadaten, Einzelheiten finden Sie im Abschnitt Timepicker](#v9-dash-dashboard-json-model) | 
| **Templating** | Metadaten als Vorlage erstellen, weitere Informationen finden Sie im Abschnitt [Templating](#v9-dash-dashboard-json-model) | 
| **Anmerkungen** | Metadaten zu Anmerkungen, wie Sie sie [hinzufügen können, finden Sie unter Anmerkungen](v9-panels-annotate-visualizations.md) | 
| **aktualisieren** | Intervall für automatische Aktualisierung | 
| **schemaVersion** | Version des JSON-Schemas (Integer), die jedes Mal erhöht wird, wenn ein Grafana-Update Änderungen an diesem Schema vornimmt | 
| **Version** | Version des Dashboards (Integer), die bei jeder Aktualisierung des Dashboards inkrementiert wird | 
| **Paneele** | Anordnung der Paneele (Einzelheiten siehe unten) | 

**Felder**

Panels sind die Bausteine eines Dashboards. Es besteht aus Datenquellenabfragen, Arten von Diagrammen, Aliasnamen und mehr. Panel-JSON besteht aus einer Reihe von JSON-Objekten, von denen jedes ein anderes Panel darstellt. Die meisten Felder sind für alle Panels gleich, aber einige Felder hängen vom Panel-Typ ab. Im Folgenden finden Sie ein Beispiel für das Panel-JSON eines Textfensters.

```
"panels": [
  {
    "type": "text",
    "title": "Panel Title",
    "gridPos": {
      "x": 0,
      "y": 0,
      "w": 12,
      "h": 9
    },
    "id": 4,
    "mode": "markdown",
    "content": "# title"
  }
```

**Größe und Position des Panels**

Die GridPos-Eigenschaft beschreibt die Größe und Position des Panels in Rasterkoordinaten.
+ `w`: 1—24 (die Breite des Dashboards ist in 24 Spalten unterteilt)
+ `h`: In Rasterhöheneinheiten entspricht jede Einheit 30 Pixeln.
+ `x`: Die X-Position, in derselben Einheit wie`w`.
+ `y`: Die Y-Position, in derselben Einheit wie`h`.

Das Gitter hat eine negative Schwerkraft, die sich nach oben bewegt, wenn sich über einem Feld ein leerer Bereich befindet.

**Timepicker**

```
"timepicker": {
    "collapse": false,
    "enable": true,
    "notice": false,
    "now": true,
    "refresh_intervals": [
      "5s",
      "10s",
      "30s",
      "1m",
      "5m",
      "15m",
      "30m",
      "1h",
      "2h",
      "1d"
    ],
    "status": "Stable",
    "type": "timepicker"
  }
```

**Vorlagen erstellen**

Das `templating` Feld enthält eine Reihe von Vorlagenvariablen mit ihren gespeicherten Werten sowie einigen anderen Metadaten.

```
"templating": {
    "enable": true,
    "list": [
       {
        "allFormat": "wildcard",
        "current":  {
          "tags": [],
          "text": "prod",
          "value": "prod"
        },
        "datasource": null,
        "includeAll": true,
        "name": "env",
        "options": [
           {
            "selected": false,
            "text": "All",
            "value": "*"
          },
           {
            "selected": false,
            "text": "stage",
            "value": "stage"
          },
           {
            "selected": false,
            "text": "test",
            "value": "test"
          }
        ],
        "query": "tag_values(cpu.utilization.average,env)",
        "refresh": false,
        "type": "query"
      },
       {
        "allFormat": "wildcard",
        "current":  {
          "text": "apache",
          "value": "apache"
        },
        "datasource": null,
        "includeAll": false,
        "multi": false,
        "multiFormat": "glob",
        "name": "app",
        "options": [
           {
            "selected": true,
            "text": "tomcat",
            "value": "tomcat"
          },
           {
            "selected": false,
            "text": "cassandra",
            "value": "cassandra"
          }
        ],
        "query": "tag_values(cpu.utilization.average,app)",
        "refresh": false,
        "regex": "",
        "type": "query"
      }
    ]
  }
```

# Verwaltung von Dashboards
<a name="v9-dash-managing-dashboards"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Ein Dashboard besteht aus einem oder mehreren [Bedienfeldern](v9-panels.md), in denen Ihre Daten in einer oder mehreren Zeilen visuell dargestellt werden.

Weitere Informationen zum Erstellen von Dashboards finden [Sie unter Hinzufügen und Organisieren von Bereichen.]()

## Dashboard-Ordner erstellen
<a name="v9-dash-create-dashboard-folder"></a>

Ordner helfen Ihnen dabei, Dashboards zu organisieren und zu gruppieren, was nützlich ist, wenn Sie viele Dashboards haben oder mehrere Teams dieselbe Grafana-Instanz verwenden.

**Voraussetzungen**

Stellen Sie sicher, dass Sie über Grafana-Administratorrechte verfügen. Weitere Informationen zu Dashboard-Berechtigungen finden Sie unter [Dashboard-Berechtigungen](Grafana-administration-authorization.md).

**Um einen Dashboard-Ordner zu erstellen**

1. Melden Sie sich bei Grafana an und klicken Sie im Seitenmenü auf **Dashboards > Neuer Ordner**

1. **Geben Sie einen eindeutigen Namen ein und klicken Sie auf Erstellen.**

**Anmerkung**  
Wenn Sie ein Dashboard speichern, können Sie entweder einen Ordner auswählen, in dem das Dashboard gespeichert werden soll, oder einen neuen Ordner erstellen.

## Verwaltung von Dashboards und Ordnern
<a name="v9-dash-manage-dashboard-folder"></a>

Auf der Seite **„Dashboards und Ordner verwalten**“ können Sie:
+ Einen Ordner erstellen
+ Erstellen eines Dashboards
+ Verschieben Sie Dashboards in Ordner
+ Löschen Sie mehrere Dashboards
+ Navigieren Sie zu einer Ordnerseite, auf der Sie Ordner- und Dashboard-Berechtigungen zuweisen können

**Ordnerseite des Dashboards**

Auf der Seite „**Dashboard-Ordner“** können Sie die folgenden Aufgaben ausführen:
+ Dashboards in einem Ordner verschieben oder löschen.
+ Benennen Sie einen Ordner um (verfügbar auf der Registerkarte **Einstellungen**).
+ Ordnen Sie Ordnern Berechtigungen zu (die von den Dashboards im Ordner übernommen werden).

Um zur Ordnerseite des Dashboards zu navigieren, klicken Sie auf das Zahnrad, das erscheint, wenn Sie in der Dashboard-Suchergebnisliste oder auf der Seite **Dashboards und Ordner verwalten** mit der Maus auf einen Ordner zeigen.

**Dashboard-Berechtigungen**

Sie können einem Ordner Berechtigungen zuweisen. Alle Berechtigungen, die Sie zuweisen, werden von den Dashboards im Ordner übernommen. Eine Zugriffskontrollliste (ACL) wird verwendet, in der der **Organisationsrolle**, dem **Team** und einem **Benutzer** Berechtigungen zugewiesen werden können.

Weitere Informationen finden Sie unter [Berechtigungen](Grafana-permissions.md).

## Dashboards exportieren und importieren
<a name="v9-dash-export-import-dashboards"></a>

Sie können die Grafana-Benutzeroberfläche oder die HTTP-API verwenden, um Dashboards zu exportieren und zu importieren.

**Ein Dashboard exportieren**

Die Dashboard-Exportaktion erstellt eine Grafana-JSON-Datei, die alles enthält, was Sie benötigen, einschließlich Layout, Variablen, Stilen, Datenquellen, Abfragen usw., sodass Sie das Dashboard später importieren können.

**Anmerkung**  
Grafana lädt eine JSON-Datei auf Ihren lokalen Computer herunter. 

1. Öffnen Sie das Dashboard, das Sie exportieren möchten.

1. Wählen Sie das Share-Symbol.

1. Wählen Sie **Export** aus.

1. Wählen Sie In **Datei speichern.**

**Ein Dashboard portabel machen**

Wenn Sie ein Dashboard exportieren möchten, damit andere es verwenden können, können Sie Vorlagenvariablen für Dinge wie ein Metrikpräfix (verwenden Sie eine konstante Variable) und einen Servernamen hinzufügen.

Eine Vorlagenvariable dieses Typs `Constant` wird automatisch im Dashboard ausgeblendet und beim Import des Dashboards auch als erforderliche Eingabe hinzugefügt.

**Ein Dashboard importieren**

1. Wählen Sie im Seitenmenü **Dashboards** aus.

1. Wählen Sie „**Neu**“ und anschließend „**Importieren**“ aus dem Drop-down-Menü.

1. Führen Sie einen der folgenden Schritte aus.
   + Laden Sie eine Dashboard-JSON-Datei hoch.
   + Fügen Sie eine [Grafana.com-Dashboard-URL](https://grafana.com/) ein.
   + Fügen Sie den JSON-Text des Dashboards direkt in den Textbereich ein.

   Der Importvorgang ermöglicht es Ihnen, den Namen des Dashboards zu ändern, die Datenquelle auszuwählen, die das Dashboard verwenden soll, und alle Metrikpräfixe anzugeben (falls das Dashboard welche verwendet).

## Fehlerbehebung bei Dashboards
<a name="v9-dash-troubleshooting"></a>

Dieser Abschnitt enthält Informationen, die Ihnen bei der Lösung häufiger Probleme mit Dashboards helfen sollen. 

**Das Dashboard ist langsam**

Wenn Ihr Dashboard langsam ist, sollten Sie Folgendes beachten:
+ Versuchen Sie, Dutzende (oder Hunderte oder Tausende) von Zeitreihen in einem Diagramm darzustellen? Dies kann dazu führen, dass der Browser verzögert wird. Versuchen Sie, Funktionen wie HighestMax (in Graphite) zu verwenden, um die zurückgegebene Serie zu reduzieren.
+ Manchmal können die Seriennamen sehr groß sein. Dies führt zu größeren Antwortgrößen. Versuchen Sie, Alias zu verwenden, um die Größe der zurückgegebenen Seriennamen zu reduzieren.
+ Fragen Sie viele Zeitreihen oder für einen langen Zeitraum ab? Beide Bedingungen können dazu führen, dass Grafana oder Ihre Datenquelle viele Daten einbezieht, was sie verlangsamen kann.
+ Dies könnte Ihre Netzwerkinfrastruktur stark belasten. Wenn die Langsamkeit nicht konstant ist, könnte dies das Problem sein.

**Probleme mit der Aktualisierungsrate des Dashboards**

Standardmäßig fragt Grafana Ihre Datenquelle alle 30 Sekunden ab. Wenn Sie eine niedrige Aktualisierungsrate für Ihre Dashboards festlegen, wird das Backend unnötig stress. In vielen Fällen ist es nicht notwendig, dies häufig abzufragen, da die Daten nicht so an das System gesendet werden, dass Änderungen sichtbar wären.

Wenn Sie dieses Problem haben, werden die folgenden Lösungen empfohlen.
+ Aktivieren Sie die automatische Aktualisierung für Dashboards, Panels oder Variablen nur, wenn Sie sie benötigen. Benutzer können ihren Browser manuell aktualisieren, oder Sie können die Aktualisierungsrate für einen Zeitraum festlegen, der sinnvoll ist (z. B. alle zehn Minuten oder jede Stunde).
+ Falls erforderlich, stellen Sie die Aktualisierungsrate auf einmal pro Minute ein. Benutzer können das Dashboard jederzeit manuell aktualisieren.
+ Wenn Ihr Dashboard einen längeren Zeitraum hat (z. B. eine Woche), ist eine automatische Aktualisierung möglicherweise nicht erforderlich.

**Der Umgang mit oder das Rendern von Nulldaten ist falsch oder verwirrend**

Einige Anwendungen veröffentlichen Daten mit Unterbrechungen. Sie veröffentlichen beispielsweise nur dann eine Metrik, wenn ein Ereignis eintritt. Standardmäßig verbinden Grafana-Graphen Linien zwischen den Datenpunkten.

# Dashboards und Panels teilen
<a name="v9-dash-sharing"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Grafana ermöglicht es Ihnen, Dashboards und Panels mit anderen Benutzern innerhalb einer Organisation und in bestimmten Situationen öffentlich im Internet zu teilen. Sie können teilen mit:
+ Ein direkter Link
+ Ein Schnappschuss
+ Ein Exportlink (nur für Dashboards)

Sie benötigen eine autorisierte Zuschauerberechtigung, um ein Bild sehen zu können, das über einen direkten Link gerendert wurde.

Dieselbe Berechtigung ist auch erforderlich, um eingebettete Links anzuzeigen, es sei denn, Sie haben die anonyme Zugriffsberechtigung für Ihre Grafana-Instanz aktiviert.

Wenn Sie ein Panel oder Dashboard als Snapshot teilen, ist ein Snapshot (der zu dem Zeitpunkt, an dem Sie den Snapshot aufnehmen, ein Panel oder Dashboard) öffentlich im Internet verfügbar. Jeder, der einen Link dazu hat, kann darauf zugreifen. Da für die Anzeige von Snapshots keine Autorisierung erforderlich ist, entfernt Grafana Informationen zu dem Konto, von dem sie stammen, sowie alle sensiblen Daten aus dem Snapshot.

## Ein Dashboard teilen
<a name="v9-dash-share-dashboard"></a>

Sie können ein Dashboard als direkten Link oder als Snapshot teilen. Sie können ein Dashboard auch exportieren.

**Anmerkung**  
Wenn Sie ein Dashboard ändern, stellen Sie sicher, dass Sie die Änderungen speichern, bevor Sie es teilen.

1. Navigieren Sie zur Startseite Ihrer Grafana-Instanz.

1. Klicken Sie in der oberen Navigation auf das Share-Symbol.

   Das Dialogfeld „Teilen“ wird geöffnet und zeigt die Registerkarte **Link** an.

**Einen direkten Link teilen**

Auf der Registerkarte **Link** werden der aktuelle Zeitraum, die Vorlagenvariablen und das Standarddesign angezeigt. Sie können auch eine verkürzte URL teilen.

1. Klicken Sie auf **Copy**. Diese Aktion kopiert die Standard- oder die verkürzte URL in die Zwischenablage.

1. Senden Sie die kopierte URL an einen Grafana-Benutzer mit der Berechtigung, den Link anzusehen.

**Einen Snapshot veröffentlichen**

Ein Dashboard-Snapshot teilt ein interaktives Dashboard öffentlich. Grafana entfernt sensible Daten wie Abfragen (Metrik, Vorlage und Anmerkung) und Panel-Links, sodass nur die sichtbaren Metrikdaten und Seriennamen im Dashboard eingebettet bleiben. Jeder, der über den Link verfügt, kann auf Dashboard-Schnappschüsse zugreifen.

Sie können Snapshots auf Ihrer lokalen Instanz veröffentlichen.

1. Klicken Sie auf **Lokaler Snapshot**.

1. Grafana generiert einen Link des Snapshots. Kopieren Sie den Snapshot-Link und teilen Sie ihn entweder innerhalb Ihrer Organisation oder öffentlich im Internet.

**Ein Dashboard exportieren**

Grafana-Dashboards können einfach exportiert und importiert werden. Weitere Informationen finden Sie unter Dashboards [exportieren und importieren](v9-dash-managing-dashboards.md#v9-dash-export-import-dashboards).

## Ein Panel teilen
<a name="v9-dash-share-panel"></a>

Sie können ein Panel als direkten Link oder als Snapshot teilen. Sie können auch Bibliotheksfenster erstellen, indem Sie in einem beliebigen Bedienfeld die Option „**Teilen**“ verwenden.

1. Klicken Sie auf einen Panel-Titel, um das Bedienfeldmenü zu öffnen.

1. Klicken Sie auf „**Teilen**“. Das Dialogfeld „Teilen“ wird geöffnet und die Registerkarte „**Link**“ wird angezeigt.

**Verwenden Sie einen direkten Link**

Auf der Registerkarte **Link** werden der aktuelle Zeitraum, die Vorlagenvariablen und das Standarddesign angezeigt. Sie können optional eine verkürzte URL zum Teilen aktivieren. 

1. Klicken Sie auf **Kopieren**, um die Standard- oder die verkürzte URL in die Zwischenablage zu kopieren. 

1. Senden Sie die kopierte URL an einen Grafana-Benutzer mit der Berechtigung, den Link anzusehen.

1. Sie können optional auch auf **Gerendertes Bild mit Direktlink verknüpfen** klicken, um ein Bild des Panels zu teilen.

**Abfragen von Zeichenkettenparametern für serverseitig gerenderte Bilder**
+ **Breite: Breite** in Pixeln. Die Standardeinstellung ist 800.
+ **Höhe**: Höhe in Pixeln. Der Standardwert ist 400.
+ **tz**: Zeitzone in dem Format, in `UTC%2BHH%3AMM` dem HH und MM in Stunden und Minuten nach UTC verschoben sind.
+ **Timeout**: Anzahl der Sekunden. Das Timeout kann erhöht werden, wenn die Abfrage für das Panel mehr als die standardmäßigen 30 Sekunden benötigt.
+ **Skala**: Numerischer Wert zur Konfiguration des Geräte-Skalierungsfaktors. Standard = 1. Verwenden Sie einen höheren Wert, um detailliertere Bilder zu erzeugen (höhere DPI). Wird in Grafana v7.0\$1 unterstützt.

**Einen Snapshot veröffentlichen**

Ein Panel-Snapshot teilt ein interaktives Panel öffentlich. Grafana entfernt sensible Daten und hinterlässt nur die sichtbaren metrischen Daten und Seriennamen, die im Dashboard eingebettet sind. Auf Panel-Snapshots kann jeder mit dem Link zugreifen

Sie können Schnappschüsse auf Ihrer lokalen Instanz veröffentlichen.

1. Klicken **Sie im Dialogfeld „Bedienfeld teilen**“ auf **Snapshot**, um die Registerkarte zu öffnen.

1. Klicken Sie auf **Lokaler Snapshot**. Grafana generiert den Link des Snapshots.

1. Kopieren Sie den Snapshot-Link und teilen Sie ihn entweder innerhalb Ihrer Organisation oder öffentlich im Internet.

Wenn Sie versehentlich einen Snapshot erstellt haben, klicken Sie auf **Snapshot löschen**, um den Snapshot aus Ihrer Grafana-Instanz zu entfernen.

**Erstellen eines Bibliotheksfensters**

Um ein Bibliotheksfenster über das Dialogfeld „**Bedienfeld teilen**“ zu erstellen.

1. Klicken Sie auf das **Bedienfeld „Bibliothek“**.

1. Geben Sie im **Feld Name des Bibliotheksfensters** den Namen ein.

1. Wählen **Sie unter Im Ordner speichern** den Ordner aus, in dem das Bedienfeld „Bibliothek“ gespeichert werden soll. Standardmäßig ist der Ordner **Allgemein** ausgewählt.

1. Klicken Sie auf das Bedienfeld „**Bibliothek erstellen**“, um Ihre Änderungen zu speichern.

1. Klicken Sie auf **Speichern**, um das Dashboard zu speichern.

# Playlisten verwalten
<a name="v9-dash-managing-playlists"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Eine *Playlist* ist eine Liste von Dashboards, die in einer Reihenfolge angezeigt werden. Sie können eine Playlist verwenden, um ein Situationsbewusstsein aufzubauen oder Ihre Kennzahlen Ihrem Team oder Ihren Besuchern zu präsentieren. Grafana skaliert Dashboards automatisch auf jede Auflösung, wodurch sie sich perfekt für große Bildschirme eignen. **Sie können über das Seitenmenü von Grafana im Untermenü Dashboards auf die Playlist-Funktion zugreifen.**

## Auf eine Playlist zugreifen, sie teilen und steuern
<a name="v9-dash-access-share-control-playlist"></a>

Verwende die Informationen in diesem Abschnitt, um auf bestehende Playlisten zuzugreifen. Starten und steuern Sie die Anzeige einer Playlist mit einem der fünf verfügbaren Modi.

**Zugriff auf eine Playlist**

1. Bewegen Sie den Mauszeiger über das Seitenmenü von Grafana.

1. **Klicken Sie auf Playlisten.**

   Sie sehen eine Liste der vorhandenen Playlisten.

**Eine Playlist starten**

Sie können eine Playlist in fünf verschiedenen Anzeigemodi starten. Der Anzeigemodus bestimmt, wie die Menüs und die Navigationsleiste auf den Dashboards angezeigt werden.

Standardmäßig wird jedes Dashboard für den Zeitraum angezeigt, den Sie im Feld **Intervall** eingegeben haben, das Sie beim Erstellen oder Bearbeiten einer Playlist festgelegt haben. Nachdem Sie eine Playlist gestartet haben, können Sie sie über die Navigationsleiste oben auf der Seite steuern.

In der Playlist werden alle Dashboards für die Zeit angezeigt, die im `Interval` Feld angegeben wurde, das beim Erstellen oder Bearbeiten einer Playlist festgelegt wurde. Nachdem eine Playlist gestartet wurde, kannst du sie über die Navigationsleiste am oberen Bildschirmrand steuern.

1. Rufen Sie die Playlist-Seite auf, um eine Liste der vorhandenen Playlisten zu sehen.

1. Suchen Sie die Playlist, die Sie starten möchten, und klicken Sie dann auf **Playlist starten**.

   Das Dialogfeld „Playlist starten“ wird geöffnet.

1. Wählen Sie anhand der Informationen in der folgenden Tabelle einen der fünf verfügbaren Playlist-Modi aus.

1. Klicken Sie auf Start.


| Mode | Description | 
| --- | --- | 
| Normaler Modus |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| TV-Modus |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| TV-Modus (mit Panels zur auto Anpassung) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| Kiosk-Modus |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| Kioskmodus (mit Paneelen zur auto Anpassung) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 

**Steuerung einer Playlist**

Sie können eine Playlist nach dem Start im **Normal** - oder **TV-Modus** über die Navigationsleiste oben auf dem Bildschirm steuern. Drücken Sie die `Esc` Taste auf Ihrer Tastatur, um die Playlist zu beenden.


| Button | Action | 
| --- | --- | 
| Weiter (Doppelpfeil nach rechts) | Wechselt zum nächsten Dashboard. | 
| Zurück (linker Pfeil) | Kehrt zum vorherigen Dashboard zurück. | 
| Stopp (quadratisch) | Beendet die Playlist und wechselt zum aktuellen Dashboard. | 
| Modus „Zyklusansicht“ (Monitorsymbol) | Dreht die Anzeige der Dashboards in verschiedenen Ansichtsmodi. | 
| Zeitraum | Zeigt Daten innerhalb eines Zeitbereichs an. Es kann so eingestellt werden, dass die letzten 5 Minuten vor bis zu 5 Jahren oder ein benutzerdefinierter Zeitraum mit dem Abwärtspfeil angezeigt werden. | 
| Aktualisieren (Kreispfeil) | Lädt das Dashboard neu, um die aktuellen Daten anzuzeigen. Über den Dropdown-Pfeil kann es so eingestellt werden, dass es automatisch alle 5 Sekunden bis 1 Tag neu geladen wird. | 

## Eine Playlist erstellen
<a name="v9-dash-create-playlist"></a>

Sie können eine Playlist erstellen, um Dashboards in einer Reihenfolge mit einer festgelegten Reihenfolge und einem festgelegten Zeitintervall zwischen den Dashboards anzuzeigen.

1. Klicken Sie auf der **Playlist-Seite auf Neue** Playlist.

1. Geben Sie einen aussagekräftigen Namen in das Textfeld **Name** ein.

1. Geben Sie in das Textfeld Intervall ein **Zeitintervall** ein.
**Anmerkung**  
Die Dashboards, die Sie hinzufügen, werden in einer sequentiellen Reihenfolge aufgeführt.

1. Fügen Sie in **Dashboards** mithilfe der Drop-down-Optionen **Nach Titel hinzufügen und Nach Tag hinzufügen** vorhandene Dashboards zur Playlist **hinzu**.

1. Optional:
   + Suchen Sie anhand seines Namens, eines regulären Ausdrucks oder eines Tags nach einem Dashboard.
   + Filtern Sie Ihre Ergebnisse nach Sternstatus oder Stichwörtern.
   + Ordnen Sie die Reihenfolge des hinzugefügten Dashboards mithilfe des Aufwärts- und Abwärtspfeilsymbols neu an.
   + Entfernen Sie ein Dashboard aus der Playlist, indem Sie auf das **X-Symbol** neben dem Dashboard klicken.

1. Klicken Sie auf **Save**, um Ihre Änderungen zu speichern.

## Eine Playlist speichern
<a name="v9-dash-save-playlist"></a>

Du kannst eine Playlist speichern und sie zu deiner **Playlist-Seite** hinzufügen, wo du sie starten kannst.

**Wichtig**  
Stellen Sie sicher, dass alle Dashboards, die in Ihrer Playlist erscheinen sollen, hinzugefügt wurden, wenn Sie die Playlist erstellen oder bearbeiten, bevor Sie sie speichern.

1. Um auf die Playlist-Funktion zuzugreifen, bewegen Sie den Mauszeiger über das Seitenmenü von Grafana.

1. Klicken Sie auf **Playlisten**, um die für Sie verfügbaren Playlisten anzuzeigen.

1. Klicke auf die Playlist deiner Wahl.

1. Bearbeiten Sie die Playlist.

1. Vergewissern Sie sich, dass der Playlist ein **Name**, ein **Intervall** und mindestens ein **Dashboard** hinzugefügt wurden.

1. Klicken Sie auf **Save**, um Ihre Änderungen zu speichern.

## Eine Playlist bearbeiten oder löschen
<a name="v9-dash-edit-delete-playlist"></a>

Sie können eine Playlist bearbeiten, indem Sie ihren Namen und ihre Intervallzeit aktualisieren und Dashboards hinzufügen, entfernen und ihre Reihenfolge ändern.

**Eine Playlist bearbeiten**

1. Klicke auf der **Playlist-Seite auf Playlist bearbeiten**.

1. Aktualisieren Sie den Namen und das Zeitintervall und fügen Sie dann Dashboards zur Playlist hinzu oder entfernen Sie sie. Folgen Sie dazu den Anweisungen unter Playlist erstellen oben.

1. Klicken Sie auf **Save**, um Ihre Änderungen zu speichern.

**Eine Playlist löschen**

1. Klicken Sie auf **Playlisten**.

1. **Klicke neben der Playlist, die du löschen möchtest, auf Entfernen.**

**Reihenfolge im Dashboard neu anordnen**

1. Klicken Sie neben dem Dashboard, das Sie verschieben möchten, auf den Aufwärts- oder Abwärtspfeil.

1. Klicken Sie auf **Save**, um Ihre Änderungen zu speichern.

**Ein Dashboard entfernen**

1. Klicken Sie auf **Entfernen**, um ein Dashboard aus der Playlist zu entfernen.

1. Klicken Sie auf **Save**, um Ihre Änderungen zu speichern.

## Eine Playlist im Anzeigemodus teilen
<a name="v9-dash-share-playlist-view-mode"></a>

Du kannst eine Playlist teilen, indem du die Linkadresse in dem von dir bevorzugten Anzeigemodus kopierst und die URL in dein Ziel einfügst.

1. **Klicken Sie im Untermenü „**Dashboards**“ auf Playlisten.**

1. Klicke neben der **Playlist, die du teilen möchtest, auf Playlist starten**.

1. Klicken Sie in der Dropdownliste mit der rechten Maustaste auf den Anzeigemodus, den Sie bevorzugen.

1. Klicken Sie auf **Link-Adresse kopieren**, um die URL in Ihre Zwischenablage zu kopieren.

1. Fügen Sie die URL in Ihr Ziel ein.

# Hinzufügen und Verwalten von Dashboard-Variablen
<a name="v9-dash-variables"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Eine Variable ist ein Platzhalter für einen Wert. Sie können Variablen in metrischen Abfragen und in Paneltiteln verwenden. Wenn Sie also den Wert mithilfe der Dropdownliste oben im Dashboard ändern, ändern sich die metrischen Abfragen Ihres Panels entsprechend dem neuen Wert.

Variablen ermöglichen es Ihnen, interaktivere und dynamischere Dashboards zu erstellen. Anstatt Dinge wie Server-, Anwendungs- und Sensornamen in Ihren metrischen Abfragen fest zu codieren, können Sie stattdessen Variablen verwenden. Variablen werden als Dropdownlisten oben im Dashboard angezeigt. Diese Dropdowns machen es einfach, die in Ihrem Dashboard angezeigten Daten zu ändern.

Diese können besonders für Administratoren nützlich sein, die Grafana-Viewern ermöglichen möchten, Visualisierungen schnell anzupassen, ihnen aber keine vollen Bearbeitungsberechtigungen geben möchten. Grafana-Viewer können Variablen verwenden.

Variablen und Vorlagen ermöglichen es Ihnen auch, Dashboards aus einer Hand zu beziehen. Wenn Sie über mehrere identische Datenquellen oder Server verfügen, können Sie ein Dashboard erstellen und Variablen verwenden, um zu ändern, was Sie gerade sehen. Das vereinfacht Wartung und Instandhaltung enorm.

**Vorlagen**

Eine Vorlage ist jede Abfrage, die eine Variable enthält. Wenn Sie beispielsweise ein Dashboard zur Überwachung mehrerer Server verwalten würden, könnten Sie für jeden Server ein Dashboard erstellen, oder Sie könnten ein Dashboard erstellen und Bereiche mit Vorlagenabfragen verwenden, z. B. die folgenden.

```
wmi_system_threads{instance=~"$server"}
```

<varname>Variablenwerte werden immer mit der Syntax var- =value mit der URL synchronisiert.

**Beispiele**

Variablen werden in Dropdownlisten oben auf dem Bildschirm aufgeführt. Wählen Sie verschiedene Variablen aus, um zu sehen, wie sich die Visualisierungen ändern.

Um die Variableneinstellungen zu sehen, navigieren Sie zu **Dashboard-Einstellungen >** Variablen. Klicken Sie in der Liste auf eine Variable, um ihre Einstellungen zu sehen. 

Variablen können in Titeln, Beschreibungen, Textfeldern und Abfragen verwendet werden. Abfragen mit Text, der mit 1 beginnt, `$` sind Vorlagen. Nicht alle Panels werden über Vorlagenabfragen verfügen.

**Verschiedene bewährte Methoden**
+ Variablen-Dropdownlisten werden in der Reihenfolge angezeigt, in der sie in der Variablenliste in den **Dashboard-Einstellungen** aufgeführt sind.
+ Platzieren Sie die Variablen, die Sie häufig ändern werden, ganz oben, sodass sie zuerst angezeigt werden (ganz links im Dashboard).

# Variablen hinzufügen und verwalten
<a name="v9-dash-variable-add"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

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


| Variablentyp | Description | 
| --- | --- | 
|  Query  |  Durch eine Abfrage generierte Werteliste wie Metriknamen, Servernamen IDs, Sensoren, Rechenzentren usw. Fügen Sie eine Abfragevariable hinzu.  | 
|  Benutzerdefiniert  |  Definieren Sie die Variablenoptionen manuell mithilfe einer durch Kommas getrennten Liste. Fügen Sie eine benutzerdefinierte Variable hinzu.  | 
|  Text box (Textfeld)  |  Zeigt ein Freitexteingabefeld mit einem optionalen Standardwert an. Fügen Sie eine Textfeld-Variable hinzu.  | 
|  Konstante  |  Definieren Sie eine versteckte Konstante. Fügen Sie eine konstante Variable hinzu.  | 
|  Datenquelle  |  Ändern Sie schnell die Datenquelle für ein gesamtes Dashboard. Fügen Sie eine Datenquellenvariable hinzu.  | 
|  Intervall  |  Intervallvariablen stellen Zeitspannen dar. Fügen Sie eine Intervallvariable hinzu.  | 
|  Ad-hoc-Filter  |  Schlüsselwertfilter, die automatisch zu allen Metrikabfragen für eine Datenquelle hinzugefügt werden (nur Prometheus, Loki, InfluxDB und Elasticsearch). Fügen Sie Ad-hoc-Filter hinzu.  | 
|  Globale Variablen  |  Integrierte Variablen, die in Ausdrücken im Abfrage-Editor verwendet werden können. Weitere Informationen finden Sie unter Globale Variablen.  | 
|  Verkettete Variablen  |  Variablenabfragen können andere Variablen enthalten. Weitere Informationen finden Sie unter Verkettete Variablen.  | 

## Allgemeine Optionen eingeben
<a name="v9-dash-variable-options"></a>

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

**Um allgemeine Optionen einzugeben**

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

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

1. Geben Sie einen **Namen** für die Variable ein.

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

1. (Optional) Geben Sie im Feld **Bezeichnung** den Anzeigenamen der Variablen-Dropdownliste ein.

   Wenn Sie keinen Anzeigenamen eingeben, entspricht das Dropdown-Label dem Variablennamen.

1. Wählen Sie eine Option zum **Ausblenden**:
   + **Keine Auswahl (leer):** In der Variablen-Dropdownliste wird der **Variablenname** oder der **Labelwert** angezeigt.
   + **Bezeichnung:** In der Variablen-Dropdownliste werden nur der ausgewählte Variablenwert und ein Abwärtspfeil angezeigt.
   + **Variabel:** Auf dem Dashboard wird kein Variablen-Dropdown angezeigt.

## Eine Abfragevariable hinzufügen
<a name="v9-dash-variable-add-query"></a>

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

Abfragevariablen werden im Allgemeinen nur für Zeichenfolgen unterstützt. Wenn Ihre Abfrage Zahlen oder einen anderen Datentyp zurückgibt, müssen Sie diese möglicherweise in Zeichenfolgen konvertieren, um sie als Variablen verwenden zu können. Für die Azure-Datenquelle können Sie zu diesem Zweck beispielsweise die [tostring-Funktion](https://docs.microsoft.com/en-us/azure/data-explorer/kusto/query/tostringfunction) verwenden.

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

**Anmerkung**  
Abfrageausdrücke sind für jede Datenquelle unterschiedlich. Weitere Informationen finden Sie in der Dokumentation zu Ihrer [Datenquelle](AMG-data-sources.md).

**Um eine Abfragevariable hinzuzufügen**

1. Geben Sie allgemeine Optionen wie oben ein.

1. Wählen Sie in der **Datenquellenliste** die Zieldatenquelle für die Abfrage aus.

1. Wählen Sie in der **Aktualisierungsliste** aus, wann die Variable die Optionen aktualisieren soll.
   + **Beim Laden des Dashboards:** Fragt bei jedem Laden des Dashboards die Datenquelle ab. Dadurch wird das Laden des Dashboards verlangsamt, da die Variablenabfrage abgeschlossen werden muss, bevor das Dashboard initialisiert werden kann.
   + **Bei Änderung des Zeitbereichs: Fragt** die Datenquelle ab, wenn sich der Zeitbereich des Dashboards ändert. Verwenden Sie diese Option nur, wenn Ihre Abfrage mit variablen Optionen einen Zeitbereichsfilter enthält oder vom Zeitbereich des Dashboards abhängig ist.

1. Geben Sie im Feld **Abfrage** eine Abfrage ein.
   + Das Abfragefeld variiert je nach Datenquelle. Einige Datenquellen verfügen über benutzerdefinierte Abfrageeditoren.
   + Wenn Sie mehr Platz in einem Abfrage-Editor für ein einzelnes Eingabefeld benötigen, bewegen Sie den Mauszeiger über die Linien in der unteren rechten Ecke des Felds und ziehen Sie es nach unten, um es zu erweitern.

1. (Optional) Geben Sie im Feld **Regex** einen Regex-Ausdruck ein, um bestimmte Teile der von Ihrer Datenquellenabfrage zurückgegebenen Namen zu filtern oder zu erfassen. Beispiele finden Sie unter [Filtern](#v9-dash-variable-add-filter) von Variablen mit Regex.

1. Wählen Sie in der **Sortierliste** die Sortierreihenfolge für die Werte aus, die in der Dropdownliste angezeigt werden sollen. Die Standardoption **Deaktiviert** bedeutet, dass die Reihenfolge der Optionen verwendet wird, die von Ihrer Datenquellenabfrage zurückgegeben wurde.

1. (Optional) Geben Sie [Auswahloptionen](#v9-dash-variable-add-selection) ein.

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

1. Wählen Sie **Hinzufügen** aus, um die Variable zum Dashboard hinzuzufügen.

## Eine benutzerdefinierte Variable hinzufügen
<a name="v9-dash-variable-add-custom"></a>

Verwenden Sie eine *benutzerdefinierte* Variable für einen Wert, der sich nicht ändert, z. B. eine Zahl oder eine Zeichenfolge.

Wenn Sie beispielsweise Servernamen oder Regionsnamen haben, die sich nie ändern, möchten Sie sie möglicherweise als benutzerdefinierte Variablen und nicht als Abfragevariablen erstellen. Da sie sich nicht ändern, können Sie sie eher in [verketteten Variablen](#v9-dash-variable-add-chained) als in anderen Abfragevariablen verwenden. Dies würde die Anzahl der Abfragen reduzieren, die Grafana senden muss, wenn verkettete Variablen aktualisiert werden.

**Um eine benutzerdefinierte Variable hinzuzufügen**

1. Geben Sie allgemeine Optionen wie oben ein.

1. Im 

   **Werte, getrennt durch Kommas**, geben Sie die Werte für diese Variable in eine kommagetrennte Liste ein. Sie können Zahlen, Zeichenketten oder Schlüssel-Wert-Paare angeben, die durch ein Leerzeichen und einen Doppelpunkt getrennt sind. Beispiel, `key1 : value1,key2 : value2`.

1. (Optional) Geben Sie [Auswahloptionen](#v9-dash-variable-add-selection) ein.

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

1. Wählen Sie **Hinzufügen** aus, um die Variable zum Dashboard hinzuzufügen.

## Eine Textfeld-Variable hinzufügen
<a name="v9-dash-variable-add-text"></a>

*Textfeldvariablen* zeigen ein Freitexteingabefeld mit einem optionalen Standardwert an. Dies ist die flexibelste Variable, da Sie einen beliebigen Wert eingeben können. Verwenden Sie diesen Variablentyp, wenn Sie Metriken mit hoher Kardinalität haben oder wenn Sie mehrere Bereiche in einem Dashboard gleichzeitig aktualisieren möchten.

**Um eine Textfeld-Variable hinzuzufügen**

1. Geben Sie allgemeine Optionen wie oben ein.

1. (Optional) Wählen Sie im Feld **Standardwert** den Standardwert für die Variable aus. Wenn Sie in dieses Feld nichts eingeben, zeigt Grafana ein leeres Textfeld an, in das Benutzer Text eingeben können.

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

1. Wählen Sie **Hinzufügen** aus, um die Variable zum Dashboard hinzuzufügen.

## Eine konstante Variable hinzufügen
<a name="v9-dash-variable-add-constant"></a>

*Konstante* Variablen ermöglichen es Ihnen, eine versteckte Konstante zu definieren. Dies ist nützlich für metrische Pfadpräfixe für Dashboards, die Sie teilen möchten. Wenn Sie ein Dashboard exportieren, werden konstante Variablen in Importoptionen umgewandelt.

Konstante Variablen sind *nicht* flexibel. Jede konstante Variable enthält nur einen Wert und kann nur aktualisiert werden, wenn Sie die Variableneinstellungen aktualisieren.

Konstante Variablen sind nützlich, wenn Sie komplexe Werte haben, die Sie in Abfragen einbeziehen müssen, aber nicht bei jeder Abfrage erneut eingeben möchten. Wenn Sie beispielsweise einen Serverpfad mit dem Namen haben`i-0b6a61efe2ab843gg`, können Sie ihn durch eine Variable mit dem Namen `$path_gg` ersetzen.

**Um eine konstante Variable hinzuzufügen**

1. Geben Sie allgemeine Optionen wie oben ein.

1. Geben Sie im Feld **Wert** den Variablenwert ein. Sie können Buchstaben, Zahlen und Symbole eingeben. Sie können sogar Platzhalter verwenden, wenn Sie das [Rohformat](https://grafana.com/docs/grafana/latest/dashboards/variables/variable-syntax/#raw) verwenden.

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

1. Wählen Sie **Hinzufügen** aus, um die Variable zum Dashboard hinzuzufügen.

## Eine Datenquellenvariable hinzufügen
<a name="v9-dash-variable-add-datasource"></a>

*Datenquellenvariablen* ermöglichen es Ihnen, die Datenquelle für ein gesamtes Dashboard schnell zu ändern. Sie sind nützlich, wenn Sie mehrere Instanzen einer Datenquelle haben, möglicherweise in unterschiedlichen Umgebungen.

**Um eine Datenquellenvariable hinzuzufügen**

1. Geben Sie allgemeine Optionen wie oben ein.

1. Wählen Sie in der Liste **Typ** die Zieldatenquelle für die Variable aus.

1. (Optional) Geben Sie im Feld **Instanznamenfilter** einen Regex-Filter ein, für die Datenquelleninstanzen Sie in der Dropdownliste mit Variablenwerten auswählen können. Lassen Sie dieses Feld leer, um alle Instanzen anzuzeigen.

1. (Optional) Geben Sie [Auswahloptionen](#v9-dash-variable-add-selection) ein.

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

1. Wählen Sie **Hinzufügen** aus, um die Variable zum Dashboard hinzuzufügen.

## Eine Intervallvariable hinzufügen
<a name="v9-dash-variable-add-internal"></a>

Verwenden Sie eine *Intervallvariable*, um Zeitspannen wie `1m``1h`, oder `1d` darzustellen. Sie können sie sich als eine *Gruppe* von Zeitbefehlen für das gesamte Dashboard vorstellen. Intervallvariablen ändern, wie die Daten in der Visualisierung gruppiert werden. Sie können auch die Option Auto verwenden, um eine festgelegte Anzahl von Datenpunkten pro Zeitspanne zurückzugeben.

Sie können eine Intervallvariable als Parameter für die Gruppierung nach Zeit (für InfluxDB), Datumshistogrammintervall (für Elasticsearch) oder als Parameter für die Zusammenfassungsfunktion (für Graphite) verwenden.

**Um eine Intervallvariable hinzuzufügen**

1. Geben Sie allgemeine Optionen wie oben ein.

1. Geben Sie im Feld **Werte** die Zeitintervalle ein, die in der Dropdownliste der Variablen angezeigt werden sollen. Die folgenden Zeiteinheiten werden unterstützt: `s (seconds)``m (minutes)`,`h (hours)`,`d (days)`, `w (weeks)``M (months)`, und`y (years)`. Sie können die Standardwerte auch akzeptieren oder bearbeiten:`1m,10m,30m,1h,6h,12h,1d,7d,14d,30d`.

1. (Optional) Aktivieren Sie die **Option Automatisch**, wenn Sie die `auto` Option zur Liste hinzufügen möchten. Mit dieser Option können Sie angeben, wie oft der aktuelle Zeitraum geteilt werden soll, um den aktuellen `auto` Zeitraum zu berechnen. Wenn Sie es einschalten, werden zwei weitere Optionen angezeigt:
   + **Schrittanzahl —** Wählen Sie aus, wie oft der aktuelle Zeitraum geteilt werden soll, um den Wert zu berechnen, ähnlich wie bei der Abfrageoption **Max. Datenpunkte**. Wenn der aktuell sichtbare Zeitraum beispielsweise 30 Minuten beträgt, gruppiert das `auto` Intervall die Daten in 30 Ein-Minuten-Schritten. Der Standardwert ist 30 Schritte.
   + **Minimales Intervall —** Der Mindestschwellenwert, unter dem die Intervalle zur Schrittzählung die Zeit nicht unterteilen. Um das 30-Minuten-Beispiel fortzusetzen: Wenn das Mindestintervall auf 2 m festgelegt ist, gruppiert Grafana die Daten in 15 Zwei-Minuten-Schritten.

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

1. Wählen Sie **Hinzufügen** aus, um die Variable zum Dashboard hinzuzufügen.

**Beispiele für Intervallvariablen**

Das folgende Beispiel zeigt eine Template-Variable `myinterval` in einer Graphite-Funktion:

```
summarize($myinterval, sum, false)
```

## Hinzufügen von Ad-hoc-Filtern
<a name="v9-dash-variable-add-adhoc"></a>

Mit *Ad-hoc-Filtern* können Sie Schlüsselwertfilter hinzufügen, die automatisch zu allen Metrikabfragen hinzugefügt werden, die die angegebene Datenquelle verwenden. Im Gegensatz zu anderen Variablen verwenden Sie in Abfragen keine Ad-hoc-Filter. Stattdessen verwenden Sie Ad-hoc-Filter, um Filter für bestehende Abfragen zu schreiben.

**Anmerkung**  
Ad-hoc-Filtervariablen funktionieren nur mit Prometheus-, Loki-, InfluxDB- und Elasticsearch-Datenquellen.

1. Geben Sie allgemeine Optionen wie oben ein.

1. Wählen Sie in der **Datenquellenliste** die Zieldatenquelle aus.

1. Wählen Sie **Hinzufügen** aus, um die Variable zum Dashboard hinzuzufügen.

**Erstellen Sie Ad-hoc-Filter**

Ad-hoc-Filter sind eine der komplexesten und flexibelsten verfügbaren Variablenoptionen. Anstatt einer regulären Liste von Variablenoptionen können Sie mit dieser Variablen eine Ad-hoc-Abfrage für das gesamte Dashboard erstellen. Filter, die Sie auf diese Weise anwenden, werden auf alle Bereiche im Dashboard angewendet.

## Konfigurieren Sie variable Auswahloptionen
<a name="v9-dash-variable-add-selection"></a>

**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
<a name="v9-dash-variable-add-selection-multi"></a>

Die Interpolation einer Variablen mit mehreren ausgewählten Werten ist schwierig, da es nicht einfach ist, die mehreren Werte in eine Zeichenfolge zu formatieren, die in dem angegebenen Kontext, in dem die Variable verwendet wird, gültig ist. Grafana versucht, dieses Problem zu lösen, indem es jedem Datenquellen-Plugin erlaubt, der Templating-Interpolationsengine mitzuteilen, welches Format für mehrere Werte verwendet werden soll.

**Anmerkung**  
Die Option **Benutzerdefiniert für alle Werte** für die Variable muss leer sein, damit Grafana alle Werte in einer einzigen Zeichenfolge formatieren kann. Wenn es leer gelassen wird, verkettet (addiert) Grafana alle Werte in der Abfrage. Beispiel, `value1,value2,value3`. Wenn ein benutzerdefinierter `all` Wert verwendet wird, lautet der Wert stattdessen oder. `*` `all`

**Variablen mit mehreren Werten und einer Graphite-Datenquelle**

Graphite verwendet Glob-Ausdrücke. **Eine Variable mit mehreren Werten würde in diesem Fall so interpoliert werden, als `{host1,host2,host3}` ob der aktuelle Variablenwert *host1, host2 und host3* wäre.**

**Variablen mit mehreren Werten mit einer Prometheus- oder InfluxDB-Datenquelle**

InfluxDB und Prometheus verwenden Regex-Ausdrücke, sodass dieselbe Variable interpoliert würde als. `(host1|host2|host3)` Jeder Wert würde auch mit Regex-Escapes versehen werden. Andernfalls würde ein Wert mit einem Regex-Steuerzeichen den Regex-Ausdruck unterbrechen.

**Variablen mit mehreren Werten und einer Elastic-Datenquelle**

Elasticsearch verwendet die Lucene-Abfragesyntax, sodass dieselbe Variable als formatiert würde. `("host1" OR "host2" OR "host3")` In diesem Fall muss jeder Wert maskiert werden, sodass der Wert nur Lucene-Kontrollwörter und Anführungszeichen enthält.

**Problembehandlung bei Variablen mit mehreren Werten**

Automatisches Escapen und Formatieren können zu Problemen führen, und es kann schwierig sein, die Logik dahinter zu verstehen. Insbesondere für InfluxDB und Prometheus, wo die Verwendung der Regex-Syntax erfordert, dass die Variable im Regex-Operator-Kontext verwendet wird.

Wenn Sie nicht möchten, dass Grafana dieses automatische Regex-Escaping und Formatieren durchführt, müssen Sie einen der folgenden Schritte ausführen:
+ **Deaktivieren Sie die Optionsoptionen **Mehrere Werte oder Alle** einbeziehen.**
+ Verwenden Sie das [unformatierte Variablenformat](https://grafana.com/docs/grafana/latest/dashboards/variables/variable-syntax/#raw).

### Option „Alle einbeziehen“
<a name="v9-dash-variable-add-multi-all"></a>

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
<a name="v9-dash-variable-add-multi-custom"></a>

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
<a name="v9-dash-variable-add-global"></a>

Grafana verfügt über globale integrierte Variablen, die in Ausdrücken im Abfrage-Editor verwendet werden können. Dieses Thema listet sie in alphabetischer Reihenfolge auf und definiert sie. Diese Variablen eignen sich für Abfragen, Dashboard-Links, Bereichsverknüpfungen und Datenverknüpfungen.

**\$1\$1\$1dashboard**

Diese Variable ist der Name des aktuellen Dashboards.

**\$1\$1\$1from und \$1\$1\$1to**

Grafana hat zwei eingebaute Zeitbereichsvariablen: `$__from` und`$__to`. Sie werden derzeit standardmäßig immer als Epochen-Millisekunden interpoliert, aber Sie können die Datumsformatierung steuern.


| Syntax | Beispielergebnis | Description | 
| --- | --- | --- | 
|  `${__from}`  |  1594671549254  |  Unix-Millisekunden-Epoche  | 
|  `${__from:date}`  |  2020-07-13T 20:19:09.254 Z  |  Keine Argumente, standardmäßig ISO 8601/RFC 3339  | 
|  `${__from:date:iso}`  |  2020-07-13T 20:19:09,254 Z  |  ISO 8601/RFC 3339  | 
|  `${__from:date:seconds}`  |  1594671549  |  Unix-Sekunden-Epoche  | 
|  `${__from:date:YYYY-MM}`  |  2020-07  |  Jedes benutzerdefinierte Datumsformat, das das Zeichen: nicht enthält  | 

Die obige Syntax funktioniert auch mit`${__to}`.

**\$1\$1\$1interval**

*Sie können die `$__interval` Variable als Parameter für die Gruppierung nach Zeit (für InfluxDB, MySQL, Postgres, MSSQL), Datumshistogrammintervall (für Elasticsearch) oder als Parameter für die Zusammenfassungsfunktion (für Graphite) verwenden.*

Grafana berechnet automatisch ein Intervall, das zur Gruppierung nach Zeit in Abfragen verwendet werden kann. Wenn es mehr Datenpunkte gibt, als in einem Diagramm dargestellt werden können, können die Abfragen effizienter gestaltet werden, indem sie nach einem größeren Intervall gruppiert werden. Wenn Sie sich beispielsweise ein Diagramm mit Daten aus 3 Monaten ansehen, sind Sie möglicherweise nicht in der Lage, Details auf Minutenebene zu erkennen. Durch die Gruppierung nach Stunden oder Tagen wird die Abfrage effizienter, ohne dass sich dies auf die Darstellung im Diagramm auswirkt. Das `$__interval` wird anhand des Zeitbereichs und der Breite des Diagramms (Anzahl der Pixel) berechnet.

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

Wenn der Zeitraum beispielsweise 1 Stunde beträgt und das Diagramm im Vollbildmodus angezeigt wird, kann das Intervall wie folgt berechnet werden: Punkte werden in Intervallen von 2 Minuten gruppiert. `2m` Wenn der Zeitraum 6 Monate umfasst und das Diagramm im Vollbildmodus angezeigt wird, könnte das Intervall `1d` (1 Tag) sein. Die Punkte werden nach Tagen gruppiert.

In der InfluxDB-Datenquelle `$interval` ist die Legacy-Variable dieselbe Variable. `$__interval`sollte stattdessen verwendet werden.

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

**\$1\$1\$1interval\$1ms**

Diese Variable ist die `$__interval` Variable in Millisekunden, keine Zeichenfolge im Zeitintervallformat. Zum Beispiel, wenn der `$__interval` ist, dann ist `20m` der. `$__interval_ms` `1200000`

**\$1\$1\$1org**

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

**\$1\$1\$1user**

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

**\$1\$1\$1range**

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

**\$1\$1\$1rate\$1interval**

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

**\$1timeFilter oder \$1\$1\$1timeFilter**

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

Dies wird an verschiedenen Stellen verwendet, unter anderem:
+ Die WHERE-Klausel für die InfluxDB-Datenquelle. Grafana fügt es im Abfrage-Editor-Modus automatisch zu InfluxDB-Abfragen hinzu. Sie können es manuell im Texteditor-Modus hinzufügen:. `WHERE $timeFilter`
+ Loggen Sie Analytics-Abfragen in der Azure Monitor-Datenquelle.
+ SQL-Abfragen in MySQL, Postgres und MSSQL.
+ Die `$__timeFilter` Variable wird in der MySQL-Datenquelle verwendet.

## Verkettete Variablen
<a name="v9-dash-variable-add-chained"></a>

*Verkettete Variablen*, auch *verknüpfte Variablen* oder *verschachtelte Variablen* genannt, sind Abfragevariablen mit einer oder mehreren anderen Variablen in ihrer Variablenabfrage. In diesem Abschnitt wird erklärt, wie verkettete Variablen funktionieren, und es werden Links zu Beispiel-Dashboards bereitgestellt, die verkettete Variablen verwenden.

Verkettete Variablenabfragen sind für jede Datenquelle unterschiedlich, aber die Prämisse ist für alle dieselbe. Sie können verkettete Variablenabfragen in jeder Datenquelle verwenden, die sie zulässt.

Extrem komplexe verknüpfte Dashboards mit Vorlagen sind möglich, die 5 oder 10 Ebenen tief sind. Technisch gesehen gibt es keine Begrenzung dafür, wie tief oder komplex Sie gehen können, aber je mehr Links Sie haben, desto größer ist die Abfragelast.

**Bewährte Methoden und Tipps**

Die folgenden Methoden erleichtern die Verwendung Ihrer Dashboards und Variablen.

**Neue verknüpfte Variablen erstellen**
+ Durch das Verketten von Variablen entstehen parent/child Abhängigkeiten. Sie können sie sich als Leiter oder Baum vorstellen.
+ Der einfachste Weg, eine neue verkettete Variable zu erstellen, besteht darin, die Variable zu kopieren, auf der die neue Variable basieren soll. Klicken Sie in der Variablenliste auf das Symbol „**Variable duplizieren**“ rechts neben dem Variableneintrag, um eine Kopie zu erstellen. Anschließend können Sie der Abfrage für die übergeordnete Variable etwas hinzufügen.
+ Neue Variablen, die auf diese Weise erstellt wurden, werden am Ende der Liste angezeigt. Möglicherweise müssen Sie sie an eine andere Position in der Liste ziehen, um sie in eine logische Reihenfolge zu bringen.

**Variable Reihenfolge**

Sie können die Reihenfolge der Variablen in der Variablenliste des Dashboards ändern, indem Sie auf die Aufwärts- und Abwärtspfeile auf der rechten Seite jedes Eintrags klicken. Grafana listet gemäß dieser Liste Variablen-Dropdowns von links nach rechts auf, wobei die Variable ganz links oben steht.
+ Listet Variablen, die keine Abhängigkeiten haben, ganz oben vor ihren untergeordneten Variablen auf.
+ Jede Variable sollte der Variablen folgen, von der sie abhängig ist.
+ Denken Sie daran, dass es in der Benutzeroberfläche keinen Hinweis darauf gibt, welche Variablen Abhängigkeitsbeziehungen haben. Listen Sie die Variablen in einer logischen Reihenfolge auf, um es anderen Benutzern (und Ihnen) zu erleichtern.

**Berücksichtigung der Komplexität**

Je mehr Abhängigkeitsebenen Sie von Variablen haben, desto länger dauert es, Dashboards zu aktualisieren, nachdem Sie Variablen geändert haben.

Wenn Sie beispielsweise eine Reihe von vier verknüpften Variablen (Land, Region, Server, Metrik) haben und Sie einen Stammvariablenwert (Land) ändern, muss Grafana Abfragen für alle abhängigen Variablen ausführen, bevor die Visualisierungen im Dashboard aktualisiert werden.

## Variablen verwalten
<a name="v9-dash-variable-add-manage"></a>

Auf der Variablenseite können Sie Variablen [hinzufügen](https://grafana.com/docs/grafana/latest/dashboards/variables/add-template-variables/) und bestehende Variablen verwalten. Außerdem können Sie Variablen [überprüfen](https://grafana.com/docs/grafana/latest/dashboards/variables/inspect-variable/) und feststellen, ob eine Variable in anderen Variablen oder im Dashboard referenziert (oder verwendet) wird.

**Verschieben:** Sie können eine Variable per Drag-and-Drop in der Liste nach oben oder unten verschieben.

**Klonen:** Um eine Variable zu klonen, klicken Sie in der Symbolgruppe auf der rechten Seite auf das Klonsymbol. Dadurch wird eine Kopie der Variablen mit dem Präfix des Namens der ursprünglichen Variablen erstellt. `copy_of_`

**Löschen: Um** eine Variable zu löschen, klicken Sie in der Gruppe von Symbolen auf der rechten Seite auf das Papierkorbsymbol.

## Filtern Sie Variablen mit Regex
<a name="v9-dash-variable-add-filter"></a>

Mithilfe der Regex-Abfrageoption filtern Sie die Liste der von der Variablenabfrage zurückgegebenen Optionen oder ändern die zurückgegebenen Optionen.

Auf dieser Seite wird gezeigt, wie Regex für filter/modify Werte in der Variablen-Dropdownliste verwendet wird.

Mithilfe der Regex-Abfrageoption filtern Sie die Liste der von der Variablenabfrage zurückgegebenen Optionen oder ändern die zurückgegebenen Optionen. Weitere Informationen finden Sie im Mozilla-Leitfaden zu [regulären](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions) Ausdrücken.

Die folgenden Beispiele zeigen das Filtern anhand der folgenden Liste von Optionen

```
backend_01
backend_02
backend_03
backend_04
```

**Filtern Sie so, dass nur die Optionen zurückgegeben `02` werden, die mit `01` oder enden**

Regex:

```
/
(
01|02 
) 
$/
```

Ergebnis:

```
backend_01
backend_02
```

**Filtern und ändern Sie die Optionen mithilfe einer Regex-Erfassungsgruppe, um einen Teil des Textes zurückzugeben**

Regex:

```
/.* 
(
01|02 
)
/
```

Ergebnis:

```
01
02
```

**Filtern und modifizieren - Prometheus-Beispiel**

Liste der Optionen:

```
up{instance="demo.robustperception.io:9090",job="prometheus"} 1 1521630638000
up{instance="demo.robustperception.io:9093",job="alertmanager"} 1 1521630638000
up{instance="demo.robustperception.io:9100",job="node"} 1 1521630638000
```

Regex:

```
/. *instance="
(
[^"]*
)
.*/
```

Ergebnis:

```
demo.robustperception.io:9090
demo.robustperception.io:9093
demo.robustperception.io:9100
```

**Filtern und ändern Sie mithilfe benannter Text- und Werterfassungsgruppen**

Mithilfe benannter Erfassungsgruppen können Sie separate Teile von „Text“ und „Wert“ aus den von der Variablenabfrage zurückgegebenen Optionen erfassen. Auf diese Weise kann die Variablen-Dropdownliste für jeden auswählbaren Wert einen benutzerfreundlichen Namen enthalten.

Wenn Sie beispielsweise die `node_hwmon_chip_names` Prometheus-Metrik abfragen, `chip_name` ist der viel freundlicher als der Wert. `chip` Also das folgende variable Abfrageergebnis:

```
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_0",chip_name="enp216s0f0np0"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_1",chip_name="enp216s0f0np1"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_2",chip_name="enp216s0f0np2"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_3",chip_name="enp216s0f0np3"} 1
```

Hat den folgenden Regex durchlaufen:

```
/chip_name="(?<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.

## 
<a name="v9-dash-variable-add-inspect"></a>

Auf der Variablenseite können Sie leicht erkennen, ob auf eine Variable in anderen Variablen oder im Dashboard verwiesen (oder verwendet) wird.

Neben jeder Variablen, auf die verwiesen wird oder die verwendet wird, ist ein grünes Häkchen markiert, während bei Variablen, auf die nicht verwiesen wird, ein orangefarbenes Warnsymbol angezeigt wird. Darüber hinaus sind alle referenzierten Variablen mit einem Abhängigkeitssymbol neben dem grünen Häkchen gekennzeichnet. Sie können das Symbol auswählen, um die Abhängigkeitsübersicht anzuzeigen. Die Abhängigkeitsübersicht kann verschoben werden. Sie können die Ansicht mit dem Mausrad oder etwas Ähnlichem vergrößern oder verkleinern.

# Syntax von Variablen
<a name="v9-dash-variable-syntax"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Paneltitel und metrische Abfragen können sich auf Variablen beziehen, die zwei unterschiedliche Syntaxen verwenden.
+ `$varname`— Diese Syntax ist leicht zu lesen, erlaubt es Ihnen jedoch nicht, eine Variable in der Mitte eines Wortes zu verwenden.

  **Beispiel**: `apps.frontend.$server.requests.count`
+ `${var_name}`— Verwenden Sie diese Syntax, wenn Sie eine Variable in der Mitte eines Ausdrucks verwenden möchten.
+ `${var_name:<format>}`— Dieses Format gibt Ihnen mehr Kontrolle darüber, wie Grafana Werte interpretiert. Weitere Informationen finden Sie unter *Erweiterte Optionen für das Variablenformat*.
+ `[[varname]]`— Nicht verwenden. Diese Syntax ist alt und veraltet. Es wird in einer future Version entfernt.

Bevor Abfragen an Ihre Datenquelle gesendet werden, wird die Abfrage *interpoliert*, was bedeutet, dass die Variable durch ihren aktuellen Wert ersetzt wird. Während der Interpolation kann der Variablenwert maskiert *werden*, um der Syntax der Abfragesprache und dem Verwendungszweck zu entsprechen. Beispielsweise wird eine Variable, die in einem Regex-Ausdruck in einer InfluxDB- oder Prometheus-Abfrage verwendet wird, mit Regex-Escapes versehen.

**Erweiterte Optionen für das Variablenformat**

Die Formatierung der Variableninterpolation hängt von der Datenquelle ab, es gibt jedoch Situationen, in denen Sie möglicherweise die Standardformatierung ändern möchten.

Die Standardeinstellung für die MySQL-Datenquelle besteht beispielsweise darin, mehrere Werte durch Kommas getrennt durch Anführungszeichen zu verbinden:. `'server01','server02'` In einigen Fällen möchten Sie vielleicht eine durch Kommas getrennte Zeichenfolge ohne Anführungszeichen verwenden:. `server01,server02` Sie können dies mit den unten aufgeführten erweiterten Optionen zur Formatierung von Variablen erreichen.

**Allgemeine Syntax**

Syntax: `${var_name:option}`

Wenn eine ungültige Formatierungsoption angegeben ist, `glob` ist dies die default/fallback Option.

**CSV**

Formatiert Variablen mit mehreren Werten als kommagetrennte Zeichenfolge.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:csv}'
Interpolation result:  'test1,test2'
```

**Verteilt - OpenTSDB**

Formatiert Variablen mit mehreren Werten in einem benutzerdefinierten Format für OpenTSDB.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:distributed}'
Interpolation result:  'test1,servers=test2'
```

**Doppeltes Anführungszeichen**

Formatiert ein- und mehrwertige Variablen in eine durch Kommas getrennte Zeichenfolge, maskiert jeden Wert mit `\"` und setzt jeden Wert mit `"` in Anführungszeichen. `"`

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:doublequote}'
Interpolation result:  '"test1","test2"'
```

**Glob - Graphit**

Formatiert Variablen mit mehreren Werten in einen Glob (für Graphite-Abfragen).

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:glob}'
Interpolation result:  '{test1,test2}'
```

**JSON**

Formatiert Variablen mit mehreren Werten als kommagetrennte Zeichenfolge.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:json}'
Interpolation result:  '["test1", "test2"]'
```

**Lucene - Elasticsearch**

Formatiert Variablen mit mehreren Werten im Lucene-Format für Elasticsearch.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:lucene}'
Interpolation result:  '("test1" OR "test2")'
```

**Prozentualer Code**

Formatiert ein- und mehrwertige Variablen zur Verwendung in URL-Parametern.

```
servers = [ 'foo()bar BAZ',  'test2' ]
String to interpolate:  '${servers:percentencode}'
Interpolation result:  'foo%28%29bar%20BAZ%2Ctest2'
```

**Pfeife**

Formatiert Variablen mit mehreren Werten in eine durch Pipe getrennte Zeichenfolge.

```
servers = [ 'test1.',  'test2' ]
String to interpolate:  '${servers:pipe}'
Interpolation result:  'test1.|test2'
```

**Roh**

Deaktiviert datenquellenspezifische Formatierungen, z. B. einfache Anführungszeichen in einer SQL-Abfrage.

```
servers = [ 'test.1',  'test2' ]
String to interpolate:  '${var_name:raw}'
Interpolation result:  'test.1,test2'
```

**Regex**

Formatiert Variablen mit mehreren Werten in eine Regex-Zeichenfolge.

```
servers = [ 'test1.',  'test2' ]
String to interpolate:  '${servers:regex}'
Interpolation result:  '(test1\.|test2)'
```

**Einfaches Anführungszeichen**

Formatiert ein- und mehrwertige Variablen in eine durch Kommas getrennte Zeichenfolge, maskiert jeden Wert mit und setzt jeden Wert mit `'` in `\'` Anführungszeichen. `'`

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:singlequote}'
Interpolation result:  "'test1','test2'"
```

**SQL-String**

Formatiert ein- und mehrwertige Variablen in eine durch Kommas getrennte Zeichenfolge, maskiert jeden Wert mit `''` und setzt jeden Wert mit `'` in Anführungszeichen. `'`

```
servers = [ "test'1",  "test2" ]
String to interpolate:  '${servers:sqlstring}'
Interpolation result:  "'test''1','test2'"
```

**Text**

Formatiert ein- und mehrwertige Variablen in ihre Textdarstellung. Für eine einzelne Variable wird nur die Textdarstellung zurückgegeben. Bei Variablen mit mehreren Werten wird die Textdarstellung in Kombination mit `+` zurückgegeben.

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:text}'
Interpolation result:  "test1 + test2"
```

**Abfrageparameter**

Formatiert ein- und mehrwertige Variablen in ihre Darstellung der Abfrageparameter. Beispiel: `var-foo=value1&var-foo=value2`

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:queryparam}'
Interpolation result:  "var-servers=test1&var-servers=test2"
```

# Bewertung der Dashboard-Nutzung
<a name="v9-dash-assess-dashboard-usage"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Mithilfe von Nutzungsinformationen können Sie besser verstehen, wie Ihre Grafana-Instanz verwendet wird.

Die Funktion Usage Insights sammelt eine Reihe aggregierter Daten und speichert sie in der Datenbank.
+ Dashboard-Ansichten (aggregiert und pro Benutzer)
+ Fehler in der Datenquelle
+ Datenquellenabfragen

Die aggregierten Daten bieten Ihnen Zugriff auf verschiedene Funktionen, darunter Einblicke in das Dashboard und die Datenquelle, die Präsenzanzeige, das Sortieren von Dashboards anhand von Insight-Daten und die Visualisierung von Nutzungsdaten in einem Dashboard.

Diese Funktion generiert auch detaillierte Protokolle, die nach Loki exportiert werden können.

## Einblicke in das Dashboard und die Datenquelle
<a name="v9-dash-insights"></a>

Für jedes Dashboard und jede Datenquelle können Sie auf Nutzungsinformationen zugreifen.

**Einblicke in das Dashboard**

Um Informationen zur Nutzung des Dashboards zu sehen, klicken Sie in der oberen Leiste auf **Dashboard-Einblicke**.

Dashboard-Einblicke zeigen die folgenden Informationen.
+ **Statistiken**: Die Anzahl der täglichen Abfragen und Fehler in den letzten 30 Tagen.
+ **Benutzer und Aktivität**: Die Anzahl der täglichen Aufrufe der letzten 30 Tage, der letzten Aktivitäten im Dashboard und der letzten Benutzer (mit einem Limit von 20).

**Einblicke in die Datenquelle**

Einblicke in Datenquellen liefern Informationen darüber, wie eine Datenquelle in den letzten 30 Tagen verwendet wurde, z. B.:
+ Abfragen pro Tag
+ Fehler pro Tag
+ Ladezeit der Abfrage pro Tag (gemittelt in ms)

So finden Sie Erkenntnisse zu Datenquellen:

1. Gehen Sie zur Listenansicht der **Datenquellen**.

1. Klicken Sie auf **Datenquelle**.

1. Klicken Sie auf den Tab **Einblicke**.

## Anwesenheitsanzeige
<a name="v9-dash-presence-indicator"></a>

Wenn Sie sich anmelden und sich ein Dashboard ansehen, können Sie anhand einer Anwesenheitsanzeige, die Avatare von Benutzern anzeigt, die kürzlich mit dem Dashboard interagiert haben, feststellen, wer dasselbe Dashboard wie Sie betrachtet. Der Standardzeitrahmen ist 10 Minuten. Um den Namen des Benutzers zu sehen, bewegen Sie den Mauszeiger über den Avatar des Benutzers. Die Avatare stammen von [Gravatar](https://gravatar.com/) und basieren auf der E-Mail-Adresse des Benutzers.

Wenn sich auf einem Dashboard mehr aktive Benutzer befinden, als in die Präsenzanzeige passen, klicken Sie auf das **\$1X-Symbol**. Dadurch werden die Dashboard-Einblicke geöffnet, die weitere Details zu den jüngsten Benutzeraktivitäten enthalten.

## Sortieren von Dashboards anhand von Insights-Daten
<a name="v9-dash-sort-dashboards"></a>

In der Suchansicht können Sie Insights-Daten verwenden, um die am häufigsten verwendeten, defekten und ungenutzten Dashboards zu finden.
+ Gesamtzahl der Fehler
+ Fehler 30 Tage
+ Gesamtzahl der Aufrufe
+ Aufrufe 30 Tage

# Durchsuchen von Dashboards in Grafana-Version 9
<a name="v9-search"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Sie können anhand des Dashboard-Namens und des Panel-Titels nach Dashboards suchen. Wenn Sie nach Dashboards suchen, gibt das System alle in der Grafana-Instanz verfügbaren Dashboards zurück, auch wenn Sie nicht berechtigt sind, den Inhalt des Dashboards anzuzeigen.

## Durchsuchen Sie Dashboards anhand des Dashboard-Namens
<a name="v9-search-by-name"></a>

Geben Sie einen beliebigen Teil des Dashboard-Namens in die Suchleiste ein. Die Suche gibt Ergebnisse für jede teilweise übereinstimmende Zeichenfolge in Echtzeit zurück, während Sie tippen.

Die Dashboard-Suche ist:
+ Echtzeit
+ Groß-/Kleinschreibung wird *nicht* beachtet
+ Funktioniert in allen gespeicherten und dateibasierten Dashboards.

**Tipp**  
Sie können die Pfeiltasten Ihrer Tastatur verwenden, um in den Ergebnissen zu navigieren, und drücken`Enter`, um das ausgewählte Dashboard zu öffnen.

## Durchsuchen Sie Dashboards anhand des Panel-Titels
<a name="v9-search-by-title"></a>

Sie können anhand des Titels eines Panels, der in einem Dashboard angezeigt wird, nach einem Dashboard suchen. Wenn der Titel eines Panels mit Ihrer Suchabfrage übereinstimmt, wird das Dashboard in den Suchergebnissen angezeigt.

## Filtern Sie die Dashboard-Suchergebnisse nach Tags
<a name="v9-search-by-tag"></a>

Tags sind eine hervorragende Möglichkeit, Ihre Dashboards zu organisieren, insbesondere wenn die Anzahl der Dashboards zunimmt. **Sie können Tags in den Dashboard-Einstellungen hinzufügen und verwalten.**

Wenn Sie mehrere Tags auswählen, zeigt Grafana Dashboards an, die alle ausgewählten Tags enthalten.

Führen Sie einen der folgenden Schritte aus, um das Dashboard-Suchergebnis nach einem Tag zu filtern:
+ Um die Dashboard-Suchergebnisse nach Tag zu filtern, wählen Sie ein Tag aus, das in der rechten Spalte der Suchergebnisse angezeigt wird.

  Sie können mit dem Filtern fortfahren, indem Sie zusätzliche Tags auswählen.
+ Um eine Liste aller verfügbaren Tags zu sehen, klicken Sie auf das Dropdownmenü Nach **Stichwörtern filtern** und wählen Sie ein Tag aus.

  Alle Tags werden angezeigt, und wenn Sie ein Tag auswählen, wird die Dashboard-Suche sofort gefiltert.

**Tipp**  
Wenn Sie nur eine Tastatur verwenden, drücken Sie die `tab` Taste und navigieren Sie zum Dropdownmenü Nach **Tag filtern**. Drücken Sie die Abwärtspfeiltaste, um das Menü zu aktivieren und nach einem Tag zu suchen, und drücken Sie, `Enter` um das Tag auszuwählen.