

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 10
<a name="v10-dashboards"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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](v10-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](v10-dash-using-dashboards.md)
+ [Dashboards erstellen](v10-dash-building-dashboards.md)
+ [Verwaltung von Dashboards](v10-dash-managing-dashboards.md)
+ [Playlisten verwalten](v10-dash-managing-playlists.md)
+ [Dashboards und Panels teilen](v10-dash-sharing.md)
+ [Variablen](v10-dash-variables.md)
+ [Bewertung der Dashboard-Nutzung](v10-dash-assess-dashboard-usage.md)
+ [Probleme mit Dashboards beheben](v10-dash-troubleshoot.md)
+ [Durchsuchen von Dashboards in Grafana-Version 10](v10-search.md)

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

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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="v10-dash-features"></a>

Mithilfe von Dashboards können Sie die Darstellung Ihrer Daten anpassen. Die folgende Abbildung zeigt die Dashboard-Oberfläche im Amazon Managed Grafana-Arbeitsbereich.

![\[Ein Bild, das die Oberfläche für Dashboards in einem Amazon Managed Grafana-Arbeitsbereich zeigt, mit Markierungen für die Schaltflächen für verschiedene Funktionen.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/AMG-dashboard-overview-v10.png)



|  Feature  |  Description  | 
| --- | --- | 
| **1. Home** | Wählen Sie das Grafana-Startsymbol aus, um auf die in der Grafana-Instanz konfigurierte Startseite umgeleitet zu werden. | 
| **2. Titel** | Wenn Sie den Dashboard-Titel auswählen, können Sie nach Dashboards suchen, die sich im aktuellen Ordner befinden. | 
| **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. Dashboard speichern** | Wählen Sie das Symbol Speichern, um die Änderungen an Ihrem Dashboard zu speichern. | 
| **6. Einblicke in das Dashboard** | Wählen Sie, ob Sie Analysen zu Ihrem Dashboard anzeigen möchten, einschließlich Informationen zu Benutzern, Aktivitäten und Anzahl der Abfragen. Weitere Informationen finden Sie unter [Bewertung der Dashboard-Nutzung](v10-dash-assess-dashboard-usage.md). | 
| **7. Einstellungen des Dashboards** | Verwenden Sie diese Option, um den Namen, den Ordner oder die Tags des Dashboards zu ändern und Variablen und Annotationsabfragen zu verwalten. Weitere Informationen zu den Dashboard-Einstellungen finden Sie unter[Dashboard-Einstellungen ändern](v10-dash-modify-settings.md). | 
| **8. Drop-down-Menü für die Zeitauswahl** |  Dient zur Auswahl relativer Zeitbereichsoptionen und zur Festlegung benutzerdefinierter absoluter Zeitbereiche. Sie können die Einstellungen für **Zeitzone** und **Geschäftsjahr** in den Steuerelementen für den Zeitraum ändern, indem Sie auf die Schaltfläche **Zeiteinstellungen ändern** klicken. Die Zeiteinstellungen werden pro Dashboard gespeichert.  | 
| **9. Zeitbereich verkleinern** |  Dient zum Verkleinern des Zeitbereichs. Weitere Informationen zur Verwendung von Steuerelementen für den Zeitbereich finden Sie unter[Zeitbereich für das Dashboard einstellen](#v10-dash-setting-dashboard-time-range).  | 
| **10. Dashboard aktualisieren** | Wählen Sie diese Option, um sofort Abfragen auszulösen und die Dashboard-Daten zu aktualisieren. | 
| **11. Aktualisieren Sie das Dashboard-Zeitintervall** | Wählen Sie ein Zeitintervall für die auto Aktualisierung des Dashboards aus. | 
| **12. Modus anzeigen**  | Wählen Sie diese Option, um das Dashboard auf einem großen Bildschirm wie einem Fernseher oder einem Kiosk anzuzeigen. Im Anzeigemodus werden irrelevante Informationen wie Navigationsmenüs ausgeblendet.  | 
| **13. Armaturenbrett** |  Der Hauptbaustein eines Dashboards ist das Panel. Um einen neuen Bereich, eine neue Dashboard-Zeile oder einen neuen Bibliotheksbereich hinzuzufügen, wählen Sie **Bereich hinzufügen**. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/v10-dash-using-dashboards.html)  | 
| **14. Legende des Diagramms** | Ändern Sie die Serienfarben, die Y-Achse und die Sichtbarkeit der Serie direkt in der Legende. | 
| **15. 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/v10-dash-using-dashboards.html)  | 

## Tastenkombinationen
<a name="v10-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="v10-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 in der Zeit zurückgehen, relativ zum aktuellen Datum und zur aktuellen Uhrzeit, oder`now`. 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 die folgenden Syntaxen nicht:  
`now+n`für future Zeitstempel.
`now-1n/n`für *Anfang von n bis Ende von n*, weil dies ein absoluter Zeitstempel ist.

**Allgemeine Steuerelemente für den Zeitbereich**

Die Zeitsteuerungen im Dashboard und im Panel 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. die lokale Browserzeit) 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**. Sie können auch aus einer Liste der zuletzt verwendeten absoluten Zeitbereiche wählen.
+ **Ein halbrelativer Zeitraum** kann in den Einstellungen für den absoluten Zeitbereich ausgewählt werden. Um beispielsweise Aktivitäten seit einem bestimmten Datum anzuzeigen, können Sie eine absolute Zeit für die Startzeit und eine relative Zeit (z. B.`now`) für die Endzeit wählen.

  Wenn Sie einen halbreativen Zeitraum verwenden, wird Ihr Dashboard im Laufe der Zeit automatisch und schrittweise verkleinert, sodass mehr Verlauf und weniger Details angezeigt werden. Gleichzeitig werden historische Trends über den gesamten Zeitraum deutlicher, wenn die hohe Datenauflösung abnimmt.
**Anmerkung**  
Semirelative Zeitbereiche werden von Warnmeldungen nicht unterstützt.
+ **Verkleinern** Sie die Ansicht, indem Sie das Verkleinern-Symbol auswählen (oder indem Sie Cmd\$1Z oder Strg\$1Z als Tastenkombination verwenden). Dadurch wird die Ansicht vergrößert und ein größerer Zeitraum im Dashboard oder in der Bedienfeldvisualisierung angezeigt.
+ **Vergrößern** Sie die Ansicht, indem Sie einen Zeitraum auswählen, den Sie im Diagramm in der Visualisierung anzeigen möchten.
**Anmerkung**  
Das Vergrößern ist nur für Grafikvisualisierungen verfügbar. 

**Aktualisieren Sie die Dashboards**

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](#v10-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="v10-dash-building-dashboards"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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. Ein Dashboard besteht aus [Panels mit](v10-panels-viz.md) Visualisierungen. Jedem Panel ist eine Abfrage zugeordnet, mit der Daten aus einem von Ihnen abgerufen werden können. [Verbinden zu Datenquellen](AMG-data-sources.md)

Sie können interaktivere und dynamischere Dashboards erstellen, indem Sie [Variablen](v10-dash-variables.md) hinzufügen und verwenden. Anstatt die Server-, Anwendungs- oder anderen Namen in Ihren Metrikabfragen fest zu codieren, können Sie stattdessen Variablen verwenden.

**Topics**
+ [Dashboards erstellen](v10-dash-creating.md)
+ [Dashboards importieren](v10-dash-importing.md)
+ [Exportieren von Dashboards](v10-dash-exporting.md)
+ [Dashboard-Einstellungen ändern](v10-dash-modify-settings.md)
+ [URL-Variablen für das Dashboard](v10-dash-dashboard-url-variables.md)
+ [Bibliotheks-Panels verwalten](v10-dash-manage-library-panels.md)
+ [Versionsverlauf des Dashboards verwalten](v10-dash-manage-version-history.md)
+ [Dashboard-Links verwalten](v10-dash-manage-dashboard-links.md)
+ [Visualisierungen kommentieren](v10-dash-annotations.md)
+ [JSON-Modell des Dashboards](v10-dash-dashboard-json-model.md)
+ [Bewährte Methoden für Dashboards](v10-dash-bestpractices.md)

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

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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. Weitere Informationen finden Sie unter [Verbinden zu Datenquellen](AMG-data-sources.md).

 Um ein Dashboard zu erstellen:

1. Melden Sie sich bei Grafana an und wählen Sie im linken **Menü Dashboards** aus.

1. Wählen Sie **Neu** und dann **Neues** Dashboard.

1. Wählen Sie auf dem leeren Dashboard **\$1 Visualisierung hinzufügen** aus. Dadurch wird das neue Visualisierungsdialogfeld geöffnet.

1. Wählen Sie eine Datenquelle aus. Sie können eine vorhandene Datenquelle, eine der integrierten Datenquellen von Grafana zum Testen auswählen oder **Neue Datenquelle konfigurieren** wählen, um eine neue einzurichten (nur Benutzer mit Administratorrechten können neue Datenquellen konfigurieren).

   Die Ansicht des **Bearbeitungsfensters** wird geöffnet, in der Ihre Datenquelle ausgewählt ist. Sie können die Datenquelle für das Bedienfeld später ändern, indem Sie bei Bedarf die Registerkarte „**Abfrage**“ des Bedienfeldeditors verwenden.

1. Schreiben oder erstellen Sie eine Abfrage in der Abfragesprache Ihrer Datenquelle. Wählen Sie das Symbol „Dashboard aktualisieren“, um eine Abfrage an der Datenquelle durchzuführen und die Ergebnisse dabei zu sehen.

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](v10-panels-viz.md).

1. Unter **Panel-Optionen** können Sie einen Titel und eine Beschreibung für Ihr Panel eingeben. 

1. Die meisten Visualisierungen müssen angepasst werden, bevor sie genau die Informationen anzeigen, die Sie benötigen. Sie können die Bedienfeldeinstellungen auf folgende Weise anpassen.
   + [Konfigurieren Sie Wertezuordnungen](v10-panels-configure-value-mappings.md)
   + [Visualisierungsspezifische Optionen](v10-panels-viz.md)
   + [Feldwerte überschreiben](v10-panels-configure-overrides.md)
   + [Schwellenwerte konfigurieren](v10-panels-configure-thresholds.md)
   + [Konfigurieren Sie Standardoptionen](v10-panels-configure-standard-options.md)

1. Wenn Sie mit der Konfiguration Ihres Panels fertig sind, wählen Sie **Speichern**, um das Dashboard zu speichern.

   Wählen Sie alternativ **Anwenden**, um die Änderungen zu sehen, ohne den Panel-Editor zu verlassen.

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.

1. Wählen Sie **Speichern**.

1. Optional können Sie dem Dashboard weitere Bereiche hinzufügen, indem Sie in der Dashboard-Kopfzeile die Option **Hinzufügen** und anschließend im Drop-down-Menü die Option **Visualisierung** auswählen.

**Ein vorhandenes Dashboard wird kopiert**

Sie können schnell ein vorhandenes Dashboard kopieren, um sofort mit der Erstellung eines neuen zu beginnen.

**Um ein vorhandenes Dashboard zu kopieren**

1. Wählen Sie im linken Menü **Dashboards** aus.

1. Wählen Sie das Dashboard aus, das Sie kopieren möchten, um es zu öffnen.

1. Wählen Sie oben rechts im Dashboard **Einstellungen** (Zahnradsymbol) aus.

1. Wählen Sie in der oberen rechten Ecke des Dashboards **Speichern unter** aus.

1. (Optional) Geben Sie den Namen, den Ordner und die Beschreibung an und ob die ursprünglichen Dashboard-Tags für das kopierte Dashboard kopiert werden sollen oder nicht.

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

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

**Um sich wiederholende Zeilen zu konfigurieren**

1. Wählen Sie im linken Menü **Dashboards** aus und wählen Sie dann das Dashboard aus, das Sie ändern möchten.

1. Wählen Sie oben im Dashboard **Hinzufügen** und dann **Zeile** aus der Dropdownliste aus.

   Wenn das Dashboard leer ist, können Sie alternativ die Schaltfläche **\$1 Zeile hinzufügen** in der Mitte des Dashboards auswählen.

1. Bewegen Sie den Mauszeiger über den Zeilentitel und wählen Sie das **angezeigte Einstellungen-Symbol** (Zahnrad) aus.

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. 

1. Wählen Sie **Aktualisieren**.

**Wiederholte Zeilen und die spezielle Dashboard-Datenquelle**

Wenn eine Zeile Bereiche enthält, die die spezielle [Dashboard-Datenquelle](AMG-data-sources.md#AMG-data-sources-special) verwenden — also die Datenquelle, die eine Ergebnismenge aus einem anderen Bereich im selben Dashboard verwendet —, verweisen die entsprechenden Bereiche in wiederholten Zeilen auf den Bereich in der ursprünglichen Zeile, nicht auf die Bereiche in den wiederholten Zeilen.

Zum Beispiel in einem Dashboard:
+ `Row 1`beinhaltet `Panel 1A` und`Panel 1B`.
+ `Panel 1B`verwendet die Ergebnisse `Panel 1A` von unter Verwendung der `Dashboard` Datenquelle.
+ `Row 2`Das Wiederholen beinhaltet `Panel 2A` und`Panel 2B`.
+ `Panel 2B`Verweise`Panel 1A`, nicht`Panel 2A`.

**Um ein Panel zu verschieben**

1. Öffnen Sie das -Dashboard.

1. Wählen Sie den Titel des Bedienfelds aus 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, ziehen Sie an der unteren rechten Ecke des Bedienfelds. Sie können die Größe eines Dashboard-Panels an Ihre Bedürfnisse anpassen.

# Dashboards importieren
<a name="v10-dash-importing"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 vorkonfigurierte Dashboards in Ihren Amazon Managed Grafana-Arbeitsbereich importieren.

**Um ein Dashboard zu importieren**

1. Melden Sie sich in Ihrem Amazon Managed Grafana-Workspace an.

1. Wählen Sie im linken **Menü Dashboards** aus.

1. Wählen Sie **Neu** und dann im Drop-down-Menü **Import** aus.

1. Als Nächstes müssen Sie die zu importierende JSON-Definition des Dashboards auswählen. Sie haben drei Möglichkeiten, JSON zu importieren:
   + Laden Sie eine Datei hoch, die Dashboard-JSON enthält.
   + Kopieren Sie JSON-Text direkt in den Textbereich.
   + Fügen Sie eine Dashboard-URL oder -ID von Grafana Labs in das Feld ein. Weitere Informationen zum Dashboard von grafana.com finden Sie im URLs nächsten Abschnitt.
   + (Optional) Ändern Sie alle Dashboard-Details, die Sie ändern möchten.
   + Wählen Sie bei Bedarf eine Datenquelle aus.
   + Wählen Sie **Importieren** aus.
   + Speichern Sie das Dashboard.

## Dashboards auf grafana.com finden
<a name="v10-dash-import-from-grafana"></a>

Die Seite [Dashboards](https://grafana.com/grafana/dashboards/) auf grafana.com bietet Ihnen Dashboards für gängige Serveranwendungen. Stöbern Sie in einer Bibliothek mit offiziellen und von der Community erstellten Dashboards und importieren Sie sie, um sie schnell einsatzbereit zu machen.

**Anmerkung**  
Um Dashboards von grafana.com zu importieren, muss Ihr Amazon Managed Grafana-Workspace Zugriff auf das Internet haben.

# Exportieren von Dashboards
<a name="v10-dash-exporting"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 die Grafana-Benutzeroberfläche oder die HTTP-API verwenden, um Dashboards zu 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.

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

**Um ein Dashboard zu exportieren**

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

1. Wählen Sie das Symbol „Teilen“ aus.

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

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

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

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

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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

**Um auf die Seite mit den Dashboard-Einstellungen zuzugreifen**

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. 
   + **Zeitzone** — Geben Sie 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.
     + **Standard** — 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.
     + **Lokale Browserzeit** — Die Zeitzone, die für den Browser des betrachtenden Benutzers konfiguriert ist, 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** — Passen Sie 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 verzögern** — Überschreiben Sie die `now` Zeit, indem Sie eine Zeitverzögerung eingeben. Verwenden Sie diese Option, um bekannten Verzögerungen bei der Datenaggregation Rechnung zu tragen und Nullwerte zu vermeiden.
   + **Zeitauswahl ausblenden** — Wählen Sie diese Option, wenn Sie nicht möchten, dass das Dashboard die Zeitauswahl anzeigt.

**Anmerkung**  
Damit Sie über Zeitsteuerungen verfügen 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). Oder für Datenquellen-Plugins, die Sie über das installieren[Finde Plugins im Plugin-Katalog](grafana-plugins.md#plugin-catalog), können Sie die [Dokumentation auf der Grafana Labs-Website](https://grafana.com/docs/grafana/v10.3/datasources/) verwenden.

**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](v10-dash-variables.md).

**Um eine Variable hinzuzufügen**

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. Fügen Sie im Abschnitt **Allgemein** den Namen der Variablen hinzu. 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. 

**Um einen Link hinzuzufügen**

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

1. Geben Sie einen Titel ein und wählen Sie im Feld **Typ** die Option **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**  
Durch die Verwendung von Tags wird ein dynamisches Drop-down-Menü mit Dashboards erstellt, die alle über ein bestimmtes Tag verfügen.

1. Um einen Weblink 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 Dashboard-Linkoptionen aus. 

**JSON-Modell des Dashboards anzeigen**

Ein Dashboard in Grafana wird durch ein JSON-Objekt repräsentiert, das die Metadaten eines Dashboards speichert. Zu den Dashboard-Metadaten gehören Dashboard-Eigenschaften, Metadaten aus Panels, Vorlagenvariablen, Panel-Abfragen usw. Die JSON-Metadaten definieren das Dashboard.

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](v10-dash-dashboard-json-model.md).

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

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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](v10-dash-manage-dashboard-links.md) und [Vorlagen und Variablen](v10-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`.

**Übergeben 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](v10-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](v10-dash-variable-add.md#v10-dash-variable-add-adhoc).

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.

# Bibliotheks-Panels verwalten
<a name="v10-dash-manage-library-panels"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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.

**Um ein Bibliotheksfenster zu erstellen**

1. Öffnen Sie das Bedienfeld, das Sie in ein Bibliotheksfenster konvertieren möchten, im Bearbeitungsmodus.

1. Klicken Sie in den Anzeigeoptionen des Bedienfelds auf den Abwärtspfeil, um mit den Änderungen an der Visualisierung zu beginnen.

1. Wählen Sie **Bibliotheksfenster** und dann **\$1 Bibliotheksfenster erstellen** aus. Dadurch wird das Dialogfeld „Erstellen“ geöffnet.

1. Geben Sie im **Feld Name des Bibliotheksfensters** den gewünschten Namen für das Bedienfeld ein.

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

1. Wählen Sie das **Bedienfeld „Bibliothek erstellen“**, um Ihre Änderungen an der Bibliothek zu speichern.

1. Speichern Sie das Dashboard.

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.

Sie können ein Bibliotheksfenster auch direkt aus dem Bearbeitungsmenü eines beliebigen Bedienfelds erstellen, indem Sie **Mehr...** wählen dann **Bedienfeld „Bibliothek erstellen“**.

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

**Um ein Bibliotheksfenster zu einem Dashboard hinzuzufügen**

1. Wählen Sie im linken Menü **Dashboards** aus.

1. Wählen Sie **Neu** und dann im Drop-down-Menü **Neues Dashboard** aus.

1. Wählen Sie im leeren Dashboard die Option **\$1 Bibliothek importieren** aus. 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.

**Um die Verknüpfung eines Bibliotheksfensters aufzuheben**

1. Wählen Sie im linken **Menü Dashboards** aus.

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

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. Wählen Sie den Titel des Bedienfelds aus (oder bewegen Sie den Mauszeiger auf eine beliebige Stelle im Bedienfeld), um das Aktionsmenü in der oberen rechten Ecke des Bedienfelds anzuzeigen.

1. Wählen Sie **Bearbeiten** aus. Das Panel wird im Bearbeitungsmodus geöffnet.

1. Wählen Sie in der oberen rechten Ecke der Seite die Option **Verknüpfung aufheben** aus.

1. Wählen Sie **Ja, Verknüpfung aufheben**.

**Eine Liste von Bibliotheksfenstern anzeigen**

Sie können eine Liste der verfügbaren Bibliotheksfenster anzeigen und nach einem Bibliotheksfenster suchen.

**Um eine Liste der Bibliotheksfenster anzuzeigen**

1. Wählen Sie im linken Menü **Dashboards** aus.

1. Wählen Sie **Bibliotheksfenster aus.** 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.

**Um ein Bibliotheksfenster zu löschen**

1. Wählen Sie im linken Menü **Dashboards** aus.

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

1. Wählen Sie das Löschsymbol neben dem Namen des Bibliotheksfensters für das Panel, das Sie löschen möchten.

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

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 nicht 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.

**Anmerkung**  
Die letzten 20 Versionen eines Dashboards werden gespeichert.

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. Dadurch wird die Ansicht der Versionsunterschiede geöffnet. Standardmäßig wird eine Zusammenfassung der Änderungen in Textform angezeigt.

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

**Eine zuvor gespeicherte Dashboard-Version wiederherstellen**

Wenn Sie eine zuvor gespeicherte Dashboard-Version wiederherstellen müssen, können Sie entweder auf die Schaltfläche **Wiederherstellen** rechts neben einer Zeile in der Dashboard-Versionsliste klicken oder in der <x>Vergleichsansicht **auf die** Schaltfläche In Version wiederherstellen** klicken. Wenn Sie eine dieser Optionen auswählen, werden Sie aufgefordert, 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. Dadurch wird sichergestellt, dass Ihre vorherigen Dashboard-Versionen von der Änderung nicht betroffen sind.

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

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 Sie den Zeitraum mithilfe einer 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 einzureichen.

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

**Links zu Dashboards hinzufügen**

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

**Um einen Link zu einem Dashboard hinzuzufügen**

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. Wählen Sie **Links** und dann **Dashboard-Link hinzufügen** oder **Neu** aus.

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, zeigt Grafana sie standardmäßig alle oben side-by-side in Ihrem Dashboard an. Wenn Sie diese Option auswählen und einen optionalen Titel hinzufügen, werden die Links in einer Dropdownliste angezeigt.
   + **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](v10-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 die richtigen Daten in Grafana vergrößert.

**Um einen URL-Link zu einem Dashboard hinzuzufügen**

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

1. Wählen Sie **Links** und dann **Dashboard-Link hinzufügen** oder **Neu** aus.

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.
   + **Titel** — Geben Sie den Titel ein, der für den Link angezeigt werden soll.
   + **Tooltip** — Geben Sie den Tooltip ein, den der Link anzeigen 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 Zeitraum 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 einem neuen Tab öffnen** — Wählen Sie diese Option, wenn der Dashboard-Link in einem neuen Tab oder Fenster geöffnet werden soll

1. Wählen Sie **Hinzufügen** aus.

**Einen Dashboard-Link aktualisieren**

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

**Um einen Dashboard-Link zu aktualisieren**

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

1. Ändern Sie die Einstellungen und wählen Sie dann **Aktualisieren**.

**Einen Dashboard-Link duplizieren**

Um einen vorhandenen Dashboard-Link zu duplizieren, wählen Sie das Duplikatsymbol neben dem vorhandenen Link aus, den Sie duplizieren möchten.

**Löschen eines Dashboard-Links**

Um einen vorhandenen Dashboard-Link zu löschen, wählen Sie das Papierkorbsymbol neben dem Link aus, den 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 die richtigen Daten in Grafana vergrößert.

Um die verfügbaren Panel-Links zu sehen, wählen Sie das Symbol rechts neben dem Panel-Titel aus.
+ **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 die richtigen Daten in Grafana vergrößert. 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 Panel, zu dem Sie einen Link hinzufügen möchten.

  1. Wählen Sie das Menü aus und wählen Sie **Bearbeiten**, oder verwenden Sie die Tastenkombination. `e`

  1. Erweitern Sie den Bereich **Panel-Optionen** und scrollen Sie nach unten zu **Panel-Links**.

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

  1. Geben Sie einen **Titel** ein. Dies 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. Drücken Sie `Ctrl+Space` (oder`Cmd+Space`) und wählen Sie das URL-Feld aus, 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. Wählen Sie ein Bedienfeld aus (oder platzieren Sie den Mauszeiger über dem Bedienfeld), um oben rechts im Bedienfeld ein Aktionsmenü anzuzeigen.

  1. Wählen Sie im Menü die Option **Bearbeiten** aus.

     Sie können auch die Tastenkombination verwenden,`e`.

  1. Erweitern Sie den Bereich **Panel-Optionen** und scrollen Sie nach unten zu **Panel-Links**.

  1. Suchen Sie den Link, den Sie ändern möchten, und wählen Sie das **Bearbeitungssymbol** (Stift) daneben aus.

  1. Nehmen Sie nach Bedarf Änderungen vor.

  1. Wählen Sie **Speichern**, um die Änderungen zu speichern und das Fenster zu schließen.

  1. Speichern Sie die Änderungen an Ihrem Dashboard, indem **Sie oben rechts auf Speichern** klicken.
+ **Löschen eines Panel-Links**

  1. Wählen Sie ein Bedienfeld aus (oder platzieren Sie den Mauszeiger über dem Bedienfeld), um oben rechts im Bedienfeld ein Aktionsmenü anzuzeigen.

  1. Wählen Sie im Menü die Option **Bearbeiten** aus.

     Sie können auch die Tastenkombination verwenden,`e`.

  1. Erweitern Sie den Bereich **Panel-Optionen** und scrollen Sie nach unten zu **Panel-Links**.

  1. Suchen Sie den Link, den Sie löschen möchten, und wählen Sie das **X-Symbol** daneben aus.

  1. Wählen Sie oben rechts **Speichern** aus, um Ihre Änderungen im Dashboard zu speichern.

# Visualisierungen kommentieren
<a name="v10-dash-annotations"></a>

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

Anmerkungen bieten eine Möglichkeit, Punkte in einer Visualisierung mit umfangreichen Ereignissen zu markieren. Sie werden in allen Grafikfeldern als vertikale Linien und Symbole visualisiert. Wenn Sie den Mauszeiger über eine Anmerkung bewegen, werden eine Beschreibung des Ereignisses und die Ereignis-Tags angezeigt. Das Textfeld kann Links zu anderen Systemen mit detaillierteren Informationen enthalten.

Sie können Visualisierungen auf drei Arten mit Anmerkungen versehen:
+ Direkt im Panel, mithilfe der [integrierten](#v10-dash-built-in-query) Annotationsabfrage.
+ Verwendung der Grafana-HTTP-API.
+ Konfiguration von Annotationsabfragen in den Dashboard-Einstellungen.

In den ersten beiden Fällen erstellen Sie neue Anmerkungen, während Sie im letzten Fall vorhandene Anmerkungen aus Datenquellen abfragen. Die integrierte Annotationsabfrage unterstützt dies ebenfalls.

In diesem Abschnitt werden die erste und dritte Option erläutert. Informationen zur Verwendung der Grafana-HTTP-API finden Sie [API für Anmerkungen](Grafana-API-Annotations.md) unter.

Anmerkungen werden für die folgenden Visualisierungstypen unterstützt:
+ Zeitreihen 
+ Zeitleiste des Bundesstaates
+ Kerzen

## Erstellen Sie Anmerkungen in Bedienfeldern
<a name="v10-dash-create-annotations-in-panels"></a>

Grafana bietet die Möglichkeit, mithilfe der [integrierten Annotationsabfrage, die in allen Dashboards vorhanden ist, Annotationsereignisse](#v10-dash-built-in-query) direkt aus einem Panel hinzuzufügen. Anmerkungen, die Sie auf diese Weise erstellen, werden in Grafana gespeichert.

Um Anmerkungen direkt im Panel hinzuzufügen:
+ Das Dashboard muss bereits gespeichert sein.
+ Die integrierte Abfrage muss aktiviert sein.

**Um eine Anmerkung hinzuzufügen**

1. Wählen Sie im Dashboard den Bereich aus, zu dem Sie die Anmerkung hinzufügen möchten. Ein Kontextmenü wird angezeigt. 

1. Wählen Sie im Kontextmenü **Anmerkung hinzufügen** aus.

1. (Optional) Fügen Sie eine Beschreibung und Tags für Anmerkungen hinzu.

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

Sie können auch eine Anmerkung hinzufügen, indem Sie bei der Auswahl des Bedienfelds auf `Ctrl` (oder`Cmd`) drücken. Daraufhin wird das Popover **Anmerkung hinzufügen** angezeigt.

**Anmerkungen zur Region**

Sie können auch Anmerkungen erstellen, die sich auf eine Region oder einen bestimmten Zeitraum in einer Visualisierung beziehen.

**Um eine Regionsanmerkung hinzuzufügen**

1. Drücken Sie im Armaturenbrett die Taste `Ctrl` (oder`Cmd`), während Sie einen Bereich des Bedienfelds auswählen.

1.  Fügen Sie eine Beschreibung der Anmerkung und Tags hinzu (optional). 

1.  Klicken Sie auf **Speichern**. 

**Um eine Anmerkung zu bearbeiten**

1. Zeigen Sie im Dashboard mit der Maus auf einen Kommentarindikator in einem Bereich.

1. Wählen Sie im Kommentar-Tooltip das Symbol **Bearbeiten** (Bleistift) aus.

1. Ändern Sie die and/or Beschreibungs-Tags.

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

**Um eine Anmerkung zu löschen**

1. Zeigen Sie im Dashboard mit der Maus auf einen Kommentarindikator in einem Bereich.

1. Wählen Sie im Kommentar-Tooltip das Symbol **Löschen** (Papierkorb) aus.

## Rufen Sie Anmerkungen über die Dashboard-Einstellungen ab
<a name="v10-dash-fetch-annotations"></a>

In den Dashboard-Einstellungen können Sie unter **Anmerkungen** neue Abfragen hinzufügen, um Anmerkungen mithilfe einer beliebigen Datenquelle abzurufen, einschließlich der integrierten Datenanmerkungsdatenquelle. Annotationsabfragen geben Ereignisse zurück, die als Ereignismarkierungen in Diagrammen im gesamten Dashboard visualisiert werden können. 

**Um eine neue Annotationsabfrage hinzuzufügen**

1. Wählen Sie das **Einstellungen-Symbol** (Zahnrad) in der Kopfzeile des Dashboards, um das Einstellungsmenü zu öffnen.

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

1. Klicken Sie auf **Annotationsabfrage hinzufügen**.

1. Geben Sie einen Namen für die Annotationsabfrage ein.

   Dieser Name wird dem Schalter (Kontrollkästchen) zugewiesen, mit dem Sie die Anzeige von Annotationsereignissen aus dieser Abfrage aktivieren können. 

1. Wählen Sie die Datenquelle für die Anmerkungen aus.

   Sie können auch „**Erweiterte Datenquellenauswahl öffnen**“ wählen, um weitere Optionen zu sehen, darunter das Hinzufügen einer neuen Datenquelle (nur für Administratoren verfügbar).

1. Wenn Sie die Annotationsabfrage nicht sofort verwenden möchten, deaktivieren Sie das Kontrollkästchen **Aktiviert**.

1. Wenn Sie nicht möchten, dass der Schalter für die Annotationsabfrage im Dashboard angezeigt wird, aktivieren Sie das Kontrollkästchen **Versteckt**.

1. Wählen Sie eine Farbe für die Ereignismarkierungen aus.

1. Wählen Sie im Drop-down-Menü „**Anzeigen in**“ eine der folgenden Optionen aus:
   + **Alle Bedienfelder** — Die Anmerkungen werden in allen Bereichen angezeigt, die Anmerkungen unterstützen.
   + **Ausgewählte Bedienfelder** — Die Anmerkungen werden auf allen ausgewählten Bedienfeldern angezeigt.
   + **Alle Bedienfelder außer** — Die Anmerkungen werden in allen Bedienfeldern angezeigt, mit Ausnahme der von Ihnen ausgewählten.

1. Konfigurieren Sie die Abfrage.

   Die Abfrageoptionen für Anmerkungen sind für jede Datenquelle unterschiedlich. Informationen zu Anmerkungen in einer bestimmten Datenquelle finden Sie unter[Verbinden zu Datenquellen](AMG-data-sources.md).

## Integrierte Abfrage
<a name="v10-dash-built-in-query"></a>

Nachdem Sie eine Anmerkung hinzugefügt haben, sind sie weiterhin sichtbar. Dies liegt an der integrierten Annotationsabfrage, die in allen Dashboards vorhanden ist. Diese Annotationsabfrage ruft alle Annotationsereignisse ab, die aus dem aktuellen Dashboard stammen und in Grafana gespeichert sind, und zeigt sie in dem Panel an, in dem sie erstellt wurden. Dies schließt Anmerkungen zum Verlauf der Warnmeldungen ein.

Standardmäßig verwendet die integrierte Annotationsabfrage die `Grafana` spezielle Datenquelle, und manuelle Anmerkungen werden nur mit dieser Datenquelle unterstützt. Sie können eine andere Datenquelle in der integrierten Annotationsabfrage verwenden, aber Sie können automatische Anmerkungen nur mit dem Abfrage-Editor für diese Datenquelle erstellen.

Um Anmerkungen direkt zum Dashboard hinzuzufügen, muss diese Abfrage aktiviert sein.

**Um zu bestätigen, dass die integrierte Abfrage aktiviert ist**

1. Wählen Sie das Symbol für die **Dashboard-Einstellungen** (Zahnrad) in der Kopfzeile des Dashboards, um das Menü mit den Dashboard-Einstellungen zu öffnen.

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

1. Suchen Sie die **Abfrage „Anmerkungen und Benachrichtigungen (integriert)**“.

   Wenn vor dem Namen der Abfrage **Deaktiviert** angezeigt wird, müssen Sie den Abfragenamen auswählen, um sie zu öffnen und die Einstellung zu aktualisieren.

**Um zu verhindern, dass Anmerkungen abgerufen und gezeichnet werden**

1. Wählen Sie das Symbol für die **Dashboard-Einstellungen** (Zahnrad) in der Kopfzeile des Dashboards, um das Menü mit den Dashboard-Einstellungen zu öffnen.

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

1. Wählen Sie die **Abfrage „Anmerkungen und Benachrichtigungen (integriert)**“ aus.

1. Wählen Sie den Schalter **Aktiviert**, um ihn auszuschalten.

Wenn Sie ein Dashboard mit der Funktion „**Speichern** unter“ kopieren, erhält es eine neue Dashboard-ID, sodass Anmerkungen, die auf dem Quell-Dashboard erstellt wurden, in der Kopie nicht mehr sichtbar sind. Sie können sie immer noch anzeigen, wenn Sie eine neue **Annotation-Abfrage** hinzufügen und nach Tags filtern. Dies funktioniert jedoch nur, wenn die Anmerkungen im Quell-Dashboard Tags enthielten, nach denen gefiltert werden konnte.

**Abfragen nach Tag filtern**

Sie können mithilfe der `Grafana` Datenquelle neue Abfragen erstellen, um Anmerkungen aus der integrierten Annotationsabfrage abzurufen, indem Sie **Filter by** auf einstellen. `Tags`

Erstellen Sie beispielsweise einen Namen für eine Annotationsabfrage `outages` und geben Sie ein Tag an. `outage` Diese Abfrage zeigt alle Anmerkungen (von einem beliebigen Dashboard oder über eine API) mit dem `outage` Tag an. Wenn in einer Annotationsabfrage mehrere Tags definiert sind, zeigt Grafana nur Anmerkungen an, die allen Tags entsprechen. Um das Verhalten zu ändern, aktivieren Sie **Match any**, und Grafana zeigt Anmerkungen an, die eines der von Ihnen angegebenen Tags enthalten.

 Sie können auch Vorlagenvariablen in der Tag-Abfrage verwenden. Das heißt, wenn Sie ein Dashboard haben, das Statistiken für verschiedene Dienste anzeigt, und eine Vorlagenvariable, die vorgibt, welche Dienste angezeigt werden sollen, können Sie dieselbe Vorlagenvariable in Ihrer Annotationsabfrage verwenden, um nur Anmerkungen für diese Dienste anzuzeigen. 

# JSON-Modell des Dashboards
<a name="v10-dash-dashboard-json-model"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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.

**So zeigen Sie den JSON-Wert eines Dashboards an**

1. Navigieren Sie zu einem Dashboard.

1. Wählen Sie im oberen Navigationsmenü das Symbol für die **Dashboard-Einstellungen** (Zahnrad) aus.

1. Wählen Sie **JSON-Modell** aus.

## JSON-Felder
<a name="v10-dash-json-fields"></a>

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": [],
  "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) | 
| `title` | aktueller Titel des Dashboards | 
| `tags` | mit dem Dashboard verknüpfte Tags, eine Reihe von Zeichenketten | 
| `style` | Thema des Dashboards, wie `dark` oder `light` | 
| `timezone` | Zeitzone des Dashboards, wie `utc` oder `browser` | 
| `editable` | ob ein Dashboard editierbar ist oder nicht | 
| `graphTooltip` | 0 für kein gemeinsames Fadenkreuz oder Tooltip (Standard), 1 für gemeinsames Fadenkreuz, 2 für gemeinsames Fadenkreuz und gemeinsamen Tooltip | 
| `time` | Zeitbereich für das Dashboard, z. B. oder `last 6 hours` `last 7 days` | 
| `timepicker` | Timepicker-Metadaten, Einzelheiten finden Sie im Abschnitt [Timepicker](#v10-dash-json-panels) | 
| `templating` | [Metadaten mit Vorlagen erstellen, weitere Informationen finden Sie im Abschnitt Templating](#v10-dash-json-panels) | 
| `annotations` | Metadaten zu Anmerkungen, wie Sie sie [hinzufügen können, finden Sie unter Anmerkungen](v10-dash-annotations.md) | 
| `refresh` | 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 | 
| `panels` | Anordnung der Bedienfelder (weitere Informationen finden Sie im nächsten Abschnitt) | 

## Felder
<a name="v10-dash-json-panels"></a>

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 bis 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"
  }
```

**Schablonen 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"
      }
    ]
  }
```

In der folgenden Tabelle wird die Verwendung der Vorlagenfelder beschrieben.


| Name | Usage | 
| --- | --- | 
|  `enable`  |  ob Templating aktiviert ist oder nicht  | 
|  `list`  |  ein Array von Objekten, die jeweils eine Vorlagenvariable repräsentieren  | 
|  `allFormat`  |  Format, das beim Abrufen aller Werte aus der Datenquelle verwendet werden soll, einschließlich`wildcard`,, `glob``regex`,`pipe`.  | 
|  `current`  |  zeigt die aktuell ausgewählte Variable text/value auf dem Dashboard  | 
|  `datasource`  |  zeigt die Datenquelle für die Variablen  | 
|  `includeAll`  |  ob die Option „Alle Werte“ verfügbar ist oder nicht  | 
|  `multi`  |  ob mehrere Werte aus der Variablenwerteliste ausgewählt werden können oder nicht  | 
|  `multiFormat`  |  Format, das beim Abrufen von Zeitreihen aus der Datenquelle verwendet werden soll  | 
|  `name`  |  Name der Variablen  | 
|  `options`  |  Eine Reihe von text/value Variablenpaaren, die auf dem Dashboard ausgewählt werden können  | 
|  `query`  |  Datenquellenabfrage, die zum Abrufen von Werten für eine Variable verwendet wird  | 
|  `refresh`  |  konfiguriert, wann eine Variable aktualisiert werden soll  | 
|  `regex`  |  extrahiert einen Teil eines Seriennamens oder eines metrischen Knotensegments  | 
|  `type`  |  Typ der Variablen`custom`,`query`, oder `interval`  | 

# Bewährte Methoden für Dashboards
<a name="v10-dash-bestpractices"></a>

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

Dieser Abschnitt enthält Informationen zu bewährten Methoden für Grafana-Administratoren und Benutzer zum Erstellen und Verwalten von Grafana-Dashboards.

Informationen zu den verschiedenen Arten von Dashboards, die Sie erstellen können, finden Sie in den [Grafana-Dashboards: Eine vollständige Anleitung zu all den verschiedenen Typen, mit denen Sie einen Blogbeitrag auf der Grafana Labs-Website erstellen können](https://grafana.com/blog/2022/06/06/grafana-dashboards-a-complete-guide-to-all-the-different-types-you-can-build/?pg=webinar-getting-started-with-grafana-dashboard-design-amer&plcmt=related-content-1).

**Anmerkung**  
Dieser Abschnitt kann Ihnen helfen, eine Strategie für Ihre Überwachung und Dashboard-Wartung zu entwickeln. Sie kennen sich mit Ihren Systemen am besten aus und sollten diesen Abschnitt als Leitfaden für Ihr Verständnis nutzen. Letztlich liegt es in Ihrer Verantwortung, die beste Strategie für Ihr System zu entwickeln.

## Allgemeine Strategien zur Beobachtbarkeit
<a name="v10-dash-common-observability-strategies"></a>

Wenn Sie viel zu überwachen haben, z. B. eine Serverfarm, benötigen Sie eine Strategie, um zu entscheiden, was wichtig genug für die Überwachung ist. Auf dieser Seite werden verschiedene gängige Methoden beschrieben, mit denen Sie auswählen können, was überwacht werden soll.

Eine logische Strategie ermöglicht es Ihnen, einheitliche Dashboards zu erstellen und Ihre Observability-Plattform einfacher zu skalieren.

**Richtlinien für Strategien**
+ Die USE-Methode sagt Ihnen, wie zufrieden Ihre Maschinen sind, die RED-Methode sagt Ihnen, wie glücklich Ihre Benutzer sind.
+ USE berichtet über die Ursachen von Problemen.
+ RED berichtet über die Benutzererfahrung und es ist wahrscheinlicher, dass Symptome von Problemen gemeldet werden.
+ Beides zu überwachen ist wichtig, um Ihr System zu verstehen. Es hat sich bewährt, eher auf Symptome als auf Ursachen aufmerksam zu machen. In der Regel werden Warnmeldungen auf RED-Dashboards konfiguriert.

**USE-Methode**

USE steht für:
+ **Auslastung** — Prozentuale Zeit, in der die Ressource ausgelastet ist, z. B. die CPU-Auslastung des Knotens.
+ **Sättigung** — Umfang der Arbeit, die eine Ressource erledigen muss, häufig Warteschlangenlänge oder Knotenlast.
+ **Fehler** — Anzahl der Fehlerereignisse.

Diese Methode eignet sich am besten für Hardwareressourcen in der Infrastruktur, wie CPU, Arbeitsspeicher und Netzwerkgeräte. Weitere Informationen finden Sie in Brendan Greggs Blogbeitrag [Die](http://www.brendangregg.com/usemethod.html) USE-Methode.

**RED-Methode**

RED steht für:
+ **Rate** — Anfragen pro Sekunde
+ **Fehler** — Anzahl der fehlgeschlagenen Anfragen.
+ **Dauer — Dauer**, die diese Anfragen in Anspruch nehmen, Verteilung der Latenzmessungen.

Diese Methode eignet sich am besten für Dienste, insbesondere für eine Microservices-Umgebung. Instrumentieren Sie für jeden Ihrer Dienste den Code, um diese Metriken für jede Komponente verfügbar zu machen. RED-Dashboards eignen sich gut für Warnmeldungen und. SLAs Ein gut gestaltetes RED-Dashboard ist ein Proxy für die Benutzererfahrung.

Weitere Informationen finden Sie in Tom Wilkies Blogbeitrag [Die RED-Methode: So instrumentieren Sie Ihre Dienste](https://grafana.com/blog/2018/08/02/the-red-method-how-to-instrument-your-services).

**Die vier goldenen Signale**

Laut dem [Google SRE-Handbuch sollten](https://landing.google.com/sre/sre-book/chapters/monitoring-distributed-systems/#xref_monitoring_golden-signals) Sie sich auf diese vier konzentrieren, wenn Sie nur vier Messwerte Ihres benutzerorientierten Systems messen können.

Diese Methode ähnelt der RED-Methode, beinhaltet jedoch die Sättigung.
+ **Latenz** — Zeit, die benötigt wird, um eine Anfrage zu bearbeiten.
+ **Traffic** — Wie stark Ihr System beansprucht wird.
+ **Fehler** — Rate der fehlgeschlagenen Anfragen.
+ **Sättigung** — Wie „voll“ Ihr System ist,

## Reifegradmodell für Dashboard-Management
<a name="v10-dash-management-maturity-model"></a>

Der *Reifegrad des Dashboard-Managements* bezieht sich darauf, wie gut konzipiert und effizient Ihr Dashboard-Ökosystem ist. Wir empfehlen, Ihre Dashboard-Einrichtung regelmäßig zu überprüfen, um festzustellen, wo Sie sich befinden und wie Sie sich verbessern können.

Im Großen und Ganzen kann der Reifegrad eines Dashboards als niedrig, mittel oder hoch definiert werden. 

 Ein Großteil der Inhalte zu diesem Thema stammt aus dem Vortrag [Fool-Proof Kubernetes Dashboards](https://www.youtube.com/watch?v=YE2aQFiMGfY) for Sleep-Deprived Oncalls aus dem KubeCon Jahr 2019. 

**Niedrig — Standardstatus**

Derzeit haben Sie keine kohärente Strategie für das Dashboard-Management. Fast jeder fängt hier an.

Woran erkennst du, dass du hier bist?
+ Jeder kann Ihre Dashboards ändern.
+ Viele kopierte Dashboards, wenig bis gar keine Wiederverwendung von Dashboards.
+ Einmalige Dashboards, die für immer da sind.
+ Keine Versionskontrolle (Dashboard-JSON in der Versionskontrolle).
+ Viel Stöbern nach Dashboards, Suchen nach dem richtigen Dashboard. Das bedeutet, dass Sie viel Zeit damit verschwenden, das Dashboard zu finden, das Sie benötigen.
+ Es gibt keine Benachrichtigungen, die Sie zum richtigen Dashboard weiterleiten.

**Mittel — methodische Dashboards**

In dieser Phase beginnen Sie, Ihre Dashboard-Nutzung mithilfe methodischer Dashboards zu verwalten. Sie haben vielleicht eine Strategie entworfen, aber es gibt einige Dinge, die Sie verbessern könnten.

 Woran erkennen Sie, dass Sie hier sind? 
+ Beugen Sie der Ausbreitung vor, indem Sie Vorlagenvariablen verwenden. Sie benötigen beispielsweise kein separates Dashboard für jeden Knoten, sondern können Abfragevariablen verwenden. Noch besser: Sie können die Datenquelle auch zu einer Vorlagenvariablen machen, sodass Sie dasselbe Dashboard in verschiedenen Clustern und Monitoring-Backends wiederverwenden können.

  Anregungen finden Sie in [Variablen](v10-dash-variables.md) der Beispielliste unter.
+ [Methodische Dashboards, die einer Observabilitätsstrategie entsprechen.](#v10-dash-common-observability-strategies)
+ Hierarchische Dashboards mit Drilldowns zur nächsten Ebene.
+ Das Dashboard-Design spiegelt die Servicehierarchien wider. Sie könnten beispielsweise die RED-Methode mit einer Zeile pro Service verwenden. Die Zeilenreihenfolge könnte den Datenfluss widerspiegeln, wenn Sie im Dashboard nach unten scrollen.
+ Vergleichen Sie ähnlich: Teilen Sie Service-Dashboards auf, wenn die Größe unterschiedlich ist. Stellen Sie sicher, dass aggregierte Metriken wichtige Informationen nicht übertönen.
+ Ausdrucksstarke Diagramme mit sinnvoller Verwendung von Farben und Normalisierung der Achsen, wo immer Sie können.
  + Beispiel für eine aussagekräftige Farbe: Blau bedeutet, dass sie gut ist, Rot bedeutet, dass sie schlecht ist. [Schwellenwerte](v10-panels-configure-thresholds.md) können dabei helfen.
  + Beispiel für die Normalisierung von Achsen: Messen Sie beim Vergleich der CPU-Auslastung in Prozent und nicht anhand der Rohzahl, da Maschinen eine unterschiedliche Anzahl von Kernen haben können. Durch die Normalisierung der CPU-Auslastung anhand der Anzahl der Kerne wird die kognitive Belastung reduziert, da der Betrachter darauf vertrauen kann, dass alle Kerne zu 100% genutzt werden, ohne die Anzahl der Kerne kennen zu müssen. CPUs
+ Gezieltes Surfen reduziert das Rätselraten.
  + Vorlagenvariablen erschweren das zufällige oder ziellose Durchsuchen.
  + Die meisten Dashboards sollten über Warnmeldungen miteinander verknüpft sein.
  + Das Surfen erfolgt über Links. Weitere Informationen finden Sie unter [Dashboard-Links verwalten](v10-dash-manage-dashboard-links.md).
+  Versionsgesteuertes Dashboard-JSON. 

**Hoch — optimierte Nutzung**

In dieser Phase haben Sie Ihre Nutzung der Dashboard-Verwaltung mit einer konsistenten und durchdachten Strategie optimiert. Es erfordert Wartung, aber die Ergebnisse sind es wert.
+ Aktive Reduzierung der Zersiedelung.
  + Überprüfen Sie die vorhandenen Dashboards regelmäßig, um sicherzustellen, dass sie weiterhin relevant sind.
  + Nur genehmigte Dashboards wurden zur Master-Dashboard-Liste hinzugefügt.
  + Nachverfolgung der Nutzung des Dashboards. Sie können [Einblicke in die Nutzung](v10-dash-assess-dashboard-usage.md) nutzen.
+ Konsistenz durch Design.
+ Verwenden Sie Skriptbibliotheken, um Dashboards zu generieren und sicherzustellen, dass Muster und Stil einheitlich sind.
  + Grafonnet (Jsonnet)
  + Grafanalib (Python)
+ Keine Bearbeitung im Browser. Dashboard-Viewer ändern Ansichten mit Variablen.
+ Das Suchen nach Dashboards ist die Ausnahme, nicht die Regel.
+ Führen Sie Experimente und Tests in einer separaten Grafana-Instanz durch, die für diesen Zweck vorgesehen ist, nicht in Ihrer Produktionsinstanz. Wenn sich ein Dashboard in der Testumgebung als nützlich erwiesen hat, fügen Sie dieses Dashboard zu Ihrer Grafana-Hauptinstanz hinzu.

## Bewährte Methoden für die Erstellung von Dashboards
<a name="v10-dash-best-practices-for-creating-dashboards"></a>

In diesem Abschnitt werden einige bewährte Methoden beschrieben, die bei der Erstellung von Grafana-Dashboards befolgt werden sollten.

**Bevor Sie beginnen**

 Hier sind einige Prinzipien, die Sie berücksichtigen sollten, bevor Sie ein Dashboard erstellen. 

**Ein Dashboard sollte eine Geschichte erzählen oder eine Frage beantworten**

Welche Geschichte versuchen Sie mit Ihrem Dashboard zu erzählen? Versuchen Sie, eine logische Abfolge von Daten zu erstellen, z. B. von groß zu klein oder von allgemein zu spezifisch. Was ist das Ziel dieses Dashboards? (Hinweis: Wenn das Dashboard kein Ziel hat, fragen Sie sich, ob Sie das Dashboard wirklich benötigen.)

Halte deine Grafiken einfach und konzentriere dich darauf, die Frage zu beantworten, die du stellst. Wenn Ihre Frage beispielsweise lautet: „Welche Server haben Probleme?“ , dann müssen Sie vielleicht nicht alle Serverdaten anzeigen. Zeige einfach Daten für diejenigen, die Probleme haben.

**Dashboards sollten die kognitive Belastung reduzieren, nicht erhöhen**

Die *kognitive Belastung* gibt im Grunde an, wie intensiv Sie über etwas nachdenken müssen, um es herauszufinden. Sorgen Sie dafür, dass Ihr Dashboard leicht zu interpretieren ist. Andere Benutzer und Ihr future Ich (wenn Sie versuchen herauszufinden, was um 2 Uhr morgens kaputt gegangen ist) werden es zu schätzen wissen.

 Frag dich selbst: 
+ Kann ich sagen, wofür die einzelnen Graphen genau stehen? Ist es offensichtlich oder muss ich darüber nachdenken?
+ Wenn ich das jemand anderem zeige, wie lange wird es dauern, bis sie es herausfinden? Werden sie sich verirren?

**Haben Sie eine Überwachungsstrategie**

Es ist einfach, neue Dashboards zu erstellen. Es ist schwieriger, die Dashboard-Erstellung zu optimieren und einen Plan einzuhalten, aber es lohnt sich. Diese Strategie sollte sowohl für Ihr gesamtes Dashboard-Schema als auch für Konsistenz beim individuellen Dashboard-Design sorgen.

Weitere Informationen finden Sie [unter Allgemeine Beobachtungsstrategien](#v10-dash-common-observability-strategies) und [Reifegrade für das Dashboard-Management](#v10-dash-management-maturity-model).

**Schreiben Sie es auf**

Sobald Sie eine Strategie oder Designrichtlinien haben, schreiben Sie sie auf, um die Konsistenz im Laufe der Zeit aufrechtzuerhalten.

**Bewährte Methoden, die Sie befolgen sollten**
+ Achten Sie beim Erstellen eines neuen Dashboards darauf, dass es einen aussagekräftigen Namen hat.
  + Wenn Sie ein Dashboard zum Spielen oder Experimentieren erstellen, fügen Sie das Wort `TEST` oder `TMP` in den Namen ein.
  + Erwägen Sie, Ihren Namen oder Ihre Initialen in den Dashboard-Namen oder als Tag aufzunehmen, damit die Benutzer wissen, wem das Dashboard gehört.
  + Entfernen Sie temporäre Experiment-Dashboards, wenn Sie mit ihnen fertig sind.
+ Wenn Sie viele ähnliche Dashboards erstellen, sollten Sie sich überlegen, wie Sie diese zur einfacheren Navigation miteinander verknüpfen können. Weitere Informationen finden Sie weiter unten in diesem [Abschnitt unter Bewährte Methoden für die Verwaltung von Dashboards](#v10-dash-best-practices-for-managing-dashboards).
+ Grafana ruft Daten aus einer Datenquelle ab. Ein grundlegendes Verständnis von Datenquellen [Verbinden zu Datenquellen](AMG-data-sources.md) im Allgemeinen und Ihren spezifischen Datenquellen ist wichtig.
+ Vermeiden Sie unnötiges Aktualisieren des Dashboards, um die Belastung des Netzwerks oder des Backends zu reduzieren. Wenn sich Ihre Daten beispielsweise stündlich ändern, müssen Sie die Aktualisierungsrate des Dashboards nicht auf 30 Sekunden festlegen.
+ Verwenden Sie die linke und rechte Y-Achse, wenn Sie Zeitreihen mit unterschiedlichen Einheiten oder Bereichen anzeigen.
+ Fügen Sie Dokumentation zu Dashboards und Panels hinzu.
  + Um einem Dashboard Dokumentation hinzuzufügen, fügen Sie dem Dashboard eine [Visualisierung im Textbereich](v10-panels-text.md) hinzu. Notieren Sie Dinge wie den Zweck des Dashboards, nützliche Links zu Ressourcen und alle Anweisungen, die Benutzer möglicherweise benötigen, um mit dem Dashboard zu interagieren.
  + Um einem Panel Dokumentation hinzuzufügen, bearbeiten Sie die Panel-Einstellungen und fügen Sie eine Beschreibung hinzu. Jeder Text, den Sie hinzufügen, wird angezeigt, wenn Sie den Mauszeiger über den kleinen Text `i` in der oberen linken Ecke des Panels bewegen.
+ Verwenden Sie Ihre Dashboards erneut und sorgen Sie mithilfe von [Vorlagen und](v10-dash-variables.md) Variablen für Konsistenz.
+ Seien Sie vorsichtig beim Stapeln von Diagrammdaten. Die Visualisierungen können irreführend sein und wichtige Daten verbergen. Wir empfehlen, es in den meisten Fällen auszuschalten.

## Bewährte Methoden für die Verwaltung von Dashboards
<a name="v10-dash-best-practices-for-managing-dashboards"></a>

 Auf dieser Seite werden einige bewährte Methoden beschrieben, die bei der Verwaltung von Grafana-Dashboards befolgt werden sollten. 

**Bevor Sie beginnen**

Hier sind einige Prinzipien, die Sie berücksichtigen sollten, bevor Sie mit der Verwaltung von Dashboards beginnen.

**Strategische Beobachtbarkeit**

Es gibt mehrere [gängige Strategien zur Beobachtbarkeit](#v10-dash-common-observability-strategies). Sie sollten sie recherchieren und entscheiden, ob eine davon für Sie funktioniert oder ob Sie sich Ihre eigene einfallen lassen möchten. So oder so, haben Sie einen Plan, schreiben Sie ihn auf und halten Sie sich daran.

Passen Sie Ihre Strategie bei Bedarf an sich ändernde Bedürfnisse an.

**Reifegrad**

Was ist der Reifegrad Ihres Dashboards? Analysieren Sie Ihre aktuelle Dashboard-Einrichtung und vergleichen Sie sie mit dem [Reifegradmodell für das Dashboard-Management](#v10-dash-management-maturity-model). Wenn Sie wissen, wo Sie sich befinden, können Sie leichter entscheiden, wie Sie dorthin gelangen, wo Sie sein möchten.

**Bewährte Methoden, die Sie befolgen sollten**
+ Vermeiden Sie die unkontrollierte Zunahme von Dashboards, d. h. das unkontrollierte Wachstum von Dashboards. Die Vielzahl an Dashboards wirkt sich negativ auf die Zeit aus, bis das richtige Dashboard gefunden ist. Das Duplizieren von Dashboards und das Ändern von „einer Sache“ (schlimmer noch: Beibehaltung der Original-Tags) ist die einfachste Form der Datenflut.
  + Überprüfen Sie die Dashboards regelmäßig und entfernen Sie überflüssige Dashboards.
  + Wenn Sie ein temporäres Dashboard erstellen, vielleicht um etwas zu testen, stellen Sie dem Namen ein Präfix voran. `TEST:` Löschen Sie das Dashboard, wenn Sie fertig sind.
+ Das Kopieren von Dashboards ohne wesentliche Änderungen ist keine gute Idee.
  + Sie verpassen Aktualisierungen des ursprünglichen Dashboards, wie z. B. Änderungen an der Dokumentation, Fehlerkorrekturen oder Ergänzungen zu Metriken.
  + In vielen Fällen werden Kopien erstellt, um die Ansicht einfach durch das Einstellen von Vorlagenparametern anzupassen. Dies sollte stattdessen geschehen, indem ein Link zum Master-Dashboard beibehalten und die Ansicht mit [URL-Parametern](v10-panels-configure-data-links.md#v10-panels-data-link-variables) angepasst wird.
+ Wenn Sie ein Dashboard kopieren müssen, benennen Sie es eindeutig um und kopieren *Sie nicht* die Dashboard-Tags. Tags sind wichtige Metadaten für Dashboards, die bei der Suche verwendet werden. Das Kopieren von Tags kann zu falschen Treffern führen.
+ Pflegen Sie ein Dashboard mit Dashboards oder Querverweis-Dashboards. Dies kann auf verschiedene Arten geschehen: 
  + Erstellen Sie Dashboard-Links, Panels- oder Datenverknüpfungen. Links können zu anderen Dashboards oder zu externen Systemen führen. Weitere Informationen finden Sie unter [Dashboard-Links verwalten](v10-dash-manage-dashboard-links.md).
  +  Fügen Sie einen [Dashboard-Listenbereich](v10-panels-dashboard-list.md) hinzu. Sie können dann anpassen, was Sie sehen, indem Sie nach Schlagwörtern oder Ordnern suchen.
  + Fügen Sie ein [Textfeld](v10-panels-dashboard-list.md) hinzu und verwenden Sie Markdown, um die Anzeige anzupassen. 

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

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 **Dashboards** Ihres Workspace (verfügbar, indem Sie im linken Menü **Dashboards** auswählen) können Sie Dashboard-Verwaltungsaufgaben ausführen, einschließlich der Organisation Ihrer Dashboards in Ordnern.

Weitere Informationen zum Erstellen von Dashboards finden Sie unter. [Dashboards erstellen](v10-dash-building-dashboards.md)

## Dashboards durchsuchen
<a name="v10-dash-browse-dashboards"></a>

Auf der Seite „**Dashboards**“ können Sie Ordner und Dashboards durchsuchen und verwalten. Dies beinhaltet Optionen für:
+ Erstellen Sie Ordner und Dashboards.
+ Verschieben Sie Dashboards zwischen Ordnern.
+ Löschen Sie mehrere Dashboards und Ordner.
+ Navigieren Sie zu einem Ordner.
+ Ordnerberechtigungen verwalten. Weitere Informationen finden Sie unter [Dashboard- und Ordnerberechtigungen](dashboard-and-folder-permissions.md).

## Dashboard-Ordner erstellen
<a name="v10-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. Unterordner ermöglichen es Ihnen, eine verschachtelte Hierarchie in Ihrer Dashboard-Organisation zu erstellen.

**Voraussetzungen**

Stellen Sie sicher, dass Sie über Grafana-Administratorrechte verfügen. Weitere Informationen zu Dashboard-Berechtigungen finden Sie unter[Dashboard- und Ordnerberechtigungen](dashboard-and-folder-permissions.md).

**So erstellen Sie einen Dashboard-Ordner**

1. Melden Sie sich bei Grafana an. 

1. Wählen Sie im linken Menü **Dashboards** aus.

1. Wählen Sie auf der Seite „**Dashboards**“ die Option **Neu** und dann im Drop-down-Menü die Option **Neuer Ordner** aus.

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.

**Um den Namen eines Ordners zu bearbeiten**

1. Wählen Sie im linken Menü **Dashboards** aus.

1. Wählen Sie den Ordner aus, den Sie umbenennen möchten

1. Wählen Sie in der Kopfzeile das Symbol **Titel bearbeiten** (Stift) und aktualisieren Sie den Namen des Ordners.

   Der neue Ordnername wird automatisch gespeichert.

**Ordnerberechtigungen**

Sie können einem Ordner Berechtigungen zuweisen. Das Dashboard im Ordner erbt alle Berechtigungen, die Sie dem Ordner zugewiesen haben. Sie können Organisationsrollen, Teams und Benutzern Berechtigungen zuweisen.

**Um die Berechtigungen für einen Ordner zu ändern**

1. Wählen Sie im linken Menü **Dashboards** aus.

1. Wählen Sie den Ordner in der Liste aus.

1. Wählen Sie auf der Detailseite des Ordners die Option **Ordneraktionen** und dann in der Dropdownliste die Option **Berechtigungen verwalten** aus.

1. Aktualisieren Sie die Berechtigungen wie gewünscht.

Änderungen werden automatisch gespeichert.

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

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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="v10-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.

**Um auf eine Playlist zuzugreifen**

1. Wähle im linken Menü **Playlisten** aus.

1. Wählen Sie eine Playlist aus der Liste der vorhandenen Playlisten aus.

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

**Um eine Playlist zu starten**

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**<playlist name>.

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


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

**Steuerung einer Playlist**

Sie können eine Playlist nach dem Start im **Normal** - oder **TV-Modus** steuern, indem Sie die Navigationsleiste oben auf dem Bildschirm verwenden. 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="v10-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.

**Um eine Playlist zu erstellen**

1. Wählen Sie im linken Menü **Dashboards** aus.

1. Wähle auf der **Playlist-Seite** Playlisten aus.

1. Wähle **Neue Playlist** aus.

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

1. Geben Sie in das Textfeld Intervall ein **Zeitintervall** ein. 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 der 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. Wählen Sie **Speichern**, um Ihre Änderungen zu speichern.

## Eine Playlist speichern
<a name="v10-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.

**Um eine Playlist zu speichern**

1. Wählen Sie im linken Menü **Dashboards** aus.

1. Wählen Sie **Playlisten** aus, um sich die Playlisten anzusehen, die Ihnen zur Verfügung stehen.

1. Wähle 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. Wählen Sie **Speichern**, um Ihre Änderungen zu speichern.

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

Sie können eine Playlist bearbeiten, indem Sie ihren Namen und ihre Intervallzeit aktualisieren und die Reihenfolge der Dashboards hinzufügen, entfernen und neu anordnen, oder Sie können die Playlist löschen.

**Um eine Playlist zu bearbeiten**

1. Wähle auf der **Playlist-Seite Playlist bearbeiten** aus.

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. Wählen Sie **Speichern** aus, um Ihre Änderungen zu speichern.

**Um eine Playlist zu löschen**

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

1. Wähle neben der Playlist, die du löschen möchtest, die Option **Entfernen** aus.

**Um die Reihenfolge der Dashboards in einer Playlist neu anzuordnen**

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

1. Wählen Sie **Speichern** aus, um Ihre Änderungen zu speichern.

**Um ein Dashboard zu entfernen**

1. Wählen Sie **Entfernen**, um ein Dashboard aus der Playlist zu entfernen.

1. Wählen Sie **Speichern**, um Ihre Änderungen zu speichern.

## Eine Playlist im Anzeigemodus teilen
<a name="v10-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.

**Um eine Playlist im Anzeigemodus zu teilen**

1. Wählen Sie im Menü „**Dashboards**“ auf der linken Seite „**Playlisten**“ aus.

1. Wähle neben der **Playlist, die du teilen möchtest, Playlist starten** aus.

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

1. Wählen Sie **Link-Adresse kopieren**, um die URL in Ihre Zwischenablage zu kopieren.

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

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

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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.

Wenn Sie einen Bereich oder ein Dashboard als Snapshot teilen, ist ein Snapshot (der zu dem Zeitpunkt, zu dem Sie den Snapshot aufnehmen, ein Bereich oder ein 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="v10-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.

**Um ein Dashboard zu teilen**

1. Wähle in deinem Workspace im linken Menü **Dashboards** aus.

1. Wähle das Dashboard aus, das du teilen möchtest.

1. Wählen Sie oben auf dem Bildschirm das Symbol „Teilen“ aus.

   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.

**Um einen direkten Link zu teilen**

1. Wählen Sie **Kopieren** aus. 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.

**Um einen Snapshot zu veröffentlichen**

1. Wählen Sie die Registerkarte **Snapshot** aus.

1. Wählen Sie den **lokalen Snapshot** aus.

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 in den Abschnitten Import und Export unter. [Dashboards erstellen](v10-dash-building-dashboards.md)

## Ein Panel teilen
<a name="v10-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.

**Um ein Panel zu teilen**

1. Wählen Sie den Panel-Titel des Panels aus, das Sie teilen möchten. Das Bedienfeldmenü wird geöffnet.

1. Wählen Sie „**Teilen**“ aus. Das Dialogfeld „Teilen“ wird geöffnet und zeigt die Registerkarte **Link** an.

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

**Um einen direkten Link zu verwenden**

1. Wählen Sie **Kopieren**, um die Standard-URL 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.

**Einen Schnappschuss eines Panels veröffentlichen**

Ein Panel-Snapshot ist ein öffentlich zugänglicher Teil eines interaktiven Panels. 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.

**Um einen Snapshot eines Panels zu veröffentlichen**

1. Wählen **Sie im Dialogfeld „Bedienfeld teilen**“ die Registerkarte „**Schnappschuss**“.

1. Wählen Sie **Lokaler Snapshot** aus. 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.

**Um ein Bibliotheksfenster zu erstellen**

1. Wählen Sie das **Bedienfeld „Bibliothek“** aus.

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 Stammordner ausgewählt.

1. Wählen Sie das **Bedienfeld „Bibliothek erstellen“**, um Ihre Änderungen zu speichern.

1. Speichern Sie das Dashboard.

# Variablen
<a name="v10-dash-variables"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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.

**Bewährte Methoden für verschiedene Varianten**
+ 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 wählen standardmäßig den obersten Wert in der Drop-down-Liste aus. Wenn Sie stattdessen einen leeren Wert wählen möchten, ändern Sie die Variableneinstellungen wie folgt:

  1. Aktivieren Sie das Kontrollkästchen „**Alle Optionen einbeziehen**“.

  1. Geben Sie im Feld **Alle Werte benutzerdefiniert** den Wert ein`+`.

**Topics**
+ [Variablen hinzufügen und verwalten](v10-dash-variable-add.md)
+ [Variablen untersuchen](v10-dash-variable-add-inspect.md)
+ [Syntax von Variablen](v10-dash-variable-syntax.md)

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

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 in Grafana aufgeführt.


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

**Topics**
+ [Allgemeine Optionen eingeben](#v10-dash-variable-options)
+ [Eine Abfragevariable hinzufügen](#v10-dash-variable-add-query)
+ [Eine benutzerdefinierte Variable hinzufügen](#v10-dash-variable-add-custom)
+ [Eine Textfeld-Variable hinzufügen](#v10-dash-variable-add-text)
+ [Eine konstante Variable hinzufügen](#v10-dash-variable-add-constant)
+ [Eine Datenquellenvariable hinzufügen](#v10-dash-variable-add-datasource)
+ [Eine Intervallvariable hinzufügen](#v10-dash-variable-add-internal)
+ [Hinzufügen von Ad-hoc-Filtern](#v10-dash-variable-add-adhoc)
+ [Konfigurieren Sie variable Auswahloptionen](#v10-dash-variable-add-selection)
+ [Globale Variablen](#v10-dash-variable-add-global)
+ [Verkettete Variablen](#v10-dash-variable-add-chained)
+ [Variablen verwalten](#v10-dash-variable-add-manage)
+ [Filtern Sie Variablen mit Regex](#v10-dash-variable-add-filter)

## Allgemeine Optionen eingeben
<a name="v10-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 **Neue Variable** 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="v10-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 die Datenquelle bei jedem Laden des Dashboards 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.
   + Die Abfrage muss Werte mit dem Namen `__text` und zurückgeben`__value`. In SQL können Sie beispielsweise eine Abfrage wie verwenden`SELECT hostname AS __text, id AS __value from MyTable`. Abfragen für andere Sprachen variieren je nach Syntax.
   + 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](#v10-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](#v10-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="v10-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](#v10-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. Geben Sie in der Liste **Durch Kommas getrennte Werte** die Werte für diese Variable in einer durch Kommas getrennten Liste ein. Sie können Zahlen, Zeichenketten 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](#v10-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="v10-dash-variable-add-text"></a>

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

**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="v10-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](v10-dash-variable-syntax.md#v10-dash-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="v10-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.

   Sie können auch „**Erweiterte Datenquellenauswahl öffnen**“ wählen, um weitere Optionen zu sehen, darunter das Hinzufügen einer Datenquelle (nur für Administratoren). Weitere Informationen finden Sie unter [Verbinden zu Datenquellen](AMG-data-sources.md).

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

1. (Optional) Geben Sie [Auswahloptionen](#v10-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="v10-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="v10-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.

   Sie können auch **Erweiterte Datenquellenauswahl öffnen** wählen, um weitere Optionen zu sehen, darunter das Hinzufügen einer Datenquelle (nur für Administratoren). Weitere Informationen finden Sie unter [Verbinden zu Datenquellen](AMG-data-sources.md).

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 Variablenoptionen, die es gibt. Anstatt einer regulären Liste von Variablenoptionen können Sie mit dieser Variablen eine Ad-hoc-Abfrage für das gesamte Dashboard erstellen. Filter, die Sie auf diese Weise anwenden, werden auf alle Bereiche im Dashboard angewendet.

## Konfigurieren Sie variable Auswahloptionen
<a name="v10-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="v10-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 wird in diesem Fall so interpoliert, 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 wird als. `(host1|host2|host3)` Jeder Wert ist auch mit Regex-Escapes versehen. 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 wie formatiert ist. `("host1" OR "host2" OR "host3")` In diesem Fall wird jeder Wert maskiert, 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 [Rohformat](v10-dash-variable-syntax.md#v10-dash-variable-syntax-raw).

### Option „Alle einschließen“
<a name="v10-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="v10-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="v10-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, können Sie möglicherweise keine Details auf Minutenebene erkennen. Durch die Gruppierung nach Stunden oder Tagen wird die Abfrage effizienter, ohne dass sich dies auf die Darstellung im Diagramm auswirkt. Das `$__interval` wird anhand des Zeitbereichs und der Breite des Diagramms (Anzahl der Pixel) berechnet.

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

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

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

Die InfluxDB- und Elasticsearch-Datenquellen verfügen über `Group by time interval` Felder, die verwendet werden, um das Intervall fest zu codieren oder das Mindestlimit für die `$__interval` Variable festzulegen (z. B. 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**

Wird 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**

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

**\$1\$1\$1timezone**

Die `$__timezone` Variable gibt die aktuell ausgewählte Zeitzone zurück, entweder `utc` oder einen Eintrag aus der IANA-Zeitzonendatenbank (zum Beispiel). `America/New_York`

Wenn die aktuell ausgewählte Zeitzone *Browserzeit* ist, versucht Grafana, die Zeitzone Ihres Browsers zu ermitteln.

## Verkettete Variablen
<a name="v10-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.

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="v10-dash-variable-add-manage"></a>

Auf der Variablenseite können Sie Variablen hinzufügen und bestehende Variablen verwalten. Außerdem können Sie Variablen [überprüfen](v10-dash-variable-add-inspect.md) 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 Gruppe von Symbolen 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="v10-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**

Für diese Liste von 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
```

Dieser reguläre Ausdruck:

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

Gibt diese Ergebnisse zurück:

```
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 Dropdownliste für Variablen 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.

# Variablen untersuchen
<a name="v10-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="v10-dash-variable-syntax"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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*, der dieser Liste folgt.
+ `[[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, dann `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="v10-dash-assess-dashboard-usage"></a>

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

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

**Einblicke in das Dashboard**

Um Informationen zur Nutzung des Dashboards anzuzeigen, wählen Sie in der oberen Leiste **Dashboard-Einblicke** aus.

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)

**Um Einblicke in Datenquellen zu erhalten**

1. Wähle in der Hauptnavigation deines Workspace **Verbindungen** aus.

1. Wähle **Datenquellen aus**.

1. Wählen Sie eine Datenquelle aus.

1. Wählen Sie den Tab **Insights** aus.

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

Wenn Sie angemeldet sind 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="v10-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. Sie können Dashboards nach folgenden Kriterien sortieren.
+ Ansichten
+ Fehler
+ Ansichten
+ Zeit der Erstellung
+ Uhrzeit aktualisiert

# Probleme mit Dashboards beheben
<a name="v10-dash-troubleshoot"></a>

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

 Verwenden Sie die folgenden Strategien, um häufig auftretende Dashboard-Probleme zu beheben. 

## Das Dashboard ist langsam
<a name="v10-dash-dashboard-is-slow"></a>
+ 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 Anzahl der zurückgegebenen Serien zu reduzieren.
+ Manchmal können Seriennamen sehr groß sein. Dies führt zu größeren Antwortgrößen. Versuchen Sie`alias`, die Größe der zurückgegebenen Seriennamen zu reduzieren.
+ Fragen Sie viele Zeitreihen oder einen langen Zeitraum ab? Beide Bedingungen können dazu führen, dass Grafana oder Ihre Datenquelle viele Daten abruft, was das Dashboard verlangsamen kann. Versuchen Sie, einen oder beide dieser Faktoren zu reduzieren.
+ Ihre Netzwerkinfrastruktur könnte stark belastet sein. Wenn die Langsamkeit nicht konstant ist, kann dies das Problem sein.

## Probleme mit der Aktualisierungsrate des Dashboards
<a name="v10-dash-refresh-rate-issues"></a>

Standardmäßig fragt Grafana Ihre Datenquelle alle 30 Sekunden ab. Wenn Sie jedoch eine niedrige Aktualisierungsrate für Ihre Dashboards festlegen, wird das Backend unnötig stress. In vielen Fällen ist eine häufige Abfrage nicht erforderlich, da die Datenquelle Daten nicht oft genug sendet, sodass alle 30 Sekunden Änderungen vorgenommen werden könnten.

Wir empfehlen Folgendes:
+ Aktivieren Sie die automatische Aktualisierung nur bei Bedarf für Dashboards, Panels oder Variablen. Benutzer können ihren Browser manuell aktualisieren.
+ Wenn Sie eine automatische Aktualisierung benötigen, stellen Sie die Aktualisierungsrate auf einen längeren Zeitraum ein, der sinnvoll ist, z. B. einmal pro Minute, alle 10 Minuten oder jede Stunde.
+ Überprüfen Sie den Zeitbereich Ihres Dashboards. Wenn Ihr Dashboard einen längeren Zeitraum hat, z. B. eine Woche, benötigen Sie wirklich keine automatische Aktualisierung und sollten sie deaktivieren.

## Der Umgang mit oder das Rendern von Nulldaten ist falsch oder verwirrend
<a name="v10-dash-handling-or-rendering-null-data-is-wrong-or-confusing"></a>

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, aber das kann täuschen.

Grafiken, bei denen die Option **Nullwerte Connect** auf **Immer** gesetzt ist, verbinden Linien, bei denen Werte fehlen.

Eine Möglichkeit, dieses Problem zu beheben, besteht darin, Balken anstelle von Linien zu verwenden und die Option **Kein Wert** (unter **Standardoptionen**) auf zu setzen`0`. In diesem Fall werden die fehlenden Daten als Bereiche des Diagramms ohne Daten angezeigt.

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

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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="v10-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="v10-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="v10-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 einem 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.

## Befehlspalette
<a name="v10-search-palette"></a>

Mit der Befehlspalette können Sie Folgendes tun:
+ Suchen und öffnen Sie Dashboards und Ordner.
+ Erstellen Sie Dashboards und Warnungsregeln.
+ Suchen Sie nach Seiten in Grafana.
+ Ändern Sie das Thema auf dunkel oder hell.

Öffnen Sie oben die Befehlspalette und geben Sie ein `ctrl+k` (`cmd+k`in macOS). Sie können die Sucheingabe auch in der Grafana-Navigationsleiste auswählen.

**Anmerkung**  
Um zum vorherigen Schritt zu gelangen, drücken Sie `backspace` bei leerer Befehlspalette.