

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.

# Arbeitet in Grafana-Version 9
<a name="using-grafana-v9"></a>

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

Wenn Sie Ihren Grafana-Workspace erstellen, haben Sie die Wahl, welche Version von Grafana Sie verwenden möchten. In den folgenden Themen wird die Verwendung eines Grafana-Workspace beschrieben, der Version 9 von Grafana verwendet.

**Topics**
+ [Dashboards in Grafana-Version 9](v9-dashboards.md)
+ [Panels und Visualisierungen in Grafana-Version 9](v9-panels.md)
+ [Erkunden Sie in Grafana-Version 9](v9-explore.md)
+ [Benachrichtigungen in Grafana-Version 9](v9-alerts.md)

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

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

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

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

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

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

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

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

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

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


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

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

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

**Fokussiertes Panel**

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

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

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

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

**Zeiteinheiten und relative Bereiche**

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

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

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

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


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

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

**Allgemeine Steuerungen für den Zeitbereich**

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

*Weitere Funktionen für den Zeitbereich*

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

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

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

*Dashboards aktualisieren*

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

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

**Steuern Sie den Zeitraum mithilfe einer URL**

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

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

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

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

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

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

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

**Ein Dashboard erstellen**

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

 Um ein Dashboard zu erstellen:

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

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

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

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

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

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

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

**Konfiguration sich wiederholender Zeilen**

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

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

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

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

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

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

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

**Um ein Panel zu verschieben**

1. Öffnen Sie das -Dashboard.

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

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

1. Öffnen Sie das -Dashboard.

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

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

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

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

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

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

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

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

1. Öffnen Sie ein Dashboard im Bearbeitungsmodus.

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

**Ändern der Zeiteinstellungen im Dashboard**

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

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

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

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

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

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

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

**Hinzufügen einer Annotationsabfrage**

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

**Um eine Annotationsabfrage hinzuzufügen**

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

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

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

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

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

**Eine Variable hinzufügen**

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

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

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

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

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

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

**Einen Link hinzufügen**

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

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

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

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

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

**JSON-Modell des Dashboards anzeigen** 

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

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

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

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

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

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

**Variablen als Abfrageparameter übergeben**

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

Zum Beispiel in dieser URL: 

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

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

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

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

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

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

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

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

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

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

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

Zum Beispiel in dieser URL:

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

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

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

**Steuern des Zeitbereichs mithilfe der URL**

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

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

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

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

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

**Ein Bibliotheksfenster erstellen**

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

1. Öffnen Sie ein Panel im Bearbeitungsmodus.

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

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

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

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

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

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

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

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

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

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

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

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

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

**Die Verknüpfung eines Bibliotheksfensters aufheben**

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

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

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

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

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

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

**Eine Liste von Bibliotheksfenstern anzeigen**

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

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

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

**Löschen eines Bibliotheksfensters**

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

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

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

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

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

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

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

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

**Vergleich von zwei Dashboard-Versionen**

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

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

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

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

**Eine zuvor gespeicherte Dashboard-Version wiederherstellen**

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

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

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

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

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

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

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

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

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

**Steuern des Zeitbereichs mithilfe der URL**

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

**Links zum Dashboard**

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

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

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

**Hinzufügen von Links zu Dashboards**

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

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

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

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

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

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

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

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

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

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

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

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

     Das Variablenformat lautet wie folgt: 

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

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

**Einen Dashboard-Link aktualisieren**

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

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

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

**Einen Dashboard-Link duplizieren**

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

**Löschen eines Dashboard-Links**

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

**Links zu Bedienfeldern**

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

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

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

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

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

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

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

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

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

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

  1. Nehmen Sie nach Bedarf Änderungen vor.

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

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

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

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

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

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

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

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

Um das JSON eines Dashboards anzuzeigen.

1. Navigieren Sie zu einem Dashboard.

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

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

**JSON-Felder**

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

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

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

Im Folgenden wird jedes Feld im Dashboard-JSON beschrieben.


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

**Felder**

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

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

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

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

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

**Timepicker**

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

**Vorlagen erstellen**

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

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

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

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

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

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

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

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

**Voraussetzungen**

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

**Um einen Dashboard-Ordner zu erstellen**

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

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

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

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

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

**Ordnerseite des Dashboards**

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

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

**Dashboard-Berechtigungen**

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

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

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

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

**Ein Dashboard exportieren**

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

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

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

1. Wählen Sie das Share-Symbol.

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

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

**Ein Dashboard portabel machen**

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

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

**Ein Dashboard importieren**

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

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

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

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

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

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

**Das Dashboard ist langsam**

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

**Probleme mit der Aktualisierungsrate des Dashboards**

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

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

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

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

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

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

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

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

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

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

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

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

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

1. Navigieren Sie zur Startseite Ihrer Grafana-Instanz.

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

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

**Einen direkten Link teilen**

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

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

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

**Einen Snapshot veröffentlichen**

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

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

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

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

**Ein Dashboard exportieren**

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

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

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

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

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

**Verwenden Sie einen direkten Link**

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

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

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

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

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

**Einen Snapshot veröffentlichen**

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

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

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

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

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

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

**Erstellen eines Bibliotheksfensters**

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

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

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

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

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

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

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

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

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

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

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

**Zugriff auf eine Playlist**

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

1. **Klicken Sie auf Playlisten.**

   Sie sehen eine Liste der vorhandenen Playlisten.

**Eine Playlist starten**

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

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

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

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

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

   Das Dialogfeld „Playlist starten“ wird geöffnet.

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

1. Klicken Sie auf Start.


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

**Steuerung einer Playlist**

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. Klicke auf die Playlist deiner Wahl.

1. Bearbeiten Sie die Playlist.

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

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

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

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

**Eine Playlist bearbeiten**

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

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

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

**Eine Playlist löschen**

1. Klicken Sie auf **Playlisten**.

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

**Reihenfolge im Dashboard neu anordnen**

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

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

**Ein Dashboard entfernen**

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

**Vorlagen**

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

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

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

**Beispiele**

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

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

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

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

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

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

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


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

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

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

**Um allgemeine Optionen einzugeben**

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

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

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

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

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

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

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

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

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

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

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

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

**Um eine Abfragevariable hinzuzufügen**

1. Geben Sie allgemeine Optionen wie oben ein.

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

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

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

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

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

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

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

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

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

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

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

**Um eine benutzerdefinierte Variable hinzuzufügen**

1. Geben Sie allgemeine Optionen wie oben ein.

1. Im 

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

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

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

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

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

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

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

1. Geben Sie allgemeine Optionen wie oben ein.

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

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

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

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

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

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

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

**Um eine konstante Variable hinzuzufügen**

1. Geben Sie allgemeine Optionen wie oben ein.

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

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

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

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

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

**Um eine Datenquellenvariable hinzuzufügen**

1. Geben Sie allgemeine Optionen wie oben ein.

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

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

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

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

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

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

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

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

**Um eine Intervallvariable hinzuzufügen**

1. Geben Sie allgemeine Optionen wie oben ein.

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

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

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

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

**Beispiele für Intervallvariablen**

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

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

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

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

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

1. Geben Sie allgemeine Optionen wie oben ein.

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

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

**Erstellen Sie Ad-hoc-Filter**

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

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

**Auswahloptionen** sind eine Funktion, mit der Sie die Auswahl variabler Optionen verwalten können. Alle Auswahloptionen sind optional und standardmäßig deaktiviert.

### Variablen mit mehreren Werten
<a name="v9-dash-variable-add-selection-multi"></a>

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

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

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

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

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

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

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

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

**Problembehandlung bei Variablen mit mehreren Werten**

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

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

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

Grafana fügt der Variablen-Dropdownliste eine `All` Option hinzu. Wenn ein Benutzer diese Option auswählt, werden alle Variablenoptionen ausgewählt.

### Benutzerdefinierter Wert für alle
<a name="v9-dash-variable-add-multi-custom"></a>

Diese Option ist nur sichtbar, wenn die **Option Alle einbeziehen** ausgewählt ist.

Geben Sie Regex-, Globs- oder Lucene-Syntax in das Feld **Alle Werte anpassen ein, um den Wert** der Option zu definieren. `All`

Standardmäßig umfasst der `All` Wert alle Optionen in einem kombinierten Ausdruck. Dies kann sehr lang werden und zu Leistungseinbußen führen. Manchmal kann es besser sein, einen benutzerdefinierten All-Wert anzugeben, z. B. einen Platzhalter-Regex.

Um eine benutzerdefinierte Regex-, Globs- oder Lucene-Syntax in der Option **Alle Werte anpassen zu haben, wird sie nie maskiert, sodass Sie sich überlegen müssen, welcher Wert** für Ihre Datenquelle gültig ist.

## Globale Variablen
<a name="v9-dash-variable-add-global"></a>

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

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

Diese Variable ist der Name des aktuellen Dashboards.

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

**Bewährte Methoden und Tipps**

Die folgenden Methoden erleichtern die Verwendung Ihrer Dashboards und Variablen.

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

**Variable Reihenfolge**

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

**Berücksichtigung der Komplexität**

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

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

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

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

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

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

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

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

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

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

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

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

```
backend_01
backend_02
backend_03
backend_04
```

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

Regex:

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

Ergebnis:

```
backend_01
backend_02
```

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

Regex:

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

Ergebnis:

```
01
02
```

**Filtern und modifizieren - Prometheus-Beispiel**

Liste der Optionen:

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

Regex:

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

Ergebnis:

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

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

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

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

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

Hat den folgenden Regex durchlaufen:

```
/chip_name="(?<text>[ ^ " ] + ) |chip=" (?<value >[ ^ " ] + )/g
```

Würde die folgende Drop-down-Liste erzeugen:

```
Display Name          Value
------------          -------------------------
enp216s0f0np0         0000:d7:00_0_0000:d8:00_0
enp216s0f0np1         0000:d7:00_0_0000:d8:00_1
enp216s0f0np2         0000:d7:00_0_0000:d8:00_2
enp216s0f0np3         0000:d7:00_0_0000:d8:00_3
```

Nur Gruppennamen `text` und `value` Capture-Namen werden unterstützt.

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

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

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

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

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

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

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

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

**Erweiterte Optionen für das Variablenformat**

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

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

**Allgemeine Syntax**

Syntax: `${var_name:option}`

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

**CSV**

Formatiert Variablen mit mehreren Werten als kommagetrennte Zeichenfolge.

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

**Verteilt - OpenTSDB**

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

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

**Doppeltes Anführungszeichen**

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

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

**Glob - Graphit**

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

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

**JSON**

Formatiert Variablen mit mehreren Werten als kommagetrennte Zeichenfolge.

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

**Lucene - Elasticsearch**

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

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

**Prozentualer Code**

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

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

**Pfeife**

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

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

**Roh**

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

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

**Regex**

Formatiert Variablen mit mehreren Werten in eine Regex-Zeichenfolge.

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

**Einfaches Anführungszeichen**

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

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

**SQL-String**

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

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

**Text**

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

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

**Abfrageparameter**

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

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

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

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

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

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

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

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

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

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

**Einblicke in das Dashboard**

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

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

**Einblicke in die Datenquelle**

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

So finden Sie Erkenntnisse zu Datenquellen:

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

1. Klicken Sie auf **Datenquelle**.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

# Panels und Visualisierungen in Grafana-Version 9
<a name="v9-panels"></a>

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

 Das *Panel* ist der grundlegende Visualisierungsbaustein in Grafana. Jedes Panel verfügt über einen Abfrage-Editor, der für die im Panel ausgewählte Datenquelle spezifisch ist. Mit dem Abfrage-Editor können Sie eine Abfrage erstellen, die die Daten zurückgibt, die Sie visualisieren möchten. 

 Für jedes Panel gibt es eine Vielzahl von Stil- und Formatierungsoptionen. Bedienfelder können per Drag-and-Drop gezogen und in der Größe verändert werden, um sie auf dem Dashboard neu anzuordnen. 

 Bevor Sie einen Bereich hinzufügen, stellen Sie sicher, dass Sie eine Datenquelle konfiguriert haben. 

Zusätzliche Panel-Typen sind möglicherweise verfügbar, wenn Sie zusätzliche [Plugins](grafana-plugins.md) in Ihrem Workspace installieren.
+  Einzelheiten zur Verwendung bestimmter Datenquellen finden Sie unter[Verbinden zu Datenquellen](AMG-data-sources.md). 

**Topics**
+ [Überblick über den Panel-Editor](v9-panels-editor-overview.md)
+ [Panel-Optionen konfigurieren](v9-panels-configure-panel-options.md)
+ [Standardoptionen konfigurieren](v9-panels-configure-standard-options.md)
+ [Daten abfragen und transformieren](v9-panels-query-xform.md)
+ [Schwellenwerte konfigurieren](v9-panels-configure-thresholds.md)
+ [Datenverknüpfungen konfigurieren](v9-panels-configure-data-links.md)
+ [Feldüberschreibungen konfigurieren](v9-panels-configure-overrides.md)
+ [Wertezuordnungen konfigurieren](v9-panels-configure-value-mappings.md)
+ [Eine Legende konfigurieren](v9-panels-configure-legend.md)
+ [Berechnungsarten](v9-panels-calculation-types.md)
+ [Visualisierungen kommentieren](v9-panels-annotate-visualizations.md)
+ [Die Ansicht „Panel inspizieren“](v9-panels-panel-inspector.md)
+ [Visualisierungen verfügbar in Grafana-Version 9](v9-panels-viz.md)

# Überblick über den Panel-Editor
<a name="v9-panels-editor-overview"></a>

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

 In diesem Abschnitt werden die Bereiche des Grafana-Panel-Editors beschrieben. 
+  Panel-Header: Der Header-Bereich listet das Dashboard auf, in dem das Panel angezeigt wird, sowie die folgenden Steuerelemente: 
  +  **Symbol für Dashboard-Einstellungen (Zahnrad):** Klicken Sie hier, um auf die Dashboard-Einstellungen zuzugreifen. 
  +  **Verwerfen:** Verwirft Änderungen, die Sie seit dem letzten Speichern des Dashboards am Panel vorgenommen haben. 
  +  **Speichern:** Speichert die Änderungen, die Sie am Panel vorgenommen haben. 
  +  **Anwenden:** Wendet die von Ihnen vorgenommenen Änderungen an und schließt den Panel-Editor, sodass Sie wieder zum Dashboard zurückkehren. Sie müssen das Dashboard speichern, um die angewendeten Änderungen beizubehalten. 
+  Visualisierungsvorschau: Der Bereich Visualisierungsvorschau enthält die folgenden Optionen: 
  +  **Tabellenansicht:** Konvertiert jede Visualisierung in eine Tabelle, sodass Sie die Daten sehen können. Tabellenansichten sind bei der Problembehandlung hilfreich. Diese Ansicht enthält nur die Rohdaten. Sie enthält keine Transformationen, die Sie möglicherweise auf die Daten angewendet haben, oder die in der [Tabellenvisualisierung](v9-panels-table.md) verfügbaren Formatierungsoptionen. 
  +  **Füllen:** Die Visualisierungsvorschau füllt den verfügbaren Platz aus. Wenn Sie die Breite des Seitenbereichs oder die Höhe des unteren Bereichs ändern, ändert sich die Visualisierung, sodass sie den verfügbaren Platz ausfüllt. 
  +  **Aktuell:** Die Visualisierungsvorschau hat genau die Größe auf dem Dashboard. Wenn nicht genügend Speicherplatz verfügbar ist, wird die Visualisierung unter Beibehaltung des Seitenverhältnisses herunterskaliert. 
  +  **Steuerelemente für den Zeitbereich:** Die **Standardeinstellung** ist entweder die lokale Zeitzone des Browsers oder die auf einer höheren Ebene ausgewählte Zeitzone. 
+  Datenbereich: Der Datenbereich enthält Registerkarten, auf denen Sie Abfragen eingeben, Ihre Daten transformieren und Warnungsregeln erstellen können (falls zutreffend). 
  +  **Registerkarte „Abfrage“:** Wählen Sie Ihre Datenquelle aus und geben Sie hier Abfragen ein. 
  +  **Registerkarte „Transformieren“:** Wenden Sie Datentransformationen an. 
  +  **Registerkarte „Warnung“:** Schreiben Sie Warnungsregeln. 
+  Anzeigeoptionen für Bedienfelder: Der Abschnitt mit den Anzeigeoptionen enthält Registerkarten, auf denen Sie fast jeden Aspekt Ihrer Datenvisualisierung konfigurieren können. 

## Öffnen Sie das Panel und überprüfen Sie die Schublade
<a name="v9-panels-editor-open-panel"></a>

 Die Inspektionsschublade hilft Ihnen dabei, Ihre Panels zu verstehen und Fehler zu beheben. Sie können die Rohdaten für jedes Panel anzeigen, diese Daten in eine Datei mit kommagetrennten Werten (CSV) exportieren, Abfrageanfragen anzeigen und Panel- und Daten-JSON exportieren. 

 **Hinweis:** Nicht alle Bedienfeldtypen enthalten alle Registerkarten. Zum Beispiel enthalten die Listenbereiche des Dashboards keine Rohdaten, die überprüft werden können, sodass die Registerkarten Statistik, Daten oder Abfrage nicht angezeigt werden. 

 Der Bedienfeldinspektor besteht aus den folgenden Optionen: 
+  In der Schubladenanzeige mit Panelinspektion wird auf der rechten Seite eine Schublade geöffnet. Klicken Sie auf den Pfeil in der oberen rechten Ecke, um das Schubladenfenster zu vergrößern oder zu verkleinern. 
+  **Registerkarte „Daten“ —** Zeigt die Rohdaten an, die von der Abfrage mit angewendeten Transformationen zurückgegeben wurden. Feldoptionen wie Überschreibungen und Wertzuordnungen werden standardmäßig nicht angewendet. 
+  **Registerkarte „Statistiken“ —** Zeigt an, wie lange Ihre Abfrage dauert und wie viel sie zurückgibt. 
+  **Registerkarte JSON —** Ermöglicht das Anzeigen und Kopieren von Panel-JSON, Panel-Daten-JSON und Datenrahmenstruktur JSON. Dies ist nützlich, wenn Sie Grafana bereitstellen oder verwalten. 
+  **Registerkarte „Abfrage“ —** Zeigt Ihnen die Anfragen an den Server an, die gesendet wurden, wenn Grafana die Datenquelle abfragt. 
+  **Registerkarte „Fehler“ —** Zeigt den Fehler an. Nur sichtbar, wenn die Abfrage einen Fehler zurückgibt. 

# Panel-Optionen konfigurieren
<a name="v9-panels-configure-panel-options"></a>

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

 Ein Grafana-Panel ist die Benutzeroberfläche, mit der Sie eine Datenquellenabfrage definieren und Daten, die in Visualisierungen angezeigt werden, transformieren und formatieren. 

 Ein Panel-Editor umfasst einen Abfragegenerator und eine Reihe von Optionen, mit denen Sie Daten transformieren und Informationen zu Ihren Panels hinzufügen können. 

 In diesem Thema wird beschrieben, wie Sie: 
+  Öffnen Sie ein Fenster zur Bearbeitung 
+  Fügen Sie einen Panel-Titel und eine Beschreibung hinzu 
+  Ein Panel-JSON-Modell anzeigen 
+  Fügen Sie sich wiederholende Zeilen und Bereiche hinzu 

## Bearbeiten Sie ein Panel
<a name="v9-panels-edit-a-panel"></a>

 Nachdem Sie einem Dashboard einen Bereich hinzugefügt haben, können Sie ihn jederzeit öffnen, um Abfragen zu ändern oder zu aktualisieren, Datentransformationen hinzuzufügen und Visualisierungseinstellungen zu ändern. 

1.  Öffnen Sie das Dashboard, das den Bereich enthält, den Sie bearbeiten möchten. 

1.  Bewegen Sie den Mauszeiger über einen beliebigen Teil des Panels, um das Aktionsmenü in der oberen rechten Ecke anzuzeigen. 

1.  Klicken Sie auf das Menü und wählen Sie **Bearbeiten**. 

    Um das Bedienfeld mit einer Tastenkombination zu öffnen, bewegen Sie den Mauszeiger über das Bedienfeld und drücken Sie **E.** 

    Das Fenster wird im Bearbeitungsmodus geöffnet. 

## Fügen Sie einem Panel einen Titel und eine Beschreibung hinzu
<a name="v9-panels-add-title-description"></a>

 Fügen Sie einem Panel einen Titel und eine Beschreibung hinzu, um Benutzern wichtige Informationen über die Visualisierung mitzuteilen. Verwenden Sie die Beschreibung beispielsweise, um den Zweck der Visualisierung zu dokumentieren. 

1.  Bearbeiten Sie ein Panel. 

1.  Suchen Sie im Bereich mit den Optionen für die Panelanzeige den Abschnitt **Panel-Optionen**. 

1.  Geben Sie einen **Titel** ein. 

    Der in dieses Feld eingegebene Text wird oben in Ihrem Panel im Panel-Editor und im Dashboard angezeigt. 

1.  Schreiben Sie eine Beschreibung des Panels und der Daten, die Sie anzeigen. 

    In dieses Feld eingegebener Text wird in einem Tooltip in der oberen linken Ecke des Bedienfelds angezeigt. 

    [Sie können [Variablen verwenden, die Sie im Feld **Titel** und **Beschreibung** definiert haben](v9-dash-variables.md), aber keine globalen Variablen.](v9-dash-variable-add.md#v9-dash-variable-add-global)

    

## Ein Panel-JSON-Modell anzeigen
<a name="v9-panels-json-model"></a>

 Erkunden und exportieren Sie JSON-Modelle für Panels, Paneldaten und Datenrahmen. 

1.  Öffnen Sie das Dashboard, das das Panel enthält. 

1.  Bewegen Sie den Mauszeiger über einen beliebigen Teil des Panels, um das Aktionsmenü in der oberen rechten Ecke anzuzeigen. 

1.  Klicken Sie auf das Menü und wählen Sie **Inspect > Panel JSON**. 

1.  **Wählen Sie im Feld Quelle** auswählen eine der folgenden Optionen aus: 
   +  **Panel-JSON:** Zeigt ein JSON-Objekt an, das das Panel darstellt. 
   +  **Panel-Daten:** Zeigt ein JSON-Objekt an, das die Daten darstellt, die an das Panel übergeben wurden. 
   +  **DataFrame Struktur:** Zeigt den Rohergebnissatz mit den angewendeten Transformationen, Feldkonfigurationen und Override-Konfigurationen an. 

1.  Um das JSON zu untersuchen, klicken Sie auf **>**, um Teile des JSON-Modells zu erweitern oder zu reduzieren. 

## Konfigurieren Sie sich wiederholende Panels
<a name="v9-panels-configure-repeating-panels"></a>

 Sie können Grafana so konfigurieren, dass einem Dashboard dynamisch Panels oder Zeilen hinzugefügt werden. Ein dynamisches Panel ist ein Panel, das das System auf der Grundlage des Werts einer Variablen erstellt. Variablen ändern Ihre Abfragen dynamisch in allen Bereichen eines Dashboards.

**Anmerkung**  
Bei sich wiederholenden Bedienfeldern müssen für Variablen ein oder mehrere Elemente ausgewählt sein. Sie können einen Bereich nicht null Mal wiederholen, um ihn auszublenden. 

 **Bevor Sie beginnen:** 
+  Stellen Sie sicher, dass die Abfrage eine Variable mit mehreren Werten enthält. 

 **So konfigurieren Sie sich wiederholende Panels:** 

1. Bearbeiten Sie das Panel, das Sie wiederholen möchten.

1.  Klicken Sie im Bereich mit den Anzeigeoptionen auf **Bedienfeldoptionen > Wiederholungsoptionen**. 

1.  Wählen Sie eine **Richtung** aus. 
   +  Wählen Sie **horizontal**, um die Panels anzuordnen side-by-side. Grafana passt die Breite eines wiederholten Panels an. Derzeit ist es nicht möglich, andere Panels in einer Reihe mit einem sich wiederholenden Panel zu mischen. 
   +  Wählen Sie „**Vertikal**“, um die Felder in einer Spalte anzuordnen. Die Breite wiederholter Panels entspricht der Breite des ursprünglichen, wiederholten Panels. 

1.  Um die Änderungen auf alle Bereiche zu übertragen, laden Sie das Dashboard neu. 

# Standardoptionen konfigurieren
<a name="v9-panels-configure-standard-options"></a>

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

 Das in Grafana verwendete Datenmodell ist eine spaltenorientierte Tabellenstruktur, die sowohl Zeitreihen- als auch Tabellenabfrageergebnisse vereinheitlicht. *Jede Spalte innerhalb dieser Struktur wird als Feld bezeichnet.* Ein Feld kann eine einzelne Zeitreihe oder Tabellenspalte darstellen. 

 Mit Feldoptionen können Sie ändern, wie die Daten in Ihren Visualisierungen angezeigt werden. Optionen und Überschreibungen, die Sie anwenden, ändern nicht die Daten, sie ändern, wie Grafana die Daten anzeigt. Wenn Sie eine Option ändern, wird sie auf alle Felder angewendet, also auf alle Reihen oder Spalten. Wenn Sie die Einheit beispielsweise in Prozent ändern, werden alle Felder mit numerischen Werten in Prozentwerten angezeigt. 

 Eine vollständige Liste der Optionen zur Feldformatierung finden Sie unter [Definitionen von Standardoptionen](#v9-panels-standard-options-definitions).

**Anmerkung**  
 Sie können Standardoptionen auf die meisten integrierten Grafana-Panels anwenden. In einigen älteren Panels und Community-Panels, die nicht auf das neue Panel und das neue Datenmodell aktualisiert wurden, fehlen entweder alle oder einige dieser Feldoptionen. 

1.  Öffnen Sie ein Dashboard, klicken Sie auf den Titel des Panels und dann auf **Bearbeiten**. 

1.  Suchen Sie im Bereich mit den Anzeigeoptionen des Panels den Abschnitt **Standardoptionen**. 

1.  Wählen Sie die Standardoptionen aus, die Sie anwenden möchten. 

1.  Um eine Vorschau Ihrer Änderung anzuzeigen, klicken Sie auf eine Stelle außerhalb des Feldoptionsfeldes, das Sie bearbeiten, oder drücken Sie die **EINGABETASTE**. 

## Definitionen der Standardoptionen
<a name="v9-panels-standard-options-definitions"></a>

 In diesem Abschnitt werden alle verfügbaren Standardoptionen erklärt. 

 Sie können Standardoptionen auf die meisten integrierten Grafana-Panels anwenden. In einigen älteren Panels und Community-Panels, die nicht auf das neue Panel und das neue Datenmodell aktualisiert wurden, fehlen entweder alle oder einige dieser Feldoptionen. 

 Die meisten Feldoptionen wirken sich erst dann auf die Visualisierung aus, wenn Sie auf eine Stelle außerhalb des Feldoptionsfeldes klicken, das Sie bearbeiten, oder die Eingabetaste drücken. 

**Anmerkung**  
 Wir arbeiten ständig daran, Optionen für alle Visualisierungen hinzuzufügen und zu erweitern, sodass möglicherweise nicht alle Optionen für alle Visualisierungen verfügbar sind. 

### Einheit
<a name="v9-panels-standard-options-unit"></a>

 Hier können Sie auswählen, welche Einheit ein Feld verwenden soll. Klicken Sie in das Feld **Einheit** und gehen Sie dann weiter, bis Sie die gewünschte Einheit gefunden haben. Die von Ihnen gewählte Einheit wird auf alle Felder mit Ausnahme der Zeit angewendet. 

#### Benutzerdefinierte Einheiten
<a name="v9-panels-standard-options-custom-units"></a>

 Sie können das Einheiten-Drop-down-Menü verwenden, um auch benutzerdefinierte Einheiten, benutzerdefinierte Präfixe oder Suffixe sowie Datums- und Uhrzeitformate anzugeben. 

 Um eine benutzerdefinierte Einheit auszuwählen, geben Sie die Einheit ein und wählen Sie in der Dropdownliste die letzte Option **Benutzerdefiniert: xxx** aus. 
+  **Suffix:** <suffix>für eine benutzerdefinierte Einheit, die hinter dem Wert stehen soll. 
+  **Präfix:** <prefix>für eine benutzerdefinierte Einheit, die vor dem Wert stehen soll. 
+  **Zeit:** <format>Geben Sie für benutzerdefinierte Datums- und Uhrzeitformate beispielsweise **time:yyyy-MM-DD** ein. Die Formatsyntax und die [Optionen finden Sie unter Formate](https://momentjs.com/docs/#/displaying/).
+  **si:** <base scale><unit characters>für benutzerdefinierte SI-Einheiten. Zum Beispiel: **si: mF**. Dieser ist etwas fortgeschrittener, da Sie sowohl eine Einheit als auch die Skala der Quelldaten angeben können. Wenn Ihre Quelldaten also als Milli (Tausende von) etwas dargestellt werden, stellen Sie der Einheit dieses SI-Skalenzeichen voran. 
+  **Anzahl:** <unit>für eine benutzerdefinierte Zähleinheit. 
+  **Währung:** <unit>für benutzerdefinierte Angaben eine Währungseinheit. 

 Sie können auch ein systemeigenes Emoji in die Einheitenauswahl einfügen und es als benutzerdefinierte Einheit auswählen. 

#### Zeichenketteneinheiten
<a name="v9-panels-standard-options-string-units"></a>

 Grafana kann manchmal zu aggressiv sein, wenn es darum geht, Zeichenketten zu analysieren und sie als Zahlen anzuzeigen. Um Grafana so zu konfigurieren, dass der ursprüngliche Zeichenkettenwert angezeigt wird, erstellen Sie eine Feldüberschreibung und fügen Sie eine Unit-Eigenschaft mit der **String-Einheit** hinzu. 

### Min
<a name="v9-panels-standard-options-min"></a>

 Ermöglicht es Ihnen, den Mindestwert festzulegen, der bei der Berechnung des prozentualen Schwellenwerts verwendet wird. Lassen Sie das Feld leer für die auto Berechnung auf der Grundlage aller Reihen und Felder. 

### Max
<a name="v9-panels-standard-options-max"></a>

 Ermöglicht es Ihnen, den Höchstwert festzulegen, der bei der Berechnung von prozentualen Schwellenwerten verwendet wird. Lassen Sie das Feld leer für die auto Berechnung auf der Grundlage aller Reihen und Felder. 

### Dezimalzahlen
<a name="v9-panels-standard-options-decimals"></a>

 Geben Sie die Anzahl der Dezimalstellen an, die Grafana in den gerenderten Wert einbezieht. Wenn Sie dieses Feld leer lassen, kürzt Grafana automatisch die Anzahl der Dezimalstellen auf der Grundlage des Werts. Beispielsweise wird 1,1234 als 1,12 und 100,456 als 100 angezeigt. 

 **Um alle Dezimalzahlen anzuzeigen, setzen Sie die Einheit auf String.** 

### Anzeigename
<a name="v9-panels-standard-options-displayname"></a>

 Ermöglicht es Ihnen, den Anzeigetitel aller Felder festzulegen. Sie können [Variablen](v9-dash-variables.md) verwenden.

 Wenn mehrere Statistiken, Felder oder Reihen angezeigt werden, steuert dieses Feld den Titel in jeder Statistik. Sie können Ausdrücke wie **\$1 \$1\$1\$1field.name\$1** verwenden, um nur den Seriennamen oder den Feldnamen im Titel zu verwenden. 

 Es wird ein Feld mit dem Namen Temp und den Bezeichnungen \$1"loc"="PBI“, „Sensor"="3"\$1 angegeben 


|  Ausdruck-Syntax  |  Beispiel  |  Rendert zu  |  Erklärung  | 
| --- | --- | --- | --- | 
|  \$1 \$1\$1\$1field.DisplayName\$1  |  Entspricht der Syntax  |  Temperatur \$1loc="PBI“, Sensor="3"\$1  |  Zeigt den Feldnamen und die Beschriftungen in \$1\$1 an, falls sie vorhanden sind. Wenn die Antwort nur einen Labelschlüssel enthält, zeigt Grafana für den Labelteil den Wert des Labels ohne die einschließenden Klammern an.  | 
|  \$1 \$1\$1\$1field.name\$1  |  Entspricht der Syntax  |  Temporäre Dateien  |  Zeigt den Namen des Felds an (ohne Beschriftungen).  | 
|  \$1 \$1\$1\$1field.labels\$1  |  Entspricht der Syntax  |  loc="PBI“, Sensor="3"  |  Zeigt die Beschriftungen ohne den Namen an.  | 
|  \$1 \$1\$1\$1field.Labels.x\$1  |  \$1 \$1\$1\$1field.labels.LOC\$1  |  PBI  |  Zeigt den Wert des angegebenen Labelschlüssels an.  | 
|  \$1 \$1\$1\$1field.labels. \$1\$1Werte\$1  |  Identisch mit Syntax  |  PBI, 3  |  Zeigt die Werte der Labels durch ein Komma getrennt an (ohne Labelschlüssel).  | 

 Wenn der Wert nach dem Rendern des Ausdrucks für ein bestimmtes Feld eine leere Zeichenfolge ist, wird die Standardanzeigemethode verwendet. 

### Farbschema
<a name="v9-panels-standard-options-color-scheme"></a>

 Die Farboptionen und ihre Auswirkung auf die Visualisierung hängen von der Visualisierung ab, mit der Sie arbeiten. Einige Visualisierungen haben unterschiedliche Farboptionen. 

 Sie können eine einzelne Farbe angeben oder ein kontinuierliches Farbschema (Farbverlauf) auswählen, das auf einem Wert basiert. Kontinuierliche Farbe interpoliert eine Farbe anhand des Prozentsatzes eines Werts im Verhältnis zu Minimum und Maximum. 

 Wählen Sie eine der folgenden Paletten aus: 


|  Farbmodus  |  Description  | 
| --- | --- | 
|  Einfarbig  |  Geben Sie eine einzelne Farbe an, was bei einer Überschreibungsregel nützlich ist  | 
|  Aus Schwellenwerten  |  Informiert Grafana, die Farbe aus dem passenden Schwellenwert zu nehmen  | 
|  Klassische Palette  |  Grafana weist eine Farbe zu, indem es eine Farbe in einer Palette anhand des Serienindex nachschlägt. Nützlich für Grafiken und Kreisdiagramme und andere kategoriale Datenvisualisierungen  | 
|  Green-Yellow-Red (nach Wert)  |  Kontinuierliches Farbschema  | 
|  Blue-Yellow-Red (nach Wert)  |  Kontinuierliches Farbschema  | 
|  Blautöne (nach Wert)  |  Kontinuierliches Farbschema (Hintergrund des Bedienfelds wird blau)  | 
|  Rottöne (nach Wert)  |  Kontinuierliches Farbschema (Hintergrundfarbe des Bedienfelds wird blau)  | 
|  Grüntöne (nach Wert)  |  Kontinuierliches Farbschema (Hintergrundfarbe des Bedienfelds wird blau)  | 
|  Violett (nach Wert)  |  Kontinuierliches Farbschema (Hintergrundfarbe des Bedienfelds wird blau)  | 

### Kein Wert
<a name="v9-panels-standard-options-no-value"></a>

 Geben Sie ein, was Grafana anzeigen soll, wenn der Feldwert leer oder Null ist. Der Standardwert ist ein Bindestrich (-). 

# Daten abfragen und transformieren
<a name="v9-panels-query-xform"></a>

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

Grafana unterstützt viele Arten von [Datenquellen](AMG-data-sources.md). *Datenquellenabfragen* geben Daten zurück, die Grafana *transformieren* und visualisieren kann. Jede Datenquelle verwendet ihre eigene Abfragesprache, und Datenquellen-Plugins implementieren jeweils eine Benutzeroberfläche zur Abfrageerstellung, die als Abfrageeditor bezeichnet wird.

## Informationen zu Abfragen
<a name="v9-panels-query-xform-about"></a>

Grafana-Panels kommunizieren mit Datenquellen über Abfragen, die Daten für die Visualisierung abrufen. Eine Abfrage ist eine Frage, die in der von der Datenquelle verwendeten Abfragesprache geschrieben ist.

In den Datenquellenoptionen des Panels können Sie die Abfragehäufigkeit und die Grenzwerte für die Datenerfassung konfigurieren. Grafana unterstützt bis zu 26 Abfragen pro Panel.

Weitere Informationen zur Abfragesprache der einzelnen Datenquellen finden Sie im Abschnitt [Datenquellen](AMG-data-sources.md).

**Abfrage-Editoren**

Der *Abfrage-Editor* jeder Datenquelle bietet eine benutzerdefinierte Benutzeroberfläche, mit der Sie Abfragen schreiben können, die die einzigartigen Funktionen nutzen.

Aufgrund der Unterschiede zwischen den Abfragesprachen sieht jeder Abfrage-Editor für Datenquellen anders aus und funktioniert auch anders. Abhängig von Ihrer Datenquelle bietet der Abfrage-Editor möglicherweise Funktionen zur automatischen Vervollständigung, Metriknamen, Variablenvorschläge oder eine visuelle Oberfläche zur Abfrageerstellung.

Einzelheiten zu den einzigartigen Funktionen des Abfrage-Editors einer bestimmten Datenquelle finden Sie in der zugehörigen Dokumentation:
+ Informationen zu den in Grafana enthaltenen Datenquellen finden Sie unter [Integrierte Datenquellen](AMG-data-sources-builtin.md).
+ Informationen zu den in der Grafana Enterprise Edition enthaltenen Datenquellen finden Sie unter. [Connect zu Unternehmensdatenquellen her](AMG-data-sources-enterprise.md)

**Abfragesyntax**

Datenquellen verwenden unterschiedliche Abfragesprachen, um Daten anzufordern. Einzelheiten zur eindeutigen Abfragesprache einer bestimmten Datenquelle finden Sie in der zugehörigen Dokumentation.

**PostgreSQL-Beispiel:**

```
SELECT hostname FROM host WHERE region IN($region)
```

**PromQL-Beispiel:**

```
query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
```

**Spezielle Datenquellen**

**Grafana umfasst auch drei spezielle Datenquellen: **Grafana**, **Mixed** und Dashboard.** Einzelheiten finden Sie unter Datenquellen

## Navigieren Sie zur Registerkarte „Abfrage“
<a name="v9-panels-query-xform-navigate"></a>

Die Registerkarte „**Abfrage**“ eines Panels besteht aus den folgenden Elementen:
+ **Datenquellenauswahl — Wählt** die abzufragende Datenquelle aus.
+ **Abfrageoptionen:** — Legt maximale Datenabrufparameter und Abfragelaufzeitintervalle fest.
+ **Schaltfläche „Abfrageinspektor“:** Öffnet den Bereich „Abfrageinspektor“, in dem Sie Ihre Abfrage anzeigen und optimieren können.
+ **Liste des Abfrage-Editors:** — Listet die Abfragen auf, die Sie geschrieben haben.
+ **Ausdrücke:** — Verwendet den Ausdrucks-Generator, um Warnungsausdrücke zu erstellen. Weitere Informationen zu Ausdrücken finden Sie unter [Ausdrucksabfragen schreiben](v9-panels-query-xform-expressions.md).

## Fügen Sie eine Abfrage hinzu
<a name="v9-panels-query-xform-add"></a>

Eine Abfrage gibt Daten zurück, die Grafana in Dashboard-Panels visualisiert. Wenn Sie ein Panel erstellen, wählt Grafana automatisch die Standarddatenquelle aus.

**Um eine Abfrage hinzuzufügen**

1. Bearbeiten Sie das Panel, zu dem Sie eine Abfrage hinzufügen.

1. Wählen Sie die Registerkarte **Queries** (Abfragen) aus.

1. Wählen Sie das Dropdownmenü **Datenquelle** und wählen Sie eine Datenquelle aus.

1. Wählen Sie **Abfrageoptionen**, um die maximale Anzahl von Datenpunkten zu konfigurieren, die Sie benötigen. Weitere Informationen zu Abfrageoptionen finden Sie unter[Abfrageoptionen](#v9-panels-query-xform-options).

1. Schreiben Sie die Abfrage mit dem Abfrage-Editor.

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

Grafana fragt die Datenquelle ab und visualisiert die Daten.

## Abfragen verwalten
<a name="v9-panels-query-xform-manage"></a>

Grafana organisiert Abfragen in zusammenklappbaren Abfragezeilen. Jede Abfragezeile enthält einen Abfrage-Editor und ist mit einem Buchstaben (A, B, C usw.) gekennzeichnet.

Um Ihre Abfragen zu verwalten, können Sie Abfragen kopieren, Abfragen ausblenden, eine Abfrage entfernen, Abfragen neu anordnen und die Hilfe für den Abfrage-Editor ein- und ausschalten.

## Abfrageoptionen
<a name="v9-panels-query-xform-options"></a>

Wählen Sie neben der Datenquellenauswahl die **Option Abfrageoptionen** aus, um die Einstellungen für die ausgewählte Datenquelle anzuzeigen. Änderungen, die Sie hier vornehmen, wirken sich nur auf Abfragen aus, die in diesem Bereich vorgenommen wurden.

Grafana legt Standardwerte fest, die in dunkelgrauem Text angezeigt werden. Änderungen werden in weißem Text angezeigt. Um ein Feld auf die Standardeinstellung zurückzusetzen, löschen Sie den weißen Text aus dem Feld.

Zu den Optionen für die Abfrage von Panel-Datenquellen gehören:
+ **Max. Datenpunkte** — Wenn die Datenquelle dies unterstützt, wird damit die maximale Anzahl von Datenpunkten für jede zurückgegebene Serie festgelegt. Wenn die Abfrage mehr Datenpunkte zurückgibt als die Einstellung für maximale Datenpunkte, reduziert die Datenquelle die Anzahl der zurückgegebenen Punkte, indem sie sie nach Durchschnitt, Maximum oder einer anderen Funktion zusammenfasst.

  Sie können die Anzahl der Punkte einschränken, um die Abfrageleistung zu verbessern oder die visualisierte Linie zu glätten. Der Standardwert ist die Breite (oder Anzahl der Pixel) des Diagramms, da Sie nur so viele Datenpunkte visualisieren können, wie das Grafikfenster Platz zur Anzeige bietet.

  Bei Streaming-Daten verwendet Grafana den Wert für maximale Datenpunkte für den Rolling-Puffer. Streaming ist ein kontinuierlicher Datenfluss, und die Pufferung unterteilt den Stream in Blöcke. Loki streamt beispielsweise Daten in seinem Live-Tailing-Modus.
+ **Minimales Intervall** — Legt einen Mindestgrenzwert für das automatisch berechnete Intervall fest, bei dem es sich in der Regel um das minimale Scrape-Intervall handelt. Wenn alle 15 Sekunden ein Datenpunkt gespeichert wird, profitieren Sie nicht von einem niedrigeren Intervall. Sie können dies auch auf ein höheres Minimum als das Scrape-Intervall festlegen, um Abfragen abzurufen, die grobkörniger sind und gut funktionieren.
+ **Intervall** — Legt eine Zeitspanne fest, die Sie beim Aggregieren oder Gruppieren von Datenpunkten nach Zeit verwenden können.

  Grafana berechnet automatisch ein geeignetes Intervall, das Sie als Variable in Abfragen mit Vorlagen verwenden können. Die Variable wird entweder in Sekunden (`$__interval`) oder Millisekunden () gemessen. `$__interval_ms`

  Intervalle werden normalerweise in Aggregationsfunktionen wie Summe oder Durchschnitt verwendet. Dies ist beispielsweise eine Prometheus-Abfrage, die die Intervallvariable verwendet:. `rate(http_requests_total[$__interval])`

  Dieses automatische Intervall wird auf der Grundlage der Breite des Diagramms berechnet. Wenn der Benutzer die Ansicht einer Visualisierung verkleinert, vergrößert sich das Intervall, was zu einer grobkörnigeren Aggregation führt. Ebenso verringert sich das Intervall, wenn der Benutzer die Ansicht vergrößert, was zu einer feinkörnigeren Aggregation führt.

  Weitere Informationen finden Sie unter [Globale Variablen](v9-dash-variable-add.md#v9-dash-variable-add-global).
+ **Relative Zeit** — Überschreibt den relativen Zeitraum für einzelne Bereiche, wodurch sie sich von dem unterscheiden, was in der Dashboard-Zeitauswahl in der oberen rechten Ecke des Dashboards ausgewählt wurde. Sie können dies verwenden, um Metriken aus verschiedenen Zeiträumen oder Tagen auf demselben Dashboard anzuzeigen.
**Anmerkung**  
Überschreibungen der Panel-Zeit haben keine Auswirkung, wenn der Zeitbereich des Dashboards absolut ist.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/v9-panels-query-xform.html)
+ **Zeitverschiebung** — Überschreibt den Zeitbereich für einzelne Panels, indem Start und Ende relativ zur Zeitauswahl verschoben werden. Sie können beispielsweise den Zeitraum für das Panel so ändern, dass er zwei Stunden vor dem Zeitwähler im Dashboard liegt.
**Anmerkung**  
Überschreibungen der Panel-Zeit haben keine Auswirkung, wenn der Zeitbereich des Dashboards absolut ist.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/v9-panels-query-xform.html)
+ **Cache-Timeout** — *(Nur sichtbar, wenn in der Datenquelle verfügbar)* Überschreibt das Standard-Cache-Timeout, wenn Ihr Zeitreihenspeicher über einen Abfrage-Cache verfügt. Geben Sie diesen Wert als numerischen Wert in Sekunden an.

# Ausdrucksabfragen schreiben
<a name="v9-panels-query-xform-expressions"></a>

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

Serverseitige Ausdrücke ermöglichen es Ihnen, Daten, die von Abfragen zurückgegeben werden, mit mathematischen und anderen Operationen zu bearbeiten. Ausdrücke erzeugen neue Daten und manipulieren nicht die von Datenquellen zurückgegebenen Daten.

## Über Ausdrücke
<a name="v9-panels-query-about"></a>

Serverseitige Ausdrücke ermöglichen es Ihnen, Daten, die von Abfragen zurückgegeben werden, mit mathematischen und anderen Operationen zu bearbeiten. Ausdrücke erzeugen neue Daten und manipulieren nicht die von Datenquellen zurückgegebenen Daten, abgesehen von einigen geringfügigen Datenumstrukturierungen, um die Daten als Eingabe für Ausdrücke akzeptabel zu machen.

**Verwendung von Ausdrücken**

Ausdrücke werden hauptsächlich von [Grafana Alerting](v9-alerts.md) verwendet. Die Verarbeitung erfolgt serverseitig, sodass Ausdrücke auch ohne Browsersitzung ausgeführt werden können. Ausdrücke können jedoch auch mit Backend-Datenquellen und Visualisierungen verwendet werden.

**Anmerkung**  
Ausdrücke funktionieren nicht mit älteren Dashboard-Warnungen.

Ausdrücke sollen Datenquellen erweitern, indem sie die Kombination von Abfragen aus verschiedenen Datenquellen ermöglichen oder Operationen bereitstellen, die in einer Datenquelle nicht verfügbar sind.

**Anmerkung**  
Wenn möglich, sollten Sie die Datenverarbeitung innerhalb der Datenquelle durchführen. Das Kopieren von Daten aus dem Speicher auf den Grafana-Server zur Verarbeitung ist ineffizient, daher sind Ausdrücke auf die einfache Datenverarbeitung ausgerichtet.

Ausdrücke funktionieren mit Datenquellenabfragen, die Zeitreihen oder Zahlendaten zurückgeben. Sie arbeiten auch mit [mehrdimensionalen Daten](getting-started-grafanaui.md#time-series-dimensions). Zum Beispiel eine Abfrage, die mehrere Datenreihen zurückgibt, wobei jede Datenreihe durch Beschriftungen oder Tags identifiziert wird.

Ein einzelner Ausdruck verwendet eine oder mehrere Abfragen oder andere Ausdrücke als Eingabe und fügt dem Ergebnis Daten hinzu. Jeder einzelne Ausdruck oder jede einzelne Abfrage wird durch eine Variable repräsentiert, bei der es sich um einen benannten Bezeichner handelt, der als RefID bezeichnet wird (z. B. der Standardbuchstabe `A` oder`B`).

Um auf die Ausgabe eines einzelnen Ausdrucks oder einer Datenquellenabfrage in einem anderen Ausdruck zu verweisen, wird dieser Bezeichner als Variable verwendet.

**Arten von Ausdrücken**

Ausdrücke funktionieren mit zwei Datentypen.
+ Eine Sammlung von Zeitreihen.
+ Eine Sammlung von Zahlen, wobei jede Zahl ein Element ist.

Jede Sammlung wird anhand einer einzelnen Datenquellenabfrage oder eines einzelnen Ausdrucks zurückgegeben und durch die RefID dargestellt. Jede Sammlung ist ein Satz, bei dem jedes Element in der Gruppe anhand seiner Dimensionen, die als [Labels](getting-started-grafanaui.md#labels) oder Schlüssel-Wert-Paare gespeichert sind, eindeutig identifiziert wird.

**Datenquellenabfragen**

Serverseitige Ausdrücke unterstützen nur Datenquellenabfragen für Backend-Datenquellen. Es wird allgemein davon ausgegangen, dass es sich bei den Daten um Zeitreihendaten handelt. In future wollten wir eine Assertion für Daten vom Rückgabetyp der Abfrage (Zahl oder Zeitreihe) hinzufügen, damit Ausdrücke Fehler besser behandeln können.

Datenquellenabfragen werden, wenn sie mit Ausdrücken verwendet werden, von der Expression Engine ausgeführt. Dabei werden die Daten so umstrukturiert, dass sie entweder eine Zeitreihe oder eine Zahl pro Datenrahmen enthalten. Wenn Sie also beispielsweise eine Datenquelle verwenden, die mehrere Reihen in einem Frame in der Tabellenansicht zurückgibt, stellen Sie möglicherweise fest, dass sie anders aussieht, wenn sie mit Ausdrücken ausgeführt wird.

Derzeit wird bei der Verwendung von Datenrahmen nur das Format (Zahl) unterstützt, das kein Zeitreihenformat ist, wenn Sie eine Tabellenantwort haben, die einen Datenrahmen ohne Zeit, Zeichenkettenspalten und eine Zahlenspalte zurückgibt:


| Loc | Host | AVG\$1CPU | 
| --- | --- | --- | 
|  MIA  |  A  |  1  | 
|  NYC  |  B  |  2  | 

Das obige Beispiel erzeugt eine Zahl, die mit Ausdrücken funktioniert. Die Zeichenkettenspalten werden zu Beschriftungen und die Zahlenspalte zum entsprechenden Wert. Zum Beispiel `{"Loc": "MIA", "Host": "A"}` mit einem Wert von 1.

**Operationen**

Sie können die folgenden Operationen in Ausdrücken verwenden: Mathe, Reduce und Resample.

**Math (Mathematik)**

Mathe steht für frei formbare mathematische Formeln für Zeitreihen oder Zahlendaten. Bei mathematischen Operationen werden Zahlen und Zeitreihen als Eingabe verwendet und in andere Zahlen und Zeitreihen umgewandelt.

Auf Daten aus anderen Abfragen oder Ausdrücken wird beispielsweise mit der RefID verwiesen, der ein Dollarzeichen vorangestellt ist. `$A` Wenn der Name der Variablen Leerzeichen enthält, können Sie eine geschweifte Syntax wie verwenden. `${my variable}`

Numerische Konstanten können dezimal (`2.24`), oktal (mit einer führenden Null wie`072`) oder hexadezimal (mit einem führenden 0x wie) sein. `0x2A` Exponentialzahlen und Vorzeichen werden ebenfalls unterstützt (z. B.). `-0.8e-2`

**Operatoren**

Die arithmetischen (`+`, binären und unären`-`,,`*`, `/``%`, Exponenten`**`), relationalen (,,`<`,, `>``==`,`<=`) und logischen (`!=``>=`, `&&``||`, und `!` unären) Operatoren werden unterstützt.

Wie sich die Operation mit Daten verhält, hängt davon ab, ob es sich um Zahlen- oder Zeitreihendaten handelt.

Bei binären Operationen wie `$A + $B` oder `$A || $B` wird der Operator je nach Datentyp auf folgende Weise angewendet:
+ Wenn beide `$A` und eine Zahl `$B` sind, wird die Operation zwischen den beiden Zahlen ausgeführt.
+ Wenn eine Variable eine Zahl und die andere Variable eine Zeitreihe ist, wird die Operation zwischen dem Wert jedes Punktes in der Zeitreihe und der Zahl ausgeführt.
+ Wenn es sich bei beiden `$A` um Zeitreihendaten `$B` handelt, wird die Operation zwischen den einzelnen Werten in den beiden Reihen für jeden Zeitstempel ausgeführt, der `$A` sowohl in als auch vorhanden ist`$B`. Die `Resample` Operation kann verwendet werden, um Zeitstempel anzuordnen.

Zusammenfassung:
+ Nummer OP-Nummer = Nummer
+ Nummer OP-Serie = Serie
+ Serie OP Serie = Serie

Da Ausdrücke mit mehreren Reihen oder Zahlen arbeiten, die durch eine einzige Variable repräsentiert werden, führen binäre Operationen auch eine Vereinigung (Verknüpfung) zwischen den beiden Variablen durch. Dies erfolgt auf der Grundlage der identifizierenden Bezeichnungen, die jeder einzelnen Reihe oder Zahl zugeordnet sind.

Wenn Sie also Zahlen mit Beschriftungen wie `{host=web01}` in `$A` und eine weitere Zahl `$B` mit denselben Beschriftungen haben, wird die Operation zwischen diesen beiden Elementen innerhalb jeder Variablen ausgeführt, und das Ergebnis verwendet dieselben Beschriftungen. Die Regeln für das Verhalten dieser Vereinigung lauten wie folgt:
+ Ein Objekt ohne Beschriftungen lässt sich mit allem verbinden.
+ Wenn beide `$A` nur ein Objekt enthalten (eine Serie oder eine Zahl), werden sie zusammengefügt. `$B`
+ Wenn die Beschriftungen exakt übereinstimmen, werden sie zusammengefügt.
+ Wenn es sich bei den Beschriftungen um eine Teilmenge der anderen handelt, z. B. wenn ein Element in beschriftet `$A` ist `{host=A,dc=MIA}` und ein Element in beschriftet `$B` ist, werden `{host=A}` sie zusammengefügt.
+ Wenn innerhalb einer Variablen beispielsweise für jedes Element unterschiedliche Tag-Schlüssel `$A` vorhanden sind, ist das Verbindungsverhalten undefiniert.

Die relationalen und logischen Operatoren geben 0 für falsch und 1 für wahr zurück.

**Mathematische Funktionen**

Während die meisten Funktionen in den eigenen Ausdrucksoperationen existieren, hat die mathematische Operation einige Funktionen, die mathematischen Operatoren oder Symbolen ähneln. Wenn Funktionen entweder Zahlen oder Reihen annehmen können, wird derselbe Typ wie das Argument zurückgegeben. Handelt es sich um eine Reihe, wird die Operation für den Wert jedes Punktes in der Reihe ausgeführt.

*Bauchmuskeln*

abs gibt den absoluten Wert seines Arguments zurück, der eine Zahl oder eine Reihe sein kann. Zum Beispiel `abs(-1)` oder `abs($A)`.

*is\$1inf*

is\$1inf nimmt eine Zahl oder eine Reihe und gibt `1` für `Inf` Werte (negativ oder positiv) und `0` für andere Werte zurück. Zum Beispiel `is_inf($A)`.

**Anmerkung**  
Wenn Sie beispielsweise gezielt nach negativer Unendlichkeit suchen müssen, können Sie einen Vergleich wie durchführen. `$A == infn()`

*is\$1nan*

is\$1nan nimmt eine Zahl oder eine Reihe und gibt `1` für `NaN` Werte und `0` für andere Werte zurück. Zum Beispiel `is_nan($A)`. Diese Funktion existiert, weil sie nicht gleich `NaN` ist. `NaN`

*is\$1null*

is\$1null nimmt eine Zahl oder eine Reihe und gibt `1` für `null` Werte und `0` für andere Werte zurück. Zum Beispiel `is_null($A)`.

*ist\$1Zahl*

is\$1number nimmt eine Zahl oder eine Reihe und gibt `1` für alle reellen Zahlenwerte und `0` für andere Werte (die`null`,`Inf+`, `Inf-` und sind) zurück. `NaN` Zum Beispiel `is_number($A)`.

*log*

Log gibt den natürlichen Logarithmus seines Arguments zurück, der eine Zahl oder eine Reihe sein kann. Wenn der Wert kleiner als 0 ist, `NaN` wird zurückgegeben. Zum Beispiel `log(-1)` oder `log($A)`.

*inf, infn, nan und null*

Die Funktionen inf, infn, nan und null geben alle einen einzelnen Wert des Namens zurück. Sie existieren hauptsächlich zum Testen. Beispiel: `null()`.

*round*

Round gibt einen gerundeten Ganzzahlwert zurück. Zum Beispiel `round(3.123)` oder `round($A)`.

*ceil*

Ceil rundet die Zahl auf den nächsten ganzzahligen Wert auf. Beispielsweise gibt `ceil(3.123)` `4` zurück.

*floor*

Floor rundet die Zahl auf den nächsten ganzzahligen Wert ab. Beispiel:`floor(3.123`) gibt zurück`3`.

**Reduzieren**

Reduce verwendet eine oder mehrere Zeitreihen, die von einer Abfrage oder einem Ausdruck zurückgegeben wurden, und wandelt jede Reihe in eine einzelne Zahl um. Die Beschriftungen der Zeitreihen werden als Beschriftungen für jede ausgegebene reduzierte Zahl beibehalten.

*Felder:*
+ **Funktion** — Die zu verwendende Reduktionsfunktion
+ **Eingabe** — Die Variable (RefID (z. B.`A`)), für die ein Resampling durchgeführt werden soll
+ **Modus** — Ermöglicht die Steuerung des Verhaltens der Reduktionsfunktion, wenn eine Reihe nicht numerische Werte enthält (Null, NaN, \$1-Inf)

**Reduktionsfunktionen**

*Count*

Count gibt die Anzahl der Punkte in jeder Reihe zurück.

*Meint*

Der Mittelwert gibt die Summe aller Werte in jeder Reihe geteilt durch die Anzahl der Punkte in dieser Reihe zurück. Wenn im `strict` Modus irgendwelche Werte in der Reihe Null oder Nan sind oder wenn die Reihe leer ist, wird NaN zurückgegeben.

*Min und Max*

Min und Max geben den kleinsten bzw. größten Wert in der Reihe zurück. Wenn im `strict` Modus irgendwelche Werte in der Reihe Null oder Nan sind oder wenn die Reihe leer ist, wird NaN zurückgegeben.

*Sum (Summe)*

Sum gibt die Summe aller Werte in der Reihe zurück. Wenn die Reihe die Länge Null hat, ist die Summe 0. Wenn im `strict` Modus NaN- oder Null-Werte in der Reihe vorhanden sind, wird NaN zurückgegeben.

*Zuletzt*

Last gibt die letzte Zahl in der Reihe zurück. Wenn die Serie keine Werte hat, wird NaN zurückgegeben.

**Reduktionsmodi**

*Streng*

Im Strict-Modus wird die Eingangsserie unverändert verarbeitet. Wenn Werte in der Reihe nicht numerisch sind (Null, NaN oder \$1-Inf), wird NaN zurückgegeben.

*Löschen Sie nicht-numerische Werte*

In diesem Modus werden alle nicht numerischen Werte (Null, NaN oder \$1-Inf) in der Eingangsserie herausgefiltert, bevor die Reduktionsfunktion ausgeführt wird.

*Ersetzen Sie nicht numerische Zahlen*

In diesem Modus werden alle nicht numerischen Werte durch einen vordefinierten Wert ersetzt.

**Stichprobe neu berechnen**

Bei Resampling werden die Zeitstempel in jeder Zeitreihe so geändert, dass ein konsistentes Zeitintervall entsteht. Der Hauptanwendungsfall besteht darin, dass Sie Zeitreihen, die nicht dieselben Zeitstempel haben, neu berechnen können, sodass Berechnungen zwischen ihnen durchgeführt werden können. Dies kann erreicht werden, indem jede der beiden Serien neu berechnet wird, und dann in einer mathematischen Operation auf die neu abgetasteten Variablen verwiesen wird.

*Felder:*
+ **Eingabe** — Die Variable der Zeitreihendaten (RefID (z. B.`A`)), für die ein Resampling durchgeführt werden soll
+ **Resampling** bis — Die Zeitdauer, auf die das Resampling durchgeführt werden soll, kann beispielsweise `10s.` `s` Sekunden, `m` Minuten, `h` Stunden, `d` Tage, Wochen und `w` Jahre sein. `y`
+ **Downsample** — Die Reduktionsfunktion, die verwendet werden soll, wenn pro Fensterstichprobe mehr als ein Datenpunkt vorhanden ist. Einzelheiten zum Verhalten finden Sie in der Reduktionsoperation.
+ **Upsample** — Die Methode, die verwendet werden soll, um eine Fensterprobe ohne Datenpunkte zu füllen.
  + **Das Pad** wird mit dem letzten bekannten Wert gefüllt
  + mit dem nächsten bekannten Wert **auffüllen**
  + **fillna** zum Füllen leerer Beispielfenster mit NaNs

## Schreiben Sie einen Ausdruck
<a name="v9-panels-query-write"></a>

Wenn Ihre Datenquelle sie unterstützt, zeigt Grafana die Schaltfläche **Ausdruck** und alle vorhandenen Ausdrücke in der Liste des Abfrage-Editors an.

**Um einen Ausdruck zu schreiben**

1. Öffnen Sie das Panel.

1. Wählen Sie unter der Abfrage die Option **Ausdruck** aus.

1. Wählen Sie im Feld **Operation** den Ausdruckstyp aus, den Sie schreiben möchten.

1. Schreiben Sie den Ausdruck.

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

## Sonderfälle
<a name="v9-panels-query-special"></a>

Wenn eine abgefragte Datenquelle keine Reihen oder Zahlen zurückgibt, gibt die Expression Engine zurück. `NoData` Wenn eine Anforderung beispielsweise zwei Datenquellenabfragen enthält, die durch einen Ausdruck zusammengeführt werden, und wenn sie von mindestens einer der Datenquellenabfragen zurückgegeben wird, dann `NoData` ist das zurückgegebene Ergebnis für die gesamte Abfrage. `NoData` Weitere Informationen darüber, wie Grafana Alerting `NoData` Ergebnisse verarbeitet, finden Sie unter. [Es werden keine Daten- oder Fehlerfälle behandelt](v9-alerting-managerules-grafana.md#v9-alerting-rule-no-data-error)

# Abfrageergebnisse mit einem anderen Panel teilen
<a name="v9-panels-query-share"></a>

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

Mit Grafana können Sie das Abfrageergebnis aus einem Panel für jedes andere Panel im Dashboard verwenden. Durch die gemeinsame Nutzung von Abfrageergebnissen über mehrere Panels hinweg wird die Anzahl der Abfragen an Ihre Datenquelle reduziert, wodurch die Leistung Ihres Dashboards verbessert werden kann.

Mit der Dashboard-Datenquelle können Sie einen Bereich in Ihrem Dashboard auswählen, der die Abfragen enthält, für die Sie die Ergebnisse teilen möchten. Anstatt für jedes Panel eine separate Abfrage zu senden, sendet Grafana eine Abfrage und andere Panels verwenden die Abfrageergebnisse, um Visualisierungen zu erstellen.

Diese Strategie kann die Anzahl der Abfragen drastisch reduzieren, wenn Sie beispielsweise mehrere Panels haben, die dieselben Daten visualisieren.

**Um Abfrageergebnisse gemeinsam zu nutzen**

1. [Erstellen Sie ein Dashboard](v9-dash-creating.md).

1. Ändern Sie den Titel in`Source panel`. Sie verwenden dieses Panel als Quelle für die anderen Panels.

1. Definieren Sie die Abfrage oder Abfragen, die Sie teilen möchten.

   Wenn keine Datenquelle verfügbar ist, verwenden Sie die Datenquelle, die **TestData**eine zufällige Zeitreihe zurückgibt, die Sie zum Testen verwenden können.

1. Fügen Sie ein zweites Fenster hinzu und wählen Sie die **Dashboard-Datenquelle** im Abfrage-Editor aus.

1. Wählen Sie in der **Liste „Ergebnisse aus Bedienfeld verwenden**“ den ersten Bereich aus, den Sie erstellt haben.

Alle im Quellbereich definierten Abfragen sind jetzt für das neue Bedienfeld verfügbar. Abfragen, die im Quellbereich gestellt wurden, können mit mehreren Panels geteilt werden.

Sie können auf eine der Abfragen klicken, um zu dem Bereich zu gelangen, in dem sie definiert sind.

# Transformieren von Daten
<a name="v9-panels-xform"></a>

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

Transformationen sind eine leistungsstarke Methode, um Daten zu bearbeiten, die von einer Abfrage zurückgegeben werden, bevor das System eine Visualisierung anwendet. Mithilfe von Transformationen können Sie:
+ Felder umbenennen
+ Zeitreihendaten verbinden
+ Führen Sie mathematische Operationen abfrageübergreifend durch
+ Verwenden Sie die Ausgabe einer Transformation als Eingabe für eine andere Transformation

Für Benutzer, die auf mehrere Ansichten desselben Datensatzes angewiesen sind, bieten Transformationen eine effiziente Methode zur Erstellung und Verwaltung zahlreicher Dashboards.

Sie können die Ausgabe einer Transformation auch als Eingabe für eine andere Transformation verwenden, was zu einer Leistungssteigerung führt.

**Anmerkung**  
Manchmal kann das System transformierte Daten nicht grafisch darstellen. Wenn das passiert, klicken Sie auf den Schalter **Tabellenansicht** über der Visualisierung, um zu einer Tabellenansicht der Daten zu wechseln. Dies kann Ihnen helfen, das Endergebnis Ihrer Transformationen zu verstehen.

## Typen von Transformationen
<a name="v9-panels-xform-types"></a>

Grafana bietet eine Reihe von Möglichkeiten, wie Sie Daten transformieren können. Im Folgenden finden Sie eine vollständige Liste der Transformationsfunktionen.

## Reihenfolge der Transformationen
<a name="v9-panels-xform-order"></a>

Wenn es mehrere Transformationen gibt, wendet Grafana sie in der Reihenfolge an, in der sie aufgelistet sind. Jede Transformation erstellt eine Ergebnismenge, die dann an die nächste Transformation in der Verarbeitungspipeline weitergegeben wird.

Die Reihenfolge, in der Grafana Transformationen anwendet, wirkt sich direkt auf die Ergebnisse aus. Wenn Sie beispielsweise eine Reduce-Transformation verwenden, um alle Ergebnisse einer Spalte zu einem einzigen Wert zu verdichten, können Sie Transformationen nur auf diesen einzelnen Wert anwenden.

## Fügen Sie Daten eine Transformationsfunktion hinzu
<a name="v9-panels-xform-add"></a>

Die folgenden Schritte führen Sie durch das Hinzufügen einer Transformation zu Daten.

**Um eine Transformation zu einem Panel hinzuzufügen**

1. Navigieren Sie zu dem Bereich, in dem Sie eine oder mehrere Transformationen hinzufügen möchten.

1. Wählen Sie den Titel des Bedienfelds und klicken Sie dann auf **Bearbeiten**.

1. Wählen Sie die Registerkarte **Transform (Transformation)** aus.

1. Wählen Sie eine Transformation aus. Eine Transformationszeile wird angezeigt, in der Sie die Transformationsoptionen konfigurieren.

1. Um eine weitere Transformation anzuwenden, wählen Sie **Transformation hinzufügen**. Diese Transformation wirkt sich auf die Ergebnismenge aus, die von der vorherigen Transformation zurückgegeben wurde.

## Debuggen Sie eine Transformation
<a name="v9-panels-xform-debug"></a>

Um die Eingabe- und Ausgaberesultsets der Transformation zu sehen, wählen Sie das Bugsymbol auf der rechten Seite der Transformationszeile.

Die Eingabe- und Ausgabeergebnissätze können Ihnen beim Debuggen einer Transformation helfen.

## Löschen Sie eine Transformation
<a name="v9-panels-xform-delete"></a>

Wir empfehlen, Transformationen zu entfernen, die Sie nicht benötigen. Wenn Sie eine Transformation löschen, entfernen Sie die Daten aus der Visualisierung.

Voraussetzungen:

Identifizieren Sie alle Dashboards, die auf der Transformation basieren, und informieren Sie die betroffenen Dashboard-Benutzer.

**Um eine Transformation zu löschen**

1. Öffnen Sie ein Panel zur Bearbeitung.

1. Wählen Sie die Registerkarte **Transform (Transformation)** aus.

1. Wählen Sie das Papierkorbsymbol neben der Transformation, die Sie löschen möchten.

## Transformationsfunktionen
<a name="v9-panels-xform-functions"></a>

Sie können die folgenden Transformationen an Ihren Daten durchführen.

**Feld aus Berechnung hinzufügen**

Verwenden Sie diese Transformation, um ein neues Feld hinzuzufügen, das aus zwei anderen Feldern berechnet wurde. Mit jeder Transformation können Sie ein neues Feld hinzufügen.
+ **Modus** — Wählen Sie einen Modus aus:
  + **Zeile reduzieren** — Wendet die ausgewählte Formel unabhängig auf jede Zeile der ausgewählten Felder an.
  + **Binäre Option** — Wendet grundlegende mathematische Operationen (Summe, Multiplikation usw.) auf Werte in einer einzelnen Zeile aus zwei ausgewählten Feldern an.
+ **Feldname** — Wählen Sie die Namen der Felder aus, die Sie in der Berechnung für das neue Feld verwenden möchten.
+ **Berechnung** — Wenn Sie den Modus **Zeile reduzieren** wählen, wird das Feld **Formel** angezeigt. Klicken Sie in das Feld, um eine Liste der Berechnungsoptionen anzuzeigen, mit denen Sie das neue Feld erstellen können. Informationen zu verfügbaren Berechnungen finden Sie unter [Berechnungstypen](v9-panels-calculation-types.md).
+ **Operation** — Wenn Sie den Modus **Binäre Option** wählen, werden die Felder **Operation** angezeigt. Mit diesen Feldern können Sie grundlegende mathematische Operationen mit Werten in einer einzelnen Zeile aus zwei ausgewählten Feldern ausführen. Sie können numerische Werte auch für binäre Operationen verwenden.
+ **Alias** — (Optional) Geben Sie den Namen Ihres neuen Felds ein. Wenn Sie dieses Feld leer lassen, wird das Feld so benannt, dass es der Formel entspricht.
+ **Alle Felder ersetzen** — (Optional) Wählen Sie diese Option, wenn Sie alle anderen Felder ausblenden und nur Ihr berechnetes Feld in der Visualisierung anzeigen möchten.

**Verketten Sie Felder**

Diese Transformation kombiniert alle Felder aus allen Frames zu einem Ergebnis. Betrachten Sie diese beiden Abfragen.

Abfrage A:


| Temporäre Dateien | Betriebszeit | 
| --- | --- | 
|  15,4  |  1230233  | 

Anfrage B:


| AQI | Fehler | 
| --- | --- | 
|  3.2  |  5  | 

Nachdem Sie die Felder verkettet haben, würde der Datenrahmen wie folgt aussehen:


| Temporäre Dateien | Betriebszeit | AQI | Fehler | 
| --- | --- | --- | --- | 
|  15,4  |  1230233  |  3.2  |  5  | 

**Config aus Abfrageergebnissen**

Mit dieser Transformation können Sie eine Abfrage auswählen und daraus Standardoptionen wie **Min., **Max**.**, **Einheit** und **Schwellenwerte** extrahieren und auf andere Abfrageergebnisse anwenden. Dies ermöglicht eine dynamische, abfragegesteuerte Visualisierungskonfiguration.

Wenn Sie für jede Zeile im Ergebnis der Konfigurationsabfrage eine eindeutige Konfiguration extrahieren möchten, versuchen Sie es mit der Transformation von Zeilen in Felder.

**Optionen**
+ **Konfigurationsabfrage** — Wählen Sie die Abfrage aus, die die Daten zurückgibt, die Sie als Konfiguration verwenden möchten.
+ **Anwenden auf** — Wählen Sie aus, auf welche Felder oder Reihen die Konfiguration angewendet werden soll.
+ Auf **Optionen anwenden** — In der Regel ein regulärer Feldtyp oder ein Feldname, je nachdem, welche Option Sie unter **Anwenden** auf ausgewählt haben.

**Feldtyp konvertieren**

Diese Transformation ändert den Feldtyp des angegebenen Felds.
+ **Feld** — Wählen Sie aus verfügbaren Feldern aus
+ **als** — Wählen Sie das aus, in das FieldType konvertiert werden soll
  + **Numerisch** — versucht, die Werte zu Zahlen zu machen
  + **Zeichenfolge** — macht die Werte zu Zeichenketten
  + **Zeit** — versucht, die Werte als Zeit zu analysieren
    + Zeigt eine Option an, um a DateFormat als Eingabe mit einer Zeichenfolge wie yyyy-mm-dd oder DD MM YYYY hh:mm:ss anzugeben
  + Boolean — macht die Werte zu **Boolean**

Beispielsweise könnte die folgende Abfrage geändert werden, indem das Zeitfeld als Uhrzeit und das Datumsformat als YYYY ausgewählt wird.


| Zeit | Markieren | Wert | 
| --- | --- | --- | 
|  1.7.2017  |  über  |  25  | 
|  8/2/2018  |  unten  |  22  | 
|  9/2/2019  |  unten  |  29  | 
|  4.10.2020  |  über  |  22  | 

Das Ergebnis:


| Zeit | Mark | Wert | 
| --- | --- | --- | 
|  1.1.2017  |  über  |  25  | 
|  1.1.2018  |  unten  |  22  | 
|  1.1.2019  |  unten  |  29  | 
|  1.1.2020  |  über  |  22  | 

**Daten nach Namen filtern**

Verwenden Sie diese Transformation, um Teile der Abfrageergebnisse zu entfernen.

Grafana zeigt das Feld **Identifier** an, gefolgt von den Feldern, die von Ihrer Abfrage zurückgegeben wurden.

Sie können Filter auf zwei Arten anwenden:
+ Geben Sie einen Regex-Ausdruck ein.
+ Wählen Sie ein Feld aus, um die Filterung für dieses Feld umzuschalten. Gefilterte Felder werden mit dunkelgrauem Text angezeigt, ungefilterte Felder haben weißen Text.

**Daten nach Abfragen filtern**

Verwenden Sie diese Transformation in Bedienfeldern mit mehreren Abfragen, wenn Sie eine oder mehrere Abfragen ausblenden möchten.

Grafana zeigt die Abfrage-Identifikationsbuchstaben in dunkelgrauem Text an. Klicken Sie auf eine Abfrage-ID, um die Filterung umzuschalten. Wenn der Abfragebuchstabe weiß ist, werden die Ergebnisse angezeigt. Wenn der Abfragebuchstabe dunkel ist, sind die Ergebnisse ausgeblendet.

**Anmerkung**  
Diese Transformation ist für Graphite nicht verfügbar, da diese Datenquelle die Korrelation zurückgegebener Daten mit Abfragen nicht unterstützt.

**Daten nach Wert filtern**

Diese Transformation ermöglicht es Ihnen, Ihre Daten direkt in Grafana zu filtern und einige Datenpunkte aus Ihrem Abfrageergebnis zu entfernen. Sie haben die Möglichkeit, Daten ein- oder auszuschließen, die einer oder mehreren von Ihnen definierten Bedingungen entsprechen. Die Bedingungen werden auf ein ausgewähltes Feld angewendet.

Diese Transformation ist nützlich, wenn Ihre Datenquelle nicht nativ nach Werten filtert. Sie können dies auch verwenden, um die anzuzeigenden Werte einzugrenzen, wenn Sie eine gemeinsam genutzte Abfrage verwenden.

Die verfügbaren Bedingungen für alle Felder sind:
+ **Regex — Entspricht** einem Regex-Ausdruck
+ **Ist Null — Stimmt** überein, wenn der Wert Null ist
+ **Ist nicht Null** — Stimmt überein, wenn der Wert nicht Null ist
+ **Gleich — Entspricht**, wenn der Wert dem angegebenen Wert entspricht
+ **Anders** — entspricht, wenn der Wert vom angegebenen Wert abweicht

Die verfügbaren Bedingungen für Zahlenfelder sind:
+ **Größer** — Entspricht, wenn der Wert größer als der angegebene Wert ist
+ **Niedriger** — Entspricht, wenn der Wert niedriger als der angegebene Wert ist
+ **Größer oder gleich — Entspricht**, wenn der Wert größer oder gleich ist
+ **Niedriger oder gleich — Entspricht**, wenn der Wert niedriger oder gleich ist
+ **Bereich** — Entspricht einem Bereich zwischen einem bestimmten Minimum und Maximum, einschließlich Mindest- und Höchstwert

Betrachten Sie den folgenden Datensatz:


| Zeit | Temperatur | Höhe | 
| --- | --- | --- | 
|  07.07.2020 11:34:23 UHR  |  32  |  101  | 
|  07.07.2020 11:34:22 UHR  |  28  |  125  | 
|  07.07.2020 11:34:21 UHR  |  26  |  110  | 
|  07.07.2020 11:34:20 UHR  |  23  |  98  | 
|  07.07.2020 10:32:24 UHR  |  31  |  95  | 
|  07.07.2020 10:31:22 UHR  |  20  |  85  | 
|  07.07.2020 09:30:57 UHR  |  19  |  101  | 

Wenn Sie die Datenpunkte mit einer Temperatur unter 30 °C **einbeziehen**, sieht die Konfiguration wie folgt aus:
+ **Filtertyp** — `Include`
+ **Bedingung** — Zeilen mit `Temperature` Übereinstimmungen `Lower Than 30`

Und Sie erhalten das folgende Ergebnis, bei dem nur die Temperaturen unter 30 °C berücksichtigt werden:


| Zeit | Temperatur | Höhe | 
| --- | --- | --- | 
|  07.07.2020 11:34:22 UHR  |  28  |  125  | 
|  07.07.2020 11:34:21 UHR  |  26  |  110  | 
|  07.07.2020 11:34:20 UHR  |  23  |  98  | 
|  07.07.2020 10:31:22 UHR  |  20  |  85  | 
|  07.07.2020 09:30:57 UHR  |  19  |  101  | 

Sie können dem Filter mehr als eine Bedingung hinzufügen. Möglicherweise möchten Sie die Daten nur einbeziehen, wenn die Höhe größer als 100 ist. Fügen Sie dazu diese Bedingung der folgenden Konfiguration hinzu:
+ Filtertyp — `Include` Zeilen, die `Match All` Bedingungen erfüllen
+ Bedingung 1 — Zeilen, in denen `Temperature` Übereinstimmungen `Lower` mit `30`
+ Bedingung 2 — Zeilen, in denen `Altitude` Übereinstimmungen `Greater` mit `100`

Wenn Sie mehr als eine Bedingung haben, können Sie wählen, ob die Aktion (Einschließen/Ausschließen) auf Zeilen angewendet werden soll, die **allen Bedingungen **entsprechen**** oder einer der von Ihnen hinzugefügten Bedingungen entsprechen.

Im obigen Beispiel haben wir **Match All** ausgewählt, weil wir die Zeilen mit einer Temperatur unter 30 UND einer Höhe über 100 einbeziehen wollten. Wenn wir stattdessen die Zeilen mit einer Temperatur unter 30 ODER einer Höhe von über 100 einbeziehen wollten, würden wir **Match any** auswählen. Dies würde die erste Zeile in den Originaldaten einschließen, die eine Temperatur von 32 °C hat (entspricht nicht der ersten Bedingung), aber eine Höhe von 101 (was der zweiten Bedingung entspricht), also ist sie enthalten.

Bedingungen, die ungültig oder unvollständig konfiguriert sind, werden ignoriert.

**Group by** (Gruppierung nach)

Diese Transformation gruppiert die Daten nach einem bestimmten Feldwert (Spaltenwert) und verarbeitet Berechnungen für jede Gruppe. Klicken Sie hier, um eine Liste mit Berechnungsoptionen anzuzeigen.

Hier ist ein Beispiel für Originaldaten.


| Zeit | Server ID | CPU-Temperatur | Status des Servers | 
| --- | --- | --- | --- | 
|  07.07.2020 11:34:20 UHR  |  Server 1  |  80  |  Herunterfahren  | 
|  07.07.2020 11:34:20 UHR  |  Server 3  |  62  |  OK  | 
|  07.07.2020 10:32:20 UHR  |  Server 2  |  90  |  Überlastung  | 
|  07.07.2020 10:31:22 UHR  |  Server 3  |  55  |  OK  | 
|  07.07.2020 9:30:57 UHR  |  Server 3  |  62  |  Rebooting  | 
|  07.07.2020 9:30:05 UHR  |  Server 2  |  88  |  OK  | 
|  07.07.2020 9:28:06 UHR  |  Server 1  |  80  |  OK  | 
|  07.07.2020 9:25:05 UHR  |  Server 2  |  88  |  OK  | 
|  07.07.2020 9:23:07 UHR  |  Server 1  |  86  |  OK  | 

Diese Transformation erfolgt in zwei Schritten. Zuerst geben Sie ein oder mehrere Felder an, nach denen die Daten gruppiert werden sollen. Dadurch werden dieselben Werte dieser Felder gruppiert, als ob Sie sie sortiert hätten. Wenn wir beispielsweise nach dem Server-ID-Feld gruppieren, würden die Daten wie folgt gruppiert:


| Zeit | Server ID | CPU-Temperatur | Status des Servers | 
| --- | --- | --- | --- | 
|  07.07.2020 11:34:20 UHR  |  Server 1  |  80  |  Herunterfahren  | 
|  07.07.2020 9:28:06 UHR  |  Server 1  |  80  |  OK  | 
|  07.07.2020 9:23:07 UHR  |  Server 1  |  86  |  OK  | 
|  07.07.2020 10:32:20 UHR  |  Server 2  |  90  |  Überlastung  | 
|  07.07.2020 9:30:05 UHR  |  Server 2  |  88  |  OK  | 
|  07.07.2020 9:25:05 UHR  |  Server 2  |  88  |  OK  | 
|  07.07.2020 11:34:20 UHR  |  Server 3  |  62  |  OK  | 
|  07.07.2020 10:31:22 UHR  |  Server 3  |  55  |  OK  | 
|  07.07.2020 9:30:57 UHR  |  Server 3  |  62  |  Rebooting  | 

Alle Zeilen mit demselben Wert für die Server-ID werden gruppiert.

Nachdem Sie ausgewählt haben, nach welchem Feld Sie Ihre Daten gruppieren möchten, können Sie verschiedene Berechnungen für die anderen Felder hinzufügen und die Berechnung auf jede Zeilengruppe anwenden. Wir könnten zum Beispiel die durchschnittliche CPU-Temperatur für jeden dieser Server berechnen wollen. Wir können also die *Mittelwertberechnung* hinzufügen, die auf das Feld CPU-Temperatur angewendet wird, um Folgendes zu erhalten:


| Server ID | CPU-Temperatur (Mittelwert) | 
| --- | --- | 
|  Server 1  |  82  | 
|  Server 2  |  88,6  | 
|  Server 3  |  59,6  | 

Und wir können mehr als eine Berechnung hinzufügen. Zum Beispiel:
+ Für das Feld Time können wir den *letzten* Wert berechnen, um zu wissen, wann der letzte Datenpunkt für jeden Server empfangen wurde
+ Für das Feld Serverstatus können wir den *letzten* Wert berechnen, um den letzten Statuswert für jeden Server zu ermitteln
+ Für das Feld Temperatur können wir auch den *letzten* Wert berechnen, um zu erfahren, welche Temperatur für jeden Server zuletzt überwacht wurde

Wir würden dann erhalten:


| Server ID | CPU-Temperatur (Mittelwert) | CPU-Temperatur (letzte) | Zeit (letzte) | Serverstatus (zuletzt) | 
| --- | --- | --- | --- | --- | 
|  Server 1  |  82  |  80  |  07.07.2020 11:34:20 UHR  |  Herunterfahren  | 
|  Server 2  |  88,6  |  90  |  07.07.2020 10:32:20 UHR  |  Überlastung  | 
|  Server 3  |  59,6  |  62  |  07.07.2020 11:34:20 UHR  |  OK  | 

Diese Transformation ermöglicht es Ihnen, wichtige Informationen aus Ihrer Zeitreihe zu extrahieren und sie auf bequeme Weise anzuzeigen.

**Nach Feld verbinden**

Verwenden Sie diese Transformation, um mehrere Ergebnisse zu einer einzigen Tabelle zusammenzuführen. Dies ist besonders nützlich, wenn Sie mehrere Zeitreihenergebnisse in eine einzige große Tabelle mit einem gemeinsamen Zeitfeld konvertieren möchten.

*Innere Verbindung*

Bei einer inneren Verknüpfung werden Daten aus mehreren Tabellen zusammengeführt, wobei alle Tabellen denselben Wert aus dem ausgewählten Feld haben. Diese Art der Verknüpfung schließt Daten aus, bei denen die Werte nicht in jedem Ergebnis übereinstimmen.

Verwenden Sie diese Transformation, um die Ergebnisse mehrerer Abfragen (Kombination aus einem übergebenen Join-Feld oder der ersten Zeitspalte) zu einem Ergebnis zu kombinieren und Zeilen zu löschen, in denen eine erfolgreiche Verknüpfung nicht möglich ist.

Im folgenden Beispiel geben zwei Abfragen Tabellendaten zurück. Es wird als zwei separate Tabellen visualisiert, bevor die innere Join-Transformation angewendet wird.

Abfrage A:


| Zeit | Aufgabe | Betriebszeit | 
| --- | --- | --- | 
|  07.07.2020 11:34:20 UHR  |  node  |  25260122  | 
|  07.07.2020 11:24:20 UHR  |  Postfach  |  123001233  | 
|  07.07.2020 11:14:20 UHR  |  Postfach  |  345001233  | 

Anfrage B:


| Zeit | Server | Fehler | 
| --- | --- | --- | 
|  07.07.2020 11:34:20 UHR  |  Server 1  |  15  | 
|  07.07.2020 11:24:20 UHR  |  Server 2  |  5  | 
|  07.07.2020 11:04:20 UHR  |  Server 3  |  10  | 

Das Ergebnis nach der Anwendung der inneren Join-Transformation sieht wie folgt aus:


| Zeit | Aufgabe | Betriebszeit | Server | Fehler | 
| --- | --- | --- | --- | --- | 
|  07.07.2020 11:34:20 UHR  |  node  |  25260122  |  Server 1  |  15  | 
|  07.07.2020 11:24:20 UHR  |  Postfach  |  123001233  |  Server 2  |  5  | 

*Äußere Verbindung*

Ein äußerer Join umfasst alle Daten aus einem inneren Join und Zeilen, in denen die Werte nicht in jeder Eingabe übereinstimmen. Während die innere Verknüpfung Abfrage A und Abfrage B im Zeitfeld verknüpft, umfasst die äußere Verknüpfung alle Zeilen, die im Zeitfeld nicht übereinstimmen.

Im folgenden Beispiel geben zwei Abfragen Tabellendaten zurück. Es wird als zwei Tabellen visualisiert, bevor die Outer-Join-Transformation angewendet wird.

Abfrage A:


| Zeit | Aufgabe | Betriebszeit | 
| --- | --- | --- | 
|  07.07.2020 11:34:20 UHR  |  node  |  25260122  | 
|  07.07.2020 11:24:20 UHR  |  Postfach  |  123001233  | 
|  07.07.2020 11:14:20 UHR  |  Postfach  |  345001233  | 

Anfrage B:


| Zeit | Server | Fehler | 
| --- | --- | --- | 
|  07.07.2020 11:34:20 UHR  |  Server 1  |  15  | 
|  07.07.2020 11:24:20 UHR  |  Server 2  |  5  | 
|  07.07.2020 11:04:20 UHR  |  Server 3  |  10  | 

Das Ergebnis nach der Anwendung der Outer-Join-Transformation sieht wie folgt aus:


| Zeit | Aufgabe | Betriebszeit | Server | Fehler | 
| --- | --- | --- | --- | --- | 
|  07.07.2020 11:04:20 UHR  |    |    |  Server 3  |  10  | 
|  07.07.2020 11:14:20 UHR  |  Postfach  |  345001233  |    |    | 
|  07.07.2020 11:34:20 UHR  |  node  |  25260122  |  Server 1  |  15  | 
|  07.07.2020 11:24:20 UHR  |  Postfach  |  123001233  |  Server 2  |  5  | 

**Beschriftungen für Felder**

Durch diese Transformation werden Zeitreihenergebnisse, die Beschriftungen oder Tags enthalten, in eine Tabelle umgewandelt, in der alle Labelschlüssel und -werte im Tabellenergebnis enthalten sind. Die Beschriftungen können entweder als Spalten- oder als Zeilenwerte angezeigt werden.

Bei einem Abfrageergebnis aus zwei Zeitreihen:
+ Serie 1 — Beschriftungen Server=Server A, DataCenter=EU
+ Serie 2 — Bezeichnungen Server=Server B, DataCenter=EU

Im **Spaltenmodus sieht** das Ergebnis wie folgt aus:


| Zeit | Server | Rechenzentrum | Wert | 
| --- | --- | --- | --- | 
|  07.07.2020 11:34:20 UHR  |  Server A  |  EU  |  1  | 
|  07.07.2020 11:34:20 UHR  |  Server B  |  EU  |  2  | 

Im Modus „Zeilen“ enthält das Ergebnis eine Tabelle für jede Reihe und zeigt jeden Labelwert wie folgt an:


| Bezeichnung | value | 
| --- | --- | 
|  Server  |  Server A  | 
|  Rechenzentrum  |  EU  | 


| Bezeichnung | value | 
| --- | --- | 
|  Server  |  Server B  | 
|  Rechenzentrum  |  EU  | 

*Name des Wertefeldes*

Wenn Sie Server als **Namen für das Wertfeld** ausgewählt haben, erhalten Sie für jeden Wert der Serverbezeichnung ein Feld.


| Zeit | Rechenzentrum | Server A | Server B | 
| --- | --- | --- | --- | 
|  07.07.2020 11:34:20 UHR  |  EU  |  1  |  2  | 

*Verhalten beim Zusammenführen*

Der Transformator „Labels to Fields“ besteht intern aus zwei getrennten Transformationen. Die erste Methode bezieht sich auf einzelne Datenreihen und extrahiert Beschriftungen in Felder. Die zweite ist die Zusammenführungstransformation, die alle Ergebnisse in einer einzigen Tabelle zusammenfasst. Die Zusammenführungstransformation versucht, alle übereinstimmenden Felder zu verknüpfen. Dieser Zusammenführungsschritt ist erforderlich und kann nicht deaktiviert werden. 

**Anmerkung**  
Die Transformation zum *Zusammenführen* kann eigenständig verwendet werden und wird im Folgenden ausführlich beschrieben.

Um dies zu veranschaulichen, finden Sie hier ein Beispiel mit zwei Abfragen, die Zeitreihen ohne überlappende Beschriftungen zurückgeben.
+ Serie 1 — Labels Server=ServerA
+ Serie 2 — Labels DataCenter=EU

Dies wird zunächst zu diesen beiden Tabellen führen:


| Zeit | Server | Wert | 
| --- | --- | --- | 
|  07.07.2020 11:34:20 UHR  |  Server A  |  10  | 


| Zeit | Rechenzentrum | Wert | 
| --- | --- | --- | 
|  07.07.2020 11:34:20 UHR  |  EU  |  20  | 

Nach der Zusammenführung:


| Zeit | Server | Wert | Rechenzentrum | 
| --- | --- | --- | --- | 
|  07.07.2020 11:34:20 UHR  |  Server A  |  10  |    | 
|  07.07.2020 11:34:20 UHR  |    |  20  |  EU  | 

**Mischen von**

Verwenden Sie diese Transformation, um das Ergebnis mehrerer Abfragen zu einem einzigen Ergebnis zu kombinieren. Dies ist hilfreich, wenn Sie die Tabellenfenster-Visualisierung verwenden. Werte, die zusammengeführt werden können, werden in derselben Zeile zusammengefasst. Werte können zusammengeführt werden, wenn die gemeinsam genutzten Felder dieselben Daten enthalten.

Im folgenden Beispiel haben wir zwei Abfragen, die Tabellendaten zurückgeben. Es wird als zwei separate Tabellen visualisiert, bevor die Transformation angewendet wird.

Abfrage A:


| Zeit | Aufgabe | Betriebszeit | 
| --- | --- | --- | 
|  07.07.2020 11:34:20 UHR  |  node  |  25260122  | 
|  07.07.2020 11:24:20 UHR  |  Postfach  |  123001233  | 

Anfrage B:


| Zeit | Aufgabe | Fehler | 
| --- | --- | --- | 
|  07.07.2020 11:34:20 UHR  |  node  |  15  | 
|  07.07.2020 11:24:20 UHR  |  Postfach  |  5  | 

Hier ist das Ergebnis nach der Anwendung der Merge-Transformation:


| Zeit | Aufgabe | Fehler | Betriebszeit | 
| --- | --- | --- | --- | 
|  07.07.2020 11:34:20 UHR  |  node  |  15  |  25260122  | 
|  07.07.2020 11:24:20 UHR  |  Postfach  |  5  |  123001233  | 

**Organisieren Sie Felder**

Verwenden Sie diese Transformation, um die von der Abfrage zurückgegebenen Felder umzubenennen, neu anzuordnen oder auszublenden.

**Anmerkung**  
Diese Transformation funktioniert nur in Panels mit einer einzigen Abfrage. Wenn Ihr Panel über mehrere Abfragen verfügt, müssen Sie entweder eine Outer Join-Transformation anwenden oder die zusätzlichen Abfragen entfernen.

Grafana zeigt eine Liste der Felder an, die von der Abfrage zurückgegeben wurden. Sie können:
+ Ändern Sie die Reihenfolge der Felder, indem Sie den Mauszeiger über ein Feld bewegen. Der Cursor verwandelt sich in eine Hand, und dann können Sie das Feld an die neue Position ziehen.
+ Ein Feld ein- oder ausblenden, indem Sie auf das Augensymbol neben dem Feldnamen klicken.
+ Benennen Sie Felder um, indem Sie einen neuen Namen in das Feld Umbenennen eingeben.

**Partitionierung nach Werten**

Diese Transformation kann dazu beitragen, dass bei der grafischen Darstellung mehrerer Reihen nicht mehrere Abfragen an dieselbe Datenquelle mit unterschiedlichen `WHERE` Klauseln erforderlich sind. Stellen Sie sich eine SQL-Tabelle mit Metriken mit den folgenden Daten vor:


| Zeit | Region | Wert | 
| --- | --- | --- | 
|  20.10.2022 12:00:00 UHR  |  US  |  1520  | 
|  20.10.2022 12:00:00 UHR  |  EU  |  2936  | 
|  20.10.2022 01:00:00 UHR  |  US  |  1327  | 
|  20.10.2022 01:00:00 UHR  |  EU  |  912  | 

Wenn Sie vor Version 9.3 im selben TimeSeries Panel eine rote Trendlinie für die USA und eine blaue Trendlinie für die EU zeichnen wollten, mussten Sie dies wahrscheinlich in zwei Abfragen aufteilen:

```
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='US'
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='EU'
```

Dazu müssen Sie auch im Voraus wissen, welche Regionen tatsächlich in der Metriktabelle enthalten sind.

Mit dem Transformator „*Nach Werten partitionieren*“ können Sie jetzt eine einzelne Abfrage ausführen und die Ergebnisse nach eindeutigen Werten in einer oder mehreren Spalten (`fields`) Ihrer Wahl aufteilen. Im folgenden Beispiel wird `Region` verwendet.

```
SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'
```


| Zeit | Region | Wert | 
| --- | --- | --- | 
|  20.10.2022 12:00:00 UHR  |  US  |  1520  | 
|  20.10.2022 01:00:00 UHR  |  US  |  1327  | 


| Zeit | Region | Wert | 
| --- | --- | --- | 
|  20.10.2022 12:00:00 UHR  |  EU  |  2936  | 
|  20.10.2022 01:00:00 UHR  |  EU  |  912  | 

**Reduzieren**

Die Transformation zum *Reduzieren* wendet eine Berechnung auf jedes Feld im Frame an und gibt einen einzelnen Wert zurück. Zeitfelder werden entfernt, wenn diese Transformation angewendet wird.

Betrachten Sie die Eingabe:

Abfrage A:


| Zeit | Temporäre Dateien | Betriebszeit | 
| --- | --- | --- | 
|  07.07.2020 11:34:20 UHR  |  12.3  |  256122  | 
|  07.07.2020 11:24:20 UHR  |  15,4  |  1230233  | 

Anfrage B:


| Zeit | AQI | Fehler | 
| --- | --- | --- | 
|  07.07.2020 11:34:20 UHR  |  6,5  |  15  | 
|  07.07.2020 11:24:20 UHR  |  3.2  |  5  | 

Der Reduktionstransformator hat zwei Modi:
+ **Reihe zu Zeilen** — Erstellt eine Zeile für jedes Feld und eine Spalte für jede Berechnung.
+ **Felder reduzieren** — Behält die bestehende Rahmenstruktur bei, reduziert jedoch jedes Feld auf einen einzigen Wert.

Wenn Sie beispielsweise die **erste** und **letzte** Berechnung mit einer Transformation von **Datenreihen in Zeilen** verwenden würden, wäre das Ergebnis:


| Feld | Erste | Letzte | 
| --- | --- | --- | 
|  Temporäre Dateien  |  12.3  |  15.4  | 
|  Betriebszeit  |  256122  |  1230233  | 
|  AQI  |  6,5  |  3.2  | 
|  Fehler  |  15  |  5  | 

Die Formel Felder mit der letzten Option reduzieren ergibt zwei Frames mit jeweils einer Zeile:

Abfrage A:


| Temporäre Dateien | Betriebszeit | 
| --- | --- | 
|  15,4  |  1230233  | 

Anfrage B:


| AQI | Fehler | 
| --- | --- | 
|  3.2  |  5  | 

**Mit Regex umbenennen**

Verwenden Sie diese Transformation, um Teile der Abfrageergebnisse mithilfe eines regulären Ausdrucks und eines Ersatzmusters umzubenennen.

Sie können einen regulären Ausdruck angeben, der nur auf Treffer angewendet wird, sowie ein Ersatzmuster, das Rückverweise unterstützt. Stellen wir uns zum Beispiel vor, Sie visualisieren die CPU-Auslastung pro Host und möchten den Domainnamen entfernen. Sie könnten die Regex auf setzen `([^\.]+)\..+` und das Ersatzmuster auf`$1`, `web-01.example.com` würde werden. `web-01`

**Zeilen zu Feldern**

Die Transformation von Zeilen in Felder konvertiert Zeilen in separate Felder. Dies kann nützlich sein, da Felder individuell gestaltet und konfiguriert werden können. Es kann auch zusätzliche Felder als Quellen für die dynamische Feldkonfiguration verwenden oder sie Feldbeschriftungen zuordnen. Die zusätzlichen Beschriftungen können dann verwendet werden, um bessere Anzeigenamen für die resultierenden Felder zu definieren.

Diese Transformation umfasst eine Feldtabelle, die alle Felder in den von der Konfigurationsabfrage zurückgegebenen Daten auflistet. Diese Tabelle gibt Ihnen die Kontrolle darüber, welches Feld jeder Konfigurationseigenschaft zugeordnet werden soll (die Option \$1Verwenden als\$1\$1). Sie können auch wählen, welcher Wert ausgewählt werden soll, wenn die zurückgegebenen Daten mehrere Zeilen enthalten.

Diese Transformation erfordert:
+ Ein Feld, das als Quelle für Feldnamen verwendet werden soll.

  Standardmäßig verwendet die Transformation das erste Zeichenkettenfeld als Quelle. Sie können diese Standardeinstellung überschreiben, indem Sie **Feldname** in der Spalte **Verwenden als** für das Feld auswählen, das Sie stattdessen verwenden möchten.
+ Ein Feld, das als Wertequelle verwendet werden soll.

  Standardmäßig verwendet die Transformation das erste Zahlenfeld als Quelle. Sie können diese Standardeinstellung jedoch überschreiben, indem Sie in der Spalte **Als verwenden** für das **Feld, das Sie stattdessen verwenden möchten, die Option Feldwert** auswählen.

Nützlich bei der Visualisierung von Daten in:
+ Messinstrument
+ Stat
+ Kreisdiagramm

*Ordnen Sie zusätzliche Felder Beschriftungen zu*

Wenn ein Feld nicht der Konfigurationseigenschaft zugeordnet ist, verwendet Grafana es automatisch als Quelle für ein Label im Ausgabefeld-

Beispiel:


| Name | DataCenter | Wert | 
| --- | --- | --- | 
|  ServerA  |  US  |  100  | 
|  Server B  |  EU  |  200  | 

Ausgabe:


| ServerA (Bezeichnungen DataCenter: US) | ServerB (Etiketten: DataCenter: EU) | 
| --- | --- | 
|  10  |  20  | 

Die zusätzlichen Beschriftungen können jetzt im Feld Anzeigename verwendet werden, um vollständigere Feldnamen bereitzustellen.

Wenn Sie die Konfiguration aus einer Abfrage extrahieren und auf eine andere anwenden möchten, sollten Sie die Konfiguration aus der Transformation der Abfrageergebnisse verwenden.

*Beispiel*

Eingabe:


| Name | Wert | Max | 
| --- | --- | --- | 
|  Server A  |  10  |  100  | 
|  Server B  |  20  |  200  | 
|  Server C  |  30  |  300  | 

Ausgabe:


| ServerA (Konfiguration: max=100) | ServerB (Konfiguration: max=200) | ServerC (Konfiguration: max=300) | 
| --- | --- | --- | 
|  10  |  20  |  30  | 

Wie Sie sehen können, wird jede Zeile in den Quelldaten zu einem separaten Feld. Für jedes Feld ist jetzt auch eine maximale Konfigurationsoption festgelegt. Optionen wie Min., Max., Einheit und Schwellenwerte sind alle Teil der Feldkonfiguration. Wenn sie so eingestellt sind, werden sie von der Visualisierung anstelle von Optionen verwendet, die manuell im Optionsbereich des Panel-Editors konfiguriert wurden.

**Bereiten Sie Zeitreihen vor**

Die Zeitreihentransformation vorbereiten ist nützlich, wenn eine Datenquelle Zeitreihendaten in einem Format zurückgibt, das von dem Panel, das Sie verwenden möchten, nicht unterstützt wird.

Diese Transformation hilft Ihnen, dieses Problem zu lösen, indem Sie die Zeitreihendaten entweder vom Breitformat in das Langformat oder umgekehrt konvertieren.

Wählen Sie die Option „**Zeitreihen mit mehreren Frames**“, um den Zeitreihendatenrahmen vom Breitformat in das Langformat umzuwandeln.

Wählen Sie die Option **Breite Zeitreihe**, um den Zeitreihen-Datenrahmen vom Langformat in das Breitformat umzuwandeln.

**Reihe in Zeilen**

Verwenden Sie diese Transformation, um das Ergebnis mehrerer Zeitreihen-Datenabfragen zu einem einzigen Ergebnis zu kombinieren. Dies ist hilfreich, wenn Sie die Tabellenfenster-Visualisierung verwenden.

Das Ergebnis dieser Transformation wird drei Spalten enthalten: Zeit, Metrik und Wert. Die Spalte Metrik wurde hinzugefügt, sodass Sie leicht erkennen können, aus welcher Abfrage die Metrik stammt. Passen Sie diesen Wert an, indem Sie Label in der Quellabfrage definieren.

Im folgenden Beispiel haben wir zwei Abfragen, die Zeitreihendaten zurückgeben. Es wird als zwei separate Tabellen visualisiert, bevor die Transformation angewendet wird.

Abfrage A:


| Zeit | Temperatur | 
| --- | --- | 
|  07.07.2020 11:34:20 UHR  |  25  | 
|  07.07.2020 10:31:22 UHR  |  22  | 
|  07.07.2020 09:30:05 UHR  |  19  | 

Anfrage B:


| Zeit | Feuchte | 
| --- | --- | 
|  07.07.2020 11:34:20 UHR  |  24  | 
|  07.07.2020 10:32:20 UHR  |  29  | 
|  07.07.2020 09:30:57 UHR  |  33  | 

Hier ist das Ergebnis nach der Anwendung der Transformation „Serie auf Zeilen“.


| Zeit | Metrik | Wert | 
| --- | --- | --- | 
|  07.07.2020 11:34:20 UHR  |  Temperatur  |  25  | 
|  07.07.2020 11:34:20 UHR  |  Luftfeuchtigkeit  |  22  | 
|  07.07.2020 10:32:20 UHR  |  Feuchtigkeit  |  29  | 
|  07.07.2020 10:31:22 UHR  |  Temperatur  |  22  | 
|  07.07.2020 09:30:57 UHR  |  Luftfeuchtigkeit  |  33  | 
|  07.07.2020 9:30:05 UHR  |  Temperatur  |  19  | 

**Sortiere nach**

Diese Transformation sortiert jeden Frame nach dem konfigurierten Feld. Wenn diese Option aktiviert `reverse` ist, werden die Werte in umgekehrter Reihenfolge zurückgegeben.

**Limit**

Verwenden Sie diese Transformation, um die Anzahl der angezeigten Zeilen zu begrenzen.

Im folgenden Beispiel haben wir die folgende Antwort von der Datenquelle:


| Zeit | Metrik | Wert | 
| --- | --- | --- | 
|  07.07.2020 11:34:20 UHR  |  Temperatur  |  25  | 
|  07.07.2020 11:34:20 UHR  |  Luftfeuchtigkeit  |  22  | 
|  07.07.2020 10:32:20 UHR  |  Feuchtigkeit  |  29  | 
|  07.07.2020 10:31:22 UHR  |  Temperatur  |  22  | 
|  07.07.2020 09:30:57 UHR  |  Luftfeuchtigkeit  |  33  | 
|  07.07.2020 9:30:05 UHR  |  Temperatur  |  19  | 

Hier ist das Ergebnis nach dem Hinzufügen einer Limit-Transformation mit dem Wert '3':


| Zeit | Metrik | Wert | 
| --- | --- | --- | 
|  07.07.2020 11:34:20 UHR  |  Temperatur  |  25  | 
|  07.07.2020 11:34:20 UHR  |  Luftfeuchtigkeit  |  22  | 
|  07.07.2020 10:32:20 UHR  |  Feuchtigkeit  |  29  | 

# Problembehandlung bei Abfragen
<a name="v9-panels-query-troubleshoot"></a>

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

Diese Seite enthält Informationen zur Lösung häufig auftretender Dashboard-Probleme.

**Ich erhalte unterschiedliche Ergebnisse, wenn ich meine Funktionen neu anordne**

Die Reihenfolge der Funktionen ist sehr wichtig. Genau wie in der Mathematik kann die Reihenfolge, in der Sie Ihre Funktionen platzieren, das Ergebnis beeinflussen.

**Prüfen Sie Ihre Anfrage und Antwort**

Die häufigsten Probleme hängen mit der Abfrage und der Antwort aus Ihrer Datenquelle zusammen. Auch wenn es in Grafana nach einem Bug oder Visualisierungsproblem aussieht, handelt es sich fast immer um ein Problem mit der Datenquellenabfrage oder der Datenquellenantwort. Überprüfen Sie zunächst Ihre Panel-Anfrage und -Antwort.

Weitere Informationen finden Sie unter [Anfrage- und Antwortdaten überprüfen](v9-panels-panel-inspector.md).

**Meine Abfrage ist langsam**

Wie viele Datenpunkte gibt Ihre Abfrage zurück? Eine Abfrage, die viele Datenpunkte zurückgibt, ist langsam. Versuche das:
+ Begrenzen Sie in den **Abfrageoptionen** die **maximale Anzahl der zurückgegebenen Datenpunkte**.
+ Erhöhen Sie in den **Abfrageoptionen** die **Mindestintervallzeit**.
+ Verwenden Sie in Ihrer Abfrage eine `group by` Funktion.

# Schwellenwerte konfigurieren
<a name="v9-panels-configure-thresholds"></a>

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

 Dieser Abschnitt enthält Informationen zur Verwendung von Schwellenwerten in Ihren Visualisierungen. Sie erfahren mehr über Schwellenwerte und deren Standardeinstellungen, wie Sie einen Schwellenwert hinzufügen oder löschen und einen Schwellenwert zu einem älteren Panel hinzufügen. 

## Über Schwellenwerte
<a name="v9-panels-thresholds-about"></a>

 Ein Schwellenwert ist ein Wert, den Sie für eine Metrik angeben und der in einem Dashboard visuell wiedergegeben wird, wenn der Schwellenwert erreicht oder überschritten wird. 

 Schwellenwerte bieten eine Methode, mit der Sie Ihre Visualisierungen auf der Grundlage von Abfrageergebnissen bedingt gestalten und einfärben können. Sie können Schwellenwerte auf die meisten, aber nicht auf alle Visualisierungen anwenden. [Weitere Informationen zu Visualisierungen finden Sie unter Visualisierungsfelder.](v9-panels.md)

 Sie können Schwellenwerte verwenden, um: 
+  Farbige Rasterlinien oder Rasterflächenbereiche in der [Zeitreihenvisualisierung](v9-panels-time-series.md) 
+  Farbige Linien in der [Zeitreihen-Visualisierung](v9-panels-time-series.md) 
+  Färben Sie den Hintergrund oder den Werttext in der [Statistik-Visualisierung](v9-panels-stat.md) ein 
+  Färben Sie die Markierungen für Messgerät und Schwellenwerte in der [Messgerät-Visualisierung](v9-panels-gauge.md) 
+  Farbmarkierungen in der [Geomap-Visualisierung](v9-panels-geomap.md) 
+  [Färben Sie den Zellentext oder den Hintergrund in der Tabellenvisualisierung](v9-panels-table.md) 
+  Definieren Sie Regionen und Regionalfarben in der [Status-Timeline-Visualisierung](v9-panels-state-timeline.md) 

 Es gibt zwei Arten von Schwellenwerten: 
+  **Absolute** Schwellenwerte werden durch eine Zahl definiert. Zum Beispiel 80 auf einer Skala von 1 bis 150. 
+  **Prozentuale** Schwellenwerte werden relativ zum Minimum oder Maximum definiert. Zum Beispiel 80 Prozent. 

### Standardschwellenwerte
<a name="v9-panels-thresholds-default"></a>

 Bei Visualisierungen, die dies unterstützen, legt Grafana folgende Standardschwellenwerte fest: 
+  80 = rot 
+  Basis = grün 
+  Modus = Absolut 

 Der **Basiswert** steht für minus Unendlich. Es ist im Allgemeinen die „gute“ Farbe. 

## Einen Schwellenwert hinzufügen oder löschen
<a name="v9-panels-thresholds-add-delete"></a>

 Sie können einem Panel beliebig viele Schwellenwerte hinzufügen. Grafana sortiert Schwellenwerte automatisch vom höchsten zum niedrigsten. 

 Löschen Sie einen Schwellenwert, wenn er für Ihren Geschäftsbetrieb nicht mehr relevant ist. Wenn Sie einen Schwellenwert löschen, entfernt das System den Schwellenwert aus allen Visualisierungen, die den Schwellenwert enthalten. 

1.  Um einen Schwellenwert hinzuzufügen: 

   1.  Bearbeiten Sie das Panel, dem Sie einen Schwellenwert hinzufügen möchten. 

   1.  Suchen Sie im Seitenbereich mit den Optionen den Abschnitt **Schwellenwerte** und klicken Sie auf **\$1 Schwellenwert hinzufügen**. 

   1.  Wählen Sie eine Farbe, eine Zahl und einen Modus für den Schwellenwert aus. Der Schwellenwertmodus gilt für alle Schwellenwerte in diesem Bereich. 

   1.  Wählen Sie für ein Zeitreihen-Panel die Option **Schwellenwerte anzeigen** aus. 

1.  Um einen Schwellenwert zu löschen, navigieren Sie zu dem Bereich, der den Schwellenwert enthält, und klicken Sie auf das Papierkorbsymbol neben dem Schwellenwert, den Sie entfernen möchten. 

## Fügen Sie einem älteren Grafikfenster einen Schwellenwert hinzu
<a name="v9-panels-thresholds-legacy-graph"></a>

 In der Visualisierung des Grafikfensters können Sie mithilfe von Schwellenwerten Linien oder Abschnitte zu einem Diagramm hinzufügen, sodass Sie leichter erkennen können, wenn das Diagramm einen Schwellenwert überschreitet. 

1.  Navigieren Sie zu dem Grafikfenster, dem Sie einen Schwellenwert hinzufügen möchten. 

1.  Klicken Sie auf der Registerkarte **Bedienfeld** auf **Schwellenwerte**. 

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

1.  Füllen Sie die folgenden Felder aus: 
   +  **T1 —** Beide Werte sind erforderlich, um einen Schwellenwert anzuzeigen. 
     +  **lt** oder **gt** — Wählen Sie **lt** für weniger als oder **gt** für größer als, um anzugeben, wofür der Schwellenwert gilt. 
     +  **Wert —** Geben Sie einen Schwellenwert ein. Grafana zeichnet bei diesem Wert eine Schwellenlinie entlang der Y-Achse. 
   +  **Farbe —** Wählen Sie eine Bedingung, die einer Farbe entspricht, oder definieren Sie Ihre eigene Farbe. 
     +  **Benutzerdefiniert —** Sie definieren die Füllfarbe und die Linienfarbe. 
     +  **kritisch —** Füll- und Linienfarbe sind rot. 
     +  **Warnung —** Füll- und Linienfarbe sind gelb. 
     +  **ok -** Füll- und Linienfarbe sind grün. 
   +  **Füllen —** Steuert, ob die Schwellenwertfüllung angezeigt wird. 
   +  **Linie —** Steuert, ob die Schwellenwertlinie angezeigt wird. 
   +  **Y-Achse —** Wählen Sie **links** oder **rechts**. 

1.  Klicken Sie auf **Speichern**, um die Änderungen im Dashboard zu speichern. 

# Datenverknüpfungen konfigurieren
<a name="v9-panels-configure-data-links"></a>

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

 Sie können Datenverknüpfungsvariablen oder Datenlinks verwenden, um Links zwischen Bedienfeldern zu erstellen. 

## Datenverknüpfungsvariablen
<a name="v9-panels-data-link-variables"></a>

 Sie können Variablen in Datenverknüpfungen verwenden, um auf Serienfelder, Beschriftungen und Werte zu verweisen. Weitere Informationen zu Datenverknüpfungen finden Sie unter[Datenverknüpfungen](#v9-panels-data-links).

 Um eine Liste der verfügbaren Variablen anzuzeigen, geben Sie **\$1** in das Feld für die **Datenlink-URL** ein, um eine Liste der Variablen anzuzeigen, die Sie verwenden können. 

**Anmerkung**  
 Diese Variablen haben sich in 6.4 geändert. Wenn Sie also eine ältere Version von Grafana haben, verwenden Sie die Versionsauswahl, um Dokumente für eine ältere Version von Grafana auszuwählen. 

 Sie können auch Vorlagenvariablen in Ihren Datenlinks URLs verwenden, siehe. [Hinzufügen und Verwalten von Dashboard-Variablen](v9-dash-variables.md)

## Variablen im Bedienfeld „Zeitbereich“
<a name="v9-panels-time-range-panel-variables"></a>

 Mit diesen Variablen können Sie den aktuellen Zeitraum in die Datenlink-URL aufnehmen. 
+  **\$1\$1url\$1time\$1range — Zeitbereich** **des aktuellen Dashboards (d. h.? von=now-6h&to=now**) 
+  \$1\$1\$1from und **\$1\$1\$1to** — Weitere Informationen finden Sie unter. [Globale Variablen](v9-dash-variable-add.md#v9-dash-variable-add-global)

## Reihenvariablen
<a name="v9-panels-series-variables"></a>

 Serienspezifische Variablen sind im Namespace **\$1\$1series** verfügbar: 
+  **\$1\$1series.name — Serienname** zur URL 

## Feldvariablen
<a name="v9-panels-field-variables"></a>

 Feldspezifische Variablen sind im Namespace **\$1\$1field verfügbar:** 
+  **\$1\$1field.name** — der Name des Feldes 
+  **\$1\$1field.labels. **<LABEL>- Der Wert des Labels für die URL. Wenn Ihr Etikett Punkte enthält, verwenden Sie die Syntax **\$1\$1field.labels [“ „**<LABEL>]. 

## Wertvariablen
<a name="v9-panels-value-variables"></a>

 Wertspezifische Variablen sind im Namespace **\$1\$1value** verfügbar: 
+  **\$1\$1value.time — Zeitstempel** **des Werts (Unix-MS-Epoche) zur URL (d. h.? **time=1560268814105) 
+  **\$1\$1value.raw - Rohwert** 
+  **\$1\$1value.numeric — numerische Darstellung eines Werts** 
+  **\$1\$1value.text — Textdarstellung eines Werts** 
+  **\$1\$1value.calc** — Berechnungsname, wenn der Wert das Ergebnis einer Berechnung ist 

## Vorlagenvariablen
<a name="v9-panels-template-variables"></a>

 Wenn Sie auf ein anderes Dashboard verlinken, das Vorlagenvariablen verwendet, wählen Sie Variablenwerte für die Person aus, die auf den Link klickt. 

 **\$1 \$1var-myvar:queryparam\$1** — wobei **var-myvar** der Name der Vorlagenvariablen ist, die einer Variablen im aktuellen Dashboard entspricht, die Sie verwenden möchten. 


|  Status der Variablen  |  Ergebnis ist die erstellte URL  | 
| --- | --- | 
|  hat einen Wert ausgewählt  |  var-myvar=Wert1  | 
|  hat mehrere Werte ausgewählt  |  var-myvar=Wert1&var-myvar=Wert2  | 
|  Alle ausgewählt  |  var-myVar=Alle  | 

 **Wenn Sie alle Variablen des aktuellen Dashboards zur URL hinzufügen möchten, verwenden Sie \$1 \$1\$1\$1all\$1variables\$1.** 

## Datenverknüpfungen
<a name="v9-panels-data-links"></a>

 Datenlinks ermöglichen es Ihnen, Ihren Links einen detaillierteren Kontext zu geben. Sie können Links erstellen, die den Seriennamen oder sogar den Wert unter dem Cursor enthalten. Wenn Ihre Visualisierung beispielsweise vier Server zeigt, könnten Sie einen Datenlink zu einem oder zwei von ihnen hinzufügen. 

 Auf den Link selbst kann je nach Visualisierung auf unterschiedliche Weise zugegriffen werden. Für das Diagramm müssen Sie auf einen Datenpunkt oder eine Linie klicken. Für ein Panel wie Stat, Gauge oder Bar Gauge können Sie auf eine beliebige Stelle in der Visualisierung klicken, um das Kontextmenü zu öffnen. 

 Sie können Variablen in Datenlinks verwenden, um Personen zu einem detaillierten Dashboard mit beibehaltenen Datenfiltern weiterzuleiten. Sie könnten Variablen beispielsweise verwenden, um einen Zeitraum, eine Reihe und eine Variablenauswahl anzugeben. Weitere Informationen finden Sie unter [Datenverknüpfungsvariablen](#v9-panels-data-link-variables).

### Geben Sie Vorschläge im Voraus ein
<a name="v9-panels-typeahead-suggestions"></a>

 Wenn Sie eine Datenverknüpfung erstellen oder aktualisieren, drücken Sie Cmd\$1Space oder Strg\$1Space auf Ihrer Tastatur, um die Typeahead-Vorschläge zu öffnen und einfacher Variablen zu Ihrer URL hinzuzufügen. 

### Fügen Sie eine Datenverknüpfung hinzu
<a name="v9-panels-add-a-datalink"></a>

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

1.  Scrollen Sie auf der Registerkarte Feld nach unten zum Abschnitt Datenlinks. 

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

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

1.  Geben Sie die **URL** ein, auf die Sie verlinken möchten. 

    Sie können sogar eine der im Dashboard definierten Vorlagenvariablen hinzufügen. Klicken Sie in das **URL-Feld** und geben Sie dann **\$1** ein oder drücken Sie Strg\$1Leertaste oder Befehlstaste\$1Leertaste, um eine Liste der verfügbaren Variablen zu sehen. Wenn Sie Ihrem Panel-Link Vorlagenvariablen hinzufügen, leitet der Link den Benutzer in den richtigen Kontext weiter, in dem die entsprechenden Variablen bereits festgelegt sind. Weitere Informationen finden Sie unter [Datenverknüpfungsvariablen](#v9-panels-data-link-variables).

1.  Wenn Sie möchten, dass der Link in einem neuen Tab geöffnet wird, wählen Sie **In einem neuen Tab öffnen**. 

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

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

### Aktualisieren Sie einen Datenlink
<a name="v9-panels-update-a-datalink"></a>

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

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

1.  Nehmen Sie nach Bedarf Änderungen vor. 

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

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

### Löschen Sie eine Datenverknüpfung
<a name="v9-panels-delete-a-datalink"></a>

1.  Suchen Sie auf der Registerkarte Feld nach dem Link, den Sie löschen möchten. 

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

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

# Feldüberschreibungen konfigurieren
<a name="v9-panels-configure-overrides"></a>

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

 Mit Overrides können Sie die Visualisierungseinstellungen für bestimmte Felder oder Serien anpassen. Dies wird erreicht, indem eine Überschreibungsregel hinzugefügt wird, die auf eine bestimmte Gruppe von Feldern abzielt und jeweils mehrere Optionen definieren kann. 

 Sie legen beispielsweise die Einheit für alle Felder fest, die den Text „Byte“ enthalten, indem Sie mithilfe des Regex-Matchers **Felder mit Namen, die mit dem Regex-Matcher übereinstimmen**, eine Überschreibung hinzufügen und dann der Überschreibungsregel die Option Einheit hinzufügen. 

## Beispiel 1: Temperatur formatieren
<a name="v9-panels-overrides-format-temperature"></a>

 Nehmen wir an, dass unsere Ergebnismenge ein Datenrahmen ist, der aus zwei Feldern besteht: Zeit und Temperatur. 


|  time  |  temperature  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45.0  | 
|  2020-01-02 03:05:00  |  47,0  | 
|  2020-01-02 03:06:00  |  48,0  | 

 Auf jedes Feld (Spalte) dieser Struktur können Feldoptionen angewendet werden, die die Art und Weise ändern, wie die Werte angezeigt werden. Das bedeutet, dass Sie die Einheit beispielsweise auf Temperatur > Celsius einstellen können, was zu der folgenden Tabelle führt: 


|  time  |  temperature  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45,0 °C  | 
|  2020-01-02 03:05:00  |  47,0 °C  | 
|  2020-01-02 03:06:00  |  48,0 °C  | 

 Außerdem ist die Dezimalstelle nicht erforderlich, sodass wir sie entfernen können. Sie können die Dezimalzahlen von **auto** auf Null (**0**) ändern, was zu der folgenden Tabelle führt: 


|  time  |  temperature  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45 °C  | 
|  2020-01-02 03:05:00  |  47 °C  | 
|  2020-01-02 03:06:00  |  48 °C  | 

## Beispiel 2: Temperatur und Luftfeuchtigkeit formatieren
<a name="v9-panels-overrides-format-humidity"></a>

 Nehmen wir an, dass unsere Ergebnismenge ein Datenrahmen ist, der aus vier Feldern besteht: Zeit, Hochtemperatur, Niedrigtemperatur und Luftfeuchtigkeit. 


|  time  |  hohe Temperatur  |  niedrige Temperatur  |  feuchtigkeit  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45.0  |  30.0  |  67  | 
|  2020-01-02 03:05:00  |  47,0  |  34,0  |  68  | 
|  2020-01-02 03:06:00  |  48,0  |  31,0  |  68  | 

 Fügen wir die Celsius-Einheit hinzu und entfernen wir die Dezimalstelle. Das ergibt die folgende Tabelle: 


|  time  |  hohe Temperatur  |  niedrige Temperatur  |  feuchtigkeit  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45 °C  |  30 °C  |  67 °C  | 
|  2020-01-02 03:05:00  |  47 °C  |  34 °C  |  68 °C  | 
|  2020-01-02 03:06:00  |  48 °C  |  31 °C  |  68 °C  | 

 Die Temperaturfelder sehen gut aus, aber die Luftfeuchtigkeit muss jetzt geändert werden. Wir können das beheben, indem wir eine Feldoption außer Kraft setzen und die Einheit auf Verschiedenes > Prozent (0-100) ändern. 


|  time  |  hohe Temperatur  |  niedrige Temperatur  |  feuchtigkeit  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45 °C  |  30 °C  |  67%  | 
|  2020-01-02 03:05:00  |  47 °C  |  34 °C  |  68%  | 
|  2020-01-02 03:06:00  |  48 °C  |  31 °C  |  68%  | 

## Fügen Sie eine Feldüberschreibung hinzu
<a name="v9-panels-overrides-add-a-field"></a>

 Mit einer Feldüberschreibungsregel können die Visualisierungseinstellungen für ein bestimmtes Feld oder eine Reihe angepasst werden. 

1.  Bearbeiten Sie den Bereich, dem Sie eine Überschreibung hinzufügen möchten. 

1.  Klicken Sie im Seitenbereich mit den **Bedienfeldoptionen unten im Bereich auf Feldüberschreibung hinzufügen**. 

1.  Wählen Sie aus, auf welche Felder eine Überschreibungsregel angewendet werden soll: 
   +  **Felder mit Namen:** Wählen Sie ein Feld aus der Liste aller verfügbaren Felder aus. Eigenschaften, die Sie mit diesem Selektor zu einer Regel hinzufügen, werden nur auf dieses einzelne Feld angewendet. 
   +  **Felder, deren Name dem regulären Ausdruck entspricht:** Geben Sie Felder an, die mit einem regulären Ausdruck überschrieben werden sollen. Eigenschaften, die Sie mit diesem Selektor zu einer Regel hinzufügen, werden auf alle Felder angewendet, bei denen der Feldname mit dem regulären Ausdruck übereinstimmt. 
   +  **Felder mit Typ:** Wählen Sie Felder nach Typ aus, z. B. Zeichenfolge, Zahl usw. Eigenschaften, die Sie mit diesem Selektor zu einer Regel hinzufügen, werden auf alle Felder angewendet, die dem ausgewählten Typ entsprechen. 
   +  **Von der Abfrage zurückgegebene Felder:** Wählen Sie alle Felder aus, die von einer bestimmten Abfrage zurückgegeben wurden, z. B. A, B oder C. Eigenschaften, die Sie mit diesem Selektor zu einer Regel hinzufügen, werden auf alle Felder angewendet, die von der ausgewählten Abfrage zurückgegeben werden. 

1.  Klicken Sie auf **Überschreibungseigenschaft hinzufügen**. 

1.  Wählen Sie die Feldoption aus, die Sie anwenden möchten. 

1.  Geben Sie Optionen ein, indem Sie Werte in die Felder eingeben. Um die Optionen auf die Standardwerte zurückzusetzen, löschen Sie den weißen Text in den Feldern. 

1.  Fügen Sie diesem Feld weitere Überschreibungen hinzu, indem Sie auf **Überschreibungseigenschaft hinzufügen** klicken, oder Sie können auf **Überschreibung hinzufügen** klicken und ein anderes Feld auswählen, zu dem Überschreibungen hinzugefügt werden sollen. 

1.  Wenn Sie fertig sind, klicken Sie auf **Speichern**, um alle Panel-Änderungen im Dashboard zu speichern. 

## Löschen Sie eine Feldüberschreibung
<a name="v9-panels-overrides-delete-a-field"></a>

 Löschen Sie eine Feldüberschreibung, wenn Sie sie nicht mehr benötigen. Wenn Sie eine Überschreibung löschen, wird der Wert standardmäßig in seinem ursprünglichen Format angezeigt. Diese Änderung wirkt sich auf Dashboards und Dashboard-Benutzer aus, die auf ein betroffenes Panel angewiesen sind. 

1.  Bearbeiten Sie den Bereich, der den Override enthält, den Sie löschen möchten. 

1.  Scrollen Sie im Seitenbereich mit den Bedienfeldoptionen nach unten, bis Sie die Überschreibungen sehen. 

1.  Klicken Sie auf die Überschreibung, die Sie löschen möchten, und klicken Sie dann auf das zugehörige Papierkorbsymbol. 

## Feldüberschreibungen anzeigen
<a name="v9-panels-overrides-view"></a>

 Sie können Feldüberschreibungen in den Anzeigeoptionen des Bedienfelds anzeigen. 

1.  Bearbeiten Sie den Bereich, der die Überschreibungen enthält, die Sie sich ansehen möchten. 

1.  Scrollen Sie im Seitenbereich mit den Bedienfeldoptionen nach unten, bis Sie die Überschreibungen sehen. 

 Die Überschreibungseinstellungen, die auf der Registerkarte **Alle** angezeigt werden, entsprechen den Einstellungen, die auf der Registerkarte **Überschreibungen** angezeigt werden. 

## Bearbeiten Sie eine Feldüberschreibung
<a name="v9-panels-overrides-edit-a-field"></a>

 Bearbeiten Sie eine Feldüberschreibung, wenn Sie Änderungen an einer Überschreibungseinstellung vornehmen möchten. Die Änderung, die Sie vornehmen, wird sofort wirksam. 

1.  Bearbeiten Sie den Bereich, der die Überschreibungen enthält, die Sie bearbeiten möchten. 

1.  Scrollen Sie im Seitenbereich mit den Bedienfeldoptionen nach unten, bis Sie die Überschreibungen sehen. 

1.  Suchen Sie die Überschreibung, die Sie ändern möchten. 

1.  Führen Sie einen der folgenden Schritte aus: 
   +  Bearbeiten Sie die Einstellungen vorhandener Überschreibungen oder Feldauswahlparameter. 
   +  Löschen Sie vorhandene Override-Eigenschaften, indem Sie auf das **X** neben der Eigenschaft klicken. 
   +  Fügen Sie eine Überschreibungseigenschaft hinzu, indem Sie auf **Überschreibungseigenschaft hinzufügen** klicken. 

# Wertezuordnungen konfigurieren
<a name="v9-panels-configure-value-mappings"></a>

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

 Neben Feldüberschreibungen ist die Wertzuweisung eine Technik, mit der Sie die visuelle Behandlung von Daten ändern können, die in einer Visualisierung angezeigt werden. 

 Werte, die über Wertzuordnungen zugeordnet werden, umgehen die Formatierung der Einheiten. Das bedeutet, dass ein Textwert, der einem numerischen Wert zugeordnet ist, nicht mit der konfigurierten Einheit formatiert wird. 

 Wenn Wertezuordnungen in einem Panel vorhanden sind, zeigt Grafana eine Zusammenfassung im Seitenbereich des Panel-Editors an. 

**Anmerkung**  
 Die neuen Wertezuordnungen sind mit einigen Visualisierungen wie Graph (alt), Text und Heatmap nicht kompatibel. 

## Arten von Wertezuordnungen
<a name="v9-panels-value-mappings-types"></a>

 Grafana unterstützt die folgenden Wertezuordnungen: 
+  **Wert: Ordnet** Textwerte einer Farbe oder einem anderen Anzeigetext zu. Sie können beispielsweise eine Wertezuordnung so konfigurieren, dass alle Instanzen des Werts **10** als **Perfection angezeigt werden\$1** statt der Zahl. 
+  **Bereich: Ordnet** numerische Bereiche einem Anzeigetext und einer Farbe zu. Wenn ein Wert beispielsweise innerhalb eines bestimmten Bereichs liegt, können Sie eine Bereichswertzuweisung so konfigurieren, dass statt der Zahl **Niedrig** oder **Hoch** angezeigt wird. 
+  **Regex: Ordnet** reguläre Ausdrücke einem Ersatztext und einer Farbe zu. Wenn ein Wert beispielsweise **www.example.com** ist, können Sie eine Regex-Wertezuordnung so konfigurieren, dass Grafana **www** anzeigt und die Domain abschneidet. 
+  **Special** Ordnet Sonderwerte wie **Null**, **NaN** (keine Zahl) und boolesche Werte wie **true** und **false** einem Anzeigetext und einer Farbe zu. **Sie können beispielsweise eine spezielle Wertezuordnung so konfigurieren, dass **Nullwerte** als N/A angezeigt werden.** 

 Sie können die Punkte auf der linken Seite auch verwenden, um Wertezuordnungen in der Liste zu ziehen und sie neu anzuordnen. 

## Ordnen Sie einen Wert zu
<a name="v9-panels-value-mappings-map-a-value"></a>

 Ordnen Sie einen Wert zu, wenn Sie einen einzelnen Wert formatieren möchten. 

1.  Öffnen Sie ein Fenster, dem Sie einen Wert zuordnen möchten. 

1.  Suchen Sie in den Anzeigeoptionen des Bedienfelds den Abschnitt **Wertezuordnungen** und klicken Sie auf **Wertezuordnungen hinzufügen**. 

1.  **Klicken Sie auf **Neue Zuordnung hinzufügen** und wählen Sie dann Wert aus.** 

1.  Geben Sie den Wert ein, dem Grafana entsprechen soll. 

1.  (Optional) Geben Sie den Anzeigetext ein. 

1.  (Optional) Stellen Sie die Farbe ein. 

1.  Klicken Sie auf **Aktualisieren**, um die Wertezuordnung zu speichern. 

## Ordnen Sie einen Bereich zu
<a name="v9-panels-value-mappings-map-a-range"></a>

 Ordnen Sie einen Wertebereich zu, wenn Sie mehrere fortlaufende Werte formatieren möchten. 

1.  Bearbeiten Sie das Panel, für das Sie einen Wertebereich zuordnen möchten. 

1.  Klicken Sie in den Bedienfeldanzeigeoptionen im Abschnitt **Wertezuordnungen** auf **Wertezuordnungen hinzufügen**. 

1.  **Klicken Sie auf **Neue Zuordnung hinzufügen** und wählen Sie dann Bereich aus.** 

1.  Geben Sie die Anfangs- und Endwerte in dem Bereich ein, dem Grafana entsprechen soll. 

1.  (Optional) Geben Sie Anzeigetext ein. 

1.  (Optional) Stellen Sie die Farbe ein. 

1.  Klicken Sie auf **Aktualisieren**, um die Wertezuordnung zu speichern. 

## Ordnen Sie einen regulären Ausdruck zu
<a name="v9-panels-value-mappings-map-a-regex"></a>

 Ordnen Sie einen regulären Ausdruck zu, wenn Sie den Text und die Farbe eines Werts eines regulären Ausdrucks formatieren möchten. 

1.  Bearbeiten Sie das Bedienfeld, dem Sie einen regulären Ausdruck zuordnen möchten. 

1.  Klicken Sie im Bereich **Wertezuordnungen** der Anzeigeoptionen des Bedienfelds auf **Wertezuordnungen hinzufügen**. 

1.  **Klicken Sie auf **Neue Zuordnung hinzufügen und wählen** Sie dann Regex aus.** 

1.  Geben Sie das Muster für reguläre Ausdrücke ein, mit dem Grafana übereinstimmen soll. 

1.  (Optional) Geben Sie Anzeigetext ein. 

1.  (Optional) Stellen Sie die Farbe ein. 

1.  Klicken Sie auf **Aktualisieren**, um die Wertezuordnung zu speichern. 

## Ordnen Sie einen speziellen Wert zu
<a name="v9-panels-value-mappings-map-a-special-value"></a>

 Ordnen Sie einen speziellen Wert zu, wenn Sie ungewöhnliche, boolesche oder leere Werte formatieren möchten. 

1.  Bearbeiten Sie das Panel, dem Sie einen speziellen Wert zuordnen möchten. 

1.  Suchen Sie in den Anzeigeoptionen des Bedienfelds den Abschnitt **Wertezuordnungen** und klicken Sie auf **Wertezuordnungen hinzufügen**. 

1.  **Klicken Sie auf **Neue Zuordnung hinzufügen und wählen** Sie dann Spezial aus.** 

1.  Wählen Sie den speziellen Wert aus, dem Grafana entsprechen soll. 

1.  (Optional) Geben Sie den Anzeigetext ein. 

1.  (Optional) Stellen Sie die Farbe ein. 

1.  Klicken Sie auf **Aktualisieren**, um die Wertezuordnung zu speichern. 

## Bearbeiten Sie eine Wertezuordnung
<a name="v9-panels-value-mappings-edit-a-value"></a>

 Sie können eine Wertezuordnung jederzeit ändern. 

1.  Bearbeiten Sie den Bereich, der die Wertezuordnung enthält, die Sie bearbeiten möchten. 

1.  Klicken Sie in den Anzeigeoptionen des Fensters im Abschnitt **Wertezuordnungen** auf **Wertezuordnungen bearbeiten**. 

1.  **Nehmen Sie die Änderungen vor und klicken Sie auf Aktualisieren.** 

# Eine Legende konfigurieren
<a name="v9-panels-configure-legend"></a>

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

Ein Bereich enthält eine Legende, anhand derer Sie die in einer Visualisierung angezeigten Daten interpretieren können. Jede Legendenoption verleiht den in einer Visualisierung dargestellten Daten Kontext und Klarheit.

## Isolieren von Seriendaten in einer Visualisierung
<a name="v9-panels-legend-isolate"></a>

Visualisierungen können oft visuell komplex sein und viele Datenreihen umfassen. Sie können die Ansicht vereinfachen, indem Sie Seriendaten aus der Visualisierung entfernen, wodurch die Daten, die Sie sehen möchten, isoliert werden. Grafana erstellt automatisch eine neue Überschreibung auf der Registerkarte **Override**.

Wenn Sie Ihre Änderungen anwenden, werden die Visualisierungsänderungen allen Benutzern des Panels angezeigt.

**Um Seriendaten in einer Visualisierung zu isolieren**

1. Öffnen Sie das Panel.

1. Wählen Sie in der Legende die Bezeichnung der Serie aus, die Sie isolieren möchten.

   Das System entfernt alle anderen Seriendaten aus der Ansicht.

1. Um einer isolierten Reihe schrittweise Seriendaten hinzuzufügen, drücken Sie die **Strg** - oder **Befehlstaste** und wählen Sie die Bezeichnung der Serie aus, die Sie hinzufügen möchten.

1. Um zur Standardansicht zurückzukehren, die alle Daten enthält, klicken Sie zweimal auf eine beliebige Reihenbeschriftung.

1. Um Ihre Änderungen zu speichern, sodass sie allen Zuschauern des Panels angezeigt werden, wählen Sie **Anwenden** aus.

Dieses Thema bezieht sich derzeit auf die folgenden Visualisierungen:
+ [Balkendiagramm](v9-panels-bar-chart.md)
+ [Histogramm](v9-panels-histogram.md)
+ [Kreisdiagramm](v9-panels-piechart.md)
+ [Zeitplan des Bundesstaates](v9-panels-state-timeline.md)
+ [Verlauf des Status](v9-panels-status-history.md)
+ [Zeitreihen](v9-panels-time-series.md)

## Hinzufügen von Werten zu einer Legende
<a name="v9-panels-legend-add-values"></a>

Um einer Visualisierung mehr Kontext hinzuzufügen, können Sie einer Legende Seriendatenwerte hinzufügen. Sie können so viele Werte hinzufügen, wie Sie möchten. Nachdem Sie Ihre Änderungen übernommen haben, können Sie die Legende horizontal scrollen, um alle Werte zu sehen.

**Um einer Legende Werte hinzuzufügen**

1. Bearbeiten Sie ein Panel.

1. Suchen Sie im Bereich mit den Anzeigeoptionen des Bedienfelds den Abschnitt **Legende**.

1. Wählen Sie im Feld **Legendenwerte** die Werte aus, die in der Legende erscheinen sollen.

1. Wählen Sie **Anwenden**, um Ihre Änderungen zu speichern, und navigieren Sie anschließend zurück zum Dashboard.

## Die Farbe einer Serie ändern
<a name="v9-panels-legend-change-color"></a>

Standardmäßig gibt Grafana die Farbe Ihrer Seriendaten an, die Sie ändern können.

**Um die Farbe einer Datenreihe zu ändern**

1. Bearbeiten Sie ein Panel.

1. Wählen Sie in der Legende die Farbleiste aus, die der Serie zugeordnet ist.

1. Wählen Sie eine voreingestellte Farbe oder eine benutzerdefinierte Farbe aus der Farbpalette aus.

1. Wählen Sie **Anwenden**, um Ihre Änderungen zu speichern, und navigieren Sie zurück zum Dashboard.

## Serien sortieren
<a name="v9-panels-legend-sort"></a>

Sie können den Legendenmodus in **Tabelle** ändern und festlegen[Berechnungsarten](v9-panels-calculation-types.md), ob die Legende in der Legende angezeigt werden soll. Wählen Sie die Überschrift des Berechnungsnamens in der Legendentabelle aus, um die Werte in der Tabelle in aufsteigender oder absteigender Reihenfolge zu sortieren.

Die Sortierreihenfolge wirkt sich auf die Positionen der Balken im Balkendiagrammfenster sowie auf die Reihenfolge der gestapelten Reihen in den Bereichen Zeitreihen und Balkendiagramm aus.

**Anmerkung**  
Diese Funktion wird nur in den folgenden Bereichen unterstützt: Balkendiagramm, Histogramm, Zeitreihe, XY-Diagramm.

# Berechnungsarten
<a name="v9-panels-calculation-types"></a>

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

 Die folgende Tabelle enthält eine Liste von Berechnungen, die Sie in Grafana durchführen können. Sie finden diese Berechnungen auf der Registerkarte **Transformieren** und in den Visualisierungen Balkenanzeige, Messgerät und Statistik. 


|  Berechnung  |  Description  | 
| --- | --- | 
|  Alle Nullen  |  Wahr, wenn alle Werte Null sind  | 
|  Alle Nullen  |  Wahr, wenn alle Werte 0 sind  | 
|  Anzahl ändern  |  Gibt an, wie oft sich der Wert des Felds ändert  | 
|  Anzahl  |  Anzahl der Werte in einem Feld  | 
|  Delta  |  Kumulative Wertänderung, zählt nur Inkremente  | 
|  Unterschied  |  Unterschied zwischen dem ersten und dem letzten Wert eines Felds  | 
|  Unterschied in%  |  Prozentuale Änderung zwischen dem ersten und dem letzten Wert eines Felds  | 
|  Eindeutige Anzahl  |  Anzahl der eindeutigen Werte in einem Feld  | 
|  Zuerst (nicht Null)  |  Erstens kein Nullwert in einem Feld  | 
|  Max  |  Maximalwert eines Felds  | 
|  Mean  |  Mittelwert aller Werte in einem Feld  | 
|  Varianz  |  Varianz aller Werte in einem Feld  | 
|  StdDev  |  Standardabweichung aller Werte in einem Feld  | 
|  Min  |  Minimaler Wert eines Feldes  | 
|  Min. (über Null)  |  Minimaler, positiver Wert eines Felds  | 
|  Bereich  |  Unterschied zwischen Maximal- und Minimalwerten eines Felds  | 
|  Schritt  |  Minimaler Abstand zwischen den Werten eines Feldes  | 
|  Gesamt  |  Summe aller Werte in einem Feld  | 

# Visualisierungen kommentieren
<a name="v9-panels-annotate-visualizations"></a>

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

Anmerkungen bieten eine Möglichkeit, Punkte im Diagramm mit reichhaltigen Ereignissen zu markieren. Wenn Sie den Mauszeiger über eine Anmerkung bewegen, können Sie eine Beschreibung des Ereignisses und die Ereignis-Tags aufrufen. Das Textfeld kann Links zu anderen Systemen mit detaillierteren Informationen enthalten.

**Systemeigene Anmerkungen**

Grafana verfügt über einen nativen Annotationsspeicher und die Möglichkeit, Annotationsereignisse direkt aus dem Grafikfenster oder über die HTTP-API hinzuzufügen.

**Hinzufügen einer Anmerkung**

1. Klicken Sie im Dashboard auf das Fenster **Zeitreihen**. Ein Kontextmenü wird angezeigt.

1. Klicken Sie im Kontextmenü auf **Anmerkung hinzufügen**.

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

1. Klicken Sie auf **Speichern**.

Sie können auch eine Anmerkung hinzufügen, `Ctrl+Click` oder `Cmd+Click` im **Zeitreihenfenster klicken**. Daraufhin wird das Popover **Anmerkung hinzufügen** angezeigt.

**Anmerkung zur Region hinzufügen**

1. Im Dashboard `Ctrl+Click` oder `Cmd+Click` im Bereich **Zeitreihen**.

1. Klicken Sie im Kontextmenü auf **Anmerkung hinzufügen**.

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

1. Klicken Sie auf **Speichern**.

**Eine Anmerkung bearbeiten**

1. Zeigen Sie im Dashboard mit der Maus auf eine Anzeige für Anmerkungen im Fenster **Zeitreihen**.

1. Klicken Sie im Kommentar-Tooltip auf das Bearbeitungssymbol (Stift).

1. Ändern Sie die Beschreibung und optional die Tags.

1. Klicken Sie auf **Speichern**.

**Löschen einer Anmerkung**

1. Zeigen Sie im Dashboard mit der Maus auf eine Anzeige für Anmerkungen im **Zeitreihenfenster**.

1. Klicken Sie im Kommentar-Tooltip auf das Papierkorbsymbol.

**Integrierte Abfrage**

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 zeigt sie in dem Bereich an, in dem sie erstellt wurden. Dies schließt Anmerkungen zum Verlauf der Warnmeldungen ein. Sie können verhindern, dass Anmerkungen abgerufen und gezeichnet werden, indem Sie die Einstellungen für **Anmerkungen** (über das Zahnradmenü im Dashboard) öffnen und die angegebene Abfrage ändern. `Annotations & Alerts (Built-in)`

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 nur, wenn die Anmerkungen im Quell-Dashboard Tags enthielten, nach denen gefiltert werden konnte.

**Abfragen nach Tag**

Sie können neue Abfragen erstellen, um Anmerkungen aus dem systemeigenen Annotationsspeicher über die `-- Grafana --` Datenquelle abzurufen, indem Sie **Filter** by auf einstellen. `Tags`

Grafana v8.1 und spätere Versionen unterstützen auch Typeahead vor vorhandenen Tags. Geben Sie mindestens ein Tag an.

Erstellen Sie beispielsweise einen Annotationsabfragenamen `outages` und geben Sie ein Tag an. `outage` Diese Abfrage zeigt alle Anmerkungen (von einem beliebigen Dashboard oder über eine API) mit dem Ausfall-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 es`Match any`, und Grafana zeigt Anmerkungen an, die eines der von Ihnen angegebenen Tags enthalten.

In Grafana v5.3\$1 ist es möglich, Template-Variablen in der Tag-Abfrage zu verwenden. Wenn Sie also ein Dashboard haben, das Statistiken für verschiedene Dienste anzeigt, und eine Vorlagenvariable, die vorgibt, welche Dienste angezeigt werden sollen, können Sie jetzt dieselbe Vorlagenvariable in Ihrer Annotationsabfrage verwenden, um nur Anmerkungen für diese Dienste anzuzeigen.

**Abfragen anderer Datenquellen**

Annotationsereignisse werden durch Annotationsabfragen abgerufen. Um einem Dashboard eine neue Annotationsabfrage hinzuzufügen, öffnen Sie das Dashboard-Einstellungsmenü und wählen Sie dann **Anmerkungen** aus. Dadurch wird die Ansicht mit den Einstellungen für Anmerkungen im Dashboard geöffnet. Um eine neue Annotationsabfrage zu erstellen, klicken Sie auf die Schaltfläche **Neu**.

Geben Sie einen Namen für die Annotationsabfrage an. Dieser Name wird dem Schalter (Kontrollkästchen) zugewiesen, mit dem Sie die Anzeige von Annotationsereignissen aus dieser Abfrage aktivieren oder deaktivieren können. Beispielsweise könnten Sie zwei Annotationsabfragen mit dem Namen `Deploys` und `Outages` haben. Mit dem Schalter können Sie entscheiden, welche Anmerkungen angezeigt werden sollen.

**Details zur Annotationsabfrage**

Die Abfrageoptionen für Anmerkungen sind für jede Datenquelle unterschiedlich. Informationen zu Anmerkungen in einer bestimmten Datenquelle finden Sie im jeweiligen Thema [zur Datenquelle](AMG-data-sources.md).

# Die Ansicht „Panel inspizieren“
<a name="v9-panels-panel-inspector"></a>

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

 Die Panel-Inspektionsansicht, die Sie über das Bedienfeldmenü öffnen können, hilft Ihnen dabei, Ihre Panels zu verstehen und Fehler zu beheben. Sie können die Rohdaten für jedes Grafana-Panel überprüfen, diese Daten in eine Datei mit kommagetrennten Werten (CSV) exportieren, Abfrageanfragen anzeigen und Panel- und Daten-JSON exportieren. 

**Anmerkung**  
 Nicht alle Paneltypen enthalten alle Tabs. Beispielsweise enthalten die Listenbereiche des Dashboards keine Rohdaten, die überprüft werden können, sodass die Registerkarten Statistik, Daten oder Abfrage nicht angezeigt werden. 

 Der Bedienfeldinspektor besteht aus den folgenden Optionen: 

1.  Im Bedienfeldinspektor wird **Inspect: [NameOfPanelBeingInspected]** oben im Fenster angezeigt. Klicken Sie auf den Pfeil in der oberen rechten Ecke, um den Bereich zu vergrößern oder zu verkleinern. 

1.  **Registerkarte „Daten“ —** Zeigt die Rohdaten an, die von der Abfrage mit angewendeten Transformationen zurückgegeben wurden. Feldoptionen wie Überschreibungen und Wertezuordnungen werden standardmäßig nicht angewendet. 

1.  **Registerkarte „Statistiken“ —** Zeigt an, wie lange Ihre Abfrage dauert und wie viel sie zurückgibt. 

1.  **Registerkarte JSON —** Ermöglicht das Anzeigen und Kopieren von Panel-JSON, Panel-Daten-JSON und Datenrahmenstruktur JSON. Dies ist nützlich, wenn Sie Grafana bereitstellen oder verwalten. 

1.  **Registerkarte „Abfrage“ —** Zeigt Ihnen die Anfragen an den Server an, die gesendet wurden, wenn Grafana die Datenquelle abfragt. 

1.  **Registerkarte „Fehler“ —** Zeigt den Fehler an. Nur sichtbar, wenn die Abfrage einen Fehler zurückgibt. 

## Laden Sie unformatierte Abfrageergebnisse herunter
<a name="v9-panels-raw-query-results"></a>

 Grafana generiert eine CSV-Datei, die Ihre Daten enthält, einschließlich aller Transformationen dieser Daten. Sie können wählen, ob Sie die Daten anzeigen möchten, bevor oder nachdem das Panel Feldoptionen oder Feldoptionsüberschreibungen angewendet hat. 

1.  Bearbeiten Sie das Fenster, das die Abfragedaten enthält, die Sie herunterladen möchten. 

1.  Klicken Sie im Abfrage-Editor auf **Query Inspector**. 

1.  Klicken Sie auf **Daten**. 

    Wenn Ihr Panel mehrere Abfragen enthält oder mehrere Knoten abfragt, stehen Ihnen zusätzliche Optionen zur Verfügung. 
   +  **Ergebnis auswählen**: Wählen Sie aus, welche Ergebnissatzdaten Sie anzeigen möchten. 
   +  **Daten transformieren** 
   +  **Nach Zeit verknüpfen**: Zeigen Sie Rohdaten aus all Ihren Abfragen gleichzeitig an, ein Ergebnissatz pro Spalte. Klicken Sie auf eine Spaltenüberschrift, um die Daten neu anzuordnen. 

1.  Um Daten zu sehen, bevor das System Feldüberschreibungen anwendet, klicken Sie auf die Umschaltfläche **Formatierte** Daten. 

1.  Um eine CSV-Datei herunterzuladen, die speziell für Excel formatiert ist, klicken Sie auf den Schalter Für Excel **herunterladen**. 

1.  Klicken Sie auf CSV **herunterladen**. 

## Überprüfen Sie die Abfrageleistung
<a name="v9-panels-query-performance"></a>

 **Auf der Registerkarte Statistik werden Statistiken angezeigt, aus denen hervorgeht, wie lange Ihre Abfrage dauert, wie viele Abfragen Sie gesendet haben und wie viele Zeilen zurückgegeben wurden.** Diese Informationen können Ihnen bei der Problembehandlung Ihrer Abfragen helfen, insbesondere wenn eine der Zahlen unerwartet hoch oder niedrig ist. 

1.  Bearbeiten Sie den Bereich, der die Abfrage enthält, deren Leistung Sie überprüfen möchten. 

1.  Klicken Sie im Abfrage-Editor auf **Query Inspector**. 

1.  Klicken Sie auf **Statistiken**. 

 Statistiken werden im schreibgeschützten Format angezeigt. 

## Überprüfen Sie die Anfrage und die Antwort auf die Anfrage
<a name="v9-panels-query-request-response"></a>

 Untersuchen Sie die Daten zu Abfrageanforderung und -antwort, wenn Sie Fehler bei einer Abfrage beheben möchten, die unerwartete Ergebnisse zurückgibt oder die erwarteten Ergebnisse nicht zurückgibt. 

1.  Bearbeiten Sie den Bereich, der die Abfrage enthält, die Sie exportieren möchten. 

1.  Klicken Sie im Abfrage-Editor auf **Query Inspector**. 

1.  Klicken Sie auf **Aktualisieren**. 

    Das Panel wird mit Antwortdaten gefüllt. 

1.  Nehmen Sie bei Bedarf Anpassungen vor und führen Sie die Abfrage erneut aus. 

1.  Um die Abfrageanforderung und die Antwortdaten herunterzuladen, klicken Sie auf das Symbol In **die Zwischenablage kopieren** und fügen Sie die Ergebnisse in eine andere Anwendung ein. 

# Visualisierungen verfügbar in Grafana-Version 9
<a name="v9-panels-viz"></a>

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

Grafana bietet eine Vielzahl von Visualisierungen zur Unterstützung verschiedener Anwendungsfälle. In diesem Abschnitt der Dokumentation werden die integrierten Panels, ihre Optionen und ihre typische Verwendung beschrieben.

Ein häufig verwendetes Panel für den Einstieg und zum Erlernen der Grundlagen der Verwendung von Panels ist das [Bedienfeld „Zeitreihen“](v9-panels-time-series.md) Panel.

**Topics**
+ [Bereich „Warnmeldungsliste“](v9-panels-alert-list.md)
+ [Bedienfeld „Anmerkungen“](v9-panels-annotations.md)
+ [Balkendiagramm-Panel](v9-panels-bar-chart.md)
+ [Balkenmessgerät](v9-panels-bar-gauge.md)
+ [Kerzenständer](v9-panels-candlestick.md)
+ [Paneel auf Leinwand](v9-panels-canvas.md)
+ [Uhr-Panel](v9-panels-clock.md)
+ [Dashboard-Liste](v9-panels-dashboard-list.md)
+ [Instrumententafel](v9-panels-gauge.md)
+ [Bedienfeld „Geomap“](v9-panels-geomap.md)
+ [Bedienfeld „Grafik“](v9-panels-graph.md)
+ [Heatmap-Panel](v9-panels-heatmap.md)
+ [Bedienfeld „Histogramm“](v9-panels-histogram.md)
+ [Bedienfeld „Protokolle“](v9-panels-logs.md)
+ [Nachrichten-Panel](v9-panels-news.md)
+ [Bereich „Knotendiagramm“](v9-panels-node-graph.md)
+ [Bereich „Kreisdiagramm“](v9-panels-piechart.md)
+ [Panel Plotly](v9-panels-plotly.md)
+ [Paneel Sankey](v9-panels-sankey.md)
+ [Scatter-Panel](v9-panels-scatter.md)
+ [Statistik-Panel](v9-panels-stat.md)
+ [Zeitleistenfenster „Status“](v9-panels-state-timeline.md)
+ [Bereich „Statusverlauf“](v9-panels-status-history.md)
+ [Tischplatte](v9-panels-table.md)
+ [Textfeld](v9-panels-text.md)
+ [Bedienfeld „Zeitreihen“](v9-panels-time-series.md)
+ [Bedienfeld „Spuren“ (Beta)](v9-panels-traces.md)
+ [WindRose](v9-panels-windrose.md)

# Bereich „Warnmeldungsliste“
<a name="v9-panels-alert-list"></a>

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

Im Bereich mit der Warnungsliste werden die Benachrichtigungen Ihrer Dashboards angezeigt. Sie können die Liste so konfigurieren, dass der aktuelle Status oder die letzten Statusänderungen angezeigt werden. Weitere Informationen zu Warnmeldungen finden Sie unter[Benachrichtigungen in Grafana-Version 9](v9-alerts.md).

Verwenden Sie diese Einstellungen, um Ihre Visualisierung zu verfeinern.

## Optionen
<a name="v9-panels-alert-list-options"></a>
+  **Gruppenmodus** — Wählen Sie **Standardgruppierung**, um Warnungsinstanzen nach ihrer Warnungsregel gruppiert anzuzeigen, oder **Benutzerdefinierte Gruppierung**, um Warnungsinstanzen nach einem benutzerdefinierten Satz von Bezeichnungen zu gruppieren.
+  **Max. Anzahl an Elementen** — Legen Sie die maximale Anzahl von Alarmen fest, die aufgelistet werden sollen.
+  **Sortierreihenfolge** — Wählen Sie aus, wie die angezeigten Benachrichtigungen sortiert werden sollen.
  +  **Alphabetisch (asc)** — Alphabetisch sortiert
  +  **Alphabetisch (desc) — Umgekehrte alphabetische** Reihenfolge
  +  **Wichtigkeit** — Nach Wichtigkeit anhand der folgenden Werte sortiert, wobei 1 der höchste Wert ist:
    + `alerting`oder`firing`: 1
    + `no_data`: 2
    + `pending`: 3
    + `ok`: 4
    + `paused`oder`inactive`: 5
+  **Benachrichtigungen von diesem Dashboard** — Zeigt nur Benachrichtigungen aus dem Dashboard an, in dem sich die Warnungsliste befindet.

## Filter
<a name="v9-panels-alert-filter"></a>

Verwenden Sie die folgenden Optionen, um die Benachrichtigungen so zu filtern, dass sie der von Ihnen ausgewählten Abfrage, dem Ordner oder den Tags entsprechen:
+  **Warnungsname** — Geben Sie eine Abfrage mit einem Warnungsnamen ein. 
+  **Bezeichnung der Warnungsinstanz** — Filtert Warnungsinstanzen mithilfe von Labelabfragen. Beispiel, `{severity="critical", instance=~"cluster-us-.+"}`.
+  **Ordner** — Wählen Sie einen Ordner aus. Es werden nur Benachrichtigungen von Dashboards im ausgewählten Ordner angezeigt.
+  **Datenquelle** — Filtert Warnmeldungen aus der ausgewählten Datenquelle. 

## Bundesstaatenfilter
<a name="v9-panels-alert-state-filter"></a>

Wählen Sie aus, welche Warnungsstatus in diesem Bereich angezeigt werden sollen.
+ Alarmieren/Abfeuern
+ Ausstehend
+ Keine Daten
+ Normal
+ Fehler

# Bedienfeld „Anmerkungen“
<a name="v9-panels-annotations"></a>

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

Im Bereich Anmerkungen wird eine Liste der verfügbaren Anmerkungen angezeigt, mit denen Sie kommentierte Daten anzeigen können. Es stehen verschiedene Optionen zur Verfügung, um die Liste nach Tags und dem aktuellen Dashboard zu filtern.

## Annotationsabfrage
<a name="v9-panels-annotations-query"></a>

Die folgenden Optionen steuern die Quellabfrage für die Liste der Anmerkungen.

**Filter abfragen**

Verwenden Sie den Abfragefilter, um eine Liste mit Anmerkungen aus allen Dashboards in Ihrer Organisation oder dem aktuellen Dashboard, in dem sich dieser Bereich befindet, zu erstellen. Es hat die folgenden Optionen:
+ Alle Dashboards — Listet Anmerkungen aus allen Dashboards der aktuellen Organisation auf.
+ Dieses Dashboard — Beschränkt die Liste auf die Anmerkungen im aktuellen Dashboard.

**Zeitbereich**

Verwenden Sie die Option Zeitbereich, um anzugeben, ob die Liste auf den aktuellen Zeitraum beschränkt werden soll. Sie hat die folgenden Optionen:
+ Keine — kein Zeitlimit für die Annotationsabfrage.
+ Dieses Dashboard — Beschränken Sie die Liste auf den Zeitraum des Dashboards, in dem der Bereich mit der Liste der Anmerkungen verfügbar ist.

**Tags**

Verwenden Sie die Tags-Option, um die Anmerkungen nach Tags zu filtern. Sie können mehrere Tags hinzufügen, um die Liste zu verfeinern.

**Anmerkung**  
Optional können Sie die Tag-Liste leer lassen und spontan filtern, indem Sie Tags auswählen, die als Teil der Ergebnisse im Panel selbst aufgeführt werden.

*Limit*

Verwenden Sie die Option „Limit“, um die Anzahl der zurückgegebenen Ergebnisse zu begrenzen.

## Anzeige
<a name="v9-panels-annotations-display"></a>

Diese Optionen steuern zusätzliche Metadaten, die in der Anzeige des Annotationsfensters angezeigt werden.

**Benutzer anzeigen**

Verwenden Sie diese Option, um ein- oder auszublenden, welcher Benutzer die Anmerkung erstellt hat.

**Zeit anzeigen**

Verwenden Sie diese Option, um die Uhrzeit der Erstellung der Anmerkung ein- oder auszublenden.

**Schlagworte einblenden**

Verwenden Sie diese Option, um die mit einer Anmerkung verknüpften Tags ein- oder auszublenden. *Hinweis*: Sie können die Tags verwenden, um die Annotationsliste im Panel selbst live zu filtern.

## Verhalten von Links
<a name="v9-panels-annotations-links"></a>

**Ziel verknüpfen**

Verwenden Sie diese Option, um auszuwählen, wie die annotierten Daten angezeigt werden sollen. Sie hat die folgenden Optionen.
+ Panel — Mit dieser Option gelangen Sie direkt zu einer Vollbildansicht des Panels mit der entsprechenden Anmerkung
+ Dashboard — Mit dieser Option wird die Anmerkung im Kontext eines vollständigen Dashboards fokussiert

**Zeit davor**

Verwenden Sie diese Option, um den Zeitraum vor der Anmerkung festzulegen. Verwenden Sie Zeichenkettenwerte für die Dauer wie „1h“ = 1 Stunde, „10m“ = 10 Minuten usw.

**Zeit danach**

Verwenden Sie diese Option, um den Zeitraum nach der Anmerkung festzulegen.

# Balkendiagramm-Panel
<a name="v9-panels-bar-chart"></a>

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

Mit dieser Panel-Visualisierung können Sie kategoriale Daten grafisch darstellen.

## Unterstützte Datumsformate
<a name="v9-panels-bar-chart-formats"></a>

Es wird nur ein Datenrahmen unterstützt, und dieser benötigt mindestens ein Zeichenkettenfeld, das als Kategorie für eine X- oder Y-Achse verwendet wird, und ein oder mehrere numerische Felder. Im Folgenden finden Sie ein Beispiel für Datenformate:


|  Browser  |  Marktanteil  | 
| --- | --- | 
|  Chrome  |  50  | 
|  Internet Explorer  |  17,5  | 

Wenn Sie mehr als ein numerisches Feld haben, zeigt das Panel gruppierte Balken an.

### Visualisieren von Zeitreihen oder mehreren Ergebnismengen
<a name="v9-panels-bar-chart-visualization"></a>

Wenn Sie über mehrere Zeitreihen oder Tabellen verfügen, müssen Sie diese zunächst mithilfe einer Join- oder Reduction-Transformation verbinden. Wenn Sie beispielsweise über mehrere Zeitreihen verfügen und deren letzten und maximalen Wert vergleichen möchten, fügen Sie die Transformation „**Reduzieren**“ hinzu und geben Sie unter **Berechnungen** die Optionen **Max** und **Last** als Optionen an.

## Optionen für Balkendiagramme
<a name="v9-panels-bar-chart-options"></a>

Verwenden Sie diese Optionen, um Ihre Visualisierungen zu verfeinern:

**Orientation (Ausrichtung)**
+  **Auto** — Grafana bestimmt die Balkenausrichtung anhand der Panelabmessungen.
+  **Horizontal** — Macht die X-Achse zur Kategorieachse.
+  **Vertikal** — Macht die Y-Achse zur Kategorieachse.

Die **maximale Länge der Hilfsstrichbeschriftung auf der X-Achse** legt die maximale Länge der Beschriftungen für Balkendiagramme fest. Beschriftungen, die länger als die maximale Länge sind, werden gekürzt (mit Ellipsen).

Der **Mindestabstand zwischen Balkenbeschriftungen** legt den Mindestabstand zwischen Balkenbeschriftungen fest.

**Werte anzeigen**

Steuert, ob Werte über oder links von Balken angezeigt werden.
+  **Auto** — Werte werden angezeigt, wenn Leerzeichen vorhanden sind.
+  **Immer** — Werte werden immer angezeigt.
+  **Nie** — Niemals Werte anzeigen.

**Stapeln**

Steuert das Stapeln von Balkendiagrammen.
+  **Aus** — Balken werden nicht gestapelt.
+  **Normal** — Balken werden übereinander gestapelt.
+  **Prozent** — Die Balken werden übereinander gestapelt, und die Höhe jedes Balkens entspricht dem Prozentsatz der Gesamthöhe des Stapels (alle Balkenstapel haben dieselbe Höhe, was zusammen 100 Prozent ergibt).

Die **Gruppenbreite bestimmt** die Breite der Gruppen. 0=minimale Breite und 1=maximale Breite.

Die **Balkenbreite bestimmt** die Breite der Balken. 0=minimale und 1=maximale Breite.

Der **Balkenradius** bestimmt den Radius der Balken, 0 = minimaler und 0,5 = maximaler Radius.

Wenn **Sie mit dem Mauszeiger auf die Leiste zeigen**, können Sie festlegen, ob der umgebende Bereich des Balkens hervorgehoben wird, wenn Sie mit dem Mauszeiger auf den Balken zeigen.

**Die Linienbreite** steuert die Linienbreite der Balken.

Die **Fülldeckkraft** steuert die Füllopazität der Balken.

Der **Verlaufsmodus** legt den Modus der Verlaufsfüllung fest. Der Füllverlauf basiert auf der Linienfarbe. Um die Farbe zu ändern, verwenden Sie die Standardfeldoption für das Farbschema. Die Darstellung des Verlaufs wird durch die Einstellung für die **Deckkraft der Füllung** beeinflusst.
+  **Keine** — keine Verlaufsfüllung, dies ist die Standardeinstellung.
+  **Opazität** — Die Transparenz des Farbverlaufs wird anhand der Werte auf der Y-Achse berechnet. Die Deckkraft der Füllung nimmt mit den Werten auf der Y-Achse zu.
+  **Farbton** — Die Verlaufsfarbe wird auf der Grundlage des Farbtons der Linienfarbe generiert.

**Tooltip-Modus** — Wenn Sie den Mauszeiger über die Visualisierung bewegen, kann Grafana Tooltips anzeigen. Wählen Sie, wie sich Tooltips verhalten.
+  **Einzeln** — Der Tooltip zeigt nur eine einzige Serie an, nämlich die, über der Sie in der Visualisierung den Mauszeiger bewegen.
+  **Alle** — Der Hover-Tooltip zeigt alle Serien in der Visualisierung an. Grafana hebt die Serie, über die Sie den Mauszeiger bewegen, in der Serienliste im Tooltip fett hervor.
+  **Versteckt** — Zeigt den Tooltip nicht an, wenn Sie mit der Visualisierung interagieren.

**Anmerkung**  
Sie können eine Überschreibung verwenden, um einzelne Serien in der QuickInfo auszublenden.

**Legendenmodus** — Verwenden Sie diese Einstellungen, um die Darstellung der Legende in Ihrer Visualisierung zu verfeinern. Weitere Informationen finden Sie unter [Eine Legende konfigurieren](v9-panels-configure-legend.md).
+  **Liste** — Zeigt die Legende als Liste an. Dies ist der Standardanzeigemodus der Legende.
+  **Tabelle** — Zeigt die Legende als Tabelle an.
+  **Versteckt** — Blendet die Legende aus.

**Platzierung der Legende** — Wählen Sie aus, wo die Legende platziert werden soll.
+  **Unten** — Unter dem Diagramm.
+  **Rechts** — Rechts neben dem Diagramm.

**Legendenberechnungen** — Wählen Sie aus, welche der Standardberechnungen in der Legende angezeigt werden sollen. Sie können mehr als eine haben.

**Textgröße** — Geben Sie einen Wert ein, um die Größe des Textes in Ihrem Balkendiagramm zu ändern.

**Achse** — Verwenden Sie die folgenden Feldeinstellungen, um die Anzeige Ihrer Achsen zu verfeinern. Einige Feldoptionen wirken sich erst dann auf die Visualisierung aus, wenn Sie auf eine Stelle außerhalb des Feldoptionsfeldes klicken, das Sie bearbeiten, oder die Eingabetaste drücken.
+  **Platzierung** — Legt die Platzierung der Y-Achse fest.
+  **Auto** — Grafana weist der Serie automatisch die Y-Achse zu. Wenn es zwei oder mehr Serien mit unterschiedlichen Einheiten gibt, weist Grafana der ersten Einheit die linke Achse und den folgenden Einheiten die rechte zu.
+  **Links** — Zeigt alle Y-Achsen auf der linken Seite an.
+  **Rechts** — Zeigt alle Y-Achsen auf der rechten Seite an.
+  **Versteckt** — Alle Y-Achsen werden ausgeblendet.
+  **Bezeichnung** — Legen Sie eine Textbeschriftung für die Y-Achse fest. Wenn Sie mehr als eine Y-Achse haben, können Sie verschiedene Beschriftungen mit einer Überschreibung zuweisen.
+  **Breite** — Legen Sie eine feste Breite der Achse fest. Standardmäßig berechnet Grafana dynamisch die Breite einer Achse.

  Durch die Einstellung der Breite der Achse können Daten mit unterschiedlichen Achstypen dieselben Anzeigeproportionen haben. Dies macht es einfacher, Daten aus mehreren Diagrammen zu vergleichen, da die Achsen in visueller Nähe zueinander nicht verschoben oder gestreckt werden.
+  **Soft Min und Soft Max** — Stellen Sie eine Soft-Min- und Soft-Max-Option ein, um die Y-Achsengrenzwerte besser kontrollieren zu können. Standardmäßig legt Grafana den Bereich für die Y-Achse automatisch auf der Grundlage des Datensatzes fest.

  Weiche Min- und Soft-Max-Einstellungen können verhindern, dass Blips zu Bergen werden, wenn die Daten größtenteils flach sind. Harte Min.- oder Max-Werte, die aus den Standardfeldoptionen für Min und Max abgeleitet werden, können verhindern, dass intermittierende Spitzen nützliche Details abflachen, indem die Spitzen über einen definierten Punkt hinaus abgeschnitten werden.

  Sie können min/max Standardoptionen festlegen, um feste Grenzwerte für die Y-Achse zu definieren.

# Balkenmessgerät
<a name="v9-panels-bar-gauge"></a>

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

Die Balkenanzeige vereinfacht Ihre Daten, indem sie jedes Feld auf einen einzigen Wert reduziert. Sie entscheiden, wie Grafana die Reduzierung berechnet.

In diesem Bereich können ein oder mehrere Balkenanzeigen angezeigt werden, je nachdem, wie viele Reihen, Zeilen oder Spalten Ihre Abfrage zurückgibt.

## Wertoptionen
<a name="v9-panels-bar-gauge-value"></a>

Verwenden Sie die folgenden Optionen, um zu verfeinern, wie Ihre Visualisierung den Wert anzeigt:

**Anzeigen** — Wählen Sie aus, wie Grafana Ihre Daten anzeigt.

**Berechnen** — Zeigt einen berechneten Wert an, der auf allen Zeilen basiert.
+ **Berechnung** — Wählen Sie eine Reduktionsfunktion aus, mit der Grafana viele Felder auf einen einzigen Wert reduziert. Eine Liste der verfügbaren Berechnungen finden Sie unter Berechnungstypen.
+ **Felder** — Wählen Sie die Felder aus, die im Panel angezeigt werden.

**Alle Werte** — Zeigt für jede Zeile eine separate Statistik an. Wenn Sie diese Option auswählen, können Sie auch die Anzahl der anzuzeigenden Zeilen einschränken.
+ **Limit** — Die maximale Anzahl der anzuzeigenden Zeilen. Die Standardeinstellung ist 5.000.
+ **Felder** — Wählen Sie die Felder aus, die im Panel angezeigt werden.

## Optionen für die Balkenanzeige
<a name="v9-panels-bar-gauge-options"></a>

Passen Sie an, wie die Balkenanzeige angezeigt wird.

**Ausrichtung** — Wählen Sie eine Stapelrichtung.
+ **Auto** — Grafana wählt aus, was es für die beste Ausrichtung hält.
+ **Horizontal** — Balken werden horizontal von links nach rechts gestreckt.
+ **Vertikal** — Die Balken werden vertikal von unten nach oben gestreckt.

**Anzeigemodus** — Wählen Sie einen Anzeigemodus.
+ **Verlauf** — Schwellenwerte definieren einen Farbverlauf.
+ **Retro-LCD** — Das Messgerät ist in kleine Zellen aufgeteilt, die entweder leuchten oder nicht.
+ **Standard** — Einzelfarbe, basierend auf dem passenden Schwellenwert.

**Ungefüllten Bereich anzeigen** — Wählen Sie diese Option, wenn Sie den ungefüllten Bereich der Balken dunkelgrau rendern möchten. Gilt nicht für den Retro-LCD-Anzeigemodus.

**Minimale Breite**

Begrenzen Sie die Mindestbreite der Balkenspalte in vertikaler Richtung.

Zeigt automatisch die Bildlaufleiste auf der X-Achse an, wenn eine große Datenmenge vorhanden ist.

**Minimale Höhe**

Begrenzen Sie die Mindesthöhe der Balkenreihe in horizontaler Richtung.

Zeigt automatisch die Scrollleiste auf der Y-Achse an, wenn eine große Datenmenge vorhanden ist.

# Kerzenständer
<a name="v9-panels-candlestick"></a>

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

Mit dem Candlestick-Panel können Sie Daten visualisieren, die eine Reihe konsistenter Dimensionen enthalten, die sich auf Preisbewegungen konzentrieren. Das Candlestick-Panel umfasst einen Open-High-Low-Close (OHLC) -Modus sowie Unterstützung für zusätzliche Dimensionen, die auf Zeitreihendaten basieren.

Das Candlestick-Panel baut auf der Grundlage von auf [Bedienfeld „Zeitreihen“](v9-panels-time-series.md) und enthält viele gängige Konfigurationseinstellungen.

**Mode (Modus)**

Mit den Modusoptionen können Sie umschalten, welche Dimensionen für die Visualisierung verwendet werden.
+ **Candles** begrenzt die Abmessungen des Panels auf die Abmessungen „Öffnen“, „Hoch“, „Niedrig“ und „Schließen“, die bei Candlestick-Visualisierungen verwendet werden.
+ **Das Volumen** begrenzt die Panelabmessung auf die Volumendimension.
+ **Beides** ist das Standardverhalten für das Candlestick-Panel. Es umfasst sowohl Candlestick- als auch Volumenvisualisierungen.

**Kerzen-Stil**
+ **Kerzen** ist der Standardanzeigestil und erzeugt Visualisierungen im Kerzenstil zwischen den Dimensionen „Öffnen“ und „Schließen“.
+ In **OHLC Bars** werden die Werte für Öffnung, Höhe, Tiefe und Schließung der vier Kerndimensionen angezeigt.

**Farbstrategie**
+ **Da Open** das Standardverhalten ist. In diesem Modus wird die Farbe „*Nach oben*“ (unten) verwendet, wenn die Preisbewegung innerhalb der Periode positiv ist. Mit anderen Worten, wenn der Wert beim Schließen größer oder gleich dem Wert beim Öffnen ist, wird die *Aufwärtsfarbe* verwendet.
+ **Da der vorherige Schlusskurs** eine alternative Darstellungsmethode ist, bei der die Farbe der Kerze auf der Preisbewegung oder Wertänderung zwischen den Perioden basiert. Mit anderen Worten, wenn der Wert beim Öffnen größer als der vorherige Wert beim Schließen ist, wird die Farbe *Nach oben* verwendet. Wenn der Wert beim Öffnen niedriger als der vorherige Wert beim Schließen ist, wird die Farbe Nach *unten* verwendet. *Diese Option löst auch den Visualisierungsmodus mit hohlen Kerzen aus*. Leere Kerzen zeigen an, dass die Bewegung innerhalb der Periode positiv ist (der Wert ist beim Schließen höher als beim Öffnen). Gefüllte Kerzen bedeuten, dass die Veränderung innerhalb der Periode negativ ist (der Wert ist beim Schließen niedriger als beim Öffnen). [Weitere Informationen finden Sie in der Erklärung der Unterschiede.](https://thetradingbible.com/how-to-read-hollow-candlesticks)

**Farben nach oben und unten**

Mit den Optionen „**Farbe nach oben**“ und „**Farbe nach unten**“ wird ausgewählt, welche Farben verwendet werden, wenn die Preisbewegung steigt oder fällt. Mit der obigen *Farbstrategie* wird bestimmt, ob die Farbe der Kerzen oder des OHLC-Balkens anhand von Preisbewegungen innerhalb oder zwischen Perioden ausgewählt wird.

**Öffnen, Hoch, Niedrig, Schließen**

Das Candlestick-Panel versucht, Felder der entsprechenden Dimension zuzuordnen. Mit den Optionen **Öffnen**, **Hoch**, **Niedrig** und **Schließen** können Sie Ihre Daten diesen Dimensionen zuordnen, falls das Panel dazu nicht in der Lage ist.

**Anmerkung**  
Diese Werte sind in der Legende verborgen.
+ **Open** entspricht dem Startwert des angegebenen Zeitraums.
+ **Hoch** entspricht dem höchsten Wert des angegebenen Zeitraums.
+ **Niedrig** entspricht dem niedrigsten Wert des angegebenen Zeitraums.
+ **Close** entspricht dem Endwert (Endwert) des angegebenen Zeitraums.
+ **Das Volumen** entspricht der Anzahl der Stichproben im angegebenen Zeitraum. (z. B. Anzahl der Geschäfte)

**Zusätzliche Felder**

Das Candlestick-Panel basiert auf dem Zeitreihen-Panel. Es kann zusätzliche Datendimensionen als „Öffnen“, „Hoch“, „Niedrig“, „Schließen“ und „Volumen“ visualisieren. Mit den Optionen „**Einschließen**“ und „**Ignorieren**“ kann das Panel auch andere enthaltene Daten wie einfache gleitende Durchschnitte, Bollinger-Bänder und mehr visualisieren. Dabei werden dieselben Stile und Konfigurationen verwendet, die auch in der verfügbar sind. [Bedienfeld „Zeitreihen“](v9-panels-time-series.md)

# Paneel auf Leinwand
<a name="v9-panels-canvas"></a>

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

Canvas ist ein neues Panel, das die Leistungsfähigkeit von Grafana mit der Flexibilität benutzerdefinierter Elemente kombiniert. Canvas-Visualisierungen sind erweiterbare, in Formularen erstellte Bedienfelder, mit denen Sie Elemente explizit in statischen und dynamischen Layouts platzieren können. Auf diese Weise können Sie benutzerdefinierte Visualisierungen und Overlay-Daten auf eine Weise entwerfen, die mit Standard-Grafana-Panels nicht möglich ist, und das alles innerhalb der Benutzeroberfläche von Grafana. Wenn Sie beliebte UI- und Webdesign-Tools verwendet haben, wird Ihnen das Entwerfen von Canvas-Panels sehr vertraut vorkommen.

## Elemente
<a name="v9-panels-canvas-elements"></a>

**Metrikwert**

Mit dem metrischen Wertelement können Sie ganz einfach die Daten auswählen, die Sie auf der Leinwand anzeigen möchten. Dieses Element verfügt über einen einzigartigen Bearbeitungsmodus, der entweder über die Option „Bearbeiten“ im Kontextmenü oder durch Doppelklicken ausgelöst werden kann. Im Bearbeitungsmodus können Sie auswählen, welche Felddaten Sie anzeigen möchten.

**Text**

Mit dem Textelement können Sie der Leinwand auf einfache Weise Text hinzufügen. Das Element unterstützt auch einen Bearbeitungsmodus, der entweder durch Doppelklicken oder durch die Menüoption Bearbeiten im Kontextmenü ausgelöst wird.

**Rechteck**

Mit dem rechteckigen Element können Sie der Leinwand ein einfaches Rechteck hinzufügen. Rechteckige Elemente unterstützen die Anzeige von Text (sowohl feste Daten als auch Felddaten) und können die Hintergrundfarbe anhand von Datenschwellenwerten ändern.

**Symbol**

Mit dem Symbolelement können Sie der Leinwand ein unterstütztes Symbol hinzufügen. Die Farbe von Symbolen kann auf der Grundlage von Schwellenwerten oder Wertzuordnungen festgelegt werden.

## Bearbeitung der Leinwand
<a name="v9-panels-canvas-editing"></a>

**Inline-Editor**

Canvas bietet ein neues Bearbeitungserlebnis. Sie können Ihr Canvas-Panel jetzt inline bearbeiten, während Sie sich im Dashboard-Modus befinden.

**Kontextmenü**

Über das Kontextmenü haben Sie Zugriff auf häufig vorkommende Aufgaben. Zu den unterstützten Funktionen gehören das Öffnen und Schließen des Inline-Editors, das Duplizieren eines Elements, das Löschen eines Elements und mehr.

Das Kontextmenü wird ausgelöst, wenn Sie mit der rechten Maustaste auf das Panel oder ein bestimmtes Canvas-Element klicken. Wenn Sie mit der rechten Maustaste auf das Panel klicken, können Sie ein Hintergrundbild festlegen und ganz einfach Elemente zur Leinwand hinzufügen.

Wenn Sie mit der rechten Maustaste auf ein Element klicken, können Sie das Element bearbeiten, löschen und duplizieren oder die Ebenenpositionierung des Elements ändern.

## Canvas-Optionen
<a name="v9-panels-canvas-options"></a>

**Inline-Bearbeitung**

Mit dem Umschalter für die Inline-Bearbeitung können Sie das Canvas-Bedienfeld sperren oder entsperren. Wenn die Option deaktiviert ist, wird das Leinwandfenster *gesperrt*, wodurch Elemente an ihrem Platz fixiert werden und unbeabsichtigte Änderungen verhindert werden.

# Uhr-Panel
<a name="v9-panels-clock"></a>

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

Das Uhrfenster zeigt die aktuelle Uhrzeit oder einen Countdown an. Es wird jede Sekunde aktualisiert.
+ **Modus** — Die Standardeinstellung ist **Zeit**. Wenn Sie **Countdown wählen, legen** Sie die **Countdown-Frist fest, um den Countdown** zu starten.
+ **12 oder 24 Stunden** — Die Optionen für die Anzeige der Uhrzeit sind das 12-Stunden-Format und das 24-Stunden-Format.
+ **Zeitzone** — Die Zeitzonen werden von der Moment Timezone Library bereitgestellt. Die Standardeinstellung ist die Zeitzone auf Ihrem Computer.
+ **Countdown-Frist** — Geben Sie die Uhrzeit und das Datum an, bis zu dem der Countdown gezählt werden soll, wenn Sie den **Modus** auf **Countdown** eingestellt haben.
+ **Text zum Ende des Countdowns — Geben Sie den Text** an, der angezeigt werden soll, wenn der Countdown endet.
+ **Formatierungsoptionen für Datum/Uhrzeit** — Passen Sie Schriftgröße, Schriftstärke und Formatierung an. date/time Wenn Sie einen Countdown anzeigen und nicht möchten, dass die Sekunden ablaufen, ändern Sie das Zeitformat auf `hh:mm` die 24-Stunden-Uhr oder `h:mm A` die 12-Stunden-Uhr. [Eine vollständige Liste der Optionen finden Sie unter Anzeige.](https://momentjs.com/docs/#/displaying/)
+ **Bg Color** — Wählen Sie eine Hintergrundfarbe für die Uhr aus.

# Dashboard-Liste
<a name="v9-panels-dashboard-list"></a>

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

Die Visualisierung der Dashboard-Liste ermöglicht es Ihnen, dynamische Links zu anderen Dashboards anzuzeigen. Die Liste kann so konfiguriert werden, dass sie mit einem Stern markierte Dashboards, kürzlich angesehene Dashboards, eine Suchabfrage und Dashboard-Tags verwendet.

Bei jedem Ladevorgang des Dashboards fragt dieser Bereich die Dashboard-Liste ab und liefert immer die meisten Ergebnisse. up-to-date

**Optionen**

Verwenden Sie diese Optionen, um Ihre Visualisierung zu verfeinern.
+ **Mit** Stern markiert — Zeigt mit Sternchen versehene Dashboards in alphabetischer Reihenfolge an.
+ **Zuletzt angesehen** — Zeigt die zuletzt aufgerufenen Dashboards in alphabetischer Reihenfolge an.
+ **Suche** — Zeigt Dashboards nach Suchabfrage oder Schlagwörtern an. Sie müssen mindestens einen Wert in **Query** oder **Tags** eingeben. Für die Felder **Abfrage** und **Tags** wird die Variableninterpolation unterstützt, `$my_var` z. B. oder. `${my_var}`
+ **Überschriften anzeigen** — Die gewählte Listenauswahl (Mit Stern markiert, Zuletzt angesehen, Suche) wird als Überschrift angezeigt.
+ **Max. Einträge** — Legt die maximale Anzahl von Elementen fest, die pro Abschnitt aufgelistet werden sollen. Wenn Sie diesen Wert beispielsweise auf den Standardwert 10 belassen und die Dashboards mit Sternchen und Zuletzt angesehen angezeigt haben, zeigt das Panel insgesamt bis zu 20 Dashboards an, zehn in jedem Abschnitt.

**Suche**

Diese Optionen gelten nur, wenn die **Suchoption ausgewählt** ist.
+ **Abfrage** — Geben Sie die Abfrage ein, nach der Sie suchen möchten. Bei Abfragen wird nicht zwischen Groß- und Kleinschreibung unterschieden, und Teilwerte werden akzeptiert.
+ **Ordner** — Wählen Sie die Dashboard-Ordner aus, die Sie anzeigen möchten.
+ **Tags** — Hier geben Sie Ihre Stichwörter ein, nach denen Sie suchen möchten. Bestehende Tags werden während der Eingabe nicht angezeigt, und bei ihnen wird zwischen Groß- und Kleinschreibung *unterschieden*.

**Anmerkung**  
Wenn mehrere Tags und Zeichenfolgen angezeigt werden, werden in der Dashboard-Liste diejenigen angezeigt, die *allen* Bedingungen entsprechen.

# Instrumententafel
<a name="v9-panels-gauge"></a>

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

Gauge ist eine Einzelwertvisualisierung, mit der ein Messgerät für jede Reihe, Spalte oder Zeile wiederholt werden kann.

**Wertoptionen**

Verwenden Sie die folgenden Optionen, um zu verfeinern, wie Ihre Visualisierung den Wert anzeigt:

**Show (Anzeigen)**

Wählen Sie, wie Grafana Ihre Daten anzeigt.

**Berechne**

Zeigt einen berechneten Wert an, der auf allen Zeilen basiert.
+ **Berechnung** — Wählen Sie eine Reduktionsfunktion aus, mit der Grafana viele Felder auf einen einzigen Wert reduziert. Eine Liste der verfügbaren Berechnungen finden Sie unter. [Berechnungsarten](v9-panels-calculation-types.md)
+ **Felder** — Wählen Sie die Felder aus, die im Panel angezeigt werden sollen.

**Alle Werte**

Zeigt für jede Zeile eine separate Statistik an. Wenn Sie diese Option auswählen, können Sie auch die Anzahl der anzuzeigenden Zeilen einschränken.
+ **Limit** — Die maximale Anzahl der anzuzeigenden Zeilen. Die Standardeinstellung ist 5.000.
+ **Felder** — Wählen Sie die Felder aus, die im Panel angezeigt werden sollen.

**Messinstrument**

Passen Sie an, wie das Messgerät angezeigt wird.
+ **Schwellenwertbeschriftungen anzeigen** — Steuert, ob Schwellenwerte angezeigt werden.
+ **Schwellenwertmarkierungen anzeigen** — Steuert, ob ein Schwellenwertband außerhalb des inneren Messbereiches angezeigt wird.

**Textgröße**

Passen Sie die Größe des Messtextes an.
+ **Titel** — Geben Sie einen numerischen Wert für die Titelgröße des Messgeräts ein.
+ **Wert** — Geben Sie einen numerischen Wert für die Größe des Messgeräts ein.

# Bedienfeld „Geomap“
<a name="v9-panels-geomap"></a>

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

Mit der Visualisierung im Geomap-Bedienfeld können Sie die Weltkarte mithilfe von Geodaten anzeigen und anpassen. Sie können verschiedene Overlay-Stile und Einstellungen für die Kartenansicht konfigurieren, um sich ganz einfach auf die wichtigen standortbezogenen Eigenschaften der Daten zu konzentrieren.

## Kartenansicht
<a name="v9-panels-geomap-view"></a>

Die Kartenansicht steuert die erste Ansicht der Karte, wenn das Dashboard geladen wird.

**Erste Ansicht**

In der ersten Ansicht wird konfiguriert, wie das GeoMap Panel gerendert wird, wenn das Panel zum ersten Mal geladen wird.
+ Die **Ansicht** legt den Mittelpunkt der Map fest, wenn das Panel zum ersten Mal geladen wird.
  + „**An Daten anpassen**“ passt sich der Kartenansicht an, basierend auf den Datenausdehnungen der Kartenebenen, und wird aktualisiert, wenn sich Daten ändern.
    + Die **Datenoption** ermöglicht die Auswahl der Ausdehnung auf der Grundlage von Daten aus „Alle Ebenen“, einer einzelnen „Ebene“ oder dem „letzten Wert“ aus einer ausgewählten Ebene.
    + Die **Ebene** kann ausgewählt werden, wenn Daten aus einer einzelnen „Ebene“ oder dem „letzten Wert“ einer Ebene angepasst werden.
    + Beim **Auffüllen** wird der Abstand über die DatenausDEHNUNG hinaus in relativer Prozentzahl festgelegt (nicht verfügbar, wenn nur der „Letzte Wert“ betrachtet wird).
    + **Max. Zoom** legt die maximale Zoomstufe für die Anpassung von Daten fest.
  + Mit den **Koordinaten** wird die Kartenansicht auf der Grundlage folgender Kriterien festgelegt:
    + **Breitengrad**
    + **Längengrad**
  + Standardansichten sind ebenfalls verfügbar, darunter:
    + **(0°, 0°)**
    + **Nordamerika**
    + **Südamerika**
    + **Europa**
    + **Afrika**
    + **West-Asien**
    + **Südasien**
    + **Südost-Asien**
    + **Ost-Asien**
    + **Australien**
    + **Ozeanien**
+ **Zoom** legt die anfängliche Zoomstufe fest.

## Kartenebenen
<a name="v9-panels-geomap-layers"></a>

Die Geomap-Visualisierung unterstützt die Anzeige mehrerer Ebenen. Jede Ebene bestimmt, wie Sie Geodaten auf der Basiskarte visualisieren.

**Typen**

In der Geomap-Visualisierung stehen drei Kartenebenentypen zur Auswahl.
+ [Ebene „Markierungen“](#v9-panels-geomap-markers)rendert an jedem Datenpunkt eine Markierung.
+ [Heatmap-Ebene](#v9-panels-geomap-heatmap)visualisiert eine Heatmap der Daten.
+ [GeoJSON-Ebene](#v9-panels-geomap-geojson)rendert statische Daten aus einer GeoJSON-Datei.

Außerdem gibt es fünf Layer-Typen, die sich derzeit in der Alpha-Version befinden.
+ [Ebene Nacht/Tag (Alpha)](#v9-panels-geomap-nightday)rendert eine Nacht- oder Tagesregion.
+ **Symbol am letzten Punkt (Alpha)** rendert ein Symbol am letzten Datenpunkt.
+ **Dynamic GeoJSON (Alpha)** stylt eine GeoJSON-Datei auf der Grundlage von Abfrageergebnissen.
+ **Route (Alpha)** rendert Datenpunkte als Route.
+ [Fotoebene (Alpha)](#v9-panels-geomap-photos)rendert an jedem Datenpunkt ein Foto.

**Ebenensteuerungen**

Mit den Ebenensteuerungen können Sie Ebenen erstellen, ihren Namen ändern, Ebenen neu anordnen und löschen.
+ „**Ebene hinzufügen**“ erstellt eine zusätzliche, konfigurierbare Datenebene für die Geomap-Visualisierung. Wenn Sie eine Ebene hinzufügen, werden Sie aufgefordert, einen Ebenentyp auszuwählen. Sie können den Ebenentyp jederzeit während der Panel-Konfiguration ändern. Einzelheiten zu den einzelnen **Ebenentypen** finden Sie oben im Abschnitt Ebenentypen.
+ Mit den Ebenensteuerungen können Sie die Ebenen des Bedienfelds umbenennen, löschen und neu anordnen.
  + **Ebenennamen bearbeiten** (Bleistiftsymbol) benennt die Ebene um.
  + Der **Papierkorb** löscht die Ebene.
  + Mit der **Option Neuanordnen** (sechs Punkte/Griff) können Sie die Reihenfolge der Ebenen ändern. Daten auf höheren Ebenen werden über Daten auf niedrigeren Ebenen angezeigt. Das Bedienfeld aktualisiert die Ebenenreihenfolge beim Ziehen und Ablegen, um die Auswahl der Ebenenreihenfolge zu vereinfachen.

Sie können einem einzelnen Geomap-Bedienfeld mehrere Datenebenen hinzufügen, um umfangreiche, detaillierte Visualisierungen zu erstellen.

**Ort**

Das Geomap-Panel benötigt eine Quelle für geografische Daten. Diese Daten stammen aus einer Datenbankabfrage, und es gibt vier Zuordnungsoptionen für Ihre Daten.
+ Sucht **automatisch** nach Standortdaten. Verwenden Sie diese Option, wenn Ihre Abfrage auf einem der folgenden Namen für Datenfelder basiert.
  + geohash: „Geohash“
  + Breitengrad: „Breitengrad“, „Breitengrad“
  + Längengrad: „Längengrad“, „Long“, „Long“
  + Suche: „Suche“
+ **Coords** gibt an, dass Ihre Abfrage Koordinatendaten enthält. Sie werden aufgefordert, numerische Datenfelder für Breitengrad und Längengrad aus Ihrer Datenbankabfrage auszuwählen.
+ **Geohash** gibt an, dass Ihre Abfrage Geohash-Daten enthält. Sie werden aufgefordert, ein Zeichenkettendatenfeld für den Geohash aus Ihrer Datenbankabfrage auszuwählen.
+ **Lookup** gibt an, dass Ihre Abfrage Ortsnamendaten enthält, die einem Wert zugeordnet werden müssen. Sie werden aufgefordert, das Nachschlagefeld aus Ihrer Datenbankabfrage und einem Ortsverzeichnis auszuwählen. Das Ortsverzeichnis ist das Verzeichnis, das verwendet wird, um Ihre abgefragten Daten einem geografischen Punkt zuzuordnen.

## Ebene „Markierungen“
<a name="v9-panels-geomap-markers"></a>

Auf der Markerebene können Sie Datenpunkte als verschiedene Markierungsformen wie Kreise, Quadrate, Dreiecke, Sterne und mehr anzeigen.

Markierungen bieten viele Anpassungsoptionen.
+ **Die Markerfarbe** konfiguriert die Farbe der Markierung. In der `Single color` Standardeinstellung behalten alle Punkte eine einzige Farbe bei. Abhängig von den Datenpunktwerten und dem im `Thresholds` Abschnitt festgelegten Schwellenwert gibt es eine alternative Option, bei der mehrere Farben verwendet werden können.
+ Die **Markierungsgröße** konfiguriert die Größe der Markierung. Die Standardeinstellung ist`Fixed size`, wodurch alle Markierungsgrößen unabhängig von den Datenpunkten gleich sind. Es besteht jedoch auch die Möglichkeit, die Kreise auf die entsprechenden Datenpunkte zu skalieren. `Min`und die `Max` Markergröße muss so eingestellt werden, dass die Markerebene innerhalb dieses Bereichs skaliert werden kann.
+ Mit **Marker Shape** können Sie die Form, das Symbol oder die Grafik auswählen, um Ihren Daten einen zusätzlichen visuellen Kontext zu verleihen. Wählen Sie aus Elementen, die in Grafana enthalten sind, wie z. B. einfache Formen oder die Unicon-Bibliothek. Sie können auch eine URL angeben, die ein Bild-Asset enthält. Das Bild muss eine skalierbare Vektorgrafik (SVG) sein.
+ Mit der **Füllundurchlässigkeit** wird die Transparenz der einzelnen Markierungen konfiguriert.

## Heatmap-Ebene
<a name="v9-panels-geomap-heatmap"></a>

Die Heatmap-Ebene gruppiert verschiedene Datenpunkte, um Orte mit unterschiedlicher Dichte zu visualisieren. Um eine Heatmap-Ebene hinzuzufügen:

Klicken Sie auf das Drop-down-Menü unter Datenebene und wählen Sie. `Heatmap`

Ähnlich wie werden Ihnen Optionen angezeigt`Markers`, mit denen Sie festlegen können, welche Datenpunkte visualisiert werden sollen und wie Sie sie visualisieren möchten.
+ **Gewichtungswerte** konfigurieren die Intensität der Heatmap-Cluster. `Fixed value`behält für alle Datenpunkte einen konstanten Gewichtungswert bei. Dieser Wert sollte im Bereich von 0\$11 liegen. Ähnlich wie bei Markierungen gibt es in der Drop-down-Liste eine alternative Option, um die Gewichtswerte automatisch in Abhängigkeit von den Datenwerten zu skalieren.
+ **Radius** konfiguriert die Größe der Heatmap-Cluster.
+ **Blur** konfiguriert den Grad der Unschärfe auf jedem Cluster.

## GeoJSON-Ebene
<a name="v9-panels-geomap-geojson"></a>

Die GeoJSON-Ebene ermöglicht es Ihnen, eine statische GeoJSON-Datei aus dem Dateisystem auszuwählen und zu laden.
+ Die **GeoJSON-URL** bietet eine Auswahl an GeoJSON-Dateien, die mit Grafana geliefert werden.
+ **Der Standardstil** steuert, welche Stile angewendet werden sollen, wenn keine der oben genannten Regeln zutreffen.
  + **Farbe** konfiguriert die Farbe des Standardstils
  + **Opazität** konfiguriert die Standard-Opazität
+ **Stilregeln** wenden Stile auf der Grundlage von Feature-Eigenschaften an
  + Mit **der Regel** können Sie ein *Feature*, eine *Bedingung* und einen *Wert* aus der GeoJSON-Datei auswählen, um eine Regel zu definieren. Das Papierkorbsymbol kann verwendet werden, um die aktuelle Regel zu löschen.
  + **Farbe** konfiguriert die Farbe des Stils für die aktuelle Regel
  + **Opazität** konfiguriert den Transparenzgrad für die aktuelle Regel
+ Mit der **Option Stilregel hinzufügen werden zusätzliche Stilregeln** erstellt.

## CARTO-Ebene
<a name="v9-panels-geomap-carto"></a>

Eine CARTO-Ebene stammt aus [CARTO](https://carto.com/about-us/) Raster-Grundkarten.

**Optionen**
+ **Thema**

   Wählen Sie ein Design, entweder ein **helles** Design, ein **dunkles** Design oder ein **automatisches** Design.
+ **Beschriftungen anzeigen** zeigt die Länderdetails oben auf der Karte an.
+ **Opazität** von 0 (transparent) bis 1 (undurchsichtig)

## XYZ-Kachelebene
<a name="v9-panels-geomap-xyz"></a>

Die XYZ-Kachelebene ist eine Karte aus einer generischen Kachelebene.

**Anmerkung**  
Weitere Informationen zu generischen Kachel-Layern finden Sie unter [Tiled Web Maps](https://en.wikipedia.org/wiki/Tiled_web_map) und [List of Open Street Map Tile Servers](https://wiki.openstreetmap.org/wiki/Tile_servers).

**Optionen**
+ **URL-Vorlage**
**Anmerkung**  
Legen Sie eine gültige Tileserver-URL mit \$1z\$1/\$1x\$1/\$1y\$1 fest, zum Beispiel:`https://tile.openstreetmap.org/{z}/{x}/{y}.png`.
+ Die **Zuordnung** legt die Referenzzeichenfolge für den Layer fest, wenn er in [Kartensteuerelementen](#v9-panels-geomap-controls) angezeigt wird
+ **Die Opazität reicht** von 0 (transparent) bis 1 (undurchsichtig)

## Öffnen Sie die Street Map-Ebene
<a name="v9-panels-geomap-osm"></a>

Eine Karte aus [Open Street Map](https://www.openstreetmap.org/about), einer kollaborativen, kostenlosen geographischen Weltdatenbank.

**Optionen**
+ **Opazität** von 0 (transparent) bis 1 (undurchsichtig)

## ArcGIS-Layer
<a name="v9-panels-geomap-arcgis"></a>

Ein [ArcGIS-Layer](https://services.arcgisonline.com/arcgis/rest/services) ist ein Layer aus einem [ESRI](https://www.esri.com/en-us/about/about-esri/overview) MapServer ArcGIS-Layer.

**Optionen**
+ **Serverinstanz** zur Auswahl aus den folgenden Kartentypen.
  + Straßenkarte der Welt
  + Weltbilder
  + Physische Welt
  + Topografisch
  + Topografisch der USA
  + Weltozean
  + Benutzerdefiniert MapServer (zur Formatierung siehe [XYZ](#v9-panels-geomap-xyz))
    + URL-Vorlage
    + Nennung
+ **Opazität** von 0 (transparent) bis 1 (undurchsichtig)

## Ebene Nacht/Tag (Alpha)
<a name="v9-panels-geomap-nightday"></a>

Die Ebene Night /Day zeigt Nacht- und Tagesregionen auf der Grundlage des aktuellen Zeitbereichs an.

**Anmerkung**  
Weitere Informationen finden Sie unter [Erweiterungen für OpenLayers - DayNight](https://viglino.github.io/ol-ext/examples/layer/map.daynight.html).

**Optionen**
+ Mit „**Anzeigen**“ wird die Zeitquelle vom Zeitbereich des Panels umgeschaltet
+ **Die Farbe des Nachtbereichs** wählt die Farbe für den Nachtbereich
+ **Sonne anzeigen** schaltet das Sonnensymbol um
+ **Opazität** von 0 (transparent) bis 1 (undurchsichtig)

## Fotoebene (Alpha)
<a name="v9-panels-geomap-photos"></a>

Die Fotoebene rendert an jedem Datenpunkt ein Foto.

**Anmerkung**  
Weitere Informationen finden Sie unter [Erweiterungen für OpenLayers - Image Photo Style](http://viglino.github.io/ol-ext/examples/style/map.style.photo.html).

**Optionen**
+ **Feld „Bildquelle“**

  Wählen Sie ein Zeichenkettenfeld aus, das Bilddaten in einem der folgenden Formate enthält:
  + **Abbild URLs**
  + **Base64-codierte** Bildbinärdatei () `data:image/png;base64,…`
+ **Freundlich**

   Wählen Sie den Rahmenstil rund um die Bilder
  + **Square (Quadrat)**
  + **Circle**
  + **Verankert**
  + **Folio**
+ Aktiviert die Option „**Zuschneiden**“, wenn die Bilder passgenau zugeschnitten sind
+ **Schatten**: Schaltet ein Feld (Schatten hinter den Bildern) ein
+ **Rahmen legt** die Rahmengröße für Bilder fest
+ **Rahmenfarbe** legt die Rahmenfarbe für Bilder fest
+ Der **Radius** legt die Gesamtgröße von Bildern in Pixeln fest

## Steuerelemente auf der Karte
<a name="v9-panels-geomap-controls"></a>

Die Benutzeroberfläche für Kartensteuerungen enthält die folgenden Optionen für Karteninformationen und Werkzeug-Overlays.

**Zoom**

In diesem Abschnitt werden die einzelnen Zoom-Steuerelemente beschrieben.

*Zoomsteuerung anzeigen*

Zeigt die Zoom-Steuerelemente in der oberen linken Ecke an.

*Zoom mit dem Mausrad*

Wird mithilfe des Mausrads zum Vergrößern oder Verkleinern ein- oder ausgeschaltet.

**Zuordnung anzeigen**

Zeigt die Zuordnung für Grundkarten-Layer auf der Karte an.

**Maßstab anzeigen**

Zeigt Maßstabsinformationen in der unteren linken Ecke an.

**Anmerkung**  
Zeigt Einheiten in [m]/[km] an.

**Messwerkzeuge anzeigen**

Zeigt Messwerkzeuge in der oberen rechten Ecke an. Messungen werden nur angezeigt, wenn dieses Steuerelement geöffnet ist.
+ **Klicken Sie**, um mit der Messung zu beginnen
+ **Klicken Sie weiter**, um mit der Messung fortzufahren
+ **Doppelklicken Sie**, um die Messung zu beenden

**Anmerkung**  
Wenn Sie den Messtyp oder die Maßeinheiten ändern, wird die vorherige Messung aus der Karte entfernt.  
Wenn die Steuerung geschlossen und dann wieder geöffnet wird, wird die letzte Messung angezeigt.  
Eine Messung kann geändert werden, indem Sie darauf klicken und sie ziehen.

*Länge*

Ermittelt die sphärische Länge einer Geometrie. Diese Länge ist die Summe der Großkreisabstände zwischen den Koordinaten. Bei mehrteiligen Geometrien ist die Länge die Summe der Länge der einzelnen Teile. Es wird davon ausgegangen, dass Geometrien in „EPSG:3857“ enthalten sind.

Sie können die folgenden Einheiten für Längenmaße wählen:
+ **Metrisch (m/km)**
+ **Fuß (ft)**
+ **Meilen (mi)**
+ **Seemeilen (NMI)**

*Area*

Ermittelt die sphärische Fläche einer Geometrie. Diese Fläche wird unter der Annahme berechnet, dass Polygonkanten Segmente von Großkreisen auf einer Kugel sind. Es wird davon ausgegangen, dass Geometrien in „EPSG:3857“ enthalten sind.

Sie können die folgenden Einheiten für Flächenmessungen wählen:
+ **Quadratmeter (m²)**
+ **Quadratkilometer (km²)**
+ **Quadratfuß (ft²)**
+ **Quadratmeilen (mi²)**
+ **Hektar (Acre)**
+ **Hektar (ha)**

**Debug anzeigen**

Zeigt Debug-Informationen in der oberen rechten Ecke der Map an. Dies kann beim Debuggen oder Überprüfen einer Datenquelle nützlich sein.
+ **Zoom** zeigt die aktuelle Zoomstufe der Karte an.
+ In der **Mitte** werden der aktuelle **Längen-** und **Breitengrad** der Kartenmitte angezeigt.

**Tooltip**
+ **Keine** zeigt QuickInfos nur an, wenn auf einen Datenpunkt geklickt wird.
+ **Details** zeigt QuickInfos an, wenn sich ein Zeiger über einem Datenpunkt befindet.

# Bedienfeld „Grafik“
<a name="v9-panels-graph"></a>

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

Ein Grafikfenster kann als Linie, als Pfad aus Punkten oder als Reihe von Balken dargestellt werden. Diese Art von Diagramm ist vielseitig genug, um fast alle Zeitreihendaten anzuzeigen.

## Daten- und Feldoptionen
<a name="v9-panels-graph-data-and-field-options"></a>

Bei der Verwendung von Grafikvisualisierungen können Sie die folgenden Optionen anwenden:
+  [Transformieren von Daten](v9-panels-xform.md) 
+ Warnmeldungen. Dies ist die einzige Art der Visualisierung, mit der Sie Warnmeldungen einrichten können. Weitere Informationen finden Sie unter [Benachrichtigungen in Grafana-Version 9](v9-alerts.md).
+  [Schwellenwerte konfigurieren](v9-panels-configure-thresholds.md) 

## Optionen anzeigen
<a name="v9-panels-graph-display-options"></a>

Verwenden Sie die folgenden Einstellungen, um Ihre Visualisierung zu verfeinern:
+  **Balken** — Zeigt Werte als Balkendiagramm an. 
+  **Linien** — Zeigt Werte als Liniendiagramm an. 
+  **Linienbreite** — Geben Sie die Breite der Linie für eine Reihe an. Der Standardwert ist 1.
+  **Treppe** — Zeichnet benachbarte Punkte als Treppe.
+  **Flächenfüllung** — Geben Sie den Umfang der Farbfüllung für eine Reihe an. Die Standardeinstellung ist 1; 0 ist keine.
+  **Füllverlauf** — Geben Sie den Grad des Farbverlaufs auf der Flächenfüllung an. Die Standardeinstellung ist 0, was kein Farbverlauf ist; 10 ist ein steiler Farbverlauf.
+  **Punkte** — Zeigt Punkte für Werte an. 
+  **Punktradius** — Steuern Sie, wie groß die Punkte sind.
+  **Alarmschwellenwerte** — Zeigt Alarmschwellenwerte und Regionen auf dem Panel an.

### Stapeln und Nullwert
<a name="v9-panels-graph-stacking-and-null-value"></a>
+  **Stapel** — Jede Serie wird übereinander gestapelt.
+  **Prozent** — Jede Reihe wird als Prozentsatz der Summe aller Serien dargestellt. Diese Option ist verfügbar, wenn **Stapel** ausgewählt ist.
+  **Nullwert** — Geben Sie an, wie Nullwerte angezeigt werden. *Dies ist eine wichtige Einstellung.* Siehe den Hinweis unten.
  +  **verbunden** — Wenn die Datenreihe eine Lücke enthält, d. h. einen oder mehrere Nullwerte, überspringt die Zeile die Lücke und verbindet sich mit dem nächsten Wert, der nicht Null ist. 
  +  **null** Wenn die Reihe eine Lücke enthält, d. h. einen Nullwert, wird die Linie im Diagramm unterbrochen und zeigt die Lücke an. Dies ist die Standardeinstellung.
  +  **null als Null** — Wenn die Reihe eine Lücke enthält, d. h. einen Nullwert, wird diese im Grafikfenster als Nullwert angezeigt.

**Wichtig**  
Wenn Sie die CPU-Auslastung eines Servers überwachen und die Auslastung 100 Prozent erreicht, stürzt der Server ab und der Agent, der die Statistiken sendet, kann die Laststatistik nicht erfassen. Dies führt zu einer Lücke in den Kennzahlen, und die Verwendung der Standardeinstellung *Null* bedeutet, dass Amazon Managed Grafana die Lücken anzeigt und darauf hinweist, dass etwas nicht stimmt. Wenn dies auf „*Verbunden*“ gesetzt ist, kann dieses Signal leicht übersehen werden. 

### Zeigen Sie mit der Maus auf den Tooltip
<a name="v9-panels-graph-hover-tooltip"></a>

Verwenden Sie diese Einstellungen, um das Aussehen des Tooltips zu ändern, der angezeigt wird, wenn Sie den Mauszeiger über der Grafikvisualisierung halten.
+  **Modus** — Legt fest, wie viele Serien der Hover-Tooltip anzeigt.
  +  **Alle Serien** — Der Hover-Tooltip zeigt alle Serien im Diagramm an. In der Serienliste im Tooltip hebt der Grafana-Arbeitsbereich die Serie, bei der Sie pausieren, fett hervor.
  +  **Einzeln** — Der Hover-Tooltip zeigt nur eine einzige Serie an, nämlich die, bei der Sie im Diagramm eine Pause einlegen.
+  **Sortierreihenfolge** **— Sortiert die Reihenfolge der Reihen in der QuickInfo, wenn Sie den Modus Alle Serien ausgewählt haben.** Wenn Sie in einem Diagramm pausieren, zeigt Amazon Managed Grafana die mit den Linien verknüpften Werte an. Im Allgemeinen sind Benutzer am meisten an den höchsten oder niedrigsten Werten interessiert. Das Sortieren dieser Werte kann das Auffinden der gewünschten Daten erheblich erleichtern.
  +  **Keine** — Die Reihenfolge der Datenreihen in der QuickInfo wird durch die Sortierreihenfolge in Ihrer Abfrage bestimmt. Sie können die Serie beispielsweise alphabetisch nach dem Seriennamen sortieren.
  +  **Zunehmend** — Die Reihen in der QuickInfo, auf die der Mauszeiger zeigt, sind nach Wert und in aufsteigender Reihenfolge sortiert, wobei der niedrigste Wert ganz oben in der Liste steht.
  +  **Absteigend** — Die Reihen im Hover-Tooltip sind nach Wert und in absteigender Reihenfolge sortiert, wobei der höchste Wert in der Liste ganz oben steht.

## Überschreibungen von Serien
<a name="v9-panels-graph-series-overrides"></a>

Durch Überschreibungen von Reihen kann eine Reihe in einem Grafikfenster anders gerendert werden als die anderen. Sie können die Anzeigeoptionen für jede Serie oder mithilfe von Regex-Regeln anpassen. Beispielsweise kann eine Serie eine dickere Linienbreite haben, um sie hervorzuheben, oder sie kann auf die rechte Y-Achse verschoben werden.

Sie können mehrere Serienüberschreibungen hinzufügen.

**Um eine Reihenüberschreibung hinzuzufügen**

1. Wählen Sie „**Serienüberschreibung hinzufügen**“.

1. Geben Sie in **Alias oder Regex** eine Serie ein, oder wählen Sie sie aus. Wählen Sie das Feld aus, um eine Liste der verfügbaren Serien anzuzeigen.

   `/Network.*/`Würde beispielsweise zwei Serien mit dem Namen `Network out` und entsprechen`Network in`.

1. Wählen Sie **\$1** und wählen Sie dann einen Stil aus, der auf die Serie angewendet werden soll. Sie können jedem Eintrag mehrere Stile hinzufügen.
+  **Balken** — Zeigt Serien als Balkendiagramm an. 
+  **Linien** — Zeigt Serien als Liniendiagramm an. 
+  **Linienfüllung** — Zeigt ein Liniendiagramm mit Flächenfüllung an. 
+  **Füllverlauf** — Geben Sie den Grad des Farbverlaufs für die Flächenfüllung an.
+  **Linienbreite** — Legt die Linienbreite fest.
+  **Nullpunktmodus** — Verwenden Sie diese Option, um Nullwerte zu ignorieren oder sie durch Null zu ersetzen. Dies ist wichtig, wenn Sie Lücken in Ihren Daten ignorieren möchten.
+  **Füllen Sie unten bis** — Füllen Sie den Bereich zwischen zwei Datenreihen aus.
+  **Treppenlinie** — Zeigt die Serie als Treppenlinie an.
+  **Striche** — Zeigt eine Linie mit Strichen an. 
+  **Versteckte Serie** — Verstecke die Serie. 
+  **Strichlänge** — Lege die Länge der Striche in der Linie fest.
+  **Strichabstand** — Legt die Länge der Abstände zwischen den Strichen in der Linie fest.
+  **Punkte** — Zeigt Reihen als separate Punkte an.
+  **Punktradius** — Legt den Radius für das Rendern von Punkten fest.
+  **Stapel** — Legt die Stapelgruppe für die Serie fest.
+  **Farbe** — Legt die Farbe der Serie fest.
+  **Y-Achse** — Legt die Y-Achse der Serie fest.
+  **Z-Index — Legt** den Z-Index der Serie fest (Renderreihenfolge). Diese Option ist wichtig, wenn Sie verschiedene Stile überlagern, z. B. Balkendiagramme und Flächendiagramme.
+  Transformieren — Transformiert den Wert in einen negativen Wert, um unterhalb der Y-Achse zu rendern.
+  **Legende** — Steuert, ob eine Reihe in der Legende angezeigt wird.
+  **Im Tooltip ausblenden** — Steuert, ob eine Reihe in einer QuickInfo eines Diagramms angezeigt wird.

## Axes (Achsen)
<a name="v9-panels-graph-axes"></a>

Verwenden Sie diese Optionen, um die Anzeige von Achsen in der Visualisierung zu steuern.

### Linkes Y/Right Y
<a name="v9-panels-graph-left-yright-y"></a>

Die Optionen sind für beide Y-Achsen identisch.
+  **Einblenden** — Wählen Sie, ob die Achse ein- oder ausgeblendet werden soll.
+  **Einheit** — Wählen Sie die Anzeigeeinheit für den Y-Wert.
+  **Skala** — Wählen Sie die Skala, die für den Y-Wert verwendet werden soll: **linear** oder **logarithmisch**. **Die Standardeinstellung ist linear.**
+  **Y-Min** — Der kleinste Y-Wert. Die Standardeinstellung ist **auto**.
+  **Y-Max** — Der maximale Y-Wert. Die Standardeinstellung ist **auto**.
+  **Dezimalzahlen** — Definiert, wie viele Dezimalzahlen für den Y-Wert angezeigt werden. Die Standardeinstellung ist **auto**. 
+  **Bezeichnung** — Geben Sie die Bezeichnung der Y-Achse an. Die Standardeinstellung ist „“,

### Y-Achsen
<a name="v9-panels-graph-y-axes"></a>
+  **Ausrichten** — Richten Sie die linke und rechte Y-Achse nach Wert aus. Die Standardeinstellung ist deaktiviert/falsch.
+  **Ebene** — Geben Sie den Wert ein, der für die Ausrichtung der linken und rechten Y-Achse verwendet werden soll, beginnend bei Y=0. Der Standardwert ist 0. Diese Option ist verfügbar, wenn **Ausrichten** ausgewählt ist. 

### X-Achse
<a name="v9-panels-graph-x-axis"></a>
+  **Einblenden** — Wählen Sie, ob die Achse ein- oder ausgeblendet werden soll.
+  **Modus** — Der Anzeigemodus verändert die Darstellung des Grafikfensters vollständig. Es ist wie drei Panels in einem. Der Hauptmodus ist der Zeitreihenmodus mit der Zeit auf der X-Achse. Die anderen beiden Modi sind ein einfacher Balkendiagrammmodus mit Reihen auf der X-Achse anstelle der Zeit und ein Histogrammmodus.
  +  **Zeit** (Standard) — Die X-Achse stellt die Zeit dar und die Daten sind nach Zeit gruppiert (z. B. nach Stunde oder Minute).
  +  **Serie** — Die Daten sind nach Serien gruppiert und nicht nach Zeit. Die Y-Achse stellt immer noch den Wert dar.
    +  **Wert** — Dies ist der Aggregationstyp, der für die Werte verwendet werden soll. Die Standardeinstellung ist „**Insgesamt**“ (Summe der Werte).
  +  **Histogramm** — Diese Option konvertiert das Diagramm in ein Histogramm. Ein Histogramm ist eine Art Balkendiagramm, das Zahlen in Bereiche gruppiert, die oft als Buckets oder Bins bezeichnet werden. Höhere Balken zeigen, dass mehr Daten in diesen Bereich fallen.

    Weitere Informationen zu Histogrammen finden Sie unter. [Einführung in Histogramme und Heatmaps](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)
    +  **Buckets** — Legt die Anzahl der Buckets fest, nach denen die Werte gruppiert werden sollen. Wenn dieses Feld leer gelassen wird, versucht Amazon Managed Grafana, eine geeignete Anzahl von Buckets zu berechnen.
    +  **X-Min — Filtert Werte aus dem Histogramm heraus, die unter diesem Mindestgrenzwert** liegen.
    +  **X-Max** — Filtert Werte heraus, die über diesem Höchstwert liegen.

## Legende
<a name="v9-panels-graph-legend"></a>

Verwenden Sie diese Einstellungen, um die Darstellung der Legende in Ihrer Visualisierung zu verfeinern.

### Optionen
<a name="v9-panels-graph-legends-options"></a>
+  **Einblenden** — Deaktivieren, um die Legende auszublenden. Die Standardeinstellung ist ausgewählt (true).
+  **Als Tabelle** — Wählen Sie diese Option, um die Legende in der Tabelle anzuzeigen. Die Standardeinstellung ist aktiviert (true).
+  **Nach rechts** — Wählen Sie diese Option, um die Legende auf der rechten Seite anzuzeigen.
+  Breite — Geben Sie die Mindestbreite für die Legende in Pixeln ein. Diese Option ist verfügbar, wenn **Nach rechts die Option Nach rechts** ausgewählt ist.

### Werte
<a name="v9-panels-graph-values"></a>

Zusätzliche Werte können neben den Legendennamen angezeigt werden.
+  **Min** — Der Mindestwert, der von der Metrikabfrage zurückgegeben wurde.
+  **Max** — Der maximale Wert, der von der Metrikabfrage zurückgegeben wurde.
+  **Avg** — Der von der Metrikabfrage zurückgegebene Durchschnittswert.
+  **Aktuell** — Der letzte Wert, der von der Metrikabfrage zurückgegeben wurde.
+  **Insgesamt** — Die Summe aller Werte, die von der Metrikabfrage zurückgegeben wurden.
+  **Dezimalzahlen — Gibt** an, wie viele Dezimalzahlen für Legendenwerte und QuickInfos zum Zeigen von Grafiken angezeigt werden.

Amazon Managed Grafana berechnet die Legendenwerte auf der Clientseite. Diese Legendenwerte hängen von der Art der Aggregation oder Punktkonsolidierung ab, die Ihre Metrikabfrage verwendet. Alle oben genannten Legendenwerte können nicht gleichzeitig korrekt sein.

Wenn Sie beispielsweise eine Rate wie Anfragen pro Sekunde grafisch darstellen und dabei wahrscheinlich der Durchschnitt als Aggregator verwendet wird, entspricht die Summe in der Legende nicht der Gesamtzahl der Anfragen. Es ist nur die Summe aller Datenpunkte, die von Amazon Managed Grafana empfangen wurden. 

### Serie ausblenden
<a name="v9-panels-graph-hide-series"></a>

Datenreihen ausblenden, wenn alle Werte einer Reihe aus einer metrischen Abfrage einen bestimmten Wert haben.
+  **Nur mit Nullen** — Wert=Null (standardmäßig deaktiviert)
+  **Nur mit Nullen — Wert=Null** (standardmäßig deaktiviert)

### Zeitregionen
<a name="v9-panels-graph-time-regions"></a>

Sie können bestimmte Zeitbereiche in der Grafik hervorheben, um sie besser erkennen zu können, z. B. Wochenenden, Geschäftszeiten und arbeitsfreie Zeiten. Alle konfigurierten Zeitregionen beziehen sich auf die UTC-Zeit.

# Heatmap-Panel
<a name="v9-panels-heatmap"></a>

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

Mit der Visualisierung im Heatmap-Panel können Sie Histogramme im Zeitverlauf anzeigen. Weitere Informationen zu Histogrammen finden Sie unter. [Einführung in Histogramme und Heatmaps](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)

## Aus Daten berechnen
<a name="v9-panels-heatmap-calculate"></a>

Diese Einstellung bestimmt, ob es sich bei den Daten bereits um eine berechnete Heatmap (aus der Datenquelle/dem Transformator) handelt oder ob sie im Panel berechnet werden soll.

**X Eimer**

Diese Einstellung bestimmt, wie die X-Achse in Buckets aufgeteilt wird. Sie können in der **Größeneingabe** ein Zeitintervall angeben. Beispiel: Bei einem Zeitbereich von sind die `1h` Zellen auf der X-Achse 1 Stunde breit.

**Y-Eimer**

Diese Einstellung bestimmt, wie die Y-Achse in Bereiche aufgeteilt wird.

**Y-Bucket-Skala**

Wählen Sie eine der folgenden Werteskalen für die Y-Achse aus:
+ **linear — Lineare** Skala.
+ **log (Basis 2)** — Logarithmische Skala mit Basis 2.
+ **log (Basis 10)** — Logarithmische Skala mit Basis 10.

## Y-Achsen
<a name="v9-panels-heatmap-y-axes"></a>

Definiert, wie die Y-Achse angezeigt wird

 **Platzierung**
+ **Links** — Auf der linken Seite
+ **Rechts** — Auf der rechten Seite
+ **Versteckt** — Versteckt

**Einheit**

Konfiguration der Einheit

**Dezimalzahlen**

Diese Einstellung bestimmt die Dezimalkonfiguration.

**Min-/Max-Wert**

Diese Einstellung konfiguriert den Achsenbereich.

**Umgekehrt**

Wenn diese Option ausgewählt ist, wird die Achse in umgekehrter Reihenfolge angezeigt.

## Colors (Farben)
<a name="v9-panels-heatmap-colors"></a>

Das Farbspektrum steuert die Zuordnung zwischen der Anzahl der Werte (in jedem Bereich) und der jedem Bereich zugewiesenen Farbe. Die Farbe ganz links im Spektrum steht für die minimale Anzahl und die Farbe ganz rechts für die maximale Anzahl. Einige Farbschemata werden automatisch invertiert, wenn das Lichtdesign verwendet wird.

Sie können den Farbmodus auch auf Deckkraft ändern. In diesem Fall ändert sich die Farbe nicht, aber der Grad der Deckkraft ändert sich mit der Anzahl der Buckets
+ **Mode (Modus)**
  + **Schema** — Der Bucket-Wert wird durch die Zellenfarbe dargestellt.
    + **Schema** — Wenn der Modus **Schema** ist, wählen Sie ein Farbschema aus.
  + **Opazität** — Der Bucket-Wert wird durch die Opazität der Zelle dargestellt. Undurchsichtige Zelle bedeutet Maximalwert.
    + **Farbe** — Zellengrundfarbe.
    + **Maßstab** — Maßstab für die Zuordnung von Bucket-Werten zur Opazität.
      + **linear — Lineare** Skala. Der Bucket-Wert wird linear der Opazität zugeordnet.
      + **sqrt — Leistungsskala**. Die Zellenopazität wird berechnet als`value ^ k`, wobei ein konfigurierter **Exponentenwert** angegeben `k` ist. Wenn der Exponent kleiner als ist`1`, erhalten Sie eine logarithmische Skala. Wenn der Exponent größer als ist`1`, erhalten Sie eine Exponentialskala. Im Fall von `1` entspricht die Skala der linearen Skala.
    + **Exponent** — Wert des Exponenten, größer als. `0`

**Start-/Endfarbe anhand des Werts**

Standardmäßig berechnet Grafana die Zellenfarben auf der Grundlage von minimalen und maximalen Bucket-Werten. Mit Min und Max können Sie diese Werte überschreiben. Betrachten Sie einen Bucket-Wert als Z-Achse und Min und Max als Z-Min bzw. Z-Max.
+ **Start** — Minimaler Wert, der für die Berechnung der Zellenfarbe verwendet wird. Wenn der Bucketwert kleiner als Min ist, wird er der „Minimalfarbe“ zugeordnet. Der Minimalwert der Serie ist der Standardwert.
+ **Ende** — Maximalwert, der für die Berechnung der Zellenfarbe verwendet wird. Wenn der Bucket-Wert größer als Max ist, wird er der „maximalen“ Farbe zugeordnet. Der Maximalwert der Serie ist der Standardwert.

## Zellenanzeige
<a name="v9-panels-heatmap-cell"></a>

Verwenden Sie die Einstellungen für die Zellenanzeige, um die Darstellung der Zellen in Ihrer Heatmap zu verfeinern.

## Zusätzliche Anzeigeoptionen
<a name="v9-panels-heatmap-options"></a>

**Tooltip**
+ **Tooltip anzeigen** — Heatmap-Tooltip anzeigen.
+ **Histogramm anzeigen** — Zeigt ein Y-Achsen-Histogramm im Tooltip an. Ein Histogramm stellt die Verteilung der Bucket-Werte für einen bestimmten Zeitstempel dar.

**Legende**

Wählen Sie aus, ob die Heatmap-Legende in der Visualisierung angezeigt werden soll.

**Exemplare**

Legt die Farbe fest, die für die Anzeige von Exemplardaten verwendet wird.

# Bedienfeld „Histogramm“
<a name="v9-panels-histogram"></a>

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

Die Histogramm-Visualisierung berechnet die Verteilung der Werte und stellt sie als Balkendiagramm dar. Die Y-Achse und die Höhe jedes Balkens stellen die Anzahl der Werte dar, die in jede Klammer fallen, während die X-Achse den Wertebereich darstellt.

Die Histogramm-Visualisierung unterstützt Zeitreihen und beliebige Tabellenergebnisse mit einem oder mehreren numerischen Feldern.

## Unterstützte Formate
<a name="v9-panels-histogram-formats"></a>

Die Histogrammvisualisierung unterstützt Zeitreihen und alle Tabellenergebnisse mit einem oder mehreren numerischen Feldern.

## Optionen anzeigen
<a name="v9-panels-histogram-options"></a>

Verwenden Sie diese Optionen, um Ihre Visualisierungen zu verfeinern:

**Größe des Eimers**

Die Größe der Eimer. Lassen Sie dieses Feld leer, wenn die Schaufelgröße automatisch angepasst werden soll (\$1 10% des gesamten Bereichs).

**Offset der Schaufel**

Wenn der erste Bucket nicht bei Null beginnen soll. Ein Offset ungleich Null verschiebt das Aggregationsfenster. Beispielsweise würden aus 5-großen Buckets mit den Werten 0—5, 5—10, 10—15 mit einem Standard-Offset von 0 2—7, 7—12, 12—17 mit einem Offset von 2 werden; Offsets von 0, 5 oder 10 würden in diesem Fall praktisch nichts bewirken. In der Regel wird diese Option nicht automatisch, sondern mit einer explizit definierten Bucket-Größe verwendet. Damit diese Einstellung wirksam wird, muss der Offset-Betrag größer als 0 und kleiner als die Bucket-Größe sein. Werte außerhalb dieses Bereichs haben die gleiche Wirkung wie Werte innerhalb dieses Bereichs.

**Reihen kombinieren**

Dadurch werden alle Serien und Felder zu einem kombinierten Histogramm zusammengeführt.

**Die Linienbreite** steuert die Linienbreite der Balken.

Die **Fülldeckkraft** steuert die Füllopazität der Balken.

Der **Verlaufsmodus** legt den Modus der Verlaufsfüllung fest. Der Füllverlauf basiert auf der Linienfarbe. Um die Farbe zu ändern, verwenden Sie die Standardfeldoption für das Farbschema. Die Darstellung des Verlaufs wird durch die Einstellung für die Deckkraft der Füllung beeinflusst.
+  **Keine** — Keine Verlaufsfüllung, dies ist die Standardeinstellung.
+  **Opazität** — Die Transparenz des Farbverlaufs wird anhand der Werte auf der Y-Achse berechnet. Die Deckkraft der Füllung nimmt mit den Werten auf der Y-Achse zu.
+  **Farbton** — Die Verlaufsfarbe wird auf der Grundlage des Farbtons der Linienfarbe generiert.

**Tooltip-Modus** Wenn Sie den Mauszeiger über das Diagramm bewegen, kann Grafana Tooltips anzeigen. Wählen Sie, wie sich Tooltips verhalten:
+  **Einzeln** — Der Tooltip zeigt nur die Serie an, über der Sie den Mauszeiger bewegen.
+  **Alle** — Der Hover-Tooltip zeigt alle Serien in der Visualisierung an. Grafana hebt die Serie, über die Sie den Mauszeiger bewegen, in der Serienliste im Tooltip fett hervor.
+  **Versteckt** — Zeigt den Tooltip nicht an. 

**Anmerkung**  
Verwenden Sie eine Überschreibung, um einzelne Serien in der QuickInfo auszublenden.

## Legendenoptionen
<a name="v9-panels-histogram-legend"></a>

Wenn die Legendenoption aktiviert ist, können entweder die Wertzuordnungen oder die Schwellenwertklammern angezeigt werden. Um die Wertzuordnungen in der Legende anzuzeigen, ist es wichtig, dass die Option Farbschema unter den Standardoptionen auf Einzelfarbe oder Klassische Palette eingestellt ist. Um die Schwellenwertklammern in der Legende zu sehen, stellen Sie das Farbschema auf Von Schwellenwerten ein.

**Legendenmodus** Verwenden Sie diese Einstellungen, um die Darstellung der Legende in Ihrer Visualisierung zu verfeinern.
+  **Liste** — Zeigt die Legende als Liste an. Dies ist der Standardanzeigemodus der Legende.
+  **Tabelle** — Zeigt die Legende als Tabelle an.
+  **Versteckt** — Blendet die Legende aus.

**Platzierung der Legende** Wählen Sie aus, wo die Legende platziert werden soll.
+  **Unten** — Unter dem Diagramm.
+  **Rechts** — Rechts neben dem Diagramm.

**Werte der Legende**

Wählen Sie aus, welche der Standardberechnungen in der Legende angezeigt werden sollen. Sie können mehr als eine haben. Weitere Informationen finden Sie unter [Berechnungsarten](v9-panels-calculation-types.md).

**Legendenberechnungen**

Wählen Sie aus, welche Berechnungen in der Legende angezeigt werden sollen. Sie können mehr als eine auswählen.

# Bedienfeld „Protokolle“
<a name="v9-panels-logs"></a>

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

Die Visualisierung des Protokollfensters zeigt Protokollzeilen aus Datenquellen, die Logs unterstützen, wie Elastic, Influx und Loki. In der Regel verwenden Sie diesen Bereich neben einem Grafikfenster, um die Protokollausgabe eines verwandten Prozesses anzuzeigen.

Im Bereich „Protokolle“ werden die Ergebnisse von Abfragen angezeigt, die auf der Registerkarte „**Abfrage**“ eingegeben wurden. Die Ergebnisse mehrerer Abfragen werden zusammengeführt und nach Zeit sortiert. Sie können innerhalb des Bedienfelds blättern, wenn die Datenquelle mehr Zeilen zurückgibt, als angezeigt werden können.

Um die Anzahl der gerenderten Zeilen zu begrenzen, können Sie die Einstellung **Max. Datenpunkte** in den **Abfrageoptionen** verwenden. Wenn sie nicht festgelegt ist, erzwingt die Datenquelle in der Regel ein Standardlimit.

## Protokollebene
<a name="v9-panels-logs-level"></a>

Bei Protokollen, bei denen eine **Ebenenbezeichnung** angegeben ist, verwenden wir den Wert der Bezeichnung, um die Protokollebene zu bestimmen und die Farbe entsprechend zu aktualisieren. Wenn für das Protokoll keine Ebenenbezeichnung angegeben ist, versuchen wir herauszufinden, ob sein Inhalt mit einem der unterstützten Ausdrücke übereinstimmt (weitere Informationen finden Sie weiter unten). Die Protokollebene wird immer durch die erste Übereinstimmung bestimmt. Falls Grafana keinen Log-Level ermitteln kann, wird dieser mit **unbekanntem** Log-Level visualisiert. Weitere Informationen finden Sie unter [Visualisierung von Protokollen](v9-explore-logs.md#v9-explore-logs-viz).

## Details protokollieren
<a name="v9-panels-logs-details"></a>

Jede Protokollzeile verfügt über einen erweiterbaren Bereich mit ihren Beschriftungen und erkannten Feldern, um eine robustere Interaktion zu ermöglichen. Jedes Feld oder jede Bezeichnung hat ein Statistiksymbol, mit dem Statistiken zu allen angezeigten Protokollen angezeigt werden.

**Datenverknüpfungen**

Mithilfe von Datenlinks können Sie jeden Teil einer Protokollnachricht in einen internen oder externen Link umwandeln. Der erstellte Link ist als Schaltfläche im Abschnitt **Links** in der Ansicht mit den **Protokolldetails** sichtbar.

**Optionen anzeigen**

Verwenden Sie die folgenden Einstellungen, um Ihre Visualisierung zu verfeinern:
+  **Zeit** — Zeigt die Zeitspalte an oder blendet sie aus. Dies ist der Zeitstempel, der der Protokollzeile zugeordnet ist, wie er von der Datenquelle gemeldet wurde.
+  **Eindeutige Beschriftungen** — Zeigt die Spalte mit eindeutigen Beschriftungen an oder blendet sie aus, in der nur ungewöhnliche Beschriftungen angezeigt werden.
+ **Allgemeine Beschriftungen** — Zeigt die allgemeinen Beschriftungen an oder blendet sie aus
+  **Linien umbrechen** — Aktiviert die Option Zeilenumbruch. 
+ **Prettify JSON** — Stellen Sie diese Option ein, `true` um alle JSON-Logs hübsch auszudrucken. Diese Einstellung wirkt sich nicht auf Protokolle in einem anderen Format als JSON aus.
+ **Protokolldetails aktivieren** — Schalten Sie die Option um, um die Protokolldetailansicht für jede Protokollzeile anzuzeigen. Die Standardeinstellung lautet `true`.
+  **Reihenfolge** — Zeigt die Ergebnisse in absteigender oder aufsteigender Reihenfolge an. Die Standardeinstellung ist **Absteigend, wobei** die neuesten Protokolle zuerst angezeigt werden. Stellen Sie die Option **Aufsteigend** ein, um die ältesten Protokollzeilen zuerst anzuzeigen.

# Nachrichten-Panel
<a name="v9-panels-news"></a>

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

In diesem Bereich wird ein RSS-Feed angezeigt. Standardmäßig werden Artikel aus dem Grafana Labs-Blog angezeigt.

Geben Sie die URL eines RSS im Bereich **Anzeige** ein. Dieser Panel-Typ akzeptiert keine anderen Abfragen.

**Anmerkung**  
RSS-Feeds werden vom Grafana-Frontend ohne Proxy geladen. Daher werden nur RSS-Feeds geladen, die mit den entsprechenden [CORS-Headern](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) konfiguriert sind. Wenn der RSS-Feed, den Sie anzeigen möchten, nicht geladen werden kann, sollten Sie erwägen, den RSS-Feed erneut zu hosten oder einen eigenen Proxy zu erstellen.

# Bereich „Knotendiagramm“
<a name="v9-panels-node-graph"></a>

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

Das Node-Graph-Panel visualisiert gerichtete Graphen oder Netzwerke. Es nutzt die Anordnung gerichteter Kräfte, um die Knoten effektiv zu positionieren, sodass es bei der Darstellung komplexer Infrastrukturkarten, Hierarchien oder Verlaufsdiagramme hilfreich sein kann.

## Datenvoraussetzungen
<a name="v9-panels-node-graph-requirements"></a>

Das Node-Graph-Panel erfordert eine bestimmte Form der Daten, damit die Knoten und Kanten angezeigt werden können. Nicht jede Datenquelle oder Abfrage kann in diesem Bereich visualisiert werden.

Die Node-Graph-Visualisierung besteht aus *Knoten* und *Kanten*.
+ Ein *Knoten* wird als Kreis angezeigt. Ein Knoten kann eine Anwendung, einen Dienst oder etwas anderes darstellen, das aus Anwendungsperspektive relevant ist.
+ Eine *Kante* wird als Linie dargestellt, die zwei Knoten verbindet. Bei der Verbindung kann es sich um eine Anfrage, eine Operation oder eine andere Beziehung zwischen den beiden Knoten handeln.

Sowohl Knoten als auch Kanten können Metadaten oder Statistiken zugeordnet sein. Die Datenquelle definiert, welche Informationen und Werte angezeigt werden, sodass verschiedene Datenquellen unterschiedliche Wertetypen anzeigen oder einige Werte nicht anzeigen können.

## Knoten
<a name="v9-panels-node-graph-nodes"></a>

Normalerweise zeigen Knoten zwei statistische Werte innerhalb des Knotens und zwei Identifikatoren direkt unter dem Knoten, normalerweise Name und Typ. Knoten können auch einen anderen Satz von Werten als Farbkreis um den Knoten herum anzeigen, wobei Abschnitte unterschiedlicher Farbe unterschiedliche Werte darstellen, die zusammen 1 ergeben sollten. Sie können beispielsweise angeben, dass der Prozentsatz der Fehler durch den roten Teil des Kreises dargestellt wird.

Zusätzliche Details können in einem Kontextmenü angezeigt werden, das angezeigt wird, wenn Sie den Knoten auswählen. Das Kontextmenü kann auch zusätzliche Links enthalten, die entweder auf andere Teile des Grafana-Arbeitsbereichs oder auf einen externen Link abzielen.

**Anmerkung**  
Das Knotendiagramm kann nur 1.500 Knoten anzeigen. Wenn diese Grenze überschritten wird, wird in der oberen rechten Ecke eine Warnung angezeigt und einige Knoten werden ausgeblendet. Sie können versteckte Teile des Diagramms erweitern, indem Sie im Diagramm auf die Markierungen für **Versteckte Knoten** klicken.

## Edges
<a name="v9-panels-node-graph-edges"></a>

Bei Kanten können auch Statistiken angezeigt werden, wenn Sie den Mauszeiger über den Rand bewegen. Ähnlich wie bei Knoten können Sie ein Kontextmenü mit zusätzlichen Details und Links öffnen, indem Sie die Kante auswählen.

Die erste Datenquelle, die diese Visualisierung unterstützt, ist die AWS X-Ray Datenquelle für die zugehörige Service Map-Funktion. Weitere Informationen finden Sie unter [Connect zu einer AWS X-Ray Datenquelle herstellen](x-ray-data-source.md).

## Im Knotendiagramm navigieren
<a name="v9-panels-node-graph-navigation"></a>

Sie können innerhalb des Knotendiagramms schwenken, indem Sie eine Position außerhalb eines Knotens oder einer Kante auswählen und den Mauszeiger ziehen.

Sie können mithilfe der Schaltflächen in der oberen linken Ecke des Knotendiagramms zoomen.

**Versteckte Knoten**

Die Anzahl der Knoten, die zu einem bestimmten Zeitpunkt angezeigt werden, ist begrenzt, um eine angemessene Leistung aufrechtzuerhalten. Knoten, die sich außerhalb dieser Grenze befinden, sind hinter anklickbaren Markierungen versteckt, die eine ungefähre Anzahl von versteckten Knoten anzeigen, die mit dieser Kante verbunden sind. Sie können die Markierung auswählen, um das Diagramm um diesen Knoten herum zu erweitern.

**Grid-Ansicht**

Sie können zur Rasteransicht wechseln, um einen besseren Überblick über die interessantesten Knoten im Diagramm zu erhalten. Die Rasteransicht zeigt Knoten in einem Raster ohne Kanten und kann nach Statistiken sortiert werden, die innerhalb des Knotens angezeigt werden, oder nach Statistiken, die durch den farbigen Rand der Knoten dargestellt werden.

Um die Knoten zu sortieren, wählen Sie die Statistiken in der Legende aus. Die Markierung neben dem Statistiknamen zeigt an, welche Statistik derzeit für die Sortierung und Sortierrichtung verwendet wird.

Wählen Sie den Knoten und dann die Option **Im Grafiklayout anzeigen**, um zum Diagrammlayout mit Fokus auf dem ausgewählten Knoten zurückzukehren und ihn im Kontext des vollständigen Diagramms anzuzeigen.

## Daten-API
<a name="v9-panels-node-graph-data-api"></a>

Diese Visualisierung benötigt eine bestimmte Form der Daten, die von der Datenquelle zurückgegeben werden, damit sie korrekt angezeigt werden können.

Node Graph benötigt mindestens einen Datenrahmen, der die Kanten des Graphen beschreibt. Standardmäßig berechnet Node Graph die Knoten und alle Statistiken auf der Grundlage dieses Datenrahmens. Optional kann ein zweiter Datenrahmen gesendet werden, der die Knoten beschreibt, falls mehr knotenspezifische Metadaten angezeigt werden müssen. Sie müssen beide Datenrahmen `frame.meta.preferredVisualisationType = 'nodeGraph'` aktivieren oder ihnen `nodes` einen Namen geben, damit der Node-Graph gerendert werden soll. `edges`

**Überschneidet Daten von der Struktur**

Erforderliche Felder:


| Feldname | Typ | Description | 
| --- | --- | --- | 
|  id  |  Zeichenfolge  |  Eindeutiger Bezeichner der Kante.  | 
|  Quelle  |  Zeichenfolge  |  ID des Quellknotens.  | 
|  Ziel  |  Zeichenfolge  |  ID des Ziels.  | 

Optionale Felder:


| Feldname | Typ | Description | 
| --- | --- | --- | 
|  Hauptstatistik  |  Zeichenfolge/Zahl  |  Erste Statistik, die im Overlay angezeigt wird, wenn Sie den Mauszeiger über den Rand bewegen. Es kann sich um eine Zeichenfolge handeln, die den Wert unverändert anzeigt, oder es kann sich um eine Zahl handeln. Wenn es sich um eine Zahl handelt, wird auch jede Einheit angezeigt, die diesem Feld zugeordnet ist  | 
|  sekundärer Status  |  Zeichenfolge/Zahl  |  Wie MainStat, wird aber direkt darunter angezeigt.  | 
|  detail\$1\$1\$1  |  Zeichenkette/Zahl  |  Jedes Feld mit einem Präfix `detail__` wird in der Kopfzeile des Kontextmenüs angezeigt, wenn es auf den Rand geklickt wird. Verwenden Sie es `config.displayName` für ein besser lesbares Etikett.  | 

**Knoten, Daten aus der Struktur**

Erforderliche Felder:


| Feldname | Typ | Description | 
| --- | --- | --- | 
|  id  |  Zeichenfolge  |  Eindeutiger Bezeichner des Knotens. Auf diese ID wird von edge in seinem Quell- und Zielfeld verwiesen.  | 

Optionale Felder:


| Feldname | Typ | Description | 
| --- | --- | --- | 
|  Titel  |  Zeichenfolge  |  Name des Knotens, der direkt unter dem Knoten sichtbar ist.  | 
|  Untertitel  |  Zeichenfolge  |  Zusätzlich wird der Name, der Typ oder eine andere Kennung unter dem Titel angezeigt.  | 
|  Hauptstatistik  |  Zeichenfolge/Zahl  |  Erster Wert, der im Knoten selbst angezeigt wird. Es kann sich entweder um eine Zeichenfolge handeln, die den Wert unverändert anzeigt, oder um eine Zahl. Wenn es sich um eine Zahl handelt, wird auch jede Einheit angezeigt, die diesem Feld zugeordnet ist.  | 
|  sekundärer Status  |  Zeichenfolge/Zahl  |  Wie MainStat, wird aber im Knoten darunter angezeigt.  | 
|  arc\$1\$1\$1  |  number  |  Jedes Feld mit dem Präfix `arc__` wird verwendet, um den Farbkreis um den Knoten herum zu erstellen. Die Summe aller Werte in diesen Feldern sollte 1 ergeben. Sie können die Farbe mit angeben`config.color.fixedColor`.  | 
|  detail\$1\$1\$1  |  Zeichenkette/Zahl  |  Jedes Feld mit einem Präfix `detail__` wird in der Kopfzeile des Kontextmenüs angezeigt, wenn auf den Knoten geklickt wird. Wird verwendet, `config.displayName` um das Etikett besser lesbar zu machen.  | 

# Bereich „Kreisdiagramm“
<a name="v9-panels-piechart"></a>

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

Das Kreisdiagramm zeigt verkleinerte Reihen oder Werte in einer Reihe aus einer oder mehreren Abfragen in ihrer Beziehung zueinander in Form von Kreissegmenten an. Die Bogenlänge, die Fläche und der Mittelwinkel eines Segments sind alle proportional zum Wert des Segments, da er sich auf die Summe aller Werte bezieht. Dieser Diagrammtyp eignet sich am besten, wenn Sie einen schnellen Vergleich einer kleinen Gruppe von Werten in einer ästhetisch ansprechenden Form wünschen.

## Wertoptionen
<a name="v9-panels-piechart-value"></a>

Verwenden Sie die folgenden Optionen, um den Wert in Ihrer Visualisierung zu verfeinern.

**Show (Anzeigen)**

Wählen Sie aus, wie viele Informationen angezeigt werden sollen.
+ **Berechnen** — Reduziert jeden Wert auf einen einzigen Wert pro Reihe.
+ **Alle Werte** — Zeigt jeden Wert aus einer einzelnen Reihe an.

**Berechnung**

Wählen Sie eine Berechnung aus, um jede Reihe zu reduzieren, wenn die Option Berechnen ausgewählt wurde. Informationen zu verfügbaren Berechnungen finden Sie unter [Berechnungstypen](v9-panels-calculation-types.md).

**Limit**

Wenn jeder Wert aus einer einzelnen Reihe angezeigt wird, begrenzt dies die Anzahl der angezeigten Werte.

**Felder**

Wählen Sie aus, welches Feld oder welche Felder in der Visualisierung angezeigt werden sollen. Jeder Feldname ist in der Liste verfügbar, oder Sie können eine der folgenden Optionen auswählen:
+ **Numerische Felder** — Alle Felder mit numerischen Werten.
+ **Alle Felder** — Alle Felder, die nicht durch Transformationen entfernt wurden.
+ **Zeit** — Alle Felder mit Zeitwerten.

## Optionen für Kreisdiagramme
<a name="v9-panels-piechart-options"></a>

Verwenden Sie diese Optionen, um das Aussehen Ihrer Visualisierung zu verfeinern.

**Typ des Kreisdiagramms**

Wählen Sie den Anzeigestil für das Kreisdiagramm aus. Kann entweder sein:
+ **Kreis** — Ein Standard-Kreisdiagramm
+ **Donut** — Ein Kreisdiagramm mit einem Loch in der Mitte

**Labels**

Wählen Sie Beschriftungen aus, die im Kreisdiagramm angezeigt werden sollen. Sie können mehrere auswählen.
+ **Name** — Der Serien- oder Feldname.
+ **Prozent** — Der Prozentsatz des Ganzen.
+ **Wert** — Der numerische Rohwert.

Beschriftungen werden standardmäßig weiß über dem Hauptteil des Diagramms angezeigt. Sie können dunklere Diagrammfarben auswählen, um sie besser sichtbar zu machen. Lange Namen oder Zahlen werden möglicherweise abgeschnitten.

**Tooltip-Modus**

Wenn Sie den Mauszeiger über die Visualisierung bewegen, kann Grafana Tooltips anzeigen. Wählen Sie, wie sich Tooltips verhalten.
+ **Einzeln** — Der Tooltip zeigt nur eine einzige Serie an, nämlich die, über der Sie in der Visualisierung den Mauszeiger bewegen.
+ **Alle** — Der Hover-Tooltip zeigt alle Serien in der Visualisierung an. Grafana hebt die Serie, über die Sie den Mauszeiger bewegen, in der Serienliste im Tooltip fett hervor.
+ **Versteckt** — Zeigt den Tooltip nicht an, wenn Sie mit der Visualisierung interagieren.

Verwenden Sie eine Überschreibung, um einzelne Serien in der QuickInfo auszublenden.

**Legendenmodus**

Verwenden Sie diese Einstellungen, um zu definieren, wie die Legende in Ihrer Visualisierung angezeigt wird. Weitere Informationen zur Legende finden Sie unter [Eine Legende konfigurieren](v9-panels-configure-legend.md).
+ **Liste** — Zeigt die Legende als Liste an. Dies ist der Standardanzeigemodus der Legende.
+ **Tabelle** — Zeigt die Legende als Tabelle an.
+ **Versteckt** — Blendet die Legende aus.

**Platzierung der Legende**

Wählen Sie aus, wo die Legende angezeigt werden soll.
+ **Unten** — Unter dem Diagramm.
+ **Rechts** — Rechts neben dem Diagramm.

**Werte der Legende**

Wählen Sie aus, welche der [Standardberechnungen](v9-panels-calculation-types.md) in der Legende angezeigt werden sollen. Sie können mehr als eine haben.

Wählen Sie Werte aus, die in der Legende angezeigt werden sollen. Sie können mehr als einen auswählen.
+ **Prozent** — Der Prozentsatz des Ganzen.
+ **Wert** — Der numerische Rohwert.

Weitere Informationen zur Legende finden Sie unter [Eine Legende konfigurieren](v9-panels-configure-legend.md).

# Panel Plotly
<a name="v9-panels-plotly"></a>

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

Das Plotly-Bedienfeld rendert Diagramme mit [Plotly](https://plotly.com/javascript/), einer Open-Source-JavaScript-Grafikbibliothek.

Die Felder **Data**, **Layout** und **Config** entsprechen den allgemeinen Parametern, die in der [Plotly-Dokumentation beschrieben sind](https://plotly.com/javascript/plotlyjs-function-reference/). Sie müssen im JSON-Format sein.

Von der Datenquelle bereitgestellte Daten können über ein benutzerdefiniertes Skript transformiert werden, bevor sie in das Plotly-Diagramm eingefügt werden. Das Skript enthält 2 Argumente.
+ `data`— Von der Datenquelle zurückgegebene Daten.
+ `variables`— Ein Objekt, das [Grafana-Variablen](templates-and-variables.md) im aktuellen Dashboard enthält (Benutzervariablen und diese wenigen globalen Variablen:`__from`, `__to``__interval`, und`__interval_ms`).

Das Skript muss ein Objekt mit einer oder mehreren der folgenden Eigenschaften zurückgeben: `data``layout`, `config` und`frames`. Im Folgenden wird ein -Beispiel gezeigt.

```
let x  = data.series[0].fields[0].values.buffer
let y  = data.series[0].fields[1].values.buffer
let serie = {
    x : x,
    y : y,
    name : variables.project //where project is the name of a Grafana’s variable
}

return {
    data : [serie],
    config : {
    displayModeBar: false
    }
}
```

Das vom Skript zurückgegebene Objekt und das in den Feldern *Data*, *Layout* und *Config* angegebene JSON werden zusammengeführt (Deep Merge).

Wenn kein Skript bereitgestellt wird, verwendet das Panel nur *Daten* -, *Layout* - und *Konfigurationsfelder*.

# Paneel Sankey
<a name="v9-panels-sankey"></a>

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

Das Sankey-Bedienfeld zeigt Sankey-Diagramme, die sich gut zur Visualisierung von Flussdaten eignen, wobei die Breite des Flusses proportional zur ausgewählten Metrik ist. Die folgende Abbildung zeigt ein Sankey-Diagramm mit zwei Gruppen von Quellen und Zielen.

![\[Sankey diagram showing flow between source organizations, science disciplines, and projects.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/sankey-panel.png)


**Funktionsweise**

Das Sankey-Panel benötigt mindestens 2 Datenspalten, eine Quelle und ein Ziel für die Flows. Ihre Abfrage sollte Ihre Daten in mindestens zwei Gruppen gruppieren. Das Panel zeichnet in der Reihenfolge der Abfrage Links von der ersten Spalte mit Datenpunkten zur letzten Spalte. Die Dicke der Links wird proportional zu dem Wert sein, der durch die Metrik in der Abfrage zugewiesen wird.

**Anpassen**
+ **Links** — Derzeit gibt es zwei Optionen für die Linkfarbe: mehrere oder einzelne. Sie ist standardmäßig mehrfarbig. Um eine einzelne Farbe für die Links auszuwählen, schalten Sie die Option **Nur Einzellink-Farbe** ein und wählen Sie Ihre Farbe aus dem Farbwähler von Grafana aus.
+ **Knoten** **— Sie können die Farbe der rechteckigen Knoten ändern, indem Sie die Option Knotenfarbe ändern**
+ **Knotenbreite** — Die Breite der Knoten kann mit dem Schieberegler für die **Knotenbreite** oder durch Eingabe einer Zahl in das Eingabefeld angepasst werden. Diese Zahl muss eine Ganzzahl sein.
+ **Knotenabstand —** Der vertikale Abstand zwischen den Knoten kann mit dem Schieberegler für den **Knotenabstand oder durch** Eingabe einer Zahl in das Eingabefeld angepasst werden. Diese Zahl muss eine Ganzzahl sein. Wenn Ihre Links zu dünn sind, versuchen Sie, diese Zahl anzupassen
+ **Kopfzeilen** — Die Spaltenüberschriften können geändert werden, indem Sie im Editorbereich eine Überschreibung des **Anzeigenamens** verwenden. **Sie werden dieselbe Farbe haben, die Sie für die Textfarbe ausgewählt haben**
+ **Sankey-Layout** — Das Layout der Sankey-Links kann mit dem **Layout-Iterationsregler** leicht angepasst werden. Diese Zahl muss eine Ganzzahl sein und entspricht der Anzahl der Relaxationsiterationen, die zur Generierung des Layouts verwendet wurden.

# Scatter-Panel
<a name="v9-panels-scatter"></a>

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

Das Streufeld zeigt ein X/Y Streudiagramm für Tabellendaten mit einer einfacheren Oberfläche als andere Grafikfelder. Im Gegensatz zum Grafikfenster müssen sich die Daten beim Punktfeld nicht in einer Zeitreihe befinden. Für das Streufeld ist ein tabellenformatierter Datensatz mit zwei oder mehr numerischen Datenspalten erforderlich.

Einer davon kann der X-Achse zugewiesen werden. Einer oder mehrere Werte können einer Reihe von Y-Achsenwerten zugewiesen werden, und die resultierenden Daten können als eine Reihe von Punkten dargestellt werden. Jede Reihe kann optional auch eine Regressionslinie zeigen, wobei eine von mehreren statistischen Bestanpassungen verwendet wird.

**Ein Scatter-Panel erstellen**

Im folgenden Verfahren wird beschrieben, wie Sie mithilfe des Streufensters ein Streudiagramm erstellen. Für dieses Beispiel gehen wir davon aus, dass es Daten gibt, wie in der folgenden Tabelle `HEIGHT` mit drei Spalten mit numerischen Werten,, und `Age` `Boys``Girls`, die die durchschnittliche Körpergröße von Jungen und Mädchen nach Alter zeigen.


| Age | Größe des Jungen | Größe des Mädchens | 
| --- | --- | --- | 
|  5  |  109,7  |  109,5  | 
|  6  |  115,6  |  115,4  | 
|  7  |  121,1  |  120,8  | 
|  8  |  126,3  |  126  | 
|  9  |  131,3  |  131,3  | 
|  10  |  136,2  |  137,1  | 
|  11  |  141,2  |  143,2  | 
|  12  |  147  |  148,7  | 
|  13  |  153,6  |  152,6  | 
|  14  |  159,9  |  155,1  | 
|  15  |  164,4  |  156,7  | 
|  16  |  167,3  |  157,6  | 
|  17  |  169  |  158  | 
|  18  |  170  |  158,3  | 
|  19  |  170,8  |  158,6  | 

**Um ein Streudiagramm mit dem Streufeld zu erstellen**

1. Wählen Sie in Ihrem Grafana-Dashboard die Option **Panel hinzufügen**.

1. Schreiben Sie für die Abfrage eine Abfrage, die die benötigten Daten zurückgibt. In diesem Fall würden Sie eine Abfrage wie verwenden`SELECT * FROM HEIGHT`.

1. Wählen Sie die **Streuvisualisierung** aus.

Dadurch wird ein Streudiagramm erstellt, bei dem die erste Spalte als X-Achse und die anderen numerischen Spalten als Y-Achsen verwendet werden.

**Konfigurationsoptionen**

Das Streufenster bietet die folgenden vier benutzerdefinierten Konfigurationsoptionen.
+ **X-Achse** — Sie können wählen, welches Feld als X-Achse verwendet werden soll, sowie Ausdehnungen, Titel und Anzeigeinformationen für die Achse.
+ **Y-Achse** — Sie können wählen, welche Felder auf der Y-Achse angezeigt werden sollen, einschließlich der Anzeigeoptionen für jedes Feld sowie Ausdehnungen und Titelinformationen für die Achse. Sie können auch festlegen, dass für jedes Feld eine Regressionslinie angezeigt wird. In den folgenden Informationen finden Sie weitere Informationen zur Konfiguration der Regressionslinien.
+ **Legende** — Sie können eine Legende für das Bedienfeld ein- oder ausschalten sowie die Größe des Texts in der Legende wählen.
+ **Anzeige** — Sie können weitere Optionen für das Diagramm festlegen, darunter die Rasterfarbe und den Rahmenstil.

**Konfiguration der Regressionslinie**

Jeder Y-Achsendatensatz kann zusätzlich zu den einzelnen Punkten eine Linie anzeigen. Für den Linientyp gibt es fünf Optionen.
+ **Keine** — Zeigt keine Regressionslinie an.
+ **Einfach** — Zeigt eine Regressionslinie an, die die Punkte des Datensatzes verbindet.
+ **Linear** — Zeigt eine gerade Linie an, wobei die Methode der kleinsten Quadrate, die beste Anpassung verwendet wird, verwendet wird.
+ Exponentiell — Zeigt eine **exponentielle Regressionslinie** mit der besten Anpassung an.
+ **Potenz** — Zeigt eine Regressionslinie mit der besten Potenz an.

# Statistik-Panel
<a name="v9-panels-stat"></a>

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

Die Visualisierung des Statistikfensters zeigt einen großen Statistikwert mit einer optionalen Grafiksparkline. Sie können die Hintergrund- oder Wertfarbe mithilfe von Schwellenwerten steuern.

Standardmäßig zeigt das Statistikfenster eine der folgenden Optionen an:
+ Nur der Wert für eine einzelne Datenreihe oder ein einzelnes Feld.
+ Sowohl der Wert als auch der Name für mehrere Serien oder Felder.

Sie können den **Textmodus** verwenden, um zu steuern, ob der Text angezeigt wird oder nicht.

## Automatische Layoutanpassung
<a name="v9-panels-stat-automatic-adjust"></a>

Das Panel passt das Layout automatisch an die verfügbare Breite und Höhe im Armaturenbrett an. Das Diagramm (Sparkline) wird automatisch ausgeblendet, wenn das Bedienfeld zu klein wird.

## Wertoptionen
<a name="v9-panels-stat-value"></a>

Verwenden Sie die folgenden Optionen, um zu verfeinern, wie Ihre Visualisierung den Wert anzeigt:

**Show (Anzeigen)**

Wählen Sie, wie Grafana Ihre Daten anzeigt.

**Berechne**

Zeigt einen berechneten Wert an, der auf allen Zeilen basiert.
+ **Berechnung** — Wählen Sie eine Reduktionsfunktion aus, mit der Grafana viele Felder auf einen einzigen Wert reduziert. Eine Liste der verfügbaren Berechnungen finden Sie unter [Standardberechnungen](v9-panels-calculation-types.md).
+ **Felder** — Wählen Sie die Felder aus, die im Panel angezeigt werden.

**Alle Werte**

Zeigt für jede Zeile eine separate Statistik an. Wenn Sie diese Option auswählen, können Sie auch die Anzahl der anzuzeigenden Zeilen einschränken.
+ **Limit** — Die maximale Anzahl der anzuzeigenden Zeilen. Die Standardeinstellung ist 5.000.
+ **Felder** — Wählen Sie die Felder aus, die im Panel angezeigt werden.

## Statistikstile
<a name="v9-panels-stat-styles"></a>

Gestalten Sie Ihre Visualisierung.

**Orientation (Ausrichtung)**

Wählen Sie eine Stapelrichtung.
+ **Auto** — Grafana wählt aus, was es für die beste Ausrichtung hält.
+ **Horizontal** — Balken werden horizontal von links nach rechts gestreckt.
+ **Vertikal** — Die Balken werden vertikal von oben nach unten gestreckt.

**Textmodus**

Mit der Option Textmodus können Sie steuern, welcher Text im Bedienfeld wiedergegeben wird. Wenn der Wert nicht wichtig ist, sondern nur der Name und die Farbe, ändern Sie den **Textmodus** in **Name**. Der Wert wird weiterhin zur Bestimmung der Farbe verwendet und in einem Tooltip angezeigt.
+ **Automatisch** — Wenn die Daten mehrere Reihen oder Felder enthalten, werden sowohl Name als auch Wert angezeigt.
+ **Wert** — Zeigt nur den Wert an, niemals den Namen. Der Name wird stattdessen im Tooltip mit der Maus angezeigt.
+ **Wert und Name** — Wert und Name werden immer angezeigt.
+ **Name** — Zeigt den Namen statt des Werts an. Der Wert wird im Hover-Tooltip angezeigt.
+ **Keine** — Nichts anzeigen (leer). Name und Wert werden im Hover-Tooltip angezeigt.

**Farbmodus**

Wählen Sie einen Farbmodus.
+ **Wert** — Färbt nur den Wert und den Grafikbereich.
+ **Hintergrund** — Färbt auch den Hintergrund ein.

**Grafikmodus**

Wählen Sie einen Grafik- und Sparkline-Modus aus.
+ **Keine** — Blendet das Diagramm aus und zeigt nur den Wert an.
+ **Fläche** — Zeigt das Flächendiagramm unter dem Wert an. Dies setzt voraus, dass Ihre Abfrage eine Zeitspalte zurückgibt.

**Ausrichtung des Textes**

Wählen Sie einen Ausrichtungsmodus.
+ **Automatisch** — Wenn nur ein einziger Wert angezeigt wird (keine Wiederholung), wird der Wert zentriert. Wenn mehrere Reihen oder Zeilen angezeigt werden, ist der Wert linksbündig ausgerichtet.
+ **Mitte** — Der Statistikwert ist zentriert.

Textgröße

Passen Sie die Größe des Messtextes an.
+ **Titel** — Geben Sie einen numerischen Wert für die Titelgröße des Messgeräts ein.
+ **Wert** — Geben Sie einen numerischen Wert für die Größe des Messgeräts ein.

# Zeitleistenfenster „Status“
<a name="v9-panels-state-timeline"></a>

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

Die Visualisierung des Zustandszeitfensters zeigt diskrete Zustandsänderungen im Zeitverlauf. Jedes Feld oder jede Reihe wird als ihr eigenes horizontales Band gerendert. Bundesstaatenregionen können entweder mit oder ohne Werte gerendert werden. Dieses Bedienfeld eignet sich gut für Zeichenketten- oder boolesche Zustände, kann aber auch mit Zeitreihen verwendet werden. Bei Verwendung mit Zeitreihen werden die Schwellenwerte verwendet, um die numerischen Werte in Bereiche mit diskreten Zuständen umzuwandeln.

## Optionen für die Zeitleiste von Bundesstaaten
<a name="v9-panels-state-timeline-options"></a>

Verwenden Sie diese Optionen, um Ihre Visualisierungen zu verfeinern:

**Gleiche aufeinanderfolgende Werte zusammenführen**

Steuert, ob Grafana identische Werte zusammenführt, wenn sie nebeneinander liegen.

**Werte anzeigen**

Steuert, ob Werte innerhalb der Regionen der Bundesstaaten gerendert werden. Auto rendert Werte, wenn ausreichend Speicherplatz vorhanden ist.

**Werte ausrichten**

Steuert die Ausrichtung der Werte innerhalb der Regionen der Bundesstaaten.

**Höhe der Zeile**

Steuert den Abstand zwischen den Zeilen. 1 = kein Leerzeichen = 0,5 = 50% Abstand.

**Linienbreite**

Steuert die Linienbreite der Regionen der Bundesstaaten.

**Deckkraft füllen**

Steuert die Opazität von Regionen der Bundesstaaten.

## Wertezuordnungen
<a name="v9-panels-state-timeline-valuemap"></a>

Um booleschen Werten oder Zeichenkettenwerten Farben zuzuweisen, verwenden Sie. [Wertezuordnungen konfigurieren](v9-panels-configure-value-mappings.md)

## Zeitreihendaten mit Schwellenwerten
<a name="v9-panels-state-timeline-threshold"></a>

Das Panel kann auch mit Zeitreihendaten verwendet werden. In diesem Fall werden die Schwellenwerte verwendet, um die Zeitreihen in diskrete farbige Zustandsregionen umzuwandeln.

## Optionen für die Legende
<a name="v9-panels-state-timeline-legend"></a>

Wenn die Legendenoption aktiviert ist, können entweder die Wertzuordnungen oder die Schwellenwertklammern angezeigt werden. Um die Wertzuordnungen in der Legende anzuzeigen, ist es wichtig, dass die Option Farbschema unter Standardoptionen auf Einzelfarbe oder Klassische Palette eingestellt ist. Um die Schwellenwertklammern in der Legende zu sehen, stellen Sie das Farbschema auf Von Schwellenwerten ein.

**Legendenmodus** Verwenden Sie diese Einstellungen, um die Darstellung der Legende in Ihrer Visualisierung zu verfeinern.
+  **Liste** — Zeigt die Legende als Liste an. Dies ist der Standardanzeigemodus der Legende.
+  **Tabelle** — Zeigt die Legende als Tabelle an.
+  **Versteckt** — Blendet die Legende aus.

**Platzierung der Legende** Wählen Sie aus, wo die Legende platziert werden soll.
+  **Unten** — Unter dem Diagramm.
+  **Rechts** — Rechts neben dem Diagramm.

**Werte der Legende**

Wählen Sie aus, welche der [Standardberechnungen](v9-panels-calculation-types.md) in der Legende angezeigt werden sollen. Sie können mehr als eine haben.

# Bereich „Statusverlauf“
<a name="v9-panels-status-history"></a>

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

Die Visualisierung des Statusverlaufs zeigt periodische Zustände im Zeitverlauf. Jedes Feld oder jede Reihe wird als horizontale Zeile gerendert. Boxen werden gerendert und um jeden Wert zentriert.

Die Visualisierung des Statusverlaufs funktioniert mit Zeichenfolgen-, booleschen und numerischen Feldern oder Zeitreihen. Ein Zeitfeld ist erforderlich. Sie können Wertezuordnungen verwenden, um Zeichenketten einzufärben oder numerischen Bereichen Textwerte zuzuweisen.

## Optionen anzeigen
<a name="v9-panels-status-history-timeline-options"></a>

Verwenden Sie diese Optionen, um Ihre Visualisierungen zu verfeinern:

**Werte anzeigen**

Steuert, ob Werte in den Wertfeldern gerendert werden. Auto rendert Werte, wenn ausreichend Platz vorhanden ist.

Die **Spaltenbreite** bestimmt die Breite der Boxen. 1=maximale Breite und 0=Minimale Breite.

**Die Linienbreite steuert die Linienbreite** der Bundesstaatenregionen.

Die **Füllopazität** steuert die Füllundurchlässigkeit der Regionen der Bundesstaaten.

## Zuordnungen von Werten
<a name="v9-panels-status-history-valuemap"></a>

Um booleschen Werten oder Zeichenkettenwerten Farben zuzuweisen, verwenden Sie. [Wertezuordnungen konfigurieren](v9-panels-configure-value-mappings.md)

## Zeitreihendaten mit Schwellenwerten
<a name="v9-panels-status-history-threshold"></a>

Das Panel kann auch mit Zeitreihendaten verwendet werden. In diesem Fall werden die Schwellenwerte verwendet, um die Boxen einzufärben. Sie können auch Farbverläufe verwenden, um Werte einzufärben.

## Legendenoptionen
<a name="v9-panels-status-history-legend"></a>

Wenn die Legendenoption aktiviert ist, können entweder die Wertzuordnungen oder die Schwellenwertklammern angezeigt werden. Um die Wertzuordnungen in der Legende anzuzeigen, ist es wichtig, dass die Option Farbschema unter Standardoptionen auf Einzelfarbe oder Klassische Palette eingestellt ist. Um die Schwellenwertklammern in der Legende zu sehen, stellen Sie das Farbschema auf Von Schwellenwerten ein.

**Legendenmodus** Verwenden Sie diese Einstellungen, um die Darstellung der Legende in Ihrer Visualisierung zu verfeinern.
+  **Liste** — Zeigt die Legende als Liste an. Dies ist der Standardanzeigemodus der Legende.
+  **Tabelle** — Zeigt die Legende als Tabelle an.
+  **Versteckt** — Blendet die Legende aus.

**Platzierung der Legende** Wählen Sie aus, wo die Legende platziert werden soll.
+  **Unten** — Unter dem Diagramm.
+  **Rechts** — Rechts neben dem Diagramm.

**Werte der Legende**

Wählen Sie aus, welche der [Standardberechnungen](v9-panels-calculation-types.md) in der Legende angezeigt werden sollen. Sie können mehr als eine haben.

# Tischplatte
<a name="v9-panels-table"></a>

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

Die Visualisierung des Tabellenfensters ist sehr flexibel und unterstützt mehrere Modi für Zeitreihen sowie für Tabellen, Anmerkungen und JSON-Rohdaten. Dieses Fenster bietet auch Optionen zur Datumsformatierung, Wertformatierung und Farbgebung.

## Spalte sortieren
<a name="v9-panels-table-sort"></a>

Klicken Sie auf einen Spaltentitel, um die Sortierreihenfolge von Standard über absteigend bis aufsteigend zu ändern. Jedes Mal, wenn Sie klicken, ändert sich die Sortierreihenfolge zur nächsten Option im Zyklus. Es kann immer nur nach einer Spalte sortiert werden.

## Tabellen-Optionen
<a name="v9-panels-table-options"></a>

**Kopfzeile anzeigen**

Aus Ihrer Datenquelle importierte Spaltennamen ein- oder ausblenden.

## Breite der Spalten
<a name="v9-panels-table-width"></a>

Standardmäßig berechnet Grafana die Spaltenbreite automatisch auf der Grundlage der Tabellengröße und der minimalen Spaltenbreite. Diese Feldoption kann die Einstellung überschreiben und die Breite für alle Spalten in Pixeln definieren.

Wenn Sie beispielsweise `100` in das Feld eingeben und dann auf eine Stelle außerhalb des Felds klicken, werden alle Spalten auf eine Breite von 100 Pixeln festgelegt.

## Minimale Spaltenbreite
<a name="v9-panels-table-min"></a>

Standardmäßig beträgt die Mindestbreite der Tabellenspalte 150 Pixel. Diese Feldoption kann diese Standardeinstellung überschreiben und definiert die neue Mindestspaltenbreite für das Tabellenfenster in Pixeln.

Wenn Sie beispielsweise `75` in das Feld eingeben und dann auf eine Stelle außerhalb des Felds klicken, werden alle Spalten auf eine Breite von nicht weniger als 75 Pixeln skaliert.

Reduzieren Sie bei Geräten mit kleinem Bildschirm, wie Smartphones oder Tablets, den `150` Standardpixelwert auf, `50` damit tabellenbasierte Bedienfelder in Dashboards korrekt dargestellt werden.

## Ausrichtung der Spalten
<a name="v9-panels-table-alignment"></a>

Wählen Sie aus, wie Grafana den Zellinhalt ausrichten soll:
+ Auto (Standard)
+ Links
+ zentrum
+ Rechts

## Zelltyp
<a name="v9-panels-table-cell-type"></a>

Standardmäßig wählt Grafana automatisch die Anzeigeeinstellungen aus. Sie können die Einstellungen überschreiben, indem Sie eine der folgenden Optionen wählen, um den Standard für alle Felder festzulegen. Für einige Zelltypen ist eine zusätzliche Konfiguration verfügbar.

**Anmerkung**  
Wenn Sie diese auf der Registerkarte „**Feld**“ festlegen, gilt der Typ für alle Felder, einschließlich des Zeitfeldes. Sie können sie auf der Registerkarte **Überschreiben** festlegen, um die Änderung auf ein oder mehrere Felder anzuwenden.

**Text einfärben**

Wenn Schwellenwerte festgelegt sind, wird der Feldtext in der entsprechenden Schwellenwertfarbe angezeigt.

**Farbiger Hintergrund (Farbverlauf oder Vollton)**

Wenn Schwellenwerte festgelegt sind, wird der Feldhintergrund in der entsprechenden Schwellenwertfarbe angezeigt.

**Messinstrument**

Zellen können als grafisches Messgerät mit verschiedenen Darstellungsarten angezeigt werden.

**Basic**

Im Basismodus wird ein einfaches Messgerät angezeigt, wobei die Schwellenwerte die Farbe des Messgeräts definieren.

**Farbverlauf**

Die Schwellenwerte definieren einen Gradienten.

**LCD**

Das Messgerät ist in kleine Zellen aufgeteilt, die leuchten oder nicht beleuchtet sind.

**JSON-Ansicht**

Zeigt den als Code formatierten Wert an. Wenn es sich bei einem Wert um ein Objekt handelt, erscheint die JSON-Ansicht, die das Durchsuchen des JSON-Objekts ermöglicht, wenn der Mauszeiger darüber bewegt wird.

## Zellenwert überprüfen
<a name="v9-panels-table-cell-value"></a>

Aktiviert die Wertprüfung von der Tabellenzelle aus. Der Rohwert wird in einem modalen Fenster dargestellt.

**Anmerkung**  
Die Überprüfung von Zellenwerten ist nur verfügbar, wenn der Zellanzeigemodus auf Auto, Farbtext, Farbiger Hintergrund oder JSON-Ansicht eingestellt ist.

## Spaltenfilter
<a name="v9-panels-table-col-filter"></a>

Sie können vorübergehend ändern, wie Spaltendaten angezeigt werden. Sie können beispielsweise Werte vom höchsten zum niedrigsten Wert sortieren oder bestimmte Werte ausblenden. Weitere Informationen finden Sie weiter unten unter [Tabellenspalten filtern](#v9-panels-table-filter).

## Paginierung
<a name="v9-panels-table-pagination"></a>

Verwenden Sie diese Option, um die Paginierung zu aktivieren oder zu deaktivieren. Es handelt sich um eine Front-End-Option, die sich nicht auf Abfragen auswirkt. Wenn diese Option aktiviert ist, passt sich die Seitengröße automatisch an die Höhe der Tabelle an.

## Tabellenspalten filtern
<a name="v9-panels-table-filter"></a>

Wenn Sie den **Spaltenfilter** aktivieren, können Sie Tabellenoptionen filtern.

**Um die Spaltenfilterung zu aktivieren**

1. Navigieren Sie in Grafana zum Dashboard mit der Tabelle mit den Spalten, die Sie filtern möchten.

1. Öffnen Sie in dem Tabellenfenster, das Sie filtern möchten, den Panel-Editor.

1. Wählen Sie die Registerkarte „**Feld**“.

1. Aktivieren Sie unter **Tabellenoptionen** die Option **Spaltenfilter**.

Neben jedem Spaltentitel wird ein Filtersymbol angezeigt.

**Filtern Sie die Spaltenwerte**

Um Spaltenwerte zu filtern, wählen Sie das Filter- (Trichter-) Symbol neben einem Spaltentitel. Grafana zeigt die Filteroptionen für diese Spalte an.

Aktivieren Sie das Kontrollkästchen neben den Werten, die Sie anzeigen möchten. Geben Sie Text in das Suchfeld oben ein, um diese Werte in der Anzeige anzuzeigen, sodass Sie sie auswählen können, anstatt zu scrollen, um sie zu finden.

**Löschen Sie die Spaltenfilter**

Bei Spalten mit angewendeten Filtern wird neben dem Titel ein blauer Trichter angezeigt.

Um den Filter zu entfernen, wählen Sie das blaue Trichtersymbol und dann Filter löschen aus.

## Fußzeile der Tabelle
<a name="v9-panels-table-footer"></a>

Sie können den Tabellenfuß verwenden, um [Berechnungen](v9-panels-calculation-types.md) für Felder anzuzeigen.

Nachdem Sie den Tabellenfuß aktiviert haben, können Sie die **Formel** und dann die **Felder** auswählen, die Sie berechnen möchten.

Das System wendet die Berechnung auf alle numerischen Felder an, wenn Sie kein Feld auswählen.

**Zählen Sie die Zeilen**

Wenn Sie die Anzahl der Zeilen im Datensatz anstelle der Anzahl der Werte in den ausgewählten Feldern anzeigen möchten, wählen Sie die Berechnung **Anzahl** und aktivieren Sie **Zeilen zählen**.

# Textfeld
<a name="v9-panels-text"></a>

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

Das Textfeld ermöglicht es Ihnen, Text oder HTML direkt in Ihre Dashboards einzufügen. Dies kann verwendet werden, um Kontextinformationen und Beschreibungen hinzuzufügen oder komplexes HTML einzubetten.

**Mode (Modus)**

Der Modus bestimmt, wie eingebettete Inhalte angezeigt werden. Er hat die folgenden Optionen
+ **Markdown** — Diese Option formatiert den Inhalt als Markdown.
+ **HTML** — Mit dieser Einstellung wird der Inhalt als bereinigtes HTML wiedergegeben.
+ **Code** — Diese Einstellung rendert Inhalte in einem schreibgeschützten Code-Editor. Wählen Sie eine geeignete Sprache aus, um die Syntaxhervorhebung auf den eingebetteten Text anzuwenden.

**Variablen**

Variablen im Inhalt werden für die Anzeige erweitert.

# Bedienfeld „Zeitreihen“
<a name="v9-panels-time-series"></a>

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

Das Zeitreihenfenster kann eine Zeitreihe als Linie, einen Pfad aus Punkten oder eine Reihe von Balken rendern. Diese Art von Diagramm ist vielseitig genug, um fast alle Zeitreihendaten anzuzeigen.

**Anmerkung**  
Sie können Visualisierungen im Grafikfenster zu Zeitreihenvisualisierungen migrieren. **Wählen Sie zur Migration auf der Registerkarte **Bedienfeld** die Option Zeitreihenvisualisierung aus.** Grafana überträgt alle zutreffenden Einstellungen.

**Topics**
+ [Tooltip-Optionen](v9-time-series-panel-tooltip.md)
+ [Legendenoptionen](v9-time-series-panel-legend.md)
+ [Optionen für den Grafikstil](v9-time-series-graph.md)
+ [Achsenoptionen](v9-time-series-axis.md)
+ [Farboptionen](v9-time-series-color.md)

# Tooltip-Optionen
<a name="v9-time-series-panel-tooltip"></a>

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

Wenn Sie den Mauszeiger über das Diagramm bewegen, kann Grafana Tooltips anzeigen. Wählen Sie, wie sich Tooltips verhalten:
+  **Einzeln** — Der Tooltip zeigt nur die Serie an, über der Sie den Mauszeiger bewegen.
+  **Alle** — Der Hover-Tooltip zeigt alle Serien im Diagramm an. Grafana hebt die Serie, über die Sie den Mauszeiger bewegen, in der Serienliste im Tooltip fett hervor.
+  **Versteckt** — Zeigt den Tooltip nicht an. 

# Legendenoptionen
<a name="v9-time-series-panel-legend"></a>

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

**Legendenmodus — Wählen Sie aus, wie die Legende** angezeigt wird.
+  **Liste** — Zeigt die Legende als Liste an. Dies ist die Standardeinstellung.
+  **Tabelle** — Zeigt die Legende als Tabelle an. 
+  **Versteckt** — Blendet die Legende aus.

**Platzierung der Legende** — Wählen Sie aus, wo die Legende angezeigt werden soll.
+  **Unten** — Unter dem Diagramm.
+  **Rechts** — Rechts neben dem Diagramm. 

**Legendenberechnungen**

Wählen Sie aus, welche Berechnungen in der Legende angezeigt werden sollen. Weitere Informationen finden Sie unter [Berechnungsarten](v9-panels-calculation-types.md).

# Optionen für den Grafikstil
<a name="v9-time-series-graph"></a>

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

**Grafikstil**

Verwenden Sie diese Option, um zu definieren, wie Ihre Zeitreihendaten angezeigt werden sollen. Sie können Überschreibungen verwenden, um mehrere Stile in derselben Grafik zu kombinieren. Es gibt drei Stiloptionen. Einige der anderen Stiloptionen gelten nur für bestimmte Grafikstile.
+ **Linien** — Zeigt die Zeitreihe als Linie in einem Diagramm an.
+ **Balken** — Zeigen Sie die Zeitreihe als eine Reihe von Balken in einem Diagramm an, einen für jeden Datenpunkt.
+ **Punkte** — Zeigt die Zeitreihen als Punkte in einem Diagramm an, einen für jeden Datenpunkt.

**Ausrichtung der Balken**

Legt bei Balkendiagrammen die Position des Balkens relativ zu der Stelle fest, an der der Punkt im Diagramm gezeichnet werden würde. Da ein Balken eine Breite hat, kann er vor, hinter oder in der Mitte des Punkts platziert werden. Für diese Option stehen die Optionen „**Vorher**“, „**Mitte**“ oder „**Nachher**“ zur Verfügung.

**Linienbreite**

Legt die Dicke der Linie für Liniendiagramme oder die Dicke der Kontur für jeden Balken in einem Balkendiagramm fest.

**Deckkraft füllen**

Legt die Deckkraft einer Füllfarbe fest. Füllungen werden beispielsweise verwendet, um den Bereich unter der Linie in einem Liniendiagramm oder als Farbe von Balken in einem Balkendiagramm darzustellen.

**Verlaufsmodus**

Der Verlaufsmodus gibt die Verlaufsfüllung an, die auf der Serienfarbe basiert. Um die Farbe zu ändern, verwenden Sie die Standardfeldoption für das Farbschema. Weitere Informationen finden Sie unter [Farbschema](v9-panels-configure-standard-options.md#v9-panels-standard-options-color-scheme). Die Optionen für den Verlaufsmodus sind:
+ **Keine** — Keine Verlaufsfüllung.
+ **Deckkraft** — Ein Deckkraftverlauf, bei dem die Deckkraft der Füllung mit steigendem Wert der Y-Achse zunimmt.
+ **Farbton** — Ein Farbverlauf, der auf dem Farbton der Serienfarbe basiert.
+ **Schema** — Ein Farbverlauf, der durch Ihr Farbschema definiert wird. Diese Einstellung kann sowohl für die Füllung als auch für die Linie verwendet werden. Weitere Informationen finden Sie unter [Farboptionen](v9-time-series-color.md).

Die Darstellung des Verlaufs wird auch durch die Einstellung für die **Deckkraft der Füllung** geändert. 

**Punkte anzeigen**

Sie können Ihre Visualisierung so konfigurieren, dass Punkte zu Linien- oder Balkendiagrammen hinzugefügt werden. Sie können „**Immer**“, „**Nie**“ oder „**Automatisch**“ wählen. Bei Verwendung von **Auto** bestimmt Grafana anhand der Dichte der Daten, ob Punkte angezeigt werden sollen. Wenn die Dichte der Daten niedrig genug ist, werden Punkte angezeigt.

**Punktgröße**

Legt die Größe der gezeichneten Punkte auf einen Durchmesser von 1 bis 40 Pixeln fest.

**Linieninterpolation**

Wählen Sie aus, wie Grafana die Serienlinie interpoliert. **Zur Auswahl stehen „**Linear**“, „**Glatt**“, „**Schritt davor**“ und „Schritt danach“.**

**Line style (Linienstil)**

Legen Sie den Stil der Linie fest. Um die Farbe zu ändern, verwenden Sie die Standardfeldoption für das Farbschema.

Die Darstellung des Linienstils wird durch die Einstellungen für **Linienbreite** und **Fülldeckkraft** beeinflusst.

Für den Linienstil stehen die Optionen „Durchgezogen“, **„****Strich**“ und „**Punkte**“ zur Auswahl.

**Nullwerte Connect**

Wählen Sie aus, wie Nullwerte (Lücken in den Daten) im Diagramm angezeigt werden. Nullwerte können so verbunden werden, dass sie eine durchgehende Linie bilden, oder Sie können optional einen Schwellenwert festlegen, ab dem Lücken in den Daten nicht mehr miteinander verbunden werden sollen. Sie können „**Niemals** Datenpunkte mit Lücken verbinden“, „Datenpunkte mit Lücken **immer** verbinden“ oder einen **Schwellenwert** festlegen, ab dem Lücken in den Daten nicht mehr miteinander verbunden werden sollen.

**Reihe stapeln**

Durch das *Stapeln* kann Grafana Serien übereinander anzeigen. Seien Sie vorsichtig, wenn Sie das Stapeln in der Visualisierung verwenden, da dadurch leicht irreführende Grafiken entstehen können. Weitere Informationen darüber, warum das Stapeln möglicherweise nicht der beste Ansatz ist, finden Sie unter [The Issue](https://www.data-to-viz.com/caveat/stacking.html) with Stacking.

Die Optionen für das Stapeln sind:
+ **Aus** — Deaktiviert die Reihenstapelung.
+ **Normal** — Stapelt Serien übereinander.
+ **100%** — Prozentual gestapelt, wobei die Summe aller Serien zusammen 100% ergibt.

**Reihen in Gruppen stapeln**

Sie können das Stapelverhalten überschreiben, um Serien in Gruppen zu stapeln. Weitere Informationen zum Erstellen einer Überschreibung finden Sie unter[Feldüberschreibungen konfigurieren](v9-panels-configure-overrides.md). Geben Sie beim Erstellen der Überschreibung den Namen der Stapelgruppe an, zu der die Serie gehören soll.

**Füllen Sie das Folgende aus**

Die Option „**Unten füllen bis**“ füllt den Bereich zwischen zwei Reihen aus. Diese Option ist nur als Reihen- oder Feldüberschreibung verfügbar. Mit dieser Option können Sie den Bereich zwischen zwei Reihen füllen, anstatt von der Reihenlinie bis 0 herunterzufahren. Wenn Sie beispielsweise zwei Datenreihen mit den Namen *Max* und *Min* haben, könnten Sie die Datenreihe **Max** auswählen und sie so überschreiben, **dass sie unterhalb** der Reihe **Min** liegt. Dadurch würde nur der Bereich zwischen den beiden Serienlinien gefüllt.

# Achsenoptionen
<a name="v9-time-series-axis"></a>

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

Optionen unter der Achsenkategorie ändern, wie die X- und Y-Achsen gerendert werden. Einige Optionen werden erst wirksam, wenn Sie auf eine Stelle außerhalb des Feld-Optionsfeldes klicken, das Sie bearbeiten. Sie können auch oder drücken`Enter`.

**Platzierung**

Wählen Sie die Platzierung der Y-Achse aus. Die Optionen sind:
+ **Auto** — Grafana weist der Serie automatisch die Y-Achse zu. Wenn es zwei oder mehr Serien mit unterschiedlichen Einheiten gibt, weist Grafana der ersten Einheit die linke Achse und den nachfolgenden Einheiten die rechte Achse zu.
+ **Links** — Zeigt alle Y-Achsen auf der linken Seite an.
+ **Rechts** — Zeigt alle Y-Achsen auf der rechten Seite an.
+ **Versteckt** — Alle Y-Achsen werden ausgeblendet.

Um jedem Feld oder jeder Reihe Achsen zuzuweisen, [fügen Sie Feldüberschreibungen](v9-panels-configure-overrides.md) hinzu.

**Label (Bezeichnung)**

Legen Sie eine Textbeschriftung für die Y-Achse fest. Wenn Sie mehr als eine Y-Achse haben, können Sie mithilfe einer Überschreibung verschiedene Beschriftungen zuweisen.

**Width (Breite)**

Stellen Sie eine feste Breite der Achse ein. Standardmäßig berechnet Grafana dynamisch die Breite einer Achse.

Durch die Einstellung der Breite der Achse können Daten mit unterschiedlichen Achstypen dieselben Anzeigeproportionen haben. Diese Einstellung erleichtert es Ihnen, die Daten mehrerer Grafiken miteinander zu vergleichen, da die Achsen in visueller Nähe zueinander nicht verschoben oder gestreckt werden.

**Weiches Minimum und sanftes Maximum**

Stellen Sie eine **Soft-Min** - oder **Soft-Max-Option** ein, um die Y-Achsen-Grenzwerte besser kontrollieren zu können. Standardmäßig legt Grafana den Bereich für die Y-Achse automatisch auf der Grundlage des Datensatzes fest.

Die Einstellungen „Soft Min“ und „Soft Max“ ermöglichen den Einblick in kleine Änderungen, wenn keine großen Änderungen vorhanden sind. Harte Min- oder Max-Werte, die aus den Standardfeldoptionen für Min und Max abgeleitet wurden, können verhindern, dass intermittierende Spitzen nützliche Details verflachen, indem die Spitzen über einen bestimmten Punkt hinaus abgeschnitten werden.

Um feste Grenzwerte für die Y-Achse zu definieren, können Sie Standardoptionen festlegen. min/max Weitere Informationen finden Sie unter [Standardoptionen konfigurieren](v9-panels-configure-standard-options.md).

**Skalieren**

Stellen Sie ein, wie die Y-Achse skaliert werden soll. Sie haben die Wahl zwischen **Linear** und **Logarithmisch**. Wenn Sie logarithmisch wählen, können Sie außerdem zwischen logarithmischen Skalen zur Basis 2 oder zur Basis 10 wählen.

**Transform**

Sie können eine Reihe überschreiben, um eine Transformation auf Werte in einem Diagramm anzuwenden (ohne die zugrunde liegenden Werte oder die Werte in QuickInfos, Kontextmenüs oder Legenden zu beeinflussen). Sie haben zwei Transformationsoptionen:
+ **Negative Y-Transformation** — Dreht die Ergebnisse auf negative Werte auf der Y-Achse um.
+ **Konstante** — Zeigt den ersten Wert als konstante Linie an.

# Farboptionen
<a name="v9-time-series-color"></a>

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

Standardmäßig verwendet das Diagramm die Standardoption [Farbschema](v9-panels-configure-standard-options.md#v9-panels-standard-options-color-scheme), um Serienfarben zuzuweisen. Sie können die Legende auch verwenden, um den Farbwähler zu öffnen, indem Sie auf das Farbsymbol der Legendenserie klicken. Wenn Sie die Farbe auf diese Weise festlegen, wird automatisch eine Überschreibungsregel erstellt, die eine bestimmte Farbe für eine bestimmte Serie festlegt.

Im Folgenden finden Sie zusätzliche Optionen, mit denen Sie die Standardeinstellungen für Serienfarben überschreiben können.

**Klassische Palette**

Die gängigste Konfiguration ist die Verwendung der **Classic-Palette** für Grafiken. Dieses Schema weist jedem Feld oder jeder Reihe automatisch eine Farbe auf der Grundlage der Reihenfolge zu. Wenn sich die Reihenfolge eines Felds in Ihrer Abfrage ändert, ändert sich auch die Farbe. Mithilfe einer Überschreibungsregel können Sie eine Farbe für ein bestimmtes Feld manuell konfigurieren.

**Einfarbig**

Verwenden Sie diesen Modus, um eine Farbe anzugeben. Sie können auch auf das farbige Liniensymbol neben jeder Serie in der Legende klicken, um den Farbwähler zu öffnen. Dadurch wird automatisch eine neue Überschreibung erstellt, die das Farbschema auf eine einzelne Farbe und die ausgewählte Farbe festlegt.

**Farbschemas nach Wert**

Wenn Sie ein Farbschema nach Wert auswählen, z. B. **Aus Schwellenwerten (nach Wert)** oder **Green-Yellow-Red (nach Wert)**, wird die Option **Reihe färben nach** angezeigt. Diese Option steuert, welcher Wert (Last, Min, Max) verwendet werden soll, um der Reihe ihre Farbe zuzuweisen.

**Schema-Gradientenmodus**

Die Option **Verlaufsmodus**, die sich unter den **Grafikstilen** befindet, hat einen Modus namens **Schema**. Wenn Sie **Schema** aktivieren, erhält die Linie oder der Balken eine Verlaufsfarbe, die anhand des ausgewählten **Farbschemas** definiert ist.

**Aus Schwellenwerten**

Wenn das **Farbschema** auf **Von Schwellenwerten (nach Wert)** und der **Verlaufsmodus** auf **Schema** eingestellt ist, ändert sich die Linien- oder Balkenfarbe, wenn sie die definierten Schwellenwerte überschreiten. Es werden nur exakt die Farben angezeigt, die im Schema ausgewählt wurden.

**Farbschemata mit Farbverlauf**

Wenn Sie ein Farbverlaufsschema verwenden, *ohne* den **Verlaufsmodus** auf **Schema** zu setzen, bedeutet dies, dass die ausgewählten Farben einen Farbverlauf zwischen den ausgewählten Farben bilden, da sich die Werte in der Reihe zwischen den festgelegten Schwellenwerten bewegen.

# Bedienfeld „Spuren“ (Beta)
<a name="v9-panels-traces"></a>

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

*Traces* sind eine Visualisierung, mit der Sie eine Anfrage verfolgen und protokollieren können, während sie die Dienste in Ihrer Infrastruktur durchläuft.

Weitere Informationen zu Traces finden Sie unter[Nachverfolgung in Explore](v9-explore-tracing.md).

# WindRose
<a name="v9-panels-windrose"></a>

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

Das WindRose Panel empfängt Rohdaten aus Zeitreihen, konvertiert die Daten und ordnet sie in einem Diagramm zu. WindRose 

![\[WindRose panel with two circular charts showing wind direction and speed data distribution.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/windrose.png)


## Optionen
<a name="v9-panels-windrose-options"></a>

Das WindRose Panel unterstützt die folgenden Optionen:
+ Frequenz der Achse
+ Achsenstil (Grad oder Kompass)
+ Maßstab (linear, quadratisch, logarithmisch)

# Erkunden Sie in Grafana-Version 9
<a name="v9-explore"></a>

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

Die Dashboard-Benutzeroberfläche von Grafana bietet Funktionen zum Erstellen von Dashboards zur Visualisierung. *Explore* entfernt die Dashboard- und Panel-Optionen, sodass Sie sich auf die Abfrage konzentrieren können. Es hilft Ihnen bei der Iteration, bis Sie eine funktionierende Abfrage haben, und dann können Sie aus der Abfrage ein Dashboard erstellen.

**Anmerkung**  
Wenn Sie nur Ihre Daten untersuchen und kein Dashboard erstellen möchten, erleichtert Explore dies erheblich. Wenn Ihre Datenquelle Diagramm- und Tabellendaten unterstützt, zeigt Explore die Ergebnisse sowohl als Grafik als auch als Tabelle an. Auf diese Weise können Sie Trends in den Daten und weitere Details gleichzeitig erkennen.

## Beginne zu erkunden
<a name="v9-explore-start"></a>

**Anmerkung**  
Um auf Explore zugreifen zu können, benötigen Sie eine Redakteur- oder Administratorrolle.

**Um auf Explore zuzugreifen**

1. Wählen Sie in Ihrem Grafana-Arbeitsbereich in der linken Menüleiste den Menüpunkt Erkunden.

   Eine leere Registerkarte „Erkunden“ wird geöffnet.

   Um mit einer vorhandenen Abfrage in einem Fenster zu beginnen, wählen Sie alternativ die Option Erkunden aus dem Bedienfeldmenü. Dadurch wird eine Registerkarte „Erkunden“ mit der Abfrage aus dem Panel geöffnet, sodass Sie die Abfrage außerhalb Ihres Dashboards optimieren oder iterieren können.

1. Wählen Sie Ihre Datenquelle aus dem Drop-down-Menü oben links aus. [Prometheus](prometheus-data-source.md) hat eine benutzerdefinierte Explore-Implementierung, die anderen Datenquellen verwenden ihren Standard-Abfrage-Editor.

1. Schreiben Sie in das Abfragefeld Ihre Abfrage, um Ihre Daten zu untersuchen. Neben dem Abfragefeld befinden sich drei Schaltflächen: eine Schaltfläche zum Löschen (X), eine Schaltfläche zum Hinzufügen von Abfragen (\$1) und die Schaltfläche zum Entfernen einer Abfrage (-). Genau wie im normalen Abfrage-Editor können Sie mehrere Abfragen hinzufügen und entfernen.

   Weitere Informationen zu Abfragen finden Sie unter[Daten abfragen und transformieren](v9-panels-query-xform.md).

## Teilen und vergleichen
<a name="v9-explore-compare"></a>

Die geteilte Ansicht bietet eine einfache Möglichkeit, Grafiken und Tabellen zu vergleichen side-by-side oder verwandte Daten gemeinsam auf einer Seite zu betrachten.

**Öffnen Sie oben eine geteilte Ansicht**

1. Wählen Sie in der Ansicht Erkunden die Schaltfläche **Teilen**, um die aktuelle Abfrage zu duplizieren und die Seite in zwei side-by-side Abfragen aufzuteilen.
**Anmerkung**  
Es ist möglich, eine andere Datenquelle für die neue Abfrage auszuwählen, sodass Sie beispielsweise dieselbe Abfrage für zwei verschiedene Server oder die Staging-Umgebung mit der Produktionsumgebung vergleichen können.

   In der geteilten Ansicht können die Zeitwähler für beide Bereiche miteinander verknüpft werden (wenn Sie eines ändern, wird auch das andere geändert), indem Sie auf eine Schaltfläche für die Zeitsynchronisierung klicken, die an einem der Zeitwähler angebracht ist. Durch das Verknüpfen von Timepickern werden die Start- und Endzeiten der Split-View-Abfragen synchron gehalten. Dadurch wird sichergestellt, dass Sie in beiden geteilten Panels dasselbe Zeitintervall betrachten.

1. Um die neu erstellte Abfrage zu schließen, klicken Sie auf die Schaltfläche Split schließen.

## Verkürzten Link teilen
<a name="v9-explore-share"></a>

Die Funktion „Verkürzten Link teilen“ ermöglicht es Ihnen, kleinere und einfachere URLs Dateien im Format /goto/:uid zu erstellen, anstatt ein längeres Format mit Abfrageparametern zu verwenden. URLs Um einen verkürzten Link zu den Abfrageergebnissen zu erstellen, wählen Sie in der Werkzeugleiste „Durchsuchen“ die Option **Teilen** aus. Ein verkürzter Link, der nie verwendet wird, wird nach sieben (7) Tagen automatisch gelöscht.

# Abfrageverwaltung in Explore
<a name="v9-explore-manage"></a>

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

Um Ihnen beim Debuggen von Abfragen zu helfen, ermöglicht Ihnen Explore, Abfrageanfragen und -antworten sowie Abfragestatistiken über den Abfrageinspektor zu untersuchen. Diese Funktion ähnelt den Aufgaben „[Abfrageleistung überprüfen“ und „Abfrageanforderungs](v9-panels-panel-inspector.md#v9-panels-query-performance) [- und Antwortdaten überprüfen](v9-panels-panel-inspector.md#v9-panels-query-request-response)“ im Panel-Inspektor.

## Verlauf abfragen
<a name="v9-explore-manage-history"></a>

Der Abfrageverlauf ist eine Liste von Abfragen, die Sie in Explore verwendet haben. Der Verlauf wird in der Grafana-Datenbank gespeichert und nicht mit anderen Benutzern geteilt. Die Aufbewahrungsfrist für Abfragen in der Historie beträgt zwei Wochen. Abfragen, die älter als zwei Wochen sind, werden automatisch gelöscht. Um Ihren Verlauf zu öffnen und mit ihm zu interagieren, klicken Sie in Explore auf die Schaltfläche **Verlauf abfragen**.

**Anmerkung**  
Mit einem Stern markierte (als Favorit markierte) Abfragen unterliegen nicht der zweiwöchigen Aufbewahrungsfrist und sie werden auch nicht gelöscht.

**Abfrageverlauf anzeigen**

Mit dem Abfrageverlauf können Sie den Verlauf Ihrer Abfragen einsehen. Für jede einzelne Abfrage können Sie:
+ Ausführen einer Abfrage
+ Einen Kommentar erstellen und and/or bearbeiten.
+ Kopiert eine Abfrage in die Zwischenablage.
+ Kopiert einen verkürzten Link mit der Abfrage in die Zwischenablage.
+ Markieren Sie eine Abfrage mit einem Stern (Favorit).

**Bevorzugte Abfragen verwalten**

Alle Abfragen, die auf der Registerkarte Abfrageverlauf mit einem Stern markiert wurden, werden in der Liste Mit Sternen markiert angezeigt. Auf diese Weise können Sie schneller auf Ihre bevorzugten Abfragen zugreifen und diese Abfragen wiederverwenden, ohne sie neu eingeben zu müssen.

**Sortieren des Abfrageverlaufs**

Standardmäßig zeigt Ihnen der Abfrageverlauf die neuesten Abfragen. Sie können Ihren Verlauf nach Datum oder nach dem Namen der Datenquelle in aufsteigender oder absteigender Reihenfolge sortieren.

**Um Ihren Abfrageverlauf zu sortieren**

1. Wählen Sie das Feld **Abfragen nach sortieren** aus.

1. Wählen Sie eine der folgenden Optionen aus:
   + Neuste zuerst
   + Älteste zuerst

**Der Abfrageverlauf wird gefiltert**

Sie können Ihren Abfrageverlauf im Abfrageverlauf und auf der Registerkarte Als Favorit markiert nach einer bestimmten Datenquelle filtern.

**Den Verlauf nach einer Datenquelle filtern**

1. Wählen Sie das Feld **Abfragen nach bestimmten Datenquellen filtern** aus.

1. Wählen Sie die Datenquelle aus, nach der Sie Ihren Verlauf filtern möchten. Sie können mehrere Datenquellen auswählen.

Auf der Registerkarte **Abfrageverlauf** ist es auch möglich, Abfragen mithilfe des Schiebereglers nach Datum zu filtern:
+ Verwenden Sie den vertikalen Schieberegler, um Abfragen nach Datum zu filtern.
+ Passen Sie das Startdatum an, indem Sie den oberen Ziehpunkt ziehen.
+ Passen Sie das Enddatum an, indem Sie den oberen Ziehpunkt ziehen.

**Im Abfrageverlauf suchen**

Sie können in Ihrem Verlauf nach Abfragen und Ihren Kommentaren suchen. Die Suche nach Abfragen ist auf den Tabs Abfrageverlauf und Sternchen möglich.

**Um im Abfrageverlauf zu suchen**

1. Wählen Sie das Feld **Suchanfragen** aus.

1. Geben Sie den Begriff, nach dem Sie suchen, in das Suchfeld ein.

**Verlaufseinstellungen abfragen**

Sie können den Abfrageverlauf auf der Registerkarte Einstellungen anpassen. Die Optionen werden in der folgenden Tabelle beschrieben.


| Einstellung | Standardwert | 
| --- | --- | 
| Ändern Sie die aktive Standardregisterkarte | Registerkarte „Verlauf abfragen“ | 

**Anmerkung**  
Die Einstellungen für den Abfrageverlauf sind global und werden im geteilten Modus auf beide Bereiche angewendet.

## Promethus-spezifische Funktionen
<a name="v9-explore-manage-prometheus"></a>

Explore bietet ein benutzerdefiniertes Abfrageerlebnis für Prometheus. Wenn eine Abfrage ausgeführt wird, werden tatsächlich zwei Abfragen ausgeführt, eine normale Prometheus-Abfrage für das Diagramm und eine *Sofortabfrage* für die Tabelle. Eine Sofortabfrage gibt den letzten Wert für jede Zeitreihe zurück, was eine gute Zusammenfassung der im Diagramm angezeigten Daten darstellt.

**Metrik-Explorer**

Wählen Sie auf der linken Seite des Abfragefelds **Metrics** aus, um den Metric Explorer zu öffnen. Daraufhin wird ein hierarchisches Menü mit Metriken angezeigt, die nach ihrem Präfix gruppiert sind. Beispielsweise sind alle Alertmanager-Metriken unter dem Präfix gruppiert. `alertmanager` Dies ist ein guter Ausgangspunkt, wenn Sie nur herausfinden möchten, welche Metriken verfügbar sind.

**Abfragefeld**

Das Abfragefeld unterstützt die automatische Vervollständigung von Metriknamen und Funktionen, vergleichbar mit dem standardmäßigen Prometheus-Abfrage-Editor. Sie können die Eingabetaste drücken, um eine neue Zeile zu erstellen, und Umschalttaste\$1Eingabetaste, um eine Abfrage auszuführen.

Das Autocomplete-Menü kann durch Drücken von Strg\$1Leertaste ausgelöst werden. Das Autocomplete-Menü enthält einen neuen Abschnitt „Verlauf“ mit einer Liste der zuletzt ausgeführten Abfragen.

Vorschläge können unter dem Abfragefeld angezeigt werden. Wählen Sie diese aus, um Ihre Abfrage mit der vorgeschlagenen Änderung zu aktualisieren.
+ Für Zähler (monoton steigende Messwerte) wird eine Ratenfunktion vorgeschlagen.
+ Für Buckets wird eine Histogrammfunktion vorgeschlagen.
+ Für Aufzeichnungsregeln ist es möglich, die Regeln zu erweitern.

**Tabellenfilter**

Wählen Sie die Filterschaltfläche in der **Labelspalte** eines Tabellenfensters aus, um dem Abfrageausdruck Filter hinzuzufügen. Sie können auch Filter für mehrere Abfragen hinzufügen — der Filter wird für alle Abfragen hinzugefügt.

# Loggt sich in Explore ein
<a name="v9-explore-logs"></a>

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

Zusammen mit Metriken können Sie mit Explore Ihre Logs in den folgenden Datenquellen untersuchen:
+ [OpenSearch](using-opensearch-in-AMG.md)
+ [InfluxDB](using-influxdb-in-AMG.md)
+ [Loki](using-loki-in-AMG.md)

Während der Überwachung der Infrastruktur und der Reaktion auf Vorfälle können Sie sich eingehender mit den Kennzahlen und Protokollen befassen, um die Ursache zu finden. Explore ermöglicht es Ihnen auch, Metriken und Protokolle zu korrelieren, indem Sie sie sich ansehen. side-by-side Dadurch wird ein neuer Debugging-Workflow erstellt.

1. Erhalten Sie eine Warnung.

1. Gehen Sie näher auf die Kennzahlen ein und untersuchen Sie sie.

1. Gehen Sie erneut nach und suchen Sie nach Protokollen, die sich auf die Metrik und das Zeitintervall beziehen (und in future auch auf verteilte Traces).

## Visualisierung von Protokollen
<a name="v9-explore-logs-viz"></a>

Die Ergebnisse von Protokollabfragen werden in der Grafik als Histogramme angezeigt, und die einzelnen Protokolle werden in den folgenden Abschnitten erklärt.

Wenn die Datenquelle ein Histogramm für das gesamte Protokollvolumen unterstützt, wird das Diagramm mit der Protokollverteilung für alle eingegebenen Protokollabfragen automatisch angezeigt. Diese Funktion wird derzeit von OpenSearch und Loki-Datenquellen unterstützt.

**Anmerkung**  
In Loki wird dieses Histogramm des gesamten Protokollvolumens durch eine metrische Abfrage wiedergegeben, was je nach abgefragtem Zeitraum teuer sein kann. Die Verarbeitung dieser Abfrage kann für kleinere Loki-Installationen besonders schwierig sein. Um dies zu vermeiden, empfehlen wir, einen Proxy wie [nginx](https://www.nginx.com/) vor Loki zu verwenden, um ein benutzerdefiniertes Timeout (z. B. 10 Sekunden) für diese Abfragen festzulegen. Protokollvolumen-Histogramm-Abfragen können identifiziert werden`Source=logvolhist`, indem nach Abfragen mit dem HTTP-Header `X-Query-Tags` mit Wert gesucht wird. Diese Header werden von Grafana zu allen Protokollvolumenhistogramm-Abfragen hinzugefügt.

Wenn die Datenquelle das Laden eines Histogramms für das gesamte Protokollvolumen nicht unterstützt, berechnet das Protokollmodell eine Zeitreihe auf der Grundlage der Anzahl der Protokollzeilen, aufgeteilt in ein automatisch berechnetes Zeitintervall, und der Zeitstempel der ersten Protokollzeile verankert dann den Beginn des Histogramms anhand des Ergebnisses. **Das Ende der Zeitreihe ist im Zielbereich der Zeitauswahl verankert.**

**Protokollebene**

Bei Protokollen, bei denen eine Ebenenbezeichnung angegeben ist, verwendet Grafana den Wert der Bezeichnung, um die Protokollebene zu bestimmen und die Farbe entsprechend zu aktualisieren. Wenn für das Protokoll keine Ebenenbezeichnung angegeben ist, versucht es herauszufinden, ob sein Inhalt mit einem der unterstützten Ausdrücke übereinstimmt (weitere Informationen finden Sie unten). Die Protokollebene wird immer durch die erste Übereinstimmung bestimmt. Falls Grafana keinen Log-Level ermitteln kann, wird dieser mit einem unbekannten Log-Level visualisiert.

**Tipp**  
Wenn Sie die Loki-Datenquelle verwenden und die in Ihrer Log-Zeile `level` steht, verwenden Sie Parser (JSON, logfmt, regex,..), um die Level-Informationen in ein Level-Label zu extrahieren, das zur Bestimmung des Log-Levels verwendet wird. Auf diese Weise kann das Histogramm die verschiedenen Log-Levels in separaten Balken anzeigen.

**Unterstützte Protokollebenen und Zuordnung von Abkürzungen und Ausdrücken der Protokollebenen:**


| Unterstützte Ausdrücke | Protokollebene | Farbe | 
| --- | --- | --- | 
| auftauchen | kritisch | lila | 
| tödlich | kritisch | lila | 
| Warnung | kritisch | lila | 
| Krit | kritisch | lila | 
| kritisch | kritisch | lila | 
| irren | error | red | 
| Irrtum | error | red | 
| error | error | red | 
| warnen | warning | Gelb | 
| warning | warning | Gelb | 
| info | info | Grün | 
| Informationen | info | Grün | 
| Notiz | info | Grün | 
| debuggen | debug | Blau | 
| debug | debug | Blau | 
| trace | trace | hellblau | 
| \$1 | unbekannt | grau | 

## Protokolliert die Navigation
<a name="v9-explore-logs-nav"></a>

Die Navigationsoberfläche für Protokolle neben den Protokollzeilen kann verwendet werden, um weitere Protokolle anzufordern. Sie können dies tun, indem Sie unten in der Navigation auf die Schaltfläche **Ältere Protokolle** klicken. Wenn Sie das Zeilenlimit erreicht haben und mehr Logs sehen möchten, können Sie diese Option verwenden, um weitere Logs abzurufen. Jede Anfrage wird in der Navigation als separate Seite angezeigt. Jede Seite zeigt den Von- und Zielzeitstempel der eingehenden Protokollzeilen. Sie können frühere Ergebnisse sehen, indem Sie auf die Seite klicken, um sie anzusehen. Explore speichert die letzten fünf Anfragen, die über die Log-Navigation ausgeführt wurden, im Cache, sodass dieselbe Abfrage nicht erneut ausgeführt wird, wenn Sie auf diese Seiten klicken.

## Optionen für die Visualisierung
<a name="v9-explore-logs-vis-options"></a>

Sie können anpassen, wie Protokolle angezeigt werden, und auswählen, welche Spalten angezeigt werden.

**Time (Zeit)**

Zeigt die Zeitspalte an oder blendet sie aus. Dies ist der Zeitstempel, der der Protokollzeile zugeordnet ist, wie sie von der Datenquelle gemeldet wurde.

**Einzigartige Beschriftungen**

Zeigt die Spalte mit den eindeutigen Bezeichnungen, die nur ungewöhnliche Beschriftungen enthält, an oder blendet sie aus. Alle gängigen Beschriftungen werden oben angezeigt.

**Linien umbrechen**

Setzen Sie diesen Wert auf True, wenn die Anzeige Zeilenumbruch verwenden soll. Wenn der Wert auf False gesetzt ist, führt dies zu horizontalem Scrollen.

**Verschönern Sie JSON**

Stellen Sie dies auf ein, `true` um alle JSON-Protokolle hübsch auszudrucken. Diese Einstellung wirkt sich nicht auf Protokolle in einem anderen Format als JSON aus.

**Deduplizierung**

Protokolldaten können sich sehr wiederholen und Explore kann helfen, indem doppelte Protokollzeilen ausgeblendet werden. Es gibt ein paar verschiedene Deduplizierungsalgorithmen, die Sie verwenden können:
+ **Exakt** — Exakte Übereinstimmungen werden in der gesamten Zeile vorgenommen, mit Ausnahme von Datumsfeldern.
+ **Zahlen** — Treffer in der Zeile, nachdem Zahlen wie Dauer, IP-Adressen usw. entfernt wurden.
+ **Signatur** — Die aggressivste Deduplizierung, bei der alle Buchstaben und Zahlen sowie Übereinstimmungen mit den verbleibenden Leerzeichen und Satzzeichen entfernt werden.

**Reihenfolge der Ergebnisse umkehren**

Sie können die Reihenfolge der empfangenen Protokolle von der standardmäßigen absteigenden Reihenfolge (neueste zuerst) in aufsteigender Reihenfolge (älteste zuerst) ändern.

**Beschriftungen und erkannte Felder**

Jede Protokollzeile verfügt über einen erweiterbaren Bereich mit ihren Beschriftungen und erkannten Feldern, um eine robustere Interaktion zu ermöglichen. Für alle Labels haben wir die Möglichkeit hinzugefügt, nach ausgewählten Labels zu filtern (positiver Filter) und herauszufiltern (negativer Filter). Jedes Feld oder Label hat außerdem ein Statistiksymbol, um Statistiken in Bezug auf alle angezeigten Protokolle anzuzeigen.

**Neuen Zeilen entkommen**

Explore erkennt automatisch einige fehlerhaft maskierte Sequenzen in Protokollzeilen, wie z. B. Zeilenumbrüche (`\n`,`\r`) oder Tabulatoren (). `\t` Wenn es solche Sequenzen erkennt, bietet Explore die Option „Zeilenumbrüche umgehen“.

Explore kann automatisch fehlerhaft maskierte Sequenzen korrigieren, die es erkannt hat

**Um Escape-Sequenzen automatisch zu korrigieren**

1. Wählen Sie **Escape newlines**, um die Sequenzen zu ersetzen.

1. Überprüfen Sie die Ersetzungen manuell, um ihre Richtigkeit zu überprüfen.

Explore ersetzt diese Sequenzen. Wenn dies der Fall ist, ändert sich die Option von **Escape newlines** zu **Remove escaping**. Prüfen Sie die Änderungen, da die Analyse aufgrund der eingegangenen Eingabe möglicherweise nicht korrekt ist. **Sie können die Ersetzungen rückgängig machen, indem Sie Escaping entfernen auswählen.**

**Datenverknüpfungen**

Mithilfe von Datenlinks können Sie jeden Teil einer Protokollnachricht in einen internen oder externen Link umwandeln. Der erstellte Link ist als Schaltfläche im Abschnitt **Links** in der Ansicht mit den **Protokolldetails** sichtbar.

**Schaltet die Sichtbarkeit des Felds um**

Erweitern Sie eine Protokollzeile und klicken Sie auf das Augensymbol, um Felder ein- oder auszublenden.

## Loki-spezifische Funktionen
<a name="v9-explore-logs-loki"></a>

Loki ist das Open-Source-Log-Aggregationssystem von Grafana Labs. Loki ist so konzipiert, dass es kostengünstig ist, da es nicht den Inhalt der Protokolle indexiert, sondern eine Reihe von Labels für jeden Protokollstream. Die Logs von Loki werden auf ähnliche Weise abgefragt wie Abfragen mit Labelselektoren in Prometheus. Es verwendet Labels, um Log-Streams zu gruppieren, die so gestaltet werden können, dass sie mit Ihren Prometheus-Labels übereinstimmen. Weitere Informationen zu Grafana Loki finden Sie auf dem [Grafana Loki Github](https://github.com/grafana/loki).

Weitere Informationen zur Abfrage von Protokolldaten finden Sie unter [Loki](using-loki-in-AMG.md).

**Wechseln Sie von Metriken zu Protokollen**

Wenn Sie von einer Prometheus-Abfrage zu einer Log-Abfrage wechseln (Sie können zuerst eine Aufteilung durchführen, um Ihre Metriken und Logs nebeneinander zu haben), dann werden die Labels Ihrer Abfrage, die in den Logs vorhanden sind, beibehalten und diese zur Abfrage der Log-Streams verwendet. Wenn Sie beispielsweise die folgende Prometheus-Abfrage haben:

```
grafana_alerting_active_alerts{job="grafana"}
```

nach dem Wechsel zur Logs-Datenquelle ändert sie sich zu:

```
{job="grafana"}
```

Dadurch wird ein Teil der Protokolle im ausgewählten Zeitraum zurückgegeben, der durchsucht werden kann.

## Beispiel für Protokolle
<a name="v9-explore-logs-sample"></a>

Wenn die ausgewählte Datenquelle Logs Sample implementiert und sowohl Protokoll- als auch Metrikabfragen unterstützt, können Sie bei Metrikabfragen automatisch Stichproben von Protokollzeilen sehen, die zu visualisierten Metriken beigetragen haben. Diese Funktion wird derzeit von Loki-Datenquellen unterstützt.

**Live-Aufzeichnung**

Verwenden Sie die Live-Tailing-Funktion, um Echtzeitprotokolle zu unterstützten Datenquellen anzuzeigen.

Wählen Sie in der **Explore-Symbolleiste die Live-Schaltfläche**, um zur Live-Tail-Ansicht zu wechseln.

In der Live-Schwanzansicht erscheinen neue Logs vom unteren Bildschirmrand und haben einen verblassenden, kontrastierenden Hintergrund, sodass du den Überblick behalten kannst, was neu ist. Wählen Sie die **Pause-Taste** oder blättern Sie durch die Protokollansicht, um das Live-Tailing zu unterbrechen und frühere Logs ohne Unterbrechung zu erkunden. **Wählen Sie die Schaltfläche „Fortfahren“, um das Live-Tailing fortzusetzen, oder klicken Sie auf die Schaltfläche „**Stopp**“, um das Live-Tailing zu beenden und zur Standardansicht von Explore zurückzukehren.**

# Nachverfolgung in Explore
<a name="v9-explore-tracing"></a>

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

Mit Explore können Sie Spuren aus Tracing-Datenquellen visualisieren.

Die folgenden Datenquellen werden unterstützt.
+ [Jaeger](jaeger-data-source.md)
+ [Tempo](tempo-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

Informationen zur Konfiguration von Abfragen für die oben aufgeführten Datenquellen finden Sie in der Dokumentation für die jeweilige Datenquelle.

## Erklärung von Trace View
<a name="v9-explore-trace-view"></a>

In diesem Abschnitt werden die Elemente des Trace View-Dashboards erklärt.

**Kopfzeile**

Der Header der Trace-Ansicht enthält die folgenden Elemente
+ Header-Titel: Zeigt den Namen des Root-Spans und die Trace-ID an.
+ Suche: Hebt Bereiche hervor, die den gesuchten Text enthalten.
+ Metadaten: Verschiedene Metadaten zum Trace.

**Minimap**

Zeigt eine komprimierte Ansicht oder die Trace-Timeline an. Ziehen Sie den Mauszeiger über die Minimap, um in einen kleineren Zeitbereich zu zoomen. Durch das Zoomen wird auch die Hauptzeitleiste aktualisiert, sodass kürzere Zeiträume leichter zu erkennen sind. Wenn Sie beim Zoomen mit der Maus über die Minikarte fahren, wird die Schaltfläche „Auswahl zurücksetzen“ angezeigt, mit der der Zoom zurückgesetzt wird.

**Zeitplan**

Zeigt eine Liste der Spans innerhalb des Traces an. Jede Span-Zeile besteht aus den folgenden Komponenten:
+ Schaltfläche „Kinder erweitern“: Erweitert oder reduziert alle untergeordneten Bereiche des ausgewählten Bereichs.
+ Dienstname: Name des Dienstes, der den Zeitraum protokolliert hat.
+ Operationsname: Name des Vorgangs, für den dieser Span steht.
+ Balken für die Dauer der Spanne: Visuelle Darstellung der Operationsdauer innerhalb der Ablaufverfolgung.

**Angaben zur Spanne**

Wenn Sie auf eine beliebige Stelle in der Span-Zeile klicken, werden Span-Details angezeigt, darunter die folgenden.
+ Vorgangsname
+ Span-Metadaten
+ Tags: Alle Tags, die mit diesem Bereich verknüpft sind.
+ Prozessmetadaten: Metadaten über den Prozess, der diesen Zeitraum protokolliert hat.
+ Protokolle: Liste der in diesem Bereich protokollierten Protokolle und der zugehörigen Schlüsselwerte. Im Fall von Zipkin-Protokollen werden im Abschnitt Zipkin-Anmerkungen angezeigt.

**Knotendiagramm**

Sie können das Knotendiagramm für die angezeigte Spur optional erweitern. Je nach Datenquelle können dadurch die Bereiche der Ablaufverfolgung als Knoten im Diagramm angezeigt oder zusätzlicher Kontext hinzugefügt werden, einschließlich des auf dem aktuellen Trace basierenden Service-Graphen.

**Zu Protokollen zurückverfolgen**

Sie können in einer Trace-Ansicht von einem Bereich direkt zu den für diesen Bereich relevanten Protokollen navigieren. Dies ist für Tempo-, Jaeger- und Zipkin-Datenquellen verfügbar. Anweisungen zur Konfiguration der einzelnen Datenquellen finden Sie in der entsprechenden Dokumentation.

Klicken Sie auf das Dokumentsymbol, um in Explore eine geteilte Ansicht mit der konfigurierten Datenquelle zu öffnen und die entsprechenden Protokolle für den Zeitraum abzufragen.

## Ansicht „Service Graph“
<a name="v9-explore-trace-graph"></a>

In der Service Graph-Ansicht werden die Span-Metriken (zeichnet Daten für Raten, Fehlerraten und Dauer (RED) auf) und die Service-Diagramme visualisiert. Sobald die Anforderungen eingerichtet sind, ist diese vorkonfigurierte Ansicht sofort verfügbar.

Weitere Informationen finden Sie auf der [Tempo-Datenquellenseite](tempo-data-source.md). Sie können sich auch die [Seite mit der Ansicht des Service-Diagramms](https://grafana.com/docs/tempo/latest/metrics-generator/service-graph-view/) in der *Tempo-Dokumentation* ansehen.

# Inspector in Explore
<a name="v9-explore-inspector"></a>

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

Der Inspektor hilft Ihnen dabei, Ihre Anfragen zu verstehen und Fehler zu beheben. Sie können die Rohdaten überprüfen, diese Daten in eine Datei mit kommagetrennten Werten (CSV) exportieren, Protokollergebnisse im TXT-Format exportieren und Abfrageanfragen anzeigen.

## Inspector UI
<a name="v9-explore-inspector-ui"></a>

Der Inspektor hat die folgenden Registerkarten:
+ **Registerkarte „Statistiken“** — Zeigt an, wie lange Ihre Abfrage dauert und wie viel sie zurückgibt.
+ **Registerkarte „Abfrage“** — Zeigt Ihnen die Anfragen an den Server an, die gesendet wurden, wenn Grafana die Datenquelle abfragt.
+ **Registerkarte JSON** — Ermöglicht das Anzeigen und Kopieren der JSON-Daten und der Datenrahmenstruktur JSON.
+ **Registerkarte „Daten“** — Zeigt die von der Abfrage zurückgegebenen Rohdaten an.
+ **Registerkarte „Fehler“** — Zeigt den Fehler an. Nur sichtbar, wenn die Abfrage einen Fehler zurückgibt.

## Aufgaben des Inspector
<a name="v9-explore-inspector-tasks"></a>

Im Explore-Inspektor können Sie eine Vielzahl von Aufgaben ausführen.

**Öffnen Sie den Inspector**

Nachdem Sie die Abfrage ausgeführt haben, die Sie überprüfen möchten, klicken Sie auf die Schaltfläche **Inspector**.

Der Inspektorbereich wird am unteren Bildschirmrand geöffnet.

*Untersuchen Sie die rohen Abfrageergebnisse*

Sie können unformatierte Abfrageergebnisse, d. h. die von der Abfrage zurückgegebenen Daten, in einer Tabelle anzeigen.

Klicken Sie auf der Registerkarte **Inspector** auf die Registerkarte **Daten**.

Für mehrere Abfragen oder für Abfragen mehrerer Knoten gibt es zusätzliche Optionen.
+ **Datenrahmen anzeigen:** Wählen Sie die Ergebnissatzdaten aus, die Sie anzeigen möchten.
+ **Zeitlich verknüpfte Reihen:** Zeigen Sie die Rohdaten all Ihrer Abfragen gleichzeitig an, ein Ergebnissatz pro Spalte. Sie können auf eine Spaltenüberschrift klicken, um die Daten zu sortieren.

**Laden Sie die unformatierten Abfrageergebnisse als CSV herunter**

Nachdem Sie sich die unformatierten Abfrageergebnisse angesehen haben, können Sie eine CSV-Datei mit den Ergebnissen generieren. Sie erhalten eine CSV-Datei mit dem angezeigten Ergebnis. Stellen Sie daher sicher, dass Sie die Ergebnisse verfeinern, um die gewünschten Ergebnisse zu erhalten, bevor Sie die CSV-Datei generieren.

Um die CSV-Datei zu generieren, wählen Sie auf der Registerkarte **Inspector** die Option **CSV herunterladen** aus.

Um eine CSV-Datei herunterzuladen, die speziell für Excel formatiert ist, erweitern Sie die **Datenoptionen** und aktivieren Sie dann die Option **Für Excel herunterladen**, bevor Sie die Option **CSV herunterladen** auswählen.

*Laden Sie die Protokollergebnisse als TXT herunter*

Sie können eine TXT-Datei mit den Protokollen, die Sie gerade ansehen, generieren, indem Sie auf der Registerkarte **Inspector** die Option **Protokolle herunterladen** auswählen.

**Trace-Ergebnisse herunterladen**

Basierend auf dem Datenquellentyp kann Grafana eine JSON-Datei für die Trace-Ergebnisse in einem der unterstützten Formate generieren: Jaeger-, Zipkin- oder OTLP-Formate.

Um die Traces herunterzuladen, wählen Sie auf der Registerkarte **Inspector** die Option **Traces herunterladen** aus.

**Prüfen Sie die Abfrageleistung**

**Auf der Registerkarte Statistik werden Statistiken angezeigt, aus denen hervorgeht, wie lange Ihre Abfrage dauert, wie viele Abfragen Sie gesendet haben und wie viele Zeilen zurückgegeben wurden.** Diese Informationen können Ihnen bei der Problembehandlung Ihrer Abfragen helfen, insbesondere wenn eine der Zahlen unerwartet hoch oder niedrig ist.

Statistiken sind schreibgeschützt.

**JSON-Modell anzeigen**

Sie können Daten sowie Datenrahmen-JSON-Modelle untersuchen und exportieren.

**Um das JSON-Modell anzuzeigen**

1. Klicken Sie im Inspektorfenster auf die Registerkarte **JSON**.

1. **Wählen Sie im Drop-down-Menü „Quelle** auswählen“ eine der folgenden Optionen aus:
   + **Daten** — Zeigt ein JSON-Objekt an, das die Daten darstellt, die an Explore zurückgegeben wurden.
   + **DataFrame Struktur** — Zeigt den Rohergebnissatz an.

1. Sie können Teile der JSON-Datei erweitern oder reduzieren, um separate Abschnitte anzuzeigen. Sie können auch die Option In die **Zwischenablage kopieren auswählen,** um den JSON-Text zu kopieren und in eine andere Anwendung einzufügen.

**Rohanfrage und Antwort an die Datenquelle anzeigen**

Während Sie mit Explore und der Registerkarte Inspector arbeiten, können Sie die Rohdaten der Anfrage und Antwort anzeigen, die Sie mit einer Abfrage generieren. Wählen Sie im Inspector die Registerkarte „**Abfrage**“ und dann „**Aktualisieren**“, um die Rohdaten zu sehen.

Grafana sendet die Anfrage an den Server und zeigt das Ergebnis an. Sie können bestimmte Teile der Abfrage aufschlüsseln, sie vollständig erweitern oder reduzieren oder die Daten in die Zwischenablage kopieren, um sie in anderen Anwendungen zu verwenden.

# Benachrichtigungen in Grafana-Version 9
<a name="v9-alerts"></a>

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

Grafana-Alerting bietet Ihnen robuste und umsetzbare Warnmeldungen, mit denen Sie sofort nach ihrem Auftreten über Probleme in den Systemen informiert werden können, wodurch Unterbrechungen Ihrer Dienste minimiert werden.

Amazon Managed Grafana bietet Zugriff auf ein aktualisiertes Warnsystem, *Grafana Alerting, das Warninformationen* in einer einzigen, durchsuchbaren Ansicht zentralisiert. Es umfasst die folgenden Funktionen:
+ Erstellen und verwalten Sie Grafana-Benachrichtigungen in einer zentralen Ansicht.
+ Erstellen und verwalten Sie verwaltete Cortex- und Loki-Benachrichtigungen über eine einzige Oberfläche.
+ Zeigen Sie Warninformationen von Prometheus, Amazon Managed Service for Prometheus und anderen AlertManager-kompatiblen Datenquellen an.

Wenn Sie Ihren Amazon Managed Grafana-Workspace erstellen, haben Sie die Wahl, Grafana-Benachrichtigungen zu verwenden oder die. [Klassische Dashboard-Benachrichtigungen](old-alerts-overview.md) In diesem Abschnitt wird die Grafana-Warnung behandelt.

**Anmerkung**  
Wenn Sie Ihren Workspace mit aktivierten klassischen Benachrichtigungen erstellt haben und zu Grafana-Benachrichtigungen wechseln möchten, können Sie [zwischen den beiden Warnsystemen wechseln](v9-alerting-use-grafana-alerts.md). .

## Einschränkungen bei Grafana-Benachrichtigungen
<a name="v9-alert-limitations"></a>
+ Das Grafana-Warnsystem kann Regeln aus allen verfügbaren Amazon Managed Service für Prometheus-, Prometheus-, Loki- und Alertmanager-Datenquellen abrufen. Es ist möglicherweise nicht in der Lage, Regeln aus anderen unterstützten Datenquellen abzurufen.
+ Warnregeln, die in Grafana und nicht in Prometheus definiert sind, senden mehrere Benachrichtigungen an Ihre Kontaktstelle. Wenn Sie native Grafana-Benachrichtigungen verwenden, empfehlen wir, die klassische Dashboard-Warnung beizubehalten und die neue Grafana-Warnfunktion nicht zu aktivieren. Wenn Sie in Ihrer Prometheus-Datenquelle definierte Benachrichtigungen anzeigen möchten, empfehlen wir Ihnen, Grafana Alerting zu aktivieren, das nur eine einzige Benachrichtigung für in Prometheus Alertmanager erstellte Warnungen sendet.
**Anmerkung**  
Diese Einschränkung gilt nicht mehr für Amazon Managed Grafana-Arbeitsbereiche, die Grafana v10.4 und höher unterstützen.

**Topics**
+ [Einschränkungen bei Grafana-Benachrichtigungen](#v9-alert-limitations)
+ [-Übersicht](v9-alerting-overview.md)
+ [Alerting erkunden](v9-alerting-explore.md)
+ [Alerting einrichten](v9-alerting-setup.md)
+ [Migration klassischer Dashboard-Benachrichtigungen zu Grafana-Benachrichtigungen](v9-alerting-use-grafana-alerts.md)
+ [Verwalte deine Alarmregeln](v9-alerting-managerules.md)
+ [Verwalte deine Warnmeldungen](v9-alerting-managenotifications.md)

# -Übersicht
<a name="v9-alerting-overview"></a>

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

Im Folgenden erhalten Sie einen Überblick über die Funktionsweise von Grafana Alerting und stellen Ihnen einige der wichtigsten Konzepte vor, die zusammenarbeiten und den Kern der flexiblen und leistungsstarken Alerting Engine bilden.

1. **Datenquelle**

   Stellt eine Verbindung zu Daten her, die für Alerting verwendet werden sollen. Bei diesen Daten handelt es sich häufig um Zeitreihendaten für Warnmeldungen. Sie zeigen die Details eines Systems, das überwacht und analysiert werden soll. Weitere Informationen finden Sie unter [Datenquellen](AMG-data-sources-builtin.md).

1. **Regeln für Warnmeldungen**

   Legen Sie Bewertungskriterien fest, die bestimmen, ob eine Warnungsinstanz ausgelöst wird. Eine Warnungsregel besteht aus einer oder mehreren Abfragen und Ausdrücken zum Abrufen von Daten aus der Datenquelle, einer Bedingung, die beschreibt, warum eine Warnung erforderlich ist, wie häufig sie ausgewertet wird und optional, für welche Dauer die Bedingung erfüllt sein muss, damit eine Warnung ausgelöst wird.

   Von Grafana verwaltete Benachrichtigungen unterstützen mehrdimensionale Benachrichtigungen, was bedeutet, dass jede Warnungsregel mehrere Warnungsinstanzen erstellen kann. Dies ist besonders leistungsstark, wenn Sie mehrere Serien in einem einzigen Ausdruck beobachten.

1. **Labels**

   Ordnen Sie eine Warnungsregel und ihre Instanzen den Benachrichtigungsrichtlinien und der Stummschaltung zu. Sie können auch verwendet werden, um Ihre Benachrichtigungen nach Schweregrad zu gruppieren.

1. **Richtlinien für Benachrichtigungen**

   Lege fest, wo, wann und wie die Benachrichtigungen weitergeleitet werden, um dein Team zu benachrichtigen, wenn die Warnung ausgelöst wird. Jede Benachrichtigungsrichtlinie gibt eine Reihe von Label-Matchern an, die angeben, für welche Benachrichtigungen sie verantwortlich sind. Einer Benachrichtigungsrichtlinie ist eine Kontaktstelle zugewiesen, die aus einem oder mehreren Meldern besteht.

1. **Kontaktstellen**

   Definieren Sie, wie Ihre Kontakte benachrichtigt werden, wenn eine Warnung ausgelöst wird. Wir unterstützen eine Vielzahl von ChatOps Tools, um sicherzustellen, dass die Benachrichtigungen Ihr Team erreichen.

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

**Eine Seite für alle Benachrichtigungen**

Eine einzige Grafana-Warnseite konsolidiert sowohl von Grafana verwaltete Benachrichtigungen als auch Benachrichtigungen, die sich in Ihrer Promethus-kompatiblen Datenquelle befinden, an einem einzigen Ort.

**Mehrdimensionale Warnmeldungen**

Mit Warnungsregeln können mehrere einzelne Warnungsinstanzen pro Warnungsregel erstellt werden, die als multidimensionale Warnungen bezeichnet werden. So erhalten Sie die Möglichkeit und Flexibilität, mit nur einer einzigen Warnung einen Überblick über Ihr gesamtes System zu erhalten.

**Weiterleitung von Warnmeldungen**

Leiten Sie jede Warnungsinstanz auf der Grundlage der von Ihnen definierten Labels an einen bestimmten Kontaktpunkt weiter. Bei Benachrichtigungsrichtlinien handelt es sich um ein Regelwerk, das festlegt, wo, wann und wie die Benachrichtigungen an Kontaktstellen weitergeleitet werden.

**Warnmeldungen zum Schweigen bringen**

Stummschalten ermöglicht es Ihnen, den Empfang permanenter Benachrichtigungen von einer oder mehreren Warnregeln zu beenden. Sie können eine Warnung auch auf der Grundlage bestimmter Kriterien teilweise pausieren. Für automatische Benachrichtigungen gibt es einen eigenen Bereich, der der besseren Organisation und Sichtbarkeit dient. So können Sie Ihre Regeln für pausierte Alarme überprüfen, ohne dass die Hauptansicht der Warnmeldungen überladen wird.

**Timings stummschalten**

Mit den Zeiten für die Stummschaltung können Sie ein Zeitintervall angeben, in dem keine neuen Benachrichtigungen generiert oder gesendet werden sollen. Sie können Warnmeldungen auch für wiederkehrende Zeiträume einfrieren, z. B. während eines Wartungszeitraums.

# Alerting erkunden
<a name="v9-alerting-explore"></a>

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

Unabhängig davon, ob Sie Ihre Implementierung von Grafana Alerting starten oder erweitern, erfahren Sie mehr über die wichtigsten Konzepte und verfügbaren Funktionen, mit denen Sie Ihre Benachrichtigungen erstellen, verwalten und darauf reagieren und die Fähigkeit Ihres Teams verbessern können, Probleme schnell zu lösen.

Schauen wir uns zunächst die verschiedenen Warnregeltypen an, die Grafana Alerting bietet.

## Arten von Warnungsregeln
<a name="v9-alerting-explore-rule-types"></a>

**Von Grafana verwaltete Regeln**

Von Grafana verwaltete Regeln sind der flexibelste Warnregeltyp. Sie ermöglichen es Ihnen, Warnmeldungen zu erstellen, die auf Daten aus allen von uns unterstützten Datenquellen reagieren können. Neben der Unterstützung mehrerer Datenquellen können Sie auch Ausdrücke hinzufügen, um Ihre Daten zu transformieren und Warnbedingungen festzulegen. Dies ist der einzige Regeltyp, der Warnmeldungen aus mehreren Datenquellen in einer einzigen Regeldefinition ermöglicht.

**Regeln für Mimir und Loki**

Um Mimir- oder Loki-Benachrichtigungen zu erstellen, benötigen Sie eine kompatible Prometheus- oder Loki-Datenquelle. Sie können überprüfen, ob Ihre Datenquelle die Regelerstellung über Grafana unterstützt, indem Sie die Datenquelle testen und beobachten, ob die Ruler-API unterstützt wird.

**Regeln aufzeichnen**

Aufzeichnungsregeln sind nur für kompatible Prometheus- oder Loki-Datenquellen verfügbar. Mit einer Aufzeichnungsregel können Sie häufig benötigte oder rechenintensive Ausdrücke vorab berechnen und deren Ergebnis als neue Zeitreihen speichern. Dies ist nützlich, wenn Sie Warnmeldungen zu aggregierten Daten ausführen möchten oder wenn Sie über Dashboards verfügen, die rechenintensive Ausdrücke wiederholt abfragen.

## Die wichtigsten Konzepte und Funktionen
<a name="v9-alerting-explore-features"></a>

Die folgende Tabelle enthält eine Liste der wichtigsten Konzepte, Funktionen und deren Definitionen, die Ihnen helfen sollen, Grafana Alerting optimal zu nutzen.


| Schlüsselkonzept oder Merkmal | Definition | 
| --- | --- | 
|  Datenquellen für Warnmeldungen  |  Wählen Sie Datenquellen aus, aus denen Sie Metriken, Logs und Traces abfragen und visualisieren möchten.  | 
|  Bereitstellung für Warnmeldungen  |  Verwalten Sie Ihre Alarmressourcen und stellen Sie sie mithilfe von Dateibereitstellung oder Terraform in Ihrem Grafana-System bereit.  | 
|  Alertmanager  |  Verwaltet das Routing und die Gruppierung von Alert-Instanzen.  | 
|  Warnungsregel  |  Eine Reihe von Bewertungskriterien für den Zeitpunkt, an dem eine Warnregel ausgelöst werden soll. Eine Warnungsregel besteht aus einer oder mehreren Abfragen und Ausdrücken, einer Bedingung, der Häufigkeit der Auswertung und der Dauer, über die die Bedingung erfüllt wird. Eine Warnungsregel kann mehrere Warnungsinstanzen erzeugen.  | 
|  Warnungsinstanz  |  Eine Warnungsinstanz ist eine Instanz einer Warnungsregel. Eine eindimensionale Warnungsregel hat eine Warnungsinstanz. Eine mehrdimensionale Warnungsregel hat eine oder mehrere Warnungsinstanzen. Eine einzelne Warnungsregel, die mehreren Ergebnissen entspricht, z. B. CPU gegen 10 VMs, wird als mehrere (in diesem Fall 10) Warnungsinstanzen gezählt. Diese Zahl kann im Laufe der Zeit variieren. Beispielsweise enthält eine Warnungsregel, die die CPU-Auslastung für alle VMs in einem System überwacht, mehr Warnungsinstanzen als hinzugefügt VMs werden. Weitere Informationen über Kontingente für Warnungsinstanzen finden Sie unter. [Fehler beim Erreichen des Kontingents](v9-alerting-managerules-grafana.md#v9-alerting-rule-quota-reached)  | 
|  Warnungsgruppe  |  Der Alertmanager gruppiert Warnungsinstanzen standardmäßig anhand der Bezeichnungen für die Stammbenachrichtigungsrichtlinie. Dadurch werden die Deduplizierung und Gruppen von Warnungsinstanzen gesteuert, die an Kontaktstellen gesendet werden.  | 
|  Kontaktstelle  |  Definieren Sie, wie Ihre Kontakte benachrichtigt werden, wenn eine Warnregel ausgelöst wird.  | 
|  Erstellung von Nachrichtenvorlagen  |  Erstellen Sie wiederverwendbare benutzerdefinierte Vorlagen und verwenden Sie sie in Kontaktpunkten.  | 
|  Benachrichtigungsrichtlinie  |  Regelwerk, das festlegt, wo, wann und wie die Benachrichtigungen gruppiert und an Kontaktstellen weitergeleitet werden.  | 
|  Labels und Label-Matcher  |  Mit Labels lassen sich Warnregeln eindeutig identifizieren. Sie verknüpfen Warnregeln mit Benachrichtigungsrichtlinien und Stummschaltungen und legen fest, welche Richtlinie sie behandeln soll und welche Warnregeln zum Schweigen gebracht werden sollen.  | 
|  Schweigen  |  Stoppt Benachrichtigungen von einer oder mehreren Warnungsinstanzen. Der Unterschied zwischen einer Stille und einer Stummschaltung besteht darin, dass eine Stille nur für ein bestimmtes Zeitfenster andauert, wohingegen eine Stummschaltung dazu gedacht ist, sich nach einem bestimmten Zeitplan zu wiederholen. Verwendet Label-Matcher, um Warnungsinstanzen zum Schweigen zu bringen.  | 
|  Timings stummschalten  |  Geben Sie ein Zeitintervall an, in dem keine neuen Benachrichtigungen generiert oder gesendet werden sollen. Sie können Warnmeldungen auch für wiederkehrende Zeiträume einfrieren, z. B. während eines Wartungszeitraums. Muss mit einer bestehenden Benachrichtigungsrichtlinie verknüpft sein.  | 

# Datenquellen
<a name="v9-alerting-explore-datasources"></a>

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

Es gibt eine Reihe von [Datenquellen](AMG-data-sources-builtin.md), die mit Grafana Alerting kompatibel sind. Jede Datenquelle wird von einem Plugin unterstützt. Sie können eine der unten aufgeführten integrierten Datenquellen verwenden.

Dies sind die Datenquellen, die mit Amazon Managed Grafana kompatibel sind und von Amazon Managed Grafana unterstützt werden.
+ [Stellen Sie eine Connect zu einer AlertManager-Datenquelle her](data-source-alertmanager.md)
+ [Stellen Sie eine Connect zu einer CloudWatch Amazon-Datenquelle her](using-amazon-cloudwatch-in-AMG.md)
+ [Stellen Sie eine Connect zu einer Amazon OpenSearch Service-Datenquelle her](using-Amazon-OpenSearch-in-AMG.md)
+ [Stellen Sie eine Connect zu einer AWS IoT SiteWise Datenquelle her](using-iotsitewise-in-AMG.md)
+ [Stellen Sie eine Connect zu einer AWS IoT TwinMaker Datenquelle her](AMG-iot-twinmaker.md)
+ [Connect zu Amazon Managed Service for Prometheus und Open-Source-Prometheus-Datenquellen her](prometheus-data-source.md)
+ [Stellen Sie eine Connect zu einer Amazon Timestream Timestream-Datenquelle her](timestream-datasource.md)
+ [Stellen Sie eine Connect zu einer Amazon Athena Athena-Datenquelle her](AWS-Athena.md)
+ [Stellen Sie eine Connect zu einer Amazon Redshift Redshift-Datenquelle her](AWS-Redshift.md)
+ [Connect zu einer AWS X-Ray Datenquelle herstellen](x-ray-data-source.md)
+ [Stellen Sie eine Connect zu einer Azure Monitor-Datenquelle her](using-azure-monitor-in-AMG.md)
+ [Stellen Sie eine Connect zu einer Google Cloud Monitoring-Datenquelle her](using-google-cloud-monitoring-in-grafana.md)
+ [Stellen Sie eine Connect zu einer Graphite-Datenquelle her](using-graphite-in-AMG.md)
+ [Stellen Sie eine Connect zu einer InfluxDB-Datenquelle her](using-influxdb-in-AMG.md)
+ [Stellen Sie eine Connect zu einer Loki-Datenquelle her](using-loki-in-AMG.md)
+ [Stellen Sie eine Connect zu einer Microsoft SQL Server-Datenquelle her](using-microsoft-sql-server-in-AMG.md)
+ [Stellen Sie eine Connect zu einer MySQL-Datenquelle her](using-mysql-in-AMG.md)
+ [Stellen Sie eine Connect zu einer OpenTSDB-Datenquelle her](using-opentsdb-in-AMG.md)
+ [Stellen Sie eine Connect zu einer PostgreSQL-Datenquelle her](using-postgresql-in-AMG.md)
+ [Stellen Sie eine Connect zu einer Jaeger-Datenquelle her](jaeger-data-source.md)
+ [Stellen Sie eine Connect zu einer Zipkin-Datenquelle her](zipkin-data-source.md)
+ [Mit einer Tempo-Datenquelle verbinden](tempo-data-source.md)
+ [Konfigurieren Sie eine TestData Datenquelle zum Testen](testdata-data-source.md)

# Über Warnungsregeln
<a name="v9-alerting-explore-rules"></a>

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

Eine Warnregel besteht aus einer Reihe von Bewertungskriterien, die bestimmen, ob eine Warnungsinstanz ausgelöst wird. Die Regel besteht aus einer oder mehreren Abfragen und Ausdrücken, einer Bedingung, der Häufigkeit der Auswertung und optional der Dauer, über die die Bedingung erfüllt wird.

Abfragen und Ausdrücke wählen zwar den Datensatz aus, der ausgewertet werden soll, aber eine Bedingung legt den Schwellenwert fest, den eine Warnung erfüllen oder überschreiten muss, um eine Warnung auszulösen.

Ein Intervall gibt an, wie oft eine Warnregel ausgewertet wird. Die Dauer gibt, sofern konfiguriert, an, wie lange eine Bedingung erfüllt sein muss. Die Warnungsregeln können auch das Warnverhalten bei fehlenden Daten definieren.

**Topics**
+ [Arten von Warnungsregeln](v9-alerting-explore-rules-types.md)
+ [Warnungsinstanzen](v9-alerting-rules-instances.md)
+ [Namespaces und Gruppen](v9-alerting-rules-grouping.md)
+ [Vorlagen für Benachrichtigungen](v9-alerting-rules-notification-templates.md)

# Arten von Warnungsregeln
<a name="v9-alerting-explore-rules-types"></a>

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

Grafana unterstützt mehrere Warnungsregeltypen. In den folgenden Abschnitten werden ihre Vor- und Nachteile erläutert und Sie bei der Auswahl des richtigen Warnungstyps für Ihren Anwendungsfall unterstützt.

Von Grafana verwaltete Regeln

Von Grafana verwaltete Regeln sind der flexibelste Warnregeltyp. Sie ermöglichen es Ihnen, Warnmeldungen zu erstellen, die auf Daten aus jeder Ihrer vorhandenen Datenquellen reagieren können.

Sie unterstützen nicht nur jede Datenquelle, sondern können auch [Ausdrücke](v9-panels-query-xform-expressions.md) hinzufügen, um Ihre Daten zu transformieren und Alarmbedingungen auszudrücken.

Mimir-, Loki- und Cortex-Regeln

Um Mimir-, Loki- oder Cortex-Benachrichtigungen zu erstellen, benötigen Sie eine kompatible Prometheus-Datenquelle. Sie können überprüfen, ob Ihre Datenquelle kompatibel ist, indem Sie die Datenquelle testen und anhand der Details überprüfen, ob die Lineal-API unterstützt wird.

Regeln für die Aufzeichnung

Aufzeichnungsregeln sind nur für kompatible Prometheus-Datenquellen wie Mimir, Loki und Cortex verfügbar.

Eine Aufzeichnungsregel ermöglicht es Ihnen, das Ergebnis eines Ausdrucks in einer neuen Reihe von Zeitreihen zu speichern. Dies ist nützlich, wenn Sie Benachrichtigungen zu aggregierten Daten ausführen möchten oder wenn Sie über Dashboards verfügen, die denselben Ausdruck wiederholt abfragen.

Lesen Sie mehr über die [Aufnahmeregeln](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/) in Prometheus.

# Warnungsinstanzen
<a name="v9-alerting-rules-instances"></a>

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

Von Grafana verwaltete Benachrichtigungen unterstützen mehrdimensionale Benachrichtigungen. Jede Warnungsregel kann mehrere Warnungsinstanzen erstellen. Dies ist besonders nützlich, wenn Sie mehrere Serien in einem einzigen Ausdruck beobachten.

Betrachten Sie den folgenden PromQL-Ausdruck:

```
sum by(cpu) (
  rate(node_cpu_seconds_total{mode!="idle"}[1m])
)
```

Eine Regel, die diesen Ausdruck verwendet, erzeugt so viele Alert-Instanzen, wie CPUs bei der Auswertung beobachtet wurden, sodass eine einzige Regel den Status jeder CPU melden kann.

# Namespaces und Gruppen
<a name="v9-alerting-rules-grouping"></a>

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

Benachrichtigungen können mithilfe von Ordnern für von Grafana verwaltete Regeln und Namespaces für Mimir-, Loki- oder Prometheus-Regeln und Gruppennamen organisiert werden.

**Namespaces**

Bei der Erstellung von von Grafana verwalteten Regeln kann der Ordner verwendet werden, um die Zugriffskontrolle durchzuführen und den Zugriff auf alle Regeln innerhalb eines bestimmten Ordners zu gewähren oder zu verweigern.

**Gruppen**

**Alle Regeln innerhalb einer Gruppe werden im gleichen Intervall ausgewertet.**

Warn- und Aufzeichnungsregeln innerhalb einer Gruppe werden immer **sequentiell** ausgewertet, d. h. Regeln werden nicht gleichzeitig und in der Reihenfolge ihres Auftretens ausgewertet.

**Tipp**  
Wenn Sie möchten, dass Regeln gleichzeitig und mit unterschiedlichen Intervallen ausgewertet werden, sollten Sie sie in verschiedenen Gruppen speichern.

# Vorlagen für Benachrichtigungen
<a name="v9-alerting-rules-notification-templates"></a>

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

Benachrichtigungen, die über Kontaktpunkte gesendet werden, werden mithilfe von Benachrichtigungsvorlagen erstellt. Die Standardvorlagen von Grafana basieren auf dem [Go-Vorlagensystem](https://golang.org/pkg/text/template), bei dem einige Felder als Text ausgewertet werden, während andere als HTML ausgewertet werden (was sich auf die Escape-Funktion auswirken kann).

Die Standardvorlage [default\$1template.go](https://github.com/grafana/alerting/blob/main/templates/default_template.go) ist eine nützliche Referenz für benutzerdefinierte Vorlagen.

Da die meisten Kontaktpunktfelder mit Vorlagen versehen werden können, können Sie wiederverwendbare benutzerdefinierte Vorlagen erstellen und diese in mehreren Kontaktpunkten verwenden. Weitere Informationen zu benutzerdefinierten Benachrichtigungen mithilfe von Vorlagen finden Sie unter[Benachrichtigungen anpassen](v9-alerting-notifications.md).

**Verschachtelte Vorlagen**

Sie können Vorlagen in andere Vorlagen einbetten.

Sie können beispielsweise ein Vorlagenfragment mithilfe des `define` Schlüsselworts definieren.

```
{{ define "mytemplate" }}
  {{ len .Alerts.Firing }} firing. {{ len .Alerts.Resolved }} resolved.
{{ end }}
```

Anschließend können Sie mithilfe des `template` Schlüsselworts benutzerdefinierte Vorlagen in dieses Fragment einbetten. Beispiel:

```
Alert summary:
{{ template "mytemplate" . }}
```

Sie können jede der folgenden integrierten Vorlagenoptionen verwenden, um benutzerdefinierte Vorlagen einzubetten.


| Name | Hinweise | 
| --- | --- | 
|  `default.title`  |  Zeigt Statusinformationen auf hoher Ebene an.  | 
|  `default.message`  |  Stellt eine formatierte Zusammenfassung der ausgelösten und gelösten Alarme bereit.  | 
|  `teams.default.message`  |  Ähnlich wie`default.messsage`, formatiert für Microsoft Teams.  | 

**HTML in Benachrichtigungsvorlagen**

HTML in Vorlagen für Warnmeldungen ist maskiert. Wir unterstützen das Rendern von HTML in der resultierenden Benachrichtigung nicht.

Einige Notifier unterstützen alternative Methoden zur Änderung des Erscheinungsbilds der resultierenden Benachrichtigung. Grafana installiert beispielsweise die Basisvorlage für Benachrichtigungen per E-Mail. `<grafana-install-dir>/public/emails/ng_alert_notification.html` Sie können diese Datei bearbeiten, um das Erscheinungsbild aller Warn-E-Mails zu ändern.

# Warnmeldungen bei numerischen Daten
<a name="v9-alerting-explore-numeric"></a>

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

In diesem Thema wird beschrieben, wie Grafana mit Benachrichtigungen bei numerischen Daten und nicht bei Zeitreihendaten umgeht.

Bei bestimmten Datenquellen können numerische Daten, bei denen es sich nicht um Zeitreihen handelt, direkt gemeldet oder an Server Side Expressions (SSE) übergeben werden. Dies ermöglicht eine bessere Verarbeitung und damit eine höhere Effizienz innerhalb der Datenquelle und kann auch die Warnungsregeln vereinfachen. Bei Warnmeldungen für numerische Daten anstelle von Zeitreihendaten ist es nicht erforderlich, jede beschriftete Zeitreihe auf eine einzelne Zahl zu reduzieren. Stattdessen werden beschriftete Zahlen stattdessen an Grafana zurückgegeben.

**Tabellarische Daten**

Diese Funktion wird bei Backend-Datenquellen unterstützt, die Tabellendaten abfragen:
+ SQL-Datenquellen wie MySQL, Postgres, MSSQL und Oracle.
+ Die auf Azure Kusto basierenden Dienste: Azure Monitor (Logs), Azure Monitor (Azure Resource Graph) und Azure Data Explorer.

Eine Abfrage mit von Grafana verwalteten Benachrichtigungen oder SSE wird bei diesen Datenquellen als numerisch betrachtet, wenn:
+ Die Option „Format AS“ ist in der Datenquellenabfrage auf „Tabelle“ eingestellt.
+ Die von der Abfrage an Grafana zurückgegebene Tabellenantwort enthält nur eine numerische Spalte (z. B. int, double, float) und optional zusätzliche Zeichenkettenspalten.

Wenn es Zeichenkettenspalten gibt, werden diese Spalten zu Beschriftungen. Der Name der Spalte wird zum Labelnamen, und der Wert für jede Zeile wird zum Wert der entsprechenden Bezeichnung. Wenn mehrere Zeilen zurückgegeben werden, sollte jede Zeile mit ihren Beschriftungen eindeutig identifiziert werden.

**Beispiel**

Für eine MySQL-Tabelle namens „DiskSpace“:


| Zeit | Host | Festplatte | PercentFree | 
| --- | --- | --- | --- | 
|  2021-Juni-7  |  Netz 1  |  /usw  |  3  | 
|  2021-Juni-7  |  Netz 2  |  /var  |  4  | 
|  2021-Juni-7  |  Netz 3  |  /var  |  8  | 
|  ...  |  ...  |  ...  |  ...  | 

Sie können die Datenfilterung rechtzeitig abfragen, ohne jedoch die Zeitreihe an Grafana zurückzugeben. Zum Beispiel eine Warnung, die pro Host und Festplatte ausgelöst wird, wenn weniger als 5% freier Speicherplatz zur Verfügung steht:

```
SELECT Host , Disk , CASE WHEN PercentFree  < 5.0 THEN PercentFree  ELSE 0 END FROM ( 
   SELECT
      Host, 
      Disk, 
      Avg(PercentFree) 
   FROM DiskSpace
   Group By
      Host, 
      Disk 
   Where __timeFilter(Time)
```

Diese Abfrage gibt die folgende Tabellenantwort an Grafana zurück:


| Host | Festplatte | PercentFree | 
| --- | --- | --- | 
|  web1  |  /usw  |  3  | 
|  web2  |  /var  |  4  | 
|  web3  |  /var  |  0  | 

Wenn diese Abfrage als **Bedingung** in einer Warnungsregel verwendet wird, wird ein Wert ungleich Null als Warnung verwendet. Infolgedessen werden drei Warnungsinstanzen erzeugt:


| Labels | Status | 
| --- | --- | 
|  \$1host=WEB1, DISK=/etc\$1  |  Warnfunktion  | 
|  \$1Host=Web2, Festplatte=/var\$1  |  Warnfunktion  | 
|  \$1host=WEB3, Festplatte=/var\$1  |  Normal  | 

# Beschriftungen und Anmerkungen
<a name="v9-alerting-explore-labels"></a>

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

Beschriftungen und Anmerkungen enthalten Informationen zu einer Warnung. Sowohl Beschriftungen als auch Anmerkungen haben dieselbe Struktur: eine Reihe benannter Werte; ihre Verwendungszwecke sind jedoch unterschiedlich. Ein Beispiel für eine Bezeichnung oder eine entsprechende Anmerkung könnte sein`alertname="test"`.

Der Hauptunterschied zwischen einer Bezeichnung und einer Anmerkung besteht darin, dass Beschriftungen verwendet werden, um eine Warnung von allen anderen Warnungen zu unterscheiden, während Anmerkungen dazu verwendet werden, einer vorhandenen Warnung zusätzliche Informationen hinzuzufügen.

Stellen Sie sich zum Beispiel zwei Warnmeldungen mit hohem CPU-Wert vor: eine für `server1` und eine weitere für`server2`. In einem solchen Beispiel könnten wir eine Bezeichnung haben, `server` bei der die erste Warnung die Bezeichnung `server="server1"` und die zweite Warnung die Bezeichnung trägt`server="server2"`. Möglicherweise möchten wir jedoch auch jeder Warnung eine Beschreibung hinzufügen`"The CPU usage for server1 is above 75%."`, z. B. wo `server1` und `75%` werden durch den Namen und die CPU-Auslastung des Servers ersetzt (Informationen dazu finden Sie in der Dokumentation). [Vorlagen für Beschriftungen und Anmerkungen erstellen](v9-alerting-explore-labels-templating.md) Diese Art von Beschreibung wäre besser als Anmerkung geeignet.

## Labels
<a name="v9-alerting-explore-labels-labels"></a>

Beschriftungen enthalten Informationen, anhand derer eine Warnung identifiziert werden kann. Ein Beispiel für ein Etikett könnte sein`server=server1`. Jede Warnung kann mehr als ein Label haben, und der komplette Satz von Labels für eine Warnung wird als Labelsatz bezeichnet. Es ist dieser Labelsatz, der die Warnung identifiziert.

Beispielsweise kann für eine Warnung die Bezeichnung festgelegt sein, `{alertname="High CPU usage",server="server1"}` während für eine andere Warnung die Bezeichnung festgelegt sein könnte`{alertname="High CPU usage",server="server2"}`. Dabei handelt es sich um zwei separate Benachrichtigungen, da ihre `alertname` Beschriftungen zwar identisch sind, ihre `server` Beschriftungen jedoch unterschiedlich sind.

Die für eine Warnung festgelegte Bezeichnung ist eine Kombination aus den Bezeichnungen aus der Datenquelle, benutzerdefinierten Bezeichnungen aus der Warnungsregel und einer Reihe von reservierten Bezeichnungen wie. `alertname`

**Benutzerdefinierte Beschriftungen**

Benutzerdefinierte Beschriftungen sind zusätzliche Beschriftungen aus der Warnungsregel. Wie Anmerkungen müssen benutzerdefinierte Beschriftungen einen Namen haben, und ihr Wert kann eine Kombination aus Text und Vorlagencode enthalten, der ausgewertet wird, wenn eine Warnung ausgelöst wird. Eine Dokumentation zur Erstellung von Vorlagen für benutzerdefinierte Beschriftungen finden Sie [hier.](v9-alerting-explore-labels-templating.md)

Wenn Sie benutzerdefinierte Beschriftungen mit Vorlagen verwenden, müssen Sie sicherstellen, dass sich der Labelwert zwischen aufeinanderfolgenden Auswertungen der Warnmeldungsregel nicht ändert, da dies zu einer großen Anzahl unterschiedlicher Benachrichtigungen führen kann. Es ist jedoch in Ordnung, wenn die Vorlage unterschiedliche Labelwerte für verschiedene Warnungen erzeugt. Fügen Sie den Wert der Abfrage beispielsweise nicht in ein benutzerdefiniertes Label ein, da dadurch bei jeder Änderung des Werts ein neuer Satz von Benachrichtigungen erstellt wird. Verwenden Sie stattdessen Anmerkungen.

Es ist auch wichtig sicherzustellen, dass das für eine Warnung festgelegte Label nicht zwei oder mehr Labels mit demselben Namen enthält. Wenn ein benutzerdefiniertes Label denselben Namen wie ein Label aus der Datenquelle hat, wird es dieses Label ersetzen. Sollte ein benutzerdefiniertes Label jedoch denselben Namen wie ein reserviertes Label haben, wird das benutzerdefinierte Label in der Warnung weggelassen.

## Anmerkungen
<a name="v9-alerting-explore-labels-annotations"></a>

Bei Anmerkungen handelt es sich um benannte Paare, die vorhandenen Warnungen zusätzliche Informationen hinzufügen. In Grafana gibt es eine Reihe von vorgeschlagenen Anmerkungen wie`description`, `summary``runbook_url`, `dashboardUId` und. `panelId` Wie benutzerdefinierte Beschriftungen müssen Anmerkungen einen Namen haben, und ihr Wert kann eine Kombination aus Text und Vorlagencode enthalten, die ausgewertet wird, wenn eine Warnung ausgelöst wird. Wenn eine Anmerkung Vorlagencode enthält, wird die Vorlage einmal ausgewertet, wenn die Warnung ausgelöst wird. Sie wird nicht erneut bewertet, auch wenn die Warnung behoben ist. [Eine Dokumentation zur Erstellung von Vorlagen für Anmerkungen finden Sie hier.](v9-alerting-explore-labels-templating.md)

# So funktioniert der Labelabgleich
<a name="v9-alerting-explore-labels-matching"></a>

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

Verwenden Sie Labels und Label-Matcher, um Warnungsregeln mit Benachrichtigungsrichtlinien und Stummschalten zu verknüpfen. Auf diese Weise können Sie Ihre Warnungsinstanzen sehr flexibel verwalten und festlegen, welche Richtlinie sie behandeln soll und welche Alarme ausgeblendet werden sollen.

Ein Label-Matcher besteht aus drei verschiedenen Teilen: dem **Label**, dem **Wert** und dem **Operator**.
+ Das **Label-Feld** ist der Name der Bezeichnung, der zugeordnet werden soll. Es muss genau mit dem Labelnamen übereinstimmen.
+ Das **Wertfeld** stimmt mit dem entsprechenden Wert für den angegebenen **Labelnamen** überein. Wie es übereinstimmt, hängt vom **Operator-Wert** ab.
+ Das Feld **Operator** ist der Operator, der mit dem Labelwert verglichen werden soll. Die verfügbaren Operatoren sind:


| Operator | Description | 
| --- | --- | 
|  `=`  |  Wählen Sie Beschriftungen aus, die genau dem Wert entsprechen.  | 
|  `!=`  |  Wählen Sie Beschriftungen aus, die nicht dem Wert entsprechen.  | 
|  `=~`  |  Wählen Sie Beschriftungen aus, die dem Wert im Regex-Format entsprechen.  | 
|  `!~`  |  Wählen Sie Beschriftungen aus, die nicht mit dem Regex-Wert übereinstimmen.  | 

Wenn Sie mehrere Label-Matcher verwenden, werden sie mit dem logischen Operator AND kombiniert. Das bedeutet, dass alle Matcher übereinstimmen müssen, um eine Regel mit einer Richtlinie zu verknüpfen.

**Beispielszenario**

Wenn Sie den folgenden Satz von Bezeichnungen für Ihre Warnung definieren:

```
{ foo=bar, baz=qux, id=12 }
```

dann:
+ Ein Label-Matcher, der als definiert ist, `foo=bar` entspricht dieser Warnungsregel.
+ Ein Label-Matcher, der als definiert ist, entspricht `foo!=bar` *nicht* dieser Warnungsregel.
+ Ein Label-Matcher, der als definiert ist, `id=~[0-9]+` entspricht dieser Warnungsregel.
+ Ein Label-Matcher, der als definiert ist, `baz!~[0-9]+` entspricht dieser Warnungsregel.
+ Zwei Label-Matcher, die als definiert sind `foo=bar` und dieser Warnungsregel `id=~[0-9]+` entsprechen.

# Etiketten in Grafana-Benachrichtigungen
<a name="v9-alerting-explore-labels-alerting"></a>

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

In diesem Thema wird erklärt, warum Beschriftungen ein grundlegender Bestandteil von Warnmeldungen sind.
+ Der vollständige Satz von Bezeichnungen für eine Warnung identifiziert eine Warnung innerhalb von Grafana-Benachrichtigungen eindeutig.
+ Der Alertmanager verwendet Labels, um Alerts für Stummmeldungen und Warnungsgruppen in den Benachrichtigungsrichtlinien zuzuordnen.
+ In der Benutzeroberfläche für Warnmeldungen werden Beschriftungen für jede Warnungsinstanz angezeigt, die bei der Auswertung dieser Regel generiert wurde.
+ Kontaktstellen können auf Labels zugreifen, um dynamisch Benachrichtigungen zu generieren, die spezifische Informationen zu der Warnung enthalten, die zu einer Benachrichtigung führt.
+ Sie können einer [Warnregel](v9-alerting-managerules.md) Labels hinzufügen. Beschriftungen können manuell konfiguriert werden, verwenden Vorlagenfunktionen und können auf andere Beschriftungen verweisen. Zu einer Warnregel hinzugefügte Labels haben im Falle einer Kollision zwischen Labels Vorrang (außer im Fall von reservierten Grafana-Labels, weitere Informationen finden Sie weiter unten).

**Kompatibilität mit externem Alertmanager**

Der integrierte Alertmanager von Grafana unterstützt sowohl Unicode-Labelschlüssel als auch Werte. [Wenn Sie einen externen Prometheus Alertmanager verwenden, müssen die Labelschlüssel mit ihrem Datenmodell kompatibel sein.](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels) **Das bedeutet, dass Labelschlüssel nur **ASCII-Buchstaben**, **Zahlen** sowie Unterstriche enthalten dürfen und der Regex entsprechen dürfen.** `[a-zA-Z_][a-zA-Z0-9_]*` Alle ungültigen Zeichen werden von der Grafana-Alerting Engine entfernt oder ersetzt, bevor sie gemäß den folgenden Regeln an den externen Alertmanager gesendet werden:
+ `Whitespace`wird entfernt.
+ `ASCII characters`wird ersetzt durch`_`.
+ `All other characters`wird durch ihre Hexadezimaldarstellung in Kleinbuchstaben ersetzt. Wenn dies das erste Zeichen ist, wird ihm ein Präfix vorangestellt. `_`

**Anmerkung**  
Wenn mehrere Labelschlüssel auf denselben Wert bereinigt werden, wird an die Duplikate ein kurzer Hash des ursprünglichen Labels als Suffix angehängt.

**Grafana reservierte Labels**

**Anmerkung**  
Etiketten mit dem Präfix `grafana_` sind von Grafana für spezielle Zwecke reserviert. Wenn ein manuell konfiguriertes Label hinzugefügt wird, kann `grafana_` es im Kollisionsfall überschrieben werden.

Reservierte Grafana-Labels können genauso verwendet werden wie manuell konfigurierte Labels. Die aktuelle Liste der verfügbaren reservierten Labels lautet:


| Label (Bezeichnung) | Description | 
| --- | --- | 
|  grafana\$1folder  |  Titel des Ordners, der die Warnung enthält.  | 

# Vorlagen für Beschriftungen und Anmerkungen erstellen
<a name="v9-alerting-explore-labels-templating"></a>

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

In Grafana erstellen Sie Vorlagen für Beschriftungen und Anmerkungen, genau wie in Prometheus. Wenn Sie Prometheus schon einmal verwendet haben, sollten Sie mit den `$value` Variablen `$labels` und vertraut sein, die die Bezeichnungen und den Wert der Warnung enthalten. Sie können dieselben Variablen in Grafana verwenden, auch wenn die Warnung keine Prometheus-Datenquelle verwendet. Wenn Sie Prometheus noch nicht verwendet haben, machen Sie sich keine Sorgen, denn jede dieser Variablen und wie Sie sie als Vorlage verwenden, wird im weiteren Verlauf dieser Seite erklärt.

## Die Vorlagensprache von Go
<a name="v9-alerting-explore-labels-templating-go"></a>

[Vorlagen für Beschriftungen und Anmerkungen sind in der Vorlagensprache von Go, Text/Vorlage, geschrieben.](https://pkg.go.dev/text/template)

**Tags öffnen und schließen**

In text/template beginnen `{{` und enden Vorlagen mit, `}}` unabhängig davon, ob die Vorlage eine Variable druckt oder Kontrollstrukturen wie if-Anweisungen ausführt. Dies unterscheidet sich von anderen Template-Sprachen wie Jinja, wo das Drucken einer Variablen und und `{{` Kontrollstrukturen `}}` und verwenden. `{%` `%}`

**Print (Ausgabe)**

Um den Wert von etwas zu drucken, verwende `{{` und. `}}` Sie können das Ergebnis einer Funktion oder den Wert einer Variablen drucken. Um beispielsweise die `$labels` Variable zu drucken, würden Sie Folgendes schreiben:

```
{{ $labels }}
```

**Iterieren Sie über Beschriftungen**

Um über jedes Etikett zu iterieren, können `$labels` Sie a verwenden. `range` `$k`Bezieht sich hier auf den Namen und `$v` bezieht sich auf den Wert des aktuellen Labels. Wenn Ihre Abfrage beispielsweise ein Label zurückgibt, `instance=test` dann `$k` wäre `instance` und `$v` wäre es`test`.

```
{{ range $k, $v := $labels }}
{{ $k }}={{ $v }}
{{ end }}
```

## Die Variablen Labels, Value und Values
<a name="v9-alerting-explore-labels-templating-variables"></a>

**Die Bezeichnungsvariable**

Die `$labels` Variable enthält die Labels aus der Abfrage. Beispielsweise kann eine Abfrage, die prüft, ob eine Instanz ausgefallen ist, ein Instanzlabel mit dem Namen der Instanz zurückgeben, die ausgefallen ist. Nehmen wir beispielsweise an, Sie haben eine Warnungsregel, die ausgelöst wird, wenn eine Ihrer Instances länger als 5 Minuten ausgefallen ist. Sie möchten der Warnung eine Zusammenfassung hinzufügen, die Ihnen mitteilt, welche Instanz ausgefallen ist. Mit der `$labels` Variablen können Sie eine Zusammenfassung erstellen, die das Instanzlabel in der Zusammenfassung ausgibt:

```
Instance {{ $labels.instance }} has been down for more than 5 minutes
```

**Beschriftungen mit Punkten**

Wenn das Etikett, das Sie drucken möchten, einen Punkt (Punkt oder Punkt) im Namen enthält, funktioniert die Verwendung desselben Punktes in der Vorlage nicht:

```
Instance {{ $labels.instance.name }} has been down for more than 5 minutes
```

Das liegt daran, dass die Vorlage versucht, ein nicht vorhandenes `name` aufgerufenes `$labels.instance` Feld zu verwenden. Sie sollten stattdessen die `index` Funktion verwenden, die das Etikett `instance.name` in der `$labels` Variablen druckt:

```
Instance {{ index $labels "instance.name" }} has been down for more than 5 minutes
```

**Die Wertvariable**

Die `$value` Variable funktioniert anders als Prometheus. In Prometheus `$value` ist es eine Fließkommazahl, die den Wert des Ausdrucks enthält, aber in Grafana ist es eine Zeichenfolge, die die Bezeichnungen und Werte aller Threshold-, Reduce- und Math-Ausdrücke sowie der klassischen Bedingungen für diese Warnregel enthält. Sie enthält keine Ergebnisse von Abfragen, da diese zwischen 10 und 10.000 Zeilen oder Metriken zurückgeben können.

Wenn Sie die `$value` Variable in der Zusammenfassung einer Warnung verwenden würden:

```
{{ $labels.service }} has over 5% of responses with 5xx errors: {{ $value }})
```

Die Zusammenfassung könnte etwa wie folgt aussehen:

```
api has an over 5% of responses with 5xx errors: [ var='B' labels={service=api} value=6.789 ]
```

`var='B'`Bezieht sich hier auf den Ausdruck mit der Referenznummer B. In Grafana werden alle Abfragen und Ausdrücke durch eine RefID identifiziert, die jede Abfrage und jeden Ausdruck in einer Alert-Regel identifiziert. `labels={service=api}`Bezieht sich in ähnlicher Weise auf die Bezeichnungen und `value=6.789` bezieht sich auf den Wert.

Möglicherweise haben Sie festgestellt, dass es keine Referenznummer A gibt. Das liegt daran, dass sich die Referenznummer A in den meisten Warnungsregeln auf eine Abfrage bezieht und dass Abfragen viele Zeilen oder Zeitreihen zurückgeben können, in denen sie nicht enthalten sind. `$value`

**Die Werte sind variabel**

Wenn die `$value` Variable mehr Informationen enthält, als Sie benötigen, können Sie stattdessen die Bezeichnungen und den Wert einzelner Ausdrücke mit drucken`$values`. Im `$value` Gegensatz dazu handelt es sich bei der `$values` Variablen um eine Tabelle mit Objekten, die die Bezeichnungen und Fließkommawerte jedes Ausdrucks enthält, die anhand ihrer Referenznummer indexiert sind.

Wenn Sie den Wert des Ausdrucks mit refID `B` in der Zusammenfassung der Warnung drucken würden:

```
{{ $labels.service }} has over 5% of responses with 5xx errors: {{ $values.B }}%
```

Die Zusammenfassung enthält nur den Wert:

```
api has an over 5% of responses with 5xx errors: 6.789%
```

Obwohl die Zahl 6,789 `{{ $values.B }}` gedruckt wird, handelt es sich tatsächlich um eine Zeichenfolge, da Sie das Objekt drucken, das sowohl die Beschriftungen als auch den Wert für Referenznummer B enthält, nicht den Fließkommawert von B. Um den Fließkommawert von Referenz B zu verwenden, müssen Sie das Feld von verwenden. `Value` `$values.B` Wenn Sie den Fließkommawert in der Zusammenfassung einer Warnung humanisieren würden:

```
{{ $labels.service }} has over 5% of responses with 5xx errors: {{ humanize $values.B.Value }}%
```

**Keine Daten, Laufzeitfehler und Timeouts**

Wenn die Abfrage in Ihrer Warnungsregel keine Daten zurückgibt oder aufgrund eines Datenquellenfehlers oder einer Zeitüberschreitung fehlschlägt, geben alle Threshold-, Reduce- oder Math-Ausdrücke, die diese Abfrage verwenden, ebenfalls keine Daten oder einen Fehler zurück. In diesem Fall fehlen diese Ausdrücke in. `$values` Es empfiehlt sich, vor der Verwendung zu überprüfen, ob eine RefID vorhanden ist, da Ihre Vorlage sonst beschädigt wird, wenn Ihre Abfrage keine Daten oder einen Fehler zurückgibt. Sie können dies mit einer if-Anweisung tun:

```
{{ if $values.B }}{{ $labels.service }} has over 5% of responses with 5xx errors: {{ humanizePercentage $values.B.Value }}{{ end }}
```

## Klassische Bedingungen
<a name="v9-alerting-explore-labels-templating-classic"></a>

Wenn die Regel klassische Bedingungen anstelle von Threshold-, Reduce- und Math-Ausdrücken verwendet, wird die `$values` Variable sowohl anhand der Referenz-ID als auch anhand der Position der Bedingung in der klassischen Bedingung indexiert. Wenn Sie beispielsweise eine klassische Bedingung mit RefID B haben, die zwei Bedingungen enthält, `$values` dann enthält sie zwei Bedingungen `B0` und. `B1`

```
The first condition is {{ $values.B0 }}, and the second condition is {{ $values.B1 }}
```

## Funktionen
<a name="v9-alerting-explore-labels-templating-functions"></a>

Die folgenden Funktionen sind auch verfügbar, wenn Beschriftungen und Anmerkungen erweitert werden:

**Argumente**

Die `args` Funktion übersetzt eine Liste von Objekten in eine Map mit den Schlüsseln arg0, arg1 usw. Dies soll die Übergabe mehrerer Argumente an Vorlagen ermöglichen.

**Beispiel**

```
{{define "x"}}{{.arg0}} {{.arg1}}{{end}}{{template "x" (args 1 "2")}}
```

```
1 2
```

**Externe URL**

Die `externalURL` Funktion gibt die externe URL des Grafana-Servers zurück, wie sie in der (den) INI-Datei (en) konfiguriert ist.

**Beispiel**

```
{{ externalURL }}
```

```
https://example.com/grafana
```

**GraphLink**

Die `graphLink` Funktion gibt den Pfad zur grafischen Ansicht [Erkunden Sie in Grafana-Version 9](v9-explore.md) für den angegebenen Ausdruck und die angegebene Datenquelle zurück.

**Beispiel**

```
{{ graphLink "{\"expr\": \"up\", \"datasource\": \"gdev-prometheus\"}" }}
```

```
/explore?left=["now-1h","now","gdev-prometheus",{"datasource":"gdev-prometheus","expr":"up","instant":false,"range":true}]
```

**humanisieren**

Die `humanize` Funktion humanisiert Dezimalzahlen.

**Beispiel**

```
{{ humanize 1000.0 }}
```

```
1k
```

**humanisieren1024**

Das `humanize1024` funktioniert ähnlich wie, verwendet `humanize` aber 1024 statt 1000 als Basis.

**Beispiel**

```
{{ humanize1024 1024.0 }}
```

```
1ki
```

**Dauer humanisieren**

Die `humanizeDuration` Funktion humanisiert eine Dauer in Sekunden.

**Beispiel**

```
{{ humanizeDuration 60.0 }}
```

```
1m 0s
```

**Prozentsatz humanisieren**

Die `humanizePercentage` Funktion humanisiert einen Verhältniswert zu einem Prozentsatz.

**Beispiel**

```
{{ humanizePercentage 0.2 }}
```

```
20%
```

**HumanizeTimestamp**

Die `humanizeTimestamp` Funktion humanisiert einen Unix-Zeitstempel.

**Beispiel**

```
{{ humanizeTimestamp 1577836800.0 }}
```

```
2020-01-01 00:00:00 +0000 UTC
```

**Spiel**

Die `match` Funktion gleicht den Text mit einem regulären Ausdrucksmuster ab.

**Beispiel**

```
{{ match "a.*" "abc" }}
```

```
true
```

**Pfad/Präfix**

Die `pathPrefix` Funktion gibt den Pfad des Grafana-Servers zurück, wie er in der (den) INI-Datei (en) konfiguriert ist.

**Beispiel**

```
{{ pathPrefix }}
```

```
/grafana
```

**TableLink**

Die `tableLink` Funktion gibt den Pfad zur Tabellenansicht [Erkunden Sie in Grafana-Version 9](v9-explore.md) für den angegebenen Ausdruck und die angegebene Datenquelle zurück.

**Beispiel**

```
{{ tableLink "{\"expr\": \"up\", \"datasource\": \"gdev-prometheus\"}" }}
```

```
/explore?left=["now-1h","now","gdev-prometheus",{"datasource":"gdev-prometheus","expr":"up","instant":true,"range":false}]
```

**Titel**

Die `title` Funktion schreibt das erste Zeichen jedes Worts groß.

**Beispiel**

```
{{ title "hello, world!" }}
```

```
Hello, World!
```

**toLower**

Die `toLower` Funktion gibt den gesamten Text in Kleinbuchstaben zurück.

**Beispiel**

```
{{ toLower "Hello, world!" }}
```

```
hello, world!
```

**toUpper**

Die `toUpper` Funktion gibt den gesamten Text in Großbuchstaben zurück.

**Beispiel**

```
{{ toUpper "Hello, world!" }}
```

```
HELLO, WORLD!
```

**reReplaceAll**

Die `reReplaceAll` Funktion ersetzt Text, der dem regulären Ausdruck entspricht.

**Beispiel**

```
{{ reReplaceAll "localhost:(.*)" "example.com:$1" "localhost:8080" }}
```

```
example.com:8080
```

# Stand und Zustand der Warnregeln
<a name="v9-alerting-explore-state"></a>

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

Der Status und die Integrität von Warnregeln helfen Ihnen dabei, mehrere wichtige Statusindikatoren Ihrer Benachrichtigungen zu verstehen.

Es gibt drei Hauptkomponenten: den *Status der Warnungsregel, den Status der* *Warnungsinstanz und den Zustand* *der Warnungsregel*. Obwohl sie miteinander verwandt sind, vermittelt jede Komponente subtil unterschiedliche Informationen.

**Status der Warnungsregel**

Eine Warnungsregel kann sich in einem der folgenden Zustände befinden:


| Status | Description | 
| --- | --- | 
|  Normal  |  Keine der von der Evaluierungs-Engine zurückgegebenen Zeitreihen hat den `Firing` Status „`Pending`Oder“.  | 
|  Ausstehend  |  Mindestens eine von der Evaluierungs-Engine zurückgegebene Zeitreihe ist`Pending`.  | 
|  Wird gefeuert  |  Mindestens eine von der Evaluierungs-Engine zurückgegebene Zeitreihe ist`Firing`.  | 

**Anmerkung**  
Warnmeldungen werden zuerst zu `pending` und dann `firing` weitergeleitet. Daher dauert es mindestens zwei Bewertungszyklen, bis eine Warnung ausgelöst wird.

**Status der Warnungsinstanz**

Eine Warnungsinstanz kann sich in einem der folgenden Zustände befinden:


| Status | Description | 
| --- | --- | 
|  Normal  |  Der Status einer Warnung, die weder ausgelöst noch aussteht. Alles funktioniert einwandfrei.  | 
|  Ausstehend  |  Der Status einer Warnung, die für weniger als die konfigurierte Schwellenwertdauer aktiv war.  | 
|  Warnfunktion  |  Der Status einer Warnung, die länger als die konfigurierte Schwellenwertdauer aktiv war.  | 
|  NoData  |  Für das konfigurierte Zeitfenster wurden keine Daten empfangen.  | 
|  Fehler  |  Der Fehler, der beim Versuch, eine Warnregel auszuwerten, aufgetreten ist.  | 

**Zustand der Warnmeldungsregel**

Eine Warnungsregel kann einen der folgenden Integritätsstatus haben:


| Status | Description | 
| --- | --- | 
|  OK  |  Bei der Auswertung einer Warnregel ist kein Fehler aufgetreten.  | 
|  Fehler  |  Bei der Auswertung einer Warnregel ist ein Fehler aufgetreten.  | 
|  NoData  |  Das Fehlen von Daten in mindestens einer Zeitreihe, die während einer Regelauswertung zurückgegeben wurde.  | 

**Besondere Warnmeldungen für `NoData` und `Error`**

Wenn die Auswertung einer Warnregel den Status `NoData` oder ergibt`Error`, generiert Grafana Alerting Warninstanzen mit den folgenden zusätzlichen Bezeichnungen:


| Label (Bezeichnung) | Description | 
| --- | --- | 
|  Name der Warnung  |  Entweder `DatasourceNoData` oder `DatasourceError` je nach Bundesland.  | 
|  datasource\$1uid  |  Die UID der Datenquelle, die den Status verursacht hat.  | 

Sie können diese Benachrichtigungen genauso behandeln wie normale Benachrichtigungen, indem Sie eine Stille, eine Route zu einem Kontaktpunkt usw. hinzufügen.

# Kontaktstellen
<a name="v9-alerting-explore-contacts"></a>

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

Definieren Sie anhand von Kontaktpunkten, wie Ihre Kontakte benachrichtigt werden, wenn eine Warnregel ausgelöst wird. Eine Kontaktstelle kann einen oder mehrere Kontaktpunkttypen haben, z. B. E-Mail, Slack, Webhook usw. Wenn eine Warnungsregel ausgelöst wird, wird eine Benachrichtigung an alle Kontaktpunkttypen gesendet, die für einen Kontaktpunkt aufgeführt sind. Kontaktpunkte können sowohl für den Grafana Alertmanager als auch für externe Alertmanager konfiguriert werden.

Sie können auch Benachrichtigungsvorlagen verwenden, um Benachrichtigungen für Kontaktpunkttypen anzupassen.

**Unterstützte Kontaktpunkttypen**

In der folgenden Tabelle sind die von Grafana unterstützten Kontaktpunkttypen aufgeführt.


| Name | Typ | 
| --- | --- | 
|  Amazon SNS  |  `sns`  | 
|  OpsGenie  |  `opsgenie`  | 
|  Pager Duty  |  `pagerduty`  | 
|  Slack  |  `slack`  | 
|  VictorOps  |  `victorops`  | 

Weitere Informationen zu Kontaktstellen finden Sie unter [Mit Kontaktstellen arbeiten](v9-alerting-contact-points.md) und[Benachrichtigungen anpassen](v9-alerting-notifications.md).

# Benachrichtigungen
<a name="v9-alerting-explore-notifications"></a>

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

Grafana verwendet Alertmanager, um Benachrichtigungen über ausgelöste und gelöste Alarme zu senden. [Grafana hat seinen eigenen Alertmanager, der in der Benutzeroberfläche als „Grafana“ bezeichnet wird, unterstützt aber auch das Senden von Benachrichtigungen von anderen Alertmanagern, wie dem Prometheus Alertmanager.](https://prometheus.io/docs/alerting/latest/alertmanager/) Der Grafana Alertmanager verwendet Benachrichtigungsrichtlinien und Kontaktpunkte, um zu konfigurieren, wie und wo eine Benachrichtigung gesendet wird, wie oft eine Benachrichtigung gesendet werden soll und ob Benachrichtigungen alle in derselben Benachrichtigung, in gruppierten Benachrichtigungen basierend auf einer Reihe von Labels oder als separate Benachrichtigungen gesendet werden sollen.

## Richtlinien für Benachrichtigungen
<a name="v9-alerting-explore-notifications-policies"></a>

Benachrichtigungsrichtlinien steuern, wann und wo Benachrichtigungen gesendet werden. Eine Benachrichtigungsrichtlinie kann wählen, ob alle Benachrichtigungen zusammen in derselben Benachrichtigung, Benachrichtigungen in gruppierten Benachrichtigungen auf der Grundlage einer Reihe von Labels oder Benachrichtigungen als separate Benachrichtigungen gesendet werden sollen. Sie können jede Benachrichtigungsrichtlinie so konfigurieren, dass gesteuert wird, wie oft Benachrichtigungen gesendet werden sollen. Außerdem können Sie eine oder mehrere Stummschaltungen einrichten, um Benachrichtigungen zu bestimmten Tageszeiten und an bestimmten Wochentagen zu blockieren.

Benachrichtigungsrichtlinien sind in einer Baumstruktur organisiert, wobei sich an der Wurzel der Struktur eine Benachrichtigungsrichtlinie befindet, die als Stammrichtlinie bezeichnet wird. Es kann nur eine Stammrichtlinie geben, und die Stammrichtlinie kann nicht gelöscht werden.

Spezifische Routing-Richtlinien sind der Stammrichtlinie untergeordnet und können verwendet werden, um entweder allen Warnungen oder einer Teilmenge von Warnungen auf der Grundlage einer Reihe von übereinstimmenden Bezeichnungen zuzuordnen. Eine Benachrichtigungsrichtlinie entspricht einer Warnung, wenn ihre entsprechenden Bezeichnungen mit den Bezeichnungen in der Warnung übereinstimmen.

Eine bestimmte Routing-Richtlinie kann eigene untergeordnete Richtlinien haben, die als verschachtelte Richtlinien bezeichnet werden und eine zusätzliche Zuordnung von Warnmeldungen ermöglichen. Ein Beispiel für eine bestimmte Routing-Richtlinie könnte das Senden von Infrastrukturwarnungen an das Ops-Team sein, während eine untergeordnete Richtlinie Benachrichtigungen mit hoher Priorität an Pagerduty und Benachrichtigungen mit niedriger Priorität an Slack senden könnte.

Alle Benachrichtigungen, unabhängig von ihrer Bezeichnung, entsprechen der Root-Richtlinie. Wenn die Stammrichtlinie jedoch eine Warnung erhält, überprüft sie jede spezifische Routing-Richtlinie und sendet die Warnung an die erste spezifische Routing-Richtlinie, die der Warnung entspricht. Wenn die spezifische Routing-Richtlinie weitere untergeordnete Richtlinien hat, kann sie versuchen, die Warnung mit einer ihrer verschachtelten Richtlinien abzugleichen. Wenn keine verschachtelten Richtlinien mit der Warnung übereinstimmen, ist die spezifische Routing-Richtlinie die passende Richtlinie. Wenn es keine spezifischen Routing-Richtlinien gibt oder keine spezifischen Routing-Richtlinien mit der Warnung übereinstimmen, ist die Stammrichtlinie die passende Richtlinie.

## Kontaktstellen
<a name="v9-alerting-explore-notifications-contacts"></a>

Kontaktpunkte enthalten die Konfiguration für das Senden von Benachrichtigungen. Eine Kontaktstelle ist eine Liste von Integrationen, von denen jede eine Benachrichtigung an eine bestimmte E-Mail-Adresse, einen bestimmten Dienst oder eine bestimmte URL sendet. Kontaktstellen können mehrere Integrationen derselben Art oder eine Kombination von Integrationen verschiedener Art haben. Eine Kontaktstelle könnte beispielsweise eine Pager Duty-Integration, eine Pager Duty- und Slack-Integration oder eine Pager Duty-Integration, eine Slack-Integration und zwei Amazon SNS-Integrationen enthalten. Sie können auch einen Kontaktpunkt ohne Integrationen konfigurieren. In diesem Fall werden keine Benachrichtigungen gesendet.

Eine Kontaktstelle kann erst dann Benachrichtigungen senden, wenn sie zu einer Benachrichtigungsrichtlinie hinzugefügt wurde. Eine Benachrichtigungsrichtlinie kann nur Benachrichtigungen an eine Kontaktstelle senden, aber eine Kontaktstelle kann gleichzeitig zu einer Reihe von Benachrichtigungsrichtlinien hinzugefügt werden. Wenn eine Warnung mit einer Benachrichtigungsrichtlinie übereinstimmt, wird die Warnung an die Kontaktstelle in dieser Benachrichtigungsrichtlinie gesendet, die dann eine Benachrichtigung an jede Integration in ihrer Konfiguration sendet.

**Anmerkung**  
Informationen zu unterstützten Integrationen für Kontaktstellen finden Sie unter[Kontaktstellen](v9-alerting-explore-contacts.md).

## Vorlagen für Benachrichtigungen erstellen
<a name="v9-alerting-explore-notifications-templating"></a>

Sie können Benachrichtigungen mit Vorlagen anpassen. Vorlagen können beispielsweise verwendet werden, um den Titel und die Nachricht von Benachrichtigungen zu ändern, die an Slack gesendet werden.

Vorlagen sind nicht auf eine einzelne Integration oder einen einzelnen Kontaktpunkt beschränkt, sondern können stattdessen in einer Reihe von Integrationen an derselben Kontaktstelle und sogar in Integrationen an verschiedenen Kontaktpunkten verwendet werden. Beispielsweise kann ein Grafana-Benutzer eine Vorlage namens erstellen `custom_subject_or_title` und sie sowohl für die Vorlage von Betreffs in Pager Duty als auch für Titel von Slack-Nachrichten verwenden, ohne zwei separate Vorlagen erstellen zu müssen.

Alle Vorlagen für Benachrichtigungen sind in der [Vorlagensprache von Go verfasst und befinden sich](https://pkg.go.dev/text/template) auf der Seite „Benachrichtigungen“ auf der Registerkarte „Kontaktstellen“.

## Schweigen
<a name="v9-alerting-explore-notifications-silences"></a>

Du kannst Stummschaltungen verwenden, um Benachrichtigungen über eine oder mehrere Feuerregeln stummzuschalten. Stille verhindert nicht, dass Warnmeldungen ausgelöst oder behoben werden, und sie verbergen auch keine Warnmeldungen in der Benutzeroberfläche. Eine Stille dauert so lange wie ihre Dauer, die in Minuten, Stunden, Tagen, Monaten oder Jahren konfiguriert werden kann.

# Alerting einrichten
<a name="v9-alerting-setup"></a>

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

Konfigurieren Sie die Funktionen und Integrationen, die Sie zum Erstellen und Verwalten Ihrer Benachrichtigungen benötigen.

**Topics**
+ [Fügen Sie einen externen Alertmanager hinzu](v9-alerting-setup-alertmanager.md)
+ [Bereitstellung von Grafana-Alerting-Ressourcen](v9-alerting-setup-provision.md)

# Fügen Sie einen externen Alertmanager hinzu
<a name="v9-alerting-setup-alertmanager"></a>

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

Richten Sie Grafana so ein, dass ein externer Alertmanager als einziger Alertmanager verwendet wird, um alle Ihre Benachrichtigungen zu erhalten. Dieser externe Alertmanager kann dann von Grafana aus konfiguriert und verwaltet werden.

Sobald Sie den Alertmanager hinzugefügt haben, können Sie die Grafana Alerting UI verwenden, um Stille, Kontaktpunkte und Benachrichtigungsrichtlinien zu verwalten. Eine Dropdown-Option auf diesen Seiten ermöglicht es Ihnen, zwischen Alertmanagern zu wechseln.

**Anmerkung**  
Ab Grafana 9.2 ist die URL-Konfiguration externer Alertmanager auf der Registerkarte Admin auf der Alerting-Seite veraltet. Es wird in einer future Version entfernt.

Externe Alertmanager sollten jetzt mithilfe der Grafana-Konfiguration im Grafana-Navigationsmenü als Datenquellen konfiguriert werden. Auf diese Weise können Sie die Kontaktpunkte und Benachrichtigungsrichtlinien externer Alertmanager von Grafana aus verwalten und außerdem die HTTP-Basisauthentifizierungsdaten verschlüsseln, die zuvor bei der Konfiguration externer Alertmanager per URL sichtbar waren.

Gehen Sie wie folgt vor, um einen externen Alertmanager hinzuzufügen.

1. Klicken Sie auf Konfiguration und dann auf Datenquellen.

1. Suchen Sie nach Alertmanager.

1. Wählen Sie Ihre Implementierung und füllen Sie die Felder auf der Seite nach Bedarf aus.

   Wenn Sie Ihre Datenquelle bereitstellen, setzen Sie die Markierung `handleGrafanaManagedAlerts` im `jsonData` Feld auf, um von Grafana verwaltete Benachrichtigungen an diesen Alertmanager `true` zu senden.
**Anmerkung**  
Prometheus-, Grafana Mimir- und Cortex-Implementierungen von Alertmanager werden unterstützt. Für Prometheus sind Kontaktstellen und Benachrichtigungsrichtlinien in der Grafana Alerting UI schreibgeschützt.

1. Klicken Sie auf Speichern und testen.

# Bereitstellung von Grafana-Alerting-Ressourcen
<a name="v9-alerting-setup-provision"></a>

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

Die Alarminfrastruktur ist oft komplex, da sich viele Teile der Pipeline oft an unterschiedlichen Orten befinden. Dies auf mehrere Teams und Organisationen zu skalieren, ist eine besonders herausfordernde Aufgabe. Die Bereitstellung von Grafana Alerting erleichtert diesen Prozess, da Sie Ihre Warndaten so erstellen, verwalten und verwalten können, wie es für Ihr Unternehmen am besten geeignet ist.

Es stehen zwei Optionen zur Auswahl:

1. Stellen Sie Ihre Alert-Ressourcen mithilfe der Alerting Provisioning HTTP-API bereit.
**Anmerkung**  
In der Regel können Sie von der API bereitgestellte Warnungsregeln nicht über die Grafana-Benutzeroberfläche bearbeiten.  
Um die Bearbeitung zu ermöglichen, fügen Sie den folgenden Anfragen den x-disable-provenance Header hinzu, wenn Sie Ihre Warnungsregeln in der API erstellen oder bearbeiten:  

   ```
   POST /api/v1/provisioning/alert-rules
   PUT /api/v1/provisioning/alert-rules/{UID}
   ```

1. Stellen Sie Ihre Benachrichtigungsressourcen mithilfe von Terraform bereit.

**Anmerkung**  
Derzeit unterstützt die Bereitstellung für Grafana Alerting Warnregeln, Kontaktpunkte, Stummschaltezeiten und Vorlagen. Bereitgestellte Warnressourcen mithilfe von Dateibereitstellung oder Terraform können nur in der Quelle bearbeitet werden, in der sie erstellt wurden, und nicht in Grafana oder einer anderen Quelle. Wenn Sie beispielsweise Ihre Warnressourcen mithilfe von Dateien von der Festplatte bereitstellen, können Sie die Daten nicht in Terraform oder in Grafana bearbeiten.

**Topics**
+ [Erstellen und verwalten Sie Warnressourcen mit Terraform](v9-alerting-setup-provision-terraform.md)
+ [Bereitgestellte Alert-Ressourcen in Grafana anzeigen](v9-alerting-setup-provision-view.md)

# Erstellen und verwalten Sie Warnressourcen mit Terraform
<a name="v9-alerting-setup-provision-terraform"></a>

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

Verwenden Sie den Grafana-Anbieter von Terraform, um Ihre Alarmressourcen zu verwalten und sie in Ihrem Grafana-System bereitzustellen. Die Terraform-Anbieterunterstützung für Grafana Alerting macht es einfach, Ihren gesamten Grafana Alerting Stack als Code zu erstellen, zu verwalten und zu warten.

Weitere Informationen zur Verwaltung Ihrer Benachrichtigungsressourcen mit Terraform finden Sie in der [Grafana-Provider-Dokumentation](https://registry.terraform.io/providers/grafana/grafana/latest/docs) in der Terraform-Dokumentation.

Führen Sie die folgenden Aufgaben aus, um Ihre Benachrichtigungsressourcen mit Terraform zu erstellen und zu verwalten.

1. Erstellen Sie einen API-Schlüssel für die Bereitstellung.

1. Konfigurieren Sie den Terraform-Anbieter.

1. Definieren Sie Ihre Benachrichtigungsressourcen in Terraform.

1. Führen Sie aus`terraform apply`, um Ihre Alarm-Ressourcen bereitzustellen.

## Voraussetzungen
<a name="v9-alerting-setup-provision-tf-prerequisites"></a>
+ Stellen Sie sicher, dass Sie den grafana/grafana [Terraform-Anbieter](https://registry.terraform.io/providers/grafana/grafana/1.28.0) 1.27.0 oder höher haben.
+ Stellen Sie sicher, dass Sie Grafana 9.1 oder höher verwenden. Wenn Sie Ihre Amazon Managed Grafana-Instance mit Grafana-Version 9 erstellt haben, trifft dies zu.

## Erstellen Sie einen API-Schlüssel für die Bereitstellung
<a name="v9-alerting-setup-provision-tf-apikey"></a>

Sie können [einen normalen Grafana-API-Schlüssel erstellen, um Terraform mit Grafana](Using-Grafana-APIs.md) zu authentifizieren. Die meisten vorhandenen Tools, die API-Schlüssel verwenden, sollten automatisch mit der neuen Grafana Alerting-Unterstützung funktionieren. Informationen speziell zum Erstellen von Schlüsseln für die Verwendung mit Terraform finden Sie unter [Verwenden von Terraform für die Amazon](https://aws-observability.github.io/observability-best-practices/recipes/recipes/amg-automation-tf/) Managed Grafana-Automatisierung.

**So erstellen Sie einen API-Schlüssel für die Bereitstellung**

1. Erstellen Sie ein neues Dienstkonto für Ihre CI-Pipeline.

1. Weisen Sie die Rolle „Access the Alert Rules Provisioning API“ zu.

1. Erstellen Sie ein neues Dienstkonto-Token.

1. Benennen und speichern Sie das Token zur Verwendung in Terraform.

Alternativ können Sie die Standardauthentifizierung verwenden. Alle unterstützten Authentifizierungsformate finden Sie unter [Grafana-Authentifizierung](https://registry.terraform.io/providers/grafana/grafana/latest/docs#authentication) in der Terraform-Dokumentation.

## Konfigurieren Sie den Terraform-Anbieter
<a name="v9-alerting-setup-provision-tf-configure"></a>

Die Unterstützung von Grafana Alerting ist im [Grafana](https://registry.terraform.io/providers/grafana/grafana/latest/docs) Terraform-Anbieter enthalten.

Im Folgenden finden Sie ein Beispiel, mit dem Sie den Terraform-Anbieter konfigurieren können.

```
terraform {
    required_providers {
        grafana = {
            source = "grafana/grafana"
            version = ">= 1.28.2"
        }
    }
}

provider "grafana" {
    url = <YOUR_GRAFANA_URL>
    auth = <YOUR_GRAFANA_API_KEY>
}
```

## Stellen Sie Kontaktpunkte und Vorlagen bereit
<a name="v9-alerting-setup-provision-tf-contacts"></a>

Kontaktstellen verbinden einen Alarm-Stack mit der Außenwelt. Sie teilen Grafana mit, wie Sie sich mit Ihren externen Systemen verbinden und wo Benachrichtigungen zugestellt werden sollen. Es stehen über fünfzehn verschiedene [Integrationen](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/contact_point#optional) zur Auswahl. In diesem Beispiel wird ein Slack-Kontaktpunkt verwendet.

**Um Kontaktpunkte und Vorlagen bereitzustellen**

1. Kopieren Sie diesen Codeblock in eine .tf-Datei auf Ihrem lokalen Computer. Ersetze es *<slack-webhook-url>* durch deine Slack-Webhook-URL (oder einen anderen Kontakt).

   In diesem Beispiel wird eine Kontaktstelle erstellt, die Warnmeldungen an Slack sendet.

   ```
   resource "grafana_contact_point" "my_slack_contact_point" {
       name = "Send to My Slack Channel"
   
       slack {
           url = <slack-webhook-url>
           text = <<EOT
   {{ len .Alerts.Firing }} alerts are firing!
   
   Alert summaries:
   {{ range .Alerts.Firing }}
   {{ template "Alert Instance Template" . }}
   {{ end }}
   EOT
       }
   }
   ```

1. Gib Text für deine Benachrichtigung in das Textfeld ein.

   Das `text` Feld unterstützt [Templating im GO-Stil](https://pkg.go.dev/text/template). Auf diese Weise können Sie Ihre Grafana-Benachrichtigungsvorlagen direkt in Terraform verwalten.

1. Führen Sie den Befehl `terraform apply` aus.

1. Gehen Sie zur Grafana-Benutzeroberfläche und überprüfen Sie die Details Ihrer Kontaktstelle.

   Sie können über Terraform bereitgestellte Ressourcen nicht über die Benutzeroberfläche bearbeiten. Dadurch wird sichergestellt, dass Ihr Alert-Stack immer mit Ihrem Code synchron bleibt.

1. Klicken Sie auf **Test**, um zu überprüfen, ob die Kontaktstelle ordnungsgemäß funktioniert.

**Anmerkung**  
Sie können dieselben Vorlagen an vielen Kontaktpunkten wiederverwenden. Im obigen Beispiel wird eine gemeinsam genutzte Vorlage mithilfe der Anweisung eingebettet `{{ template "Alert Instance Template" . }}`  
Dieses Fragment kann dann separat in Terraform verwaltet werden:  

```
resource "grafana_message_template" "my_alert_template" {
    name = "Alert Instance Template"

    template = <<EOT
{{ define "Alert Instance Template" }}
Firing: {{ .Labels.alertname }}
Silence: {{ .SilenceURL }}
{{ end }}
EOT
}
```

## Bereitstellen von Benachrichtigungsrichtlinien und Routing
<a name="v9-alerting-setup-provision-tf-notifications"></a>

Benachrichtigungsrichtlinien teilen Grafana mit, wie Alarminstanzen weitergeleitet werden sollen, und nicht wohin. Sie verbinden ausgelöste Alarme mithilfe eines Systems von Labels und Matchern mit Ihren zuvor definierten Kontaktpunkten.

**Zur Bereitstellung von Benachrichtigungsrichtlinien und Routing**

1. Kopieren Sie diesen Codeblock in eine .tf-Datei auf Ihrem lokalen Computer.

   In diesem Beispiel werden die Benachrichtigungen nach gruppiert`alertname`, was bedeutet, dass alle Benachrichtigungen, die von Benachrichtigungen stammen, die denselben Namen haben, in derselben Slack-Nachricht gruppiert werden.

   Wenn du bestimmte Benachrichtigungen unterschiedlich weiterleiten möchtest, kannst du Unterrichtlinien hinzufügen. Mithilfe von Unterrichtlinien können Sie das Routing auf verschiedene Benachrichtigungen anwenden, die auf der Zuordnung von Bezeichnungen basieren. In diesem Beispiel wenden wir eine Stummschaltung auf alle Alarme mit der Bezeichnung a=b an.

   ```
   resource "grafana_notification_policy" "my_policy" {
       group_by = ["alertname"]
       contact_point = grafana_contact_point.my_slack_contact_point.name
   
       group_wait = "45s"
       group_interval = "6m"
       repeat_interval = "3h"
   
       policy {
           matcher {
               label = "a"
               match = "="
               value = "b"
           }
           group_by = ["..."]
           contact_point = grafana_contact_point.a_different_contact_point.name
           mute_timings = [grafana_mute_timing.my_mute_timing.name]
   
           policy {
               matcher {
                   label = "sublabel"
                   match = "="
                   value = "subvalue"
               }
               contact_point = grafana_contact_point.a_third_contact_point.name
               group_by = ["..."]
           }
       }
   }
   ```

1. Verknüpfen Sie im Feld mute\$1timings einen Zeitpunkt der Stummschaltung mit Ihrer Benachrichtigungsrichtlinie.

1. Führen Sie den Befehl `terraform apply` aus.

1. Gehen Sie zur Grafana-Benutzeroberfläche und überprüfen Sie die Details Ihrer Benachrichtigungsrichtlinie.
**Anmerkung**  
Sie können die von Terraform bereitgestellten Ressourcen nicht über die Benutzeroberfläche bearbeiten. Dadurch wird sichergestellt, dass Ihr Benachrichtigungsstapel immer mit Ihrem Code synchron bleibt.

1. Klicken Sie auf **Test**, um zu überprüfen, ob der Benachrichtigungspunkt ordnungsgemäß funktioniert.

## Stellen Sie Zeiten zur Stummschaltung bereit
<a name="v9-alerting-setup-provision-tf-mutetiming"></a>

Stummschaltungen bieten die Möglichkeit, Warnmeldungen für bestimmte Zeiträume stummzuschalten.

**Zur Bereitstellung von Timings für die Stummschaltung**

1. Kopieren Sie diesen Codeblock in eine .tf-Datei auf Ihrem lokalen Computer.

   In diesem Beispiel sind Warnmeldungen am Wochenende stummgeschaltet.

   ```
   resource "grafana_mute_timing" "my_mute_timing" {
       name = "My Mute Timing"
   
       intervals {
           times {
             start = "04:56"
             end = "14:17"
           }
           weekdays = ["saturday", "sunday", "tuesday:thursday"]
           months = ["january:march", "12"]
           years = ["2025:2027"]
       }
   }
   ```

1. Führen Sie den Befehl `terraform apply` aus.

1. Gehen Sie zur Grafana-Benutzeroberfläche und überprüfen Sie die Details Ihres Mute-Timings.

1. Verweisen Sie mithilfe des `mute_timings` Felds in einer Benachrichtigungsrichtlinie auf Ihr neu erstelltes Timing für die Stummschaltung. Dadurch wird dein Timing für die Stummschaltung auf einige oder alle deine Benachrichtigungen angewendet.
**Anmerkung**  
Sie können die von Terraform bereitgestellten Ressourcen nicht über die Benutzeroberfläche bearbeiten. Dadurch wird sichergestellt, dass Ihr Benachrichtigungsstapel immer mit Ihrem Code synchron bleibt.

1. Klicken Sie auf **Test**, um zu überprüfen, ob das Timing der Stummschaltung korrekt funktioniert.

## Regeln für Warnmeldungen bereitstellen
<a name="v9-alerting-setup-provision-tf-rules"></a>

[Mit Warnungsregeln](v9-alerting-managerules.md) können Sie vor jeder Grafana-Datenquelle warnen. Dies kann eine Datenquelle sein, die Sie bereits konfiguriert haben, oder Sie können [Ihre Datenquellen in Terraform zusammen mit Ihren Warnungsregeln definieren](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/data_source).

**Um Warnungsregeln bereitzustellen**

1. Erstellen Sie eine Datenquelle für die Abfrage und einen Ordner zum Speichern Ihrer Regeln.

   In diesem Beispiel wird die [Konfigurieren Sie eine TestData Datenquelle zum Testen](testdata-data-source.md) Datenquelle verwendet.

   Alerts können für jede Backend-Datenquelle in Grafana definiert werden.

   ```
   resource "grafana_data_source" "testdata_datasource" {
       name = "TestData"
       type = "testdata"
   }
   
   resource "grafana_folder" "rule_folder" {
       title = "My Rule Folder"
   }
   ```

1. Definieren Sie eine Warnungsregel.

   Weitere Informationen zu Warnungsregeln finden Sie unter [So erstellen Sie von Grafana](https://grafana.com/blog/2022/08/01/grafana-alerting-video-how-to-create-alerts-in-grafana-9/) verwaltete Benachrichtigungen.

1. Erstellen Sie eine Regelgruppe, die eine oder mehrere Regeln enthält.

   In diesem Beispiel wird die `grafana_rule_group` Ressourcengruppe verwendet.

   ```
   resource "grafana_rule_group" "my_rule_group" {
       name = "My Alert Rules"
       folder_uid = grafana_folder.rule_folder.uid
       interval_seconds = 60
       org_id = 1
   
       rule {
           name = "My Random Walk Alert"
           condition = "C"
           for = "0s"
   
           // Query the datasource.
           data {
               ref_id = "A"
               relative_time_range {
                   from = 600
                   to = 0
               }
               datasource_uid = grafana_data_source.testdata_datasource.uid
               // `model` is a JSON blob that sends datasource-specific data.
               // It's different for every datasource. The alert's query is defined here.
               model = jsonencode({
                   intervalMs = 1000
                   maxDataPoints = 43200
                   refId = "A"
               })
           }
   
           // The query was configured to obtain data from the last 60 seconds. Let's alert on the average value of that series using a Reduce stage.
           data {
               datasource_uid = "__expr__"
               // You can also create a rule in the UI, then GET that rule to obtain the JSON.
               // This can be helpful when using more complex reduce expressions.
               model = <<EOT
   {"conditions":[{"evaluator":{"params":[0,0],"type":"gt"},"operator":{"type":"and"},"query":{"params":["A"]},"reducer":{"params":[],"type":"last"},"type":"avg"}],"datasource":{"name":"Expression","type":"__expr__","uid":"__expr__"},"expression":"A","hide":false,"intervalMs":1000,"maxDataPoints":43200,"reducer":"last","refId":"B","type":"reduce"}
   EOT
               ref_id = "B"
               relative_time_range {
                   from = 0
                   to = 0
               }
           }
   
           // Now, let's use a math expression as our threshold.
           // We want to alert when the value of stage "B" above exceeds 70.
           data {
               datasource_uid = "__expr__"
               ref_id = "C"
               relative_time_range {
                   from = 0
                   to = 0
               }
               model = jsonencode({
                   expression = "$B > 70"
                   type = "math"
                   refId = "C"
               })
           }
       }
   }
   ```

1. Gehen Sie zur Grafana-Benutzeroberfläche und überprüfen Sie Ihre Alarmregel.

   Sie können sehen, ob die Warnregel ausgelöst wird. Sie können sich auch eine Visualisierung der einzelnen Abfrageschritte der Warnungsregel anzeigen lassen.

   Wenn die Warnung ausgelöst wird, leitet Grafana eine Benachrichtigung über die von Ihnen definierte Richtlinie weiter.

   Wenn du beispielsweise Slack als Kontaktstelle ausgewählt hast, sendet der eingebettete [Alertmanager](https://github.com/prometheus/alertmanager) von Grafana automatisch eine Nachricht an Slack.

# Bereitgestellte Alert-Ressourcen in Grafana anzeigen
<a name="v9-alerting-setup-provision-view"></a>

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

 Sie können überprüfen, ob Ihre Warnressourcen in Grafana erstellt wurden.

**So zeigen Sie Ihre bereitgestellten Ressourcen in Grafana an**

1. Öffnen Sie Ihre Grafana-Instanz.

1. Navigieren Sie zu Alerting.

1. Klicken Sie auf einen Ressourcenordner für Warnmeldungen, z. B. auf Warnungsregeln.

   Bereitgestellte Ressourcen werden als **Bereitgestellt** gekennzeichnet, sodass deutlich wird, dass sie nicht manuell erstellt wurden.

**Anmerkung**  
Sie können bereitgestellte Ressourcen nicht von Grafana aus bearbeiten. Sie können die Ressourceneigenschaften nur ändern, indem Sie die Provisioning-Datei ändern und Grafana neu starten oder einen Hot-Reload durchführen. Dadurch wird verhindert, dass Änderungen an der Ressource vorgenommen werden, die überschrieben würden, wenn eine Datei erneut bereitgestellt oder ein Hot-Reload durchgeführt würde.

# Migration klassischer Dashboard-Benachrichtigungen zu Grafana-Benachrichtigungen
<a name="v9-alerting-use-grafana-alerts"></a>

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

Arbeitsbereiche, die Grafana-Benachrichtigungen nicht verwenden möchten, verwenden die klassischen Dashboard-Benachrichtigungen. Um zur neuen Grafana-Benachrichtigung zu wechseln, müssen Sie sich für die Funktion anmelden.

Sie können Ihre Amazon Managed Grafana-Instance so konfigurieren, dass Grafana-Benachrichtigungen mithilfe der AWS-Managementkonsole, der oder der Amazon Managed Grafana-API verwendet werden. AWS CLI Einzelheiten zur Konfiguration von Amazon Managed Grafana, einschließlich der Aktivierung oder Deaktivierung von Grafana-Benachrichtigungen, finden Sie unter. [Konfigurieren Sie einen Amazon Managed Grafana-Arbeitsbereich](AMG-configure-workspace.md)

**Anmerkung**  
Wenn Sie Grafana-Benachrichtigungen verwenden, senden Warnregeln, die in Grafana und nicht in Prometheus definiert sind, mehrere Benachrichtigungen an Ihre Kontaktstelle. Wenn Sie native Grafana-Benachrichtigungen verwenden, empfehlen wir, die klassische Dashboard-Warnung beizubehalten und die neue Grafana-Warnfunktion nicht zu aktivieren. Wenn Sie in Ihrer Prometheus-Datenquelle definierte Benachrichtigungen anzeigen möchten, empfehlen wir Ihnen, Grafana Alerting zu aktivieren, das nur eine einzige Benachrichtigung für in Prometheus Alertmanager erstellte Warnungen sendet.  
Diese Einschränkung wurde in Amazon Managed Grafana-Arbeitsbereichen, die Grafana v10.4 und höher unterstützen, aufgehoben.

## Migration zum Grafana-Warnsystem
<a name="v9-alerting-use-grafana-alerts-opt-in"></a>

Wenn die Grafana-Warnung aktiviert ist, werden bestehende klassische Dashboard-Benachrichtigungen in ein Format migriert, das mit der Grafana-Warnung kompatibel ist. Auf der Seite „Benachrichtigungen“ Ihrer Grafana-Instanz können Sie die migrierten Benachrichtigungen zusammen mit neuen Benachrichtigungen anzeigen. Mit Grafana-Benachrichtigungen senden Ihre von Grafana verwalteten Alarmregeln mehrere Benachrichtigungen statt einer einzigen Warnung, wenn sie übereinstimmen.

Der Lese- und Schreibzugriff auf klassische Dashboard-Benachrichtigungen und Grafana-Benachrichtigungen wird durch die Berechtigungen der Ordner geregelt, in denen sie gespeichert sind. Während der Migration werden die klassischen Dashboard-Warnungsberechtigungen wie folgt den neuen Regelberechtigungen zugeordnet:
+ Wenn das Dashboard der ursprünglichen Warnung über Berechtigungen verfügt, wird bei der Migration ein Ordner mit diesem Format erstellt`Migrated {"dashboardUid": "UID", "panelId": 1, "alertId": 1}`, der den Berechtigungen des ursprünglichen Dashboards entspricht (einschließlich der geerbten Berechtigungen aus dem Ordner).
+ Wenn keine Dashboard-Berechtigungen vorhanden sind und sich das Dashboard unter einem Ordner befindet, wird die Regel mit diesem Ordner verknüpft und erbt dessen Berechtigungen.
+ Wenn keine Dashboard-Berechtigungen vorhanden sind und sich das Dashboard im Ordner Allgemein befindet, wird die Regel mit dem Ordner Allgemeine Benachrichtigungen verknüpft, und die Regel erbt die Standardberechtigungen.

**Anmerkung**  
Da es `NoData` in Grafana-Benachrichtigungen keine `Keep Last State` Option gibt, wird diese Option `NoData` bei der klassischen Regelmigration aktiviert. Die Option `Keep Last State` für die `Error` Handhabung wurde auf eine neue Option migriert. `Error` Um dem Verhalten der zu entsprechen`Keep Last State`, erstellt Amazon Managed Grafana in beiden Fällen während der Migration automatisch eine Stille für jede Alarmregel mit einer Dauer von einem Jahr.

Benachrichtigungskanäle werden auf eine Alertmanager-Konfiguration mit den entsprechenden Routen und Empfängern migriert. Standardbenachrichtigungskanäle werden als Kontaktpunkte zur Standardroute hinzugefügt. Benachrichtigungskanäle, die keiner Dashboard-Warnung zugeordnet sind, führen zur `autogen-unlinked-channel-recv` Route.

### Einschränkungen
<a name="v9-alerting-use-grafana-alerts-limitations"></a>
+ Das Grafana-Warnsystem kann Regeln aus allen verfügbaren Prometheus-, Loki- und Alertmanager-Datenquellen abrufen. Es ist möglicherweise nicht in der Lage, Warnregeln aus anderen unterstützten Datenquellen abzurufen.
+ Die Migration zwischen Grafana-Benachrichtigungen und den klassischen Dashboard-Benachrichtigungen kann zu Datenverlust für Funktionen führen, die in einem System unterstützt werden, im anderen jedoch nicht.
**Anmerkung**  
Wenn Sie zurück zur klassischen Dashboard-Warnung migrieren, verlieren Sie alle Änderungen, die an der Warnungskonfiguration vorgenommen wurden, während Sie die Grafana-Warnung aktiviert hatten, einschließlich aller neuen Warnungsregeln, die erstellt wurden.

# Verwalte deine Alarmregeln
<a name="v9-alerting-managerules"></a>

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

Eine Warnregel besteht aus einer Reihe von Bewertungskriterien, die bestimmen, ob eine Warnung ausgelöst wird. Die Warnungsregel besteht aus einer oder mehreren Abfragen und Ausdrücken, einer Bedingung, der Häufigkeit der Auswertung und optional der Dauer, für die die Bedingung erfüllt ist.

Abfragen und Ausdrücke wählen zwar den Datensatz aus, der ausgewertet werden soll, aber eine Bedingung legt den Schwellenwert fest, den eine Warnung erfüllen oder überschreiten muss, um eine Warnung zu erzeugen. Ein Intervall gibt an, wie oft eine Warnungsregel ausgewertet wird. Die Dauer gibt, sofern konfiguriert, an, wie lange eine Bedingung erfüllt sein muss. Warnungsregeln können auch das Warnverhalten bei fehlenden Daten definieren.

**Anmerkung**  
Von Grafana verwaltete Warnungsregeln können nur von Benutzern mit Bearbeitungsberechtigungen für den Ordner bearbeitet oder gelöscht werden, in dem die Regeln gespeichert sind.  
Warnungsregeln für eine externe Grafana Mimir- oder Loki-Instanz können von Benutzern mit Editor- oder Admin-Rollen bearbeitet oder gelöscht werden.

**Topics**
+ [Von Grafana verwaltete Alarmregeln erstellen](v9-alerting-managerules-grafana.md)
+ [Regeln für verwaltete Benachrichtigungen mit Grafana Mimir oder Loki erstellen](v9-alerting-managerules-mimir-loki.md)
+ [Erstellen von verwalteten Aufnahmeregeln mit Grafana, Mimir oder Loki](v9-alerting-managerules-mimir-loki-recording.md)
+ [Grafana Mimir oder Loki Regelgruppen und Namespaces](v9-alerting-managerules-mimir-loki-groups.md)
+ [Warnregeln anzeigen und bearbeiten](v9-alerting-managerules-view-edit.md)

# Von Grafana verwaltete Alarmregeln erstellen
<a name="v9-alerting-managerules-grafana"></a>

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

Grafana ermöglicht es Ihnen, Warnregeln zu erstellen, die eine oder mehrere Datenquellen abfragen, die Ergebnisse reduzieren oder transformieren und sie miteinander oder mit festen Schwellenwerten vergleichen. Wenn diese ausgeführt werden, sendet Grafana Benachrichtigungen an die Kontaktstelle.

**So fügen Sie eine verwaltete Grafana-Regel hinzu**

1. Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** mit den vorhandenen **Alerts** zu öffnen.

1. **Wählen Sie Neue Warnungsregel.**

1. Fügen Sie in **Schritt 1** den Namen, den Typ und den Speicherort der Regel wie folgt hinzu:
   + Fügen Sie im **Feld Regelname** einen beschreibenden Namen hinzu. Dieser Name wird in der Liste der Warnungsregeln angezeigt. Es ist auch die `alertname` Bezeichnung für jede Warnungsinstanz, die anhand dieser Regel erstellt wird.
   + Wählen Sie **in der Dropdownliste Regeltyp** die Option **Grafana Managed** Alert aus.
   + Wählen Sie aus der Dropdownliste **Ordner** den Ordner aus, in dem Sie die Regel speichern möchten. Wenn Sie keinen Ordner auswählen, wird die Regel in dem `General` Ordner gespeichert. Um einen Ordner zu erstellen, wählen Sie das Drop-down-Menü aus und geben Sie einen neuen Ordnernamen ein.

1. Fügen Sie in **Schritt 2** die auszuwertenden Abfragen und Ausdrücke hinzu.
   + Behalten Sie den Standardnamen bei oder bewegen Sie den Mauszeiger darüber und wählen Sie das Bearbeitungssymbol, um den Namen zu ändern.
   + Wählen Sie für Abfragen eine Datenquelle aus der Dropdownliste aus.
   + Fügen Sie eine oder mehrere [Abfragen oder Ausdrücke](v9-panels-query-xform-expressions.md) hinzu.
   + Wählen Sie für jeden Ausdruck entweder **klassische Bedingung** aus, um eine einzelne Warnungsregel zu erstellen, oder wählen Sie aus den Optionen **Mathe**, **Reduce**, **Resample**, um separate Alerts für jede Serie zu generieren. Einzelheiten zu diesen Optionen finden Sie unter[Ein- und mehrdimensionale Regeln](#v9-alerting-single-multi-rule).
   + Wählen Sie **Abfragen ausführen**, um zu überprüfen, ob die Abfrage erfolgreich ist.

1. Fügen Sie in **Schritt 3** Bedingungen hinzu.
   + Wählen Sie in der Dropdownliste **Bedingung** die Abfrage oder den Ausdruck aus, mit dem die Warnungsregel initiiert werden soll.
   + Geben **Sie für Alle auswerten** die Häufigkeit der Auswertung an. Muss ein Vielfaches von 10 Sekunden sein. Zum Beispiel `1m`, `30s`.
   + Geben Sie unter **Evaluieren für** die Dauer an, für die die Bedingung erfüllt sein muss, bevor eine Warnung ausgelöst wird.
**Anmerkung**  
Wenn eine Bedingung verletzt wurde, geht die Warnung in den `Pending` Status über. Bleibt die Bedingung für die angegebene Dauer verletzt, wechselt die Warnung in den `Firing` Status. Wenn sie nicht mehr erfüllt ist, wird der `Normal` Status wiederhergestellt.
   + **Konfigurieren Sie unter Keine Daten konfigurieren und Fehlerbehandlung** das Warnverhalten bei fehlenden Daten. Beachten Sie die Richtlinien unter. [Es werden keine Daten- oder Fehlerfälle behandelt](#v9-alerting-rule-no-data-error)
   + Wählen Sie „**Warnmeldungen in der Vorschau**“, um das Ergebnis der Ausführung der Abfrage in diesem Moment zu überprüfen. In der Vorschau sind keine Daten und keine Bedingungen für die Fehlerbehandlung enthalten.

1. Fügen Sie in **Schritt 4** zusätzliche Metadaten hinzu, die der Regel zugeordnet sind.
   + Fügen Sie eine Beschreibung und eine Zusammenfassung hinzu, um Warnmeldungen individuell anzupassen. Verwenden Sie die Richtlinien in[Beschriftungen und Anmerkungen](v9-alerting-explore-labels.md).
   + Fügen Sie die Runbook-URL, das Panel, das Dashboard und die Warnung IDs hinzu.
   + Fügen Sie benutzerdefinierte Labels hinzu.

1. Wählen Sie **Speichern**, um die Regel zu **speichern, oder Speichern und beenden**, um die Regel zu speichern und zur **Warnseite** zurückzukehren.

Nachdem Sie Ihre Regel erstellt haben, können Sie eine Benachrichtigung für Ihre Regel erstellen. Weitere Informationen zu Benachrichtigungen finden Sie unter [Verwalte deine Warnmeldungen](v9-alerting-managenotifications.md).

## Ein- und mehrdimensionale Regeln
<a name="v9-alerting-single-multi-rule"></a>

Für von Grafana verwaltete Warnungsregeln können Sie eine Regel mit einer klassischen Bedingung oder eine mehrdimensionale Regel erstellen.

**Eindimensionale Regel (klassische Bedingung)**

Verwenden Sie einen klassischen Bedingungsausdruck, um eine Regel zu erstellen, die eine einzelne Warnung auslöst, wenn ihre Bedingung erfüllt ist. Bei einer Abfrage, die mehrere Serien zurückgibt, verfolgt Grafana nicht den Alarmstatus jeder Serie. Infolgedessen sendet Grafana nur eine einzige Warnung, selbst wenn die Alarmbedingungen für mehrere Serien erfüllt sind.

Weitere Informationen zum Formatieren von Ausdrücken finden Sie unter [Ausdrücke](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) in der *Grafana-Dokumentation*.

**Mehrdimensionale Regel**

Um für jede in der Abfrage zurückgegebene Serie eine separate Warnungsinstanz zu generieren, erstellen Sie eine multidimensionale Regel.

**Anmerkung**  
Jede durch eine multidimensionale Regel generierte Warnungsinstanz wird auf Ihr Gesamtkontingent an Warnmeldungen angerechnet. Regeln werden nicht ausgewertet, wenn Sie Ihr Alert-Kontingent erreicht haben. Weitere Informationen zu Kontingenten für mehrdimensionale Regeln finden Sie unter[Fehler beim Erreichen des Kontingents](#v9-alerting-rule-quota-reached).

Um mehrere Instanzen aus einer einzigen Regel zu erstellen, verwenden Sie, oder `Resample` Ausdrücke `Math``Reduce`, um eine multidimensionale Regel zu erstellen. Beispielsweise ist Folgendes möglich:
+ Fügen Sie für jede Abfrage einen `Reduce` Ausdruck hinzu, um Werte im ausgewählten Zeitraum zu einem einzigen Wert zusammenzufassen. (Nicht erforderlich für [Regeln, die numerische Daten verwenden](v9-alerting-explore-numeric.md)).
+ Fügen Sie einen `Math` Ausdruck mit der Bedingung für die Regel hinzu. Dies ist nicht erforderlich, wenn eine Abfrage oder ein Reduce-Ausdruck bereits 0 zurückgibt, wenn die Regel keine Warnung auslösen soll, oder eine positive Zahl, wenn sie eine Warnung auslösen soll. 

  Hier einige Beispiele: 
  + `$B > 70`wenn sie eine Warnung auslösen soll, falls der Wert von B größer als 70 query/expression ist. 
  + `$B < $C * 100`falls es eine Warnung auslösen soll, wenn der Wert von B kleiner als der Wert von C multipliziert mit 100 ist. Wenn die Ergebnisse von Abfragen, die verglichen werden, mehrere Reihen enthalten, werden Reihen aus verschiedenen Abfragen abgeglichen, wenn sie dieselben Beschriftungen haben oder eine eine Teilmenge der anderen ist.

**Anmerkung**  
Grafana unterstützt keine Warnabfragen mit Vorlagenvariablen. Weitere Informationen finden Sie auf der Community-Seite. [Vorlagenvariablen werden bei der Einrichtung von Alert in Warnungsabfragen nicht unterstützt](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514).



**Überlegungen zur Leistung multidimensionaler Regeln**

Jede Warnungsinstanz wird auf das Warnungskontingent angerechnet. Mehrdimensionale Regeln, die mehr Instanzen erstellen, als innerhalb des Warnungskontingents untergebracht werden können, werden nicht ausgewertet und geben einen Kontingentfehler zurück. Weitere Informationen finden Sie unter [Fehler beim Erreichen des Kontingents](#v9-alerting-rule-quota-reached).

Mehrdimensionale Benachrichtigungen können einen großen Einfluss auf die Leistung Ihres Grafana-Workspace sowie auf die Leistung Ihrer Datenquellen haben, da Grafana sie abfragt, um Ihre Warnungsregeln auszuwerten. Die folgenden Überlegungen können hilfreich sein, wenn Sie versuchen, die Leistung Ihres Überwachungssystems zu optimieren.
+ **Häufigkeit der Regelauswertung** — Die Eigenschaft „**Alle auswerten**“ einer Warnungsregel steuert die Häufigkeit der Regelauswertung. Wir empfehlen, die niedrigste akzeptable Evaluierungshäufigkeit zu verwenden. 
+ **Kardinalität der Ergebnismenge** — Die Anzahl der Warnungsinstanzen, die Sie mit einer Regel erstellen, wirkt sich auf deren Leistung aus. Angenommen, Sie überwachen API-Antwortfehler für jeden API-Pfad auf jeder VM in Ihrer Flotte. Dieser Satz hat eine Kardinalität der Anzahl der Pfade multipliziert mit der Anzahl von. VMs Sie können die Kardinalität der Ergebnismenge reduzieren, indem Sie beispielsweise die Gesamtanzahl der Fehler pro VM statt pro Pfad pro VM überwachen.
+ **Komplexität der Abfrage** — Abfragen, die Datenquellen schnell verarbeiten und beantworten können, verbrauchen weniger Ressourcen. Diese Überlegung ist zwar weniger wichtig als die anderen oben aufgeführten Überlegungen, aber wenn Sie sie so weit wie möglich reduziert haben, könnte die Betrachtung der individuellen Abfrageleistung einen Unterschied machen. Sie sollten sich auch der Auswirkungen bewusst sein, die die Bewertung dieser Regeln auf die Leistung Ihrer Datenquellen hat. Warnabfragen machen häufig die überwiegende Mehrheit der Abfragen aus, die von Überwachungsdatenbanken verarbeitet werden. Daher wirken sich dieselben Auslastungsfaktoren, die sich auf die Grafana-Instanz auswirken, auch auf sie aus.

## Fehler beim Erreichen des Kontingents
<a name="v9-alerting-rule-quota-reached"></a>

Es gibt ein Kontingent für die Anzahl der Warnungsinstanzen, die Sie in einem einzelnen Workspace haben können. Wenn Sie diese Anzahl erreichen, können Sie in diesem Workspace keine neuen Warnungsregeln mehr erstellen. Bei mehrdimensionalen Benachrichtigungen kann die Anzahl der Warnungsinstanzen im Laufe der Zeit variieren.

Bei der Arbeit mit Warnungsinstanzen sollten Sie Folgendes beachten.
+ Wenn Sie nur eindimensionale Regeln erstellen, ist jede Regel eine einzelne Warnungsinstanz. Sie können in einem einzigen Workspace die gleiche Anzahl von Regeln erstellen wie Ihr Kontingent für Warnungsinstanzen, und nicht mehr.
+ Mehrdimensionale Regeln erzeugen mehrere Warnungsinstanzen, deren Anzahl jedoch erst bekannt ist, wenn sie ausgewertet wurden. Wenn Sie beispielsweise eine Warnungsregel erstellen, die die CPU-Auslastung Ihrer Amazon EC2 EC2-Instances verfolgt, gibt es bei der Erstellung möglicherweise 50 EC2-Instances (und somit 50 Alert-Instances). Wenn Sie jedoch eine Woche später 10 weitere EC2-Instances hinzufügen, umfasst die nächste Auswertung 60 Alert-Instances.

  Die Anzahl der Alert-Instances wird ausgewertet, wenn Sie eine multidimensionale Warnung erstellen, und Sie können keine erstellen, bei der Sie sofort Ihr Alert-Instance-Kontingent überschreiten. Da sich die Anzahl der Warnungsinstanzen ändern kann, wird Ihr Kontingent bei jeder Auswertung Ihrer Regeln überprüft.
+ Wenn Sie bei der Regelauswertung aufgrund einer Regel Ihr Kontingent für Warnungsinstanzen überschreiten, wird diese Regel erst evaluiert, wenn die Warnungsregel aktualisiert wird, sodass die Gesamtzahl der Warnungsinstanzen unter das Dienstkontingent fällt. In diesem Fall erhalten Sie eine Warnmeldung, die Sie darüber informiert, dass Ihr Kontingent erreicht wurde (die Benachrichtigung verwendet die Benachrichtigungsrichtlinie für die auszuwertende Regel). Die Benachrichtigung enthält eine `Error` Anmerkung mit dem Wert`QuotaReachedError`.
+ Eine Regel, die bewirkt, dass a `QuotaReachedError` nicht mehr ausgewertet wird. Die Auswertung wird nur dann wieder aufgenommen, wenn ein Update vorgenommen wird und die Auswertung nach dem Update selbst keine Ursache hat`QuotaReachedError`. Eine Regel, die nicht ausgewertet wird, zeigt in der Grafana-Konsole den Fehler **Kontingent erreicht** an.
+ Sie können die Anzahl der Warnungsinstanzen verringern, indem Sie Warnungsregeln entfernen oder indem Sie mehrdimensionale Warnungen bearbeiten, sodass weniger Warnungsinstanzen angezeigt werden (z. B. indem Sie eine Warnung bei Fehlern pro VM anstelle einer Warnung bei Fehlern pro API in einer VM haben).
+ Um die Evaluierungen fortzusetzen, aktualisieren Sie die Warnung und speichern Sie sie. Sie können es aktualisieren, um die Anzahl der Warnungsinstanzen zu verringern, oder wenn Sie andere Änderungen vorgenommen haben, um die Anzahl der Warnungsinstanzen zu verringern, können Sie es unverändert speichern. Wenn es wieder aufgenommen werden kann, ist es das auch. Wenn es ein anderes verursacht`QuotaReachedError`, können Sie es nicht speichern.
+ Wenn eine Warnung gespeichert wird und die Auswertung wieder aufgenommen wird, ohne das Warnungskontingent zu überschreiten, kann der Fehler **Kontingent erreicht** noch einige Zeit (bis zum Bewertungsintervall) in der Grafana-Konsole angezeigt werden. Die Auswertung der Warnungsregel wird jedoch gestartet und es werden Warnungen gesendet, wenn der Regelschwellenwert erreicht ist.
+ Einzelheiten zur Quote für Warnmeldungen sowie zu anderen Kontingenten finden Sie unter. [Amazon Managed Grafana-Servicekontingente](AMG_quotas.md)

## Es werden keine Daten- oder Fehlerfälle behandelt
<a name="v9-alerting-rule-no-data-error"></a>

Wählen Sie Optionen für den Umgang mit Warnmeldungen, wenn keine Daten vorliegen oder Fehler auftreten.

Die Optionen für den Umgang mit fehlenden Daten sind in der folgenden Tabelle aufgeführt.


| Option „Keine Daten“ | Behavior | 
| --- | --- | 
|  Keine Daten  |  Erstellen Sie eine Warnung `DatasourceNoData` mit dem Namen und der UID der Warnungsregel sowie der UID der Datenquelle, die keine Daten zurückgegeben hat, als Beschriftungen.  | 
|  Warnfunktion  |  Legen Sie den Status der Warnungsregel auf fest. `Alerting`  | 
|  OK  |  Stellen Sie den Status der Warnungsregel auf ein`Normal`.  | 

Die Optionen für die Behandlung von Fehlerfällen sind in der folgenden Tabelle aufgeführt.


| Fehler- oder Timeout-Option | Behavior | 
| --- | --- | 
|  Warnfunktion  |  Setzen Sie den Status der Warnungsregel auf `Alerting`  | 
|  OK  |  Legen Sie den Status der Warnungsregel fest auf `Normal`  | 
|  Fehler  |  Erstellen Sie eine Warnung `DatasourceError` mit dem Namen und der UID der Warnungsregel sowie der UID der Datenquelle, die keine Daten zurückgegeben hat, als Beschriftungen.  | 

# Regeln für verwaltete Benachrichtigungen mit Grafana Mimir oder Loki erstellen
<a name="v9-alerting-managerules-mimir-loki"></a>

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

Mit Grafana können Sie Warnregeln für eine externe Grafana-Mimir- oder Loki-Instanz erstellen.

**Anmerkung**  
Grafana Mimir kann eine Verbindung zu Amazon Managed Service for Prometheus- und Prometheus-Datenquellen herstellen.

**Voraussetzungen**
+ Stellen Sie sicher, dass Sie Schreibberechtigungen für die Prometheus-Datenquelle haben. Andernfalls können Sie keine von Cortex verwalteten Warnregeln erstellen oder aktualisieren.
+ Aktivieren Sie für Grafana Mimir- und Loki-Datenquellen die Ruler-API, indem Sie ihre jeweiligen Dienste konfigurieren.
  + **Loki** — Der `local` Regelspeichertyp, standardmäßig für die Loki-Datenquelle, unterstützt nur die Anzeige von Regeln. Um Regeln zu bearbeiten, konfigurieren Sie einen der anderen Speichertypen.
  + **Grafana Mimir** — Verwenden Sie das `/api/prom` Legacy-Präfix, nicht. `/prometheus` Die Prometheus-Datenquelle unterstützt sowohl Grafana Mimir als auch Prometheus, und Grafana geht davon aus, dass sich sowohl die Query-API als auch die Ruler-API unter derselben URL befinden. Sie können keine separate URL für die Ruler-API angeben.

**Anmerkung**  
Wenn Sie keine Warnungsregeln für eine bestimmte Loki- oder Prometheus-Datenquelle verwalten möchten, gehen Sie zu deren Einstellungen und deaktivieren Sie das Kontrollkästchen **Benachrichtigungen über die Alerting UI verwalten**.

**So fügen Sie eine verwaltete Alarmregel mit Grafana, Mimir oder Loki hinzu**

1. Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Warnsymbol** (Glocke), um die **Warnseite mit den vorhandenen Benachrichtigungen** zu öffnen.

1. **Wählen Sie Warnungsregel erstellen.**

1. Wählen Sie in **Schritt 1** den Regeltyp und die Details wie folgt aus:
   + Wählen Sie **Mimir oder Loki Alert**.
   + Fügen Sie im **Feld Regelname** einen aussagekräftigen Namen hinzu. Dieser Name wird in der Liste der Warnungsregeln angezeigt. Es ist auch die `alertname` Bezeichnung für jede Warnungsinstanz, die anhand dieser Regel erstellt wird.
   + **Wählen Sie in der Dropdownliste Datenquelle** auswählen eine Prometheus- oder Loki-Datenquelle aus.
   + Wählen Sie aus der Dropdownliste **Namespace** einen vorhandenen Regel-Namespace aus. Andernfalls wählen Sie **Neu hinzufügen** und geben Sie einen Namen ein, um einen zu erstellen. Namespaces können eine oder mehrere Regelgruppen enthalten und haben nur einen organisatorischen Zweck. Weitere Informationen finden Sie unter [Cortex- oder Loki-Regelgruppen und Namespaces](alert-rules.md#alert-rule-groups).
   + Wählen Sie in der Dropdownliste **Gruppe** eine bestehende Gruppe im ausgewählten Namespace aus. Andernfalls wählen Sie **Neu hinzufügen** und geben Sie einen Namen ein, um einen zu erstellen. Neu erstellte Regeln werden am Ende der Gruppe angehängt. Regeln innerhalb einer Gruppe werden sequenziell in regelmäßigen Intervallen mit derselben Evaluierungszeit ausgeführt.

1. Fügen Sie in **Schritt 2** die auszuwertende Abfrage hinzu.

   Der Wert kann ein PromQL- oder LogQL-Ausdruck sein. Die Regel löst eine Warnung aus, wenn das Auswertungsergebnis mindestens eine Reihe mit einem Wert größer als 0 enthält. Für jede Serie wird eine Warnung erstellt.

1. Geben Sie in **Schritt 3** das Bewertungsintervall für die Warnung an.

   Geben Sie im Textfeld **Für** der Bedingung die Dauer an, für die die Bedingung erfüllt sein muss, bevor die Warnung ausgelöst wird. Wenn Sie angeben`5m`, müssen die Bedingungen fünf Minuten lang erfüllt sein, bevor die Warnung ausgelöst wird.
**Anmerkung**  
Wenn eine Bedingung erfüllt ist, geht die Warnung in den `Pending` Status über. Wenn die Bedingung für die angegebene Dauer aktiv bleibt, wechselt die Warnung in den `Firing` Status. Wenn sie nicht mehr erfüllt ist, wird der `Normal` Status wiederhergestellt.

1. Fügen Sie in **Schritt 4** zusätzliche Metadaten hinzu, die der Regel zugeordnet sind.
   + Fügen Sie eine Beschreibung und eine Zusammenfassung hinzu, um Warnmeldungen anzupassen. Verwenden Sie die Richtlinien in[Beschriftungen und Anmerkungen](v9-alerting-explore-labels.md).
   + Fügen Sie die Runbook-URL, das Panel, das Dashboard und die Warnung IDs hinzu.
   + Fügen Sie benutzerdefinierte Labels hinzu.

1. Wählen Sie „**Warnmeldungen in der Vorschau anzeigen**“, um die Regel auszuwerten und zu sehen, welche Warnmeldungen sie ausgeben würde. Es wird eine Liste von Warnmeldungen mit Status und Wert der einzelnen Warnungen angezeigt.

1. Wählen Sie **Speichern**, um die Regel zu **speichern, oder Speichern und beenden**, um die Regel zu speichern und zur **Warnseite** zurückzukehren.

Nachdem Sie Ihre Regel erstellt haben, können Sie eine Benachrichtigung für Ihre Regel erstellen. Weitere Informationen zu Benachrichtigungen finden Sie unter [Verwalte deine Warnmeldungen](v9-alerting-managenotifications.md).

# Erstellen von verwalteten Aufnahmeregeln mit Grafana, Mimir oder Loki
<a name="v9-alerting-managerules-mimir-loki-recording"></a>

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

Sie können Aufzeichnungsregeln für eine externe Instanz von Grafana Mimir oder Loki erstellen und verwalten. Aufzeichnungsregeln berechnen häufig benötigte Ausdrücke oder rechenaufwändige Ausdrücke im Voraus und speichern das Ergebnis als neue Zeitreihe. Die Abfrage dieser neuen Zeitreihe ist schneller, insbesondere bei Dashboards, da bei jeder Aktualisierung der Dashboards derselbe Ausdruck abgefragt wird.

**Voraussetzungen**

Aktivieren Sie für Grafana Mimir- und Loki-Datenquellen die Ruler-API, indem Sie ihre jeweiligen Dienste konfigurieren.
+ **Loki** — Der `local` Regelspeichertyp, standardmäßig für die Loki-Datenquelle, unterstützt nur die Anzeige von Regeln. Um Regeln zu bearbeiten, konfigurieren Sie einen der anderen Speichertypen.
+ **Grafana Mimir** — Wenn Sie eine Datenquelle so konfigurieren, dass sie auf Grafana Mimir verweist, verwenden Sie das `/api/prom` Legacy-Präfix, nicht. `/prometheus` Die Prometheus-Datenquelle unterstützt sowohl Grafana Mimir als auch Prometheus, und Grafana geht davon aus, dass sich sowohl die Query-API als auch die Ruler-API unter derselben URL befinden. Sie können keine separate URL für die Ruler-API angeben.

**Anmerkung**  
Wenn Sie keine Warnungsregeln für eine bestimmte Loki- oder Prometheus-Datenquelle verwalten möchten, gehen Sie zu deren Einstellungen und deaktivieren Sie das Kontrollkästchen **Benachrichtigungen über die Alerting UI verwalten**.

**So fügen Sie eine Regel für verwaltete Aufzeichnungen mit Grafana, Mimir oder Loki hinzu**

1. Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** mit den vorhandenen **Alerts** zu öffnen.

1. **Wählen Sie Warnungsregel erstellen.**

1. Fügen Sie in **Schritt 1** den Regeltyp, den Regelnamen und den Speicherort wie folgt hinzu.
   + Wählen Sie die Option **Mimir- oder Loki-Aufnahmeregel** aus.
   + Fügen Sie im **Feld Regelname** einen aussagekräftigen Namen hinzu. Dieser Name wird in der Liste der Warnungsregeln angezeigt. Es ist auch die `alertname` Bezeichnung für jede Warnungsinstanz, die anhand dieser Regel erstellt wird.
   + **Wählen Sie in der Dropdownliste Datenquelle** auswählen eine Prometheus- oder Loki-Datenquelle aus.
   + Wählen Sie aus der Dropdownliste **Namespace** einen vorhandenen Regel-Namespace aus. Andernfalls wählen Sie **Neu hinzufügen** und geben Sie einen Namen ein, um einen zu erstellen. Namespaces können eine oder mehrere Regelgruppen enthalten und haben nur einen organisatorischen Zweck. Weitere Informationen finden Sie unter [Cortex- oder Loki-Regelgruppen und Namespaces](alert-rules.md#alert-rule-groups).
   + Wählen Sie in der Dropdownliste **Gruppe** eine bestehende Gruppe im ausgewählten Namespace aus. Andernfalls wählen Sie **Neu hinzufügen** und geben Sie einen Namen ein, um einen zu erstellen. Neu erstellte Regeln werden an das Ende der Gruppe angehängt. Regeln innerhalb einer Gruppe werden sequenziell in regelmäßigen Intervallen mit derselben Evaluierungszeit ausgeführt.

1. Fügen Sie in **Schritt 2** die auszuwertende Abfrage hinzu.

   Der Wert kann ein PromQL- oder LogQL-Ausdruck sein. Die Regel löst eine Warnung aus, wenn das Auswertungsergebnis mindestens eine Reihe mit einem Wert größer als 0 enthält. Für jede Serie wird eine Warnung erstellt.

1. Fügen Sie in **Schritt 3** zusätzliche Metadaten hinzu, die der Regel zugeordnet sind.
   + Fügen Sie eine Beschreibung und eine Zusammenfassung hinzu, um Warnmeldungen individuell anzupassen. Verwenden Sie die Richtlinien in[Anmerkungen und Beschriftungen für Warnregeln](alert-rules.md#alert-rule-labels).
   + Fügen Sie die Runbook-URL, das Panel, das Dashboard und die Warnung IDs hinzu.
   + Fügen Sie benutzerdefinierte Labels hinzu.

1. Wählen Sie **Speichern**, um die Regel zu **speichern, oder Speichern und beenden**, um die Regel zu speichern und zur **Warnseite** zurückzukehren.

# Grafana Mimir oder Loki Regelgruppen und Namespaces
<a name="v9-alerting-managerules-mimir-loki-groups"></a>

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

Sie können Ihre Regeln organisieren. Regeln werden innerhalb von Regelgruppen erstellt, und Regelgruppen sind in Namespaces organisiert. Die Regeln innerhalb einer Regelgruppe werden nacheinander in regelmäßigen Abständen ausgeführt. Das Standardintervall ist eine Minute. Sie können Grafana Mimir- oder Loki-Namespaces und Regelgruppen umbenennen und die Bewertungsintervalle für Regelgruppen bearbeiten.

**Um eine Regelgruppe oder einen Namespace zu bearbeiten**

1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Warnsymbol** (Glocke), um die Warnseite zu öffnen.**

1. Navigieren Sie zu einer Regel innerhalb der Regelgruppe oder des Namespace, die Sie bearbeiten möchten.

1. Wählen Sie das Symbol **Bearbeiten** (Stift).

1. Nehmen Sie Änderungen an der Regelgruppe oder dem Namespace vor.
**Anmerkung**  
Bei Namespaces können Sie nur den Namen bearbeiten. Bei Regelgruppen ändern Sie den Namen oder das Bewertungsintervall für Regeln in der Gruppe. Sie können beispielsweise festlegen`1m`, dass die Regeln einmal pro Minute oder `30s` einmal alle 30 Sekunden ausgewertet werden.

1. Wählen Sie **Änderungen speichern ** aus.

# Warnregeln anzeigen und bearbeiten
<a name="v9-alerting-managerules-view-edit"></a>

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

Auf der Seite „**Benachrichtigungen“ werden Warnregeln aufgeführt.** Standardmäßig sind Regeln nach Datenquellentypen gruppiert. Der **Grafana-Abschnitt** listet Regeln auf, die von Grafana verwaltet werden, und der Abschnitt **Cortex/Loki** listet Regeln für Prometheus-kompatible Datenquellen auf. Sie können Warnregeln für Prometheus-kompatible Datenquellen anzeigen, sie jedoch nicht bearbeiten.

Im Abschnitt Mimir/Cortex/Loki Regeln sind alle Regeln für Mimir-, Cortex- oder Loki-Datenquellen aufgeführt. Cloud-Warnungsregeln sind ebenfalls in diesem Abschnitt aufgeführt.

Bei der Verwaltung großer Mengen von Benachrichtigungen können Sie erweiterte Funktionen zur Suche nach Warnungsregeln verwenden, um nach Ordnern, Bewertungsgruppen und Regeln zu filtern. Darüber hinaus können Sie Warnungsregeln nach ihren Eigenschaften wie Bezeichnungen, Status, Typ und Zustand filtern.

**Anmerkung**  
Sie können Abfragedefinitionen für bereitgestellte Benachrichtigungen anzeigen, sie jedoch nicht bearbeiten. Wenn Sie sie anzeigen können, können Sie überprüfen, ob Ihre Abfragen und Regeldefinitionen korrekt sind, ohne zu Ihrem Provisioning-Repository für Regeldefinitionen zurückkehren zu müssen.

## Regeln für Warnmeldungen anzeigen
<a name="v9-alerting-managerules-view"></a>

Mit Grafana-Benachrichtigungen können Sie alle Ihre Benachrichtigungen auf einer Seite anzeigen.

**Um die Details der Benachrichtigungen anzuzeigen**

1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** zu öffnen.** Standardmäßig werden Regeln in Gruppen nach Datenquellentyp angezeigt. Sie können die einzelnen Warnmeldungen auch anhand des aktuellen Status anzeigen (diese werden im folgenden Text ausführlicher beschrieben).

1. In „**Anzeigen als**“ können Sie zwischen der Gruppen- und der Statusansicht wechseln, indem Sie die von Ihnen bevorzugte Option auswählen.

1. Wählen Sie den Pfeil neben einer Zeile, um weitere Details zu dieser Zeile anzuzeigen. Zu den Details einer Regel gehören die Regelbezeichnungen, Anmerkungen, Datenquellen und Abfragen sowie eine Liste der Warnungsinstanzen, die sich aus der Regel ergeben.

**Anmerkung**  
Weitere Informationen zum Verständnis der Details Ihrer Benachrichtigungen finden Sie unter[Stand und Zustand der Warnregeln](v9-alerting-explore-state.md).

**Gruppenansicht**

Die Gruppenansicht zeigt Grafana-Alarmregeln gruppiert nach Ordnern und Loki- oder Prometheus-Alarmregeln gruppiert nach \$1. `namespace` `group` Dies ist die Standardregellistenansicht, die für die Verwaltung von Regeln vorgesehen ist. Sie können jede Gruppe erweitern, um eine Liste der Regeln in dieser Gruppe anzuzeigen. Erweitern Sie eine Regel weiter, um ihre Details anzuzeigen. Sie können auch Aktionsschaltflächen und Warnmeldungen, die sich aus der Regel ergeben, erweitern, um deren Details anzuzeigen.

**Ansicht „Status“**

In der Statusansicht werden die Warnungsregeln nach Bundesland gruppiert angezeigt. Verwenden Sie diese Ansicht, um einen Überblick darüber zu erhalten, welche Regeln sich in welchem Status befinden. Jede Regel kann erweitert werden, um ihre Details anzuzeigen. Aktionsschaltflächen und alle durch diese Regel generierten Warnungen. Jede Warnung kann weiter erweitert werden, um ihre Details anzuzeigen.

**Regeln für die Filterung von Warnmeldungen**

Sie können die Warnregeln, die auf der Seite „**Benachrichtigungen“ angezeigt werden, auf verschiedene** Arten filtern.
+ Sie können filtern, um die Regeln anzuzeigen, die eine bestimmte Datenquelle abfragen, indem **Sie Datenquellen auswählen** und dann eine Datenquelle auswählen, nach der gefiltert werden soll.
+ Sie können nach Bezeichnungen filtern, indem Sie unter Nach **Bezeichnung suchen die gewünschten** Suchkriterien auswählen. Sie könnten beispielsweise eingeben, `environment=production,region=~US|EU,severity!=warning` um nach Produktionswarnungen in den USA und der EU zu filtern.
+ Sie können filtern, um die Regeln in einem bestimmten Bundesstaat anzuzeigen, indem Sie die Option **Benachrichtigungen nach Bundesland filtern** und dann den Bundesstaat auswählen, den Sie anzeigen möchten.

## Warnungsregeln bearbeiten oder löschen
<a name="v9-alerting-managerules-edit"></a>

Von Grafana verwaltete Alarmregeln können nur von Benutzern mit Bearbeitungsberechtigungen für den Ordner bearbeitet oder gelöscht werden, in dem die Regeln gespeichert sind. Warnregeln für eine externe Mimir- oder Loki-Instanz können von Benutzern mit Editor- oder Admin-Rollen bearbeitet oder gelöscht werden.

**Um eine Regel zu bearbeiten oder zu löschen**

1. Erweitern Sie eine Regel, bis Sie die Regelsteuerelemente für **Anzeigen**, **Bearbeiten** und **Löschen** sehen können.

1. Wählen Sie **Bearbeiten**, um die Seite „Regel erstellen“ zu öffnen. Nehmen Sie Aktualisierungen auf die gleiche Weise vor, wie Sie eine Regel erstellen. Einzelheiten finden Sie in den Anweisungen unter [Von Grafana verwaltete Alarmregeln erstellen](v9-alerting-managerules-grafana.md) oder[Regeln für verwaltete Benachrichtigungen mit Grafana Mimir oder Loki erstellen](v9-alerting-managerules-mimir-loki.md).

1. Wählen Sie optional **Löschen**, um eine Regel zu löschen.

## Warnungsregeln exportieren
<a name="v9-alerting-managerules-export"></a>

**Sie können Regeln im Grafana-Arbeitsbereich nach YAML oder JSON exportieren, indem Sie Exportieren wählen.** Sie haben die Möglichkeit, eine neue Regel zu definieren und diese dann zu exportieren. Sie können eine Regel mithilfe der Benutzeroberfläche erstellen und sie dann zur Verwendung in der Provisioning-API oder in Terraform-Skripten exportieren.

**Anmerkung**  
Dies wird sowohl im Grafana-Workspace als auch in der Provisioning-Schnittstelle unterstützt.

# Verwalte deine Warnmeldungen
<a name="v9-alerting-managenotifications"></a>

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

Die Entscheidung, wie, wann und wohin Ihre Warnmeldungen gesendet werden sollen, ist ein wichtiger Bestandteil der Einrichtung Ihres Warnsystems. Diese Entscheidungen wirken sich direkt auf Ihre Fähigkeit aus, Probleme schnell zu lösen und nichts Wichtiges zu verpassen.

Definieren Sie als ersten Schritt Ihre *Kontaktstellen* und an wen Sie Ihre Warnmeldungen senden möchten. Bei einer Kontaktstelle kann es sich um eine Reihe von Zielen für passende Benachrichtigungen handeln. Fügen Sie Benachrichtigungsvorlagen zu Kontaktpunkten hinzu, um sie wiederzuverwenden und die Nachrichtenübermittlung in Ihren Benachrichtigungen einheitlich zu gestalten.

Erstellen Sie als Nächstes eine *Benachrichtigungsrichtlinie*. Dabei handelt es sich um eine Reihe von Regeln dafür, wo, wann und wie Ihre Benachrichtigungen an Kontaktstellen weitergeleitet werden. In einer Benachrichtigungsrichtlinie definieren Sie, wohin Ihre Warnmeldungen gesendet werden sollen, indem Sie eine der von Ihnen erstellten Kontaktstellen auswählen. Fügen Sie Ihrer Benachrichtigungsrichtlinie Zeiten für die Stummschaltung hinzu. Eine *Stummschaltung* ist ein wiederkehrendes Zeitintervall, in dem du nicht möchtest, dass Benachrichtigungen versendet werden.

Wenn eine Warnungsregel ausgewertet wird, sendet die Warnmeldungsinstanz Warninstanzen an den Alertmanager — eine Warnungsregel kann mehrere einzelne *Warnungsinstanzen* auslösen.

Der Alertmanager empfängt diese Warnungsinstanzen und kümmert sich dann um die Stummschaltung, gruppiert Alarme und sendet Benachrichtigungen an Ihre Kontaktstellen, wie in der Benachrichtigungsrichtlinie definiert.

**Topics**
+ [Alert-Manager](v9-alerting-managenotifications-alertmanager.md)
+ [Mit Kontaktstellen arbeiten](v9-alerting-contact-points.md)
+ [Mit Benachrichtigungsrichtlinien arbeiten](v9-alerting-notification-policies.md)
+ [Benachrichtigungen anpassen](v9-alerting-notifications.md)
+ [Stummschalten von Warnmeldungen für Prometheus-Datenquellen](v9-alerting-silences.md)
+ [Timings stummschalten](v9-alerting-notification-muting.md)
+ [Warnungsgruppen anzeigen und nach Warnungsgruppen filtern](v9-alerting-viewfiltergroups.md)
+ [Benachrichtigungsfehler anzeigen](v9-alerting-viewnotificationerrors.md)

# Alert-Manager
<a name="v9-alerting-managenotifications-alertmanager"></a>

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

Mit Alertmanager können Sie Warnmeldungen schnell und effizient verwalten und darauf reagieren. Er empfängt Benachrichtigungen, kümmert sich um Stummschaltung, Sperrung, Gruppierung und Weiterleitung, indem er Benachrichtigungen über den Kanal Ihrer Wahl versendet, z. B. E-Mail oder Slack.

In Grafana können Sie den Grafana Alertmanager oder einen externen Alertmanager verwenden. Sie können auch mehrere Alertmanager ausführen. Ihre Entscheidung hängt von Ihrer Einrichtung ab und davon, wo Ihre Benachrichtigungen generiert werden.

**Grafana Alarmmanager**

Grafana Alertmanager ist ein interner Alertmanager, der vorkonfiguriert ist und standardmäßig ausgewählt werden kann, wenn Sie Grafana vor Ort oder als Open Source ausführen.

Der Grafana Alertmanager kann Benachrichtigungen von Grafana empfangen, aber er kann keine Benachrichtigungen von außerhalb von Grafana empfangen, z. B. von Mimir oder Loki.

**Anmerkung**  
Inhibitionsregeln werden im Grafana Alertmanager nicht unterstützt.

**Externer Alertmanager**

Wenn Sie einen einzigen Alertmanager verwenden möchten, um alle Ihre Grafana-, Loki-, Mimir- und Prometheus-Benachrichtigungen zu erhalten, können Sie Grafana so einrichten, dass ein externer Alertmanager verwendet wird. Dieser externe Alertmanager kann in Grafana selbst konfiguriert und verwaltet werden.

Hier sind zwei Beispiele dafür, wann Sie vielleicht Ihren eigenen externen Alertmanager konfigurieren und Ihre Benachrichtigungen anstelle des Grafana-Alertmanagers dorthin senden möchten:

1. Sie haben bereits Alertmanager vor Ort in Ihrer eigenen Cloud-Infrastruktur, die Sie eingerichtet haben und weiterhin verwenden möchten, da Sie über andere Alert-Generatoren wie Prometheus verfügen.

1. Sie möchten sowohl Prometheus vor Ort als auch gehostetes Grafana verwenden, um Benachrichtigungen an denselben Alertmanager zu senden, der in Ihrer Cloud-Infrastruktur ausgeführt wird.

Alertmanager sind im Drop-down-Menü auf den Seiten Alerting Contact Points und Notification Policies sichtbar.

Wenn Sie Ihre Datenquelle bereitstellen, setzen Sie die Markierung `handleGrafanaManagedAlerts` im `jsonData` Feld auf, um von Grafana verwaltete Benachrichtigungen an diesen Alertmanager `true` zu senden.

# Mit Kontaktstellen arbeiten
<a name="v9-alerting-contact-points"></a>

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

Definieren Sie anhand von Kontaktpunkten, wie Ihre Kontakte benachrichtigt werden, wenn eine Warnung ausgelöst wird. Eine Kontaktstelle kann über eine oder mehrere Kontaktpunktintegrationen verfügen, z. B. Amazon Simple Notification Service oder Slack. Wenn eine Warnung ausgelöst wird, wird eine Benachrichtigung an alle Kontaktpunkt-Integrationen gesendet, die für eine Kontaktstelle aufgeführt sind. Verwenden Sie optional [Benachrichtigungsvorlagen](v9-alerting-create-templates.md), um die Benachrichtigungen an die Kontaktpunkttypen anzupassen.

**Anmerkung**  
Sie können Kontaktpunkte für von Grafana verwaltete Benachrichtigungen erstellen und bearbeiten. Kontaktpunkte für Alertmanager-Benachrichtigungen sind schreibgeschützt.

## Mit Kontaktpunkten arbeiten
<a name="v9-alerting-working-contact-points"></a>

In den folgenden Verfahren wird detailliert beschrieben, wie Kontaktpunkte hinzugefügt, bearbeitet, getestet und gelöscht werden.

**Um eine Kontaktstelle hinzuzufügen**

1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Warnsymbol** (Glocke), um die Warnseite zu öffnen.**

1. **Wählen Sie **Kontaktpunkte** und dann Kontaktstelle hinzufügen.**

1. Wählen Sie im Drop-down-Menü **Alertmanager** einen Alertmanager aus. Der Grafana Alertmanager ist standardmäßig ausgewählt.

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

1. Wählen **Sie unter Kontaktpunktintegration** einen Typ und die darauf basierenden Pflichtfelder aus. Wenn du dich beispielsweise für Slack entscheidest, gib die Slack-Kanäle und Benutzer ein, die kontaktiert werden sollen.

1. Falls für den von dir ausgewählten Kontaktpunkt verfügbar, wähle die gewünschten **optionalen Einstellungen, um zusätzliche Einstellungen** festzulegen.

1. Wählen Sie unter **Benachrichtigungseinstellungen** optional die Option **Gelöste Nachricht deaktivieren** aus, wenn Sie nicht benachrichtigt werden möchten, wenn eine Warnung behoben wird.

1. Wenn Ihre Kontaktstelle mehr Kontaktpunkttypen benötigt, können Sie **Kontaktpunktintegration hinzufügen** auswählen und die Schritte für jeden benötigten Kontaktpunkttyp wiederholen.

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

**Um eine Kontaktstelle zu bearbeiten**

1. Wählen Sie **Kontaktstellen**, um eine Liste der vorhandenen Kontaktstellen zu sehen.

1. Wählen Sie die Kontaktstelle aus, die Sie bearbeiten möchten, und wählen Sie dann das **Bearbeiten-Symbol** (Stift).

1. Nehmen Sie alle erforderlichen Änderungen vor und wählen Sie dann **Kontaktstelle speichern**, um Ihre Änderungen zu speichern.

Nachdem Ihre Kontaktstelle erstellt wurde, können Sie eine Testbenachrichtigung senden, um zu überprüfen, ob sie ordnungsgemäß konfiguriert ist.

**Um eine Testbenachrichtigung zu senden**

1. Wählen Sie **Kontaktstellen**, um die Liste der vorhandenen Kontaktstellen zu öffnen.

1. Wählen Sie die Kontaktstelle aus, die Sie testen möchten, und wählen Sie dann das **Bearbeiten-Symbol** (Stift).

1. Wählen Sie das **Testsymbol** (Papierflugzeug).

1. Wählen Sie aus, ob Sie eine vordefinierte Testbenachrichtigung senden möchten, oder wählen Sie **Benutzerdefiniert**, um der Testbenachrichtigung Ihre eigenen benutzerdefinierten Anmerkungen und Beschriftungen hinzuzufügen.

1. Wählen Sie **Testbenachrichtigung senden**, um die Warnung mit den angegebenen Kontaktpunkten zu testen.

Sie können Kontaktpunkte löschen, die nicht von einer Benachrichtigungsrichtlinie verwendet werden.

**Um eine Kontaktstelle zu löschen**

1. Wählen Sie **Kontaktstellen**, um die Liste der vorhandenen Kontaktstellen zu öffnen.

1. Wählen Sie die Kontaktstelle aus, die Sie löschen möchten, und wählen Sie dann das **Löschen-Symbol** (Mülleimer).

1. Wählen Sie im Bestätigungsdialogfeld **Ja, löschen** aus.

**Anmerkung**  
Wenn der Kontaktpunkt von einer Benachrichtigungsrichtlinie verwendet wird, müssen Sie die Benachrichtigungsrichtlinie löschen oder sie so bearbeiten, dass sie einen anderen Kontaktpunkt verwendet, bevor Sie den Kontaktpunkt löschen.

## Liste der unterstützten Notifier
<a name="v9-alerting-contactpoint-supported-notifiers"></a>


|  Name  |  Typ  | 
| --- | --- | 
| Amazon SNS  |  sns  | 
|  OpsGenie  |  opsgenie  | 
| Pager Duty  |  pagerduty  | 
| Slack  |  slack  | 
|  VictorOps  |  victorops  | 

# Mit Benachrichtigungsrichtlinien arbeiten
<a name="v9-alerting-notification-policies"></a>

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

Benachrichtigungsrichtlinien bestimmen, wie Warnmeldungen an Kontaktstellen weitergeleitet werden. Richtlinien haben eine Baumstruktur, wobei jede Richtlinie eine oder mehrere untergeordnete Richtlinien haben kann. Jede Richtlinie, mit Ausnahme der Stammrichtlinie, kann auch bestimmten Warnmeldungsbezeichnungen entsprechen. Jede Warnung wird anhand der Stammrichtlinie und anschließend anhand jeder untergeordneten Richtlinie bewertet. Wenn Sie die `Continue matching subsequent sibling nodes` Option für eine bestimmte Richtlinie aktivieren, wird die Auswertung auch nach einer oder mehreren Übereinstimmungen fortgesetzt. Die Konfigurationseinstellungen und Kontaktpunktinformationen einer übergeordneten Richtlinie regeln das Verhalten einer Warnung, die keiner der untergeordneten Richtlinien entspricht. Eine Stammrichtlinie regelt jede Warnung, die keiner bestimmten Richtlinie entspricht.

**Anmerkung**  
Sie können Benachrichtigungsrichtlinien für von Grafana verwaltete Benachrichtigungen erstellen und bearbeiten. Benachrichtigungsrichtlinien für Alertmanager-Benachrichtigungen sind schreibgeschützt.

**Benachrichtigungen gruppieren**

Durch die Gruppierung werden Warnmeldungen ähnlicher Art in einem einzigen Trichter kategorisiert. Auf diese Weise können Sie die Warnmeldungen bei größeren Ausfällen steuern, wenn viele Teile eines Systems gleichzeitig ausfallen und dadurch eine große Anzahl von Alarmen gleichzeitig ausgelöst wird.

**Beispiel für eine Gruppierung**

Angenommen, Sie haben 100 Dienste in verschiedenen Umgebungen mit einer Datenbank verbunden. Diese Dienste unterscheiden sich anhand der Bezeichnung`env=environmentname`. Es gibt eine Warnregel, mit der überwacht wird, ob Ihre Dienste die Datenbank erreichen können. Die Warnungsregel erstellt Warnungen mit dem Namen`alertname=DatabaseUnreachable`.

Wenn eine Netzwerkpartition auftritt, bei der die Hälfte Ihrer Dienste die Datenbank nicht mehr erreichen kann, werden 50 verschiedene Warnungen ausgelöst. In diesem Fall möchten Sie eine einseitige Benachrichtigung (statt 50) mit einer Liste der betroffenen Umgebungen erhalten.

Sie können die Gruppierung so konfigurieren `group_by: [alertname]` (ohne die `env` Bezeichnung zu verwenden, die für jeden Dienst unterschiedlich ist). Wenn diese Konfiguration eingerichtet ist, sendet Grafana eine einzige kompakte Benachrichtigung, die alle betroffenen Umgebungen für diese Warnregel enthält.

**Spezielle Gruppen**

Grafana hat zwei spezielle Gruppen. Die Standardgruppe `group_by: null` gruppiert *alle* Alarme in einer einzigen Gruppe. Sie können auch eine spezielle Bezeichnung verwenden, um Benachrichtigungen `...` nach allen Bezeichnungen zu gruppieren, wodurch die Gruppierung effektiv deaktiviert wird und jede Warnung in eine eigene Gruppe gesendet wird.

## Working with notifications
<a name="v9-alerting-notification-policies-working"></a>

Die folgenden Verfahren zeigen Ihnen, wie Sie Benachrichtigungsrichtlinien erstellen und verwalten.

**Um die Root-Benachrichtigungsrichtlinie zu bearbeiten**

1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** zu öffnen.**

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

1. Wählen Sie im Drop-down-Menü **Alertmanager** den Alertmanager aus, den Sie bearbeiten möchten.

1. Wählen Sie im Bereich **Root-Richtlinie** das Symbol **Bearbeiten** (Stift) aus.

1. Aktualisieren **Sie unter Standardkontaktpunkt** die Kontaktstelle, an die Benachrichtigungen für Regeln gesendet werden sollen, wenn die Warnungsregeln keiner bestimmten Richtlinie entsprechen.

1. Wählen Sie unter **Gruppieren nach** die Labels (oder speziellen Gruppen) aus, nach denen Benachrichtigungen gruppiert werden sollen.

1. Wählen Sie **unter Zeitoptionen** eine der folgenden Optionen aus.
   + **Wartezeit für Gruppen** — Wartezeit bis zum Zwischenspeichern von Warnmeldungen derselben Gruppe, bevor eine erste Benachrichtigung gesendet wird. Standardmäßig ist ein Zeitraum von 30 Sekunden festgelegt.
   + **Gruppenintervall** — Minimales Zeitintervall zwischen zwei Benachrichtigungen für eine Gruppe. Der Standardwert ist 5 Minuten.
   + **Wiederholungsintervall** — Minimales Zeitintervall vor dem erneuten Senden einer Benachrichtigung, wenn der Gruppe keine neuen Benachrichtigungen hinzugefügt wurden. Die Standardeinstellung ist 4 Stunden.

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

**Um eine neue, spezifische Richtlinie auf oberster Ebene hinzuzufügen**

1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** zu öffnen.**

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

1. Wählen Sie im Drop-down-Menü **Alertmanager** den Alertmanager aus, den Sie bearbeiten möchten.

1. **Wählen Sie im Abschnitt **Spezifisches Routing die Option Neue spezifische** Richtlinie aus.**

1. **Fügen Sie im Abschnitt Passende Labels** ein oder mehrere passende Warnungslabels hinzu. Weitere Informationen zum Abgleich von Bezeichnungen finden Sie weiter unten in diesem Thema.

1. Fügen **Sie unter Kontaktpunkt** die Kontaktstelle hinzu, an die Benachrichtigungen gesendet werden sollen, wenn die Warnung dieser speziellen Richtlinie entspricht. Verschachtelte Richtlinien haben Vorrang vor dieser Kontaktstelle.

1. Aktivieren Sie optional die Option Mit dem **Abgleich aufeinanderfolgender gleichgeordneter Knoten** fortfahren, um den Abgleich von Richtlinien für gleichgeordnete Knoten auch dann fortzusetzen, wenn die Warnung mit der aktuellen Richtlinie übereinstimmt. Wenn diese Richtlinie aktiviert ist, können Sie mehr als eine Benachrichtigung für dieselbe Warnung erhalten.

1. Wählen Sie optional **Gruppierung überschreiben**, um eine Gruppierung anzugeben, die sich von der Stammrichtlinie unterscheidet.

1. Wählen Sie optional **Allgemeine Zeitangaben außer Kraft setzen, um** die Zeitoptionen in der Gruppenbenachrichtigungsrichtlinie außer Kraft zu setzen.

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

**Um eine verschachtelte Richtlinie hinzuzufügen**

1. Erweitern Sie die spezifische Richtlinie, unter der Sie eine verschachtelte Richtlinie erstellen möchten.

1. Wählen Sie **Verschachtelte Richtlinie hinzufügen** und fügen Sie dann die Details hinzu (wie beim Hinzufügen einer spezifischen Richtlinie der obersten Ebene).

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

**Um eine bestimmte Richtlinie zu bearbeiten**

1. Wählen Sie auf der Seite „**Benachrichtigungen**“ die Option **Benachrichtigungsrichtlinien** aus, um die Seite mit den vorhandenen Richtlinien zu öffnen.

1. Wählen Sie die Richtlinie aus, die Sie bearbeiten möchten, und klicken Sie dann auf das Symbol **Bearbeiten** (Stift).

1. Nehmen Sie alle Änderungen vor (z. B. beim Hinzufügen einer spezifischen Richtlinie auf oberster Ebene).

1. Wählen Sie **Richtlinie speichern**.

**Auf der Suche nach Richtlinien**

Sie können im Richtlinienbaum nach *Label-Matchern* oder *Kontaktstellen* suchen.
+ Um nach Kontaktstelle zu suchen, geben Sie einen vollständigen oder vollständigen Namen einer Kontaktstelle in das Feld **Nach Kontaktstelle suchen** ein.
+ Um nach Label zu suchen, geben Sie einen gültigen Label-Matcher in das Feld **Nach Label suchen** ein. Es können mehrere Matcher eingegeben werden, getrennt durch ein Komma. Eine gültige Matcher-Eingabe könnte beispielsweise sein. `severity=high, region=~EMEA|NA`
**Anmerkung**  
Bei der Suche nach Bezeichnungen werden alle übereinstimmenden Richtlinien exakt übereinstimmen. Partielle Übereinstimmungen und Übereinstimmungen im Regex-Stil werden nicht unterstützt.

**So funktioniert der Labelabgleich**

Eine Richtlinie entspricht einer Warnung, wenn die Bezeichnungen der Warnung mit allen in der Richtlinie angegebenen *übereinstimmenden Labels* übereinstimmen.
+ **Bezeichnung** — Der Name der Bezeichnung, der zugeordnet werden soll. Er muss exakt mit dem Labelnamen der Warnung übereinstimmen.
+ **Operator** — Der Operator, der verwendet wird, um den Labelwert mit dem passenden Labelwert zu vergleichen. Die verfügbaren Operatoren sind:
  + `=`Wählen Sie Beschriftungen aus, deren Wert genau mit der angegebenen Zeichenfolge übereinstimmt.
  + `!=`Wählen Sie Beschriftungen aus, deren Wert nicht mit der angegebenen Zeichenfolge übereinstimmt.
  + `=~`Wählen Sie Labels aus, deren Wert mit dem regex-interpretierten Wert der angegebenen Zeichenfolge übereinstimmt (die angegebene Zeichenfolge wird als regulärer Ausdruck interpretiert).
  + `!=`Wählen Sie Beschriftungen aus, die nicht mit dem angegebenen regulären Ausdruck übereinstimmen.
+ **Wert** — Der Wert, dem der Labelwert zugeordnet werden soll. Er kann je nach ausgewähltem Operator als Zeichenfolge oder als regulärer Ausdruck übereinstimmen.

# Benachrichtigungen anpassen
<a name="v9-alerting-notifications"></a>

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

Passen Sie Ihre Benachrichtigungen mit Vorlagen für Benachrichtigungen an.

Sie können Benachrichtigungsvorlagen verwenden, um den Titel, die Nachricht und das Format der Nachricht in Ihren Benachrichtigungen zu ändern.

Benachrichtigungsvorlagen sind nicht an bestimmte Kontaktpunkt-Integrationen wie E-Mail oder Slack gebunden. Sie können sich jedoch dafür entscheiden, separate Benachrichtigungsvorlagen für verschiedene Kontaktpunkt-Integrationen zu erstellen.

Sie können Benachrichtigungsvorlagen verwenden, um:
+ Informationen in der Benachrichtigung hinzufügen, entfernen oder neu anordnen, einschließlich Zusammenfassung, Beschreibung, Beschriftungen und Anmerkungen, Werten und Links
+ Formatieren Sie Text fett und kursiv und fügen Sie Zeilenumbrüche hinzu oder entfernen Sie sie

Sie können Benachrichtigungsvorlagen nicht verwenden, um:
+ Ändern Sie das Design von Benachrichtigungen in Instant-Messaging-Diensten wie Slack und Microsoft Teams

**Topics**
+ [Verwendung der Template-Sprache von Go](v9-alerting-notifications-go-templating.md)
+ [Vorlagen für Benachrichtigungen erstellen](v9-alerting-create-templates.md)
+ [Vorlage – Referenz](v9-alerting-template-reference.md)

# Verwendung der Template-Sprache von Go
<a name="v9-alerting-notifications-go-templating"></a>

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

[Sie schreiben Benachrichtigungsvorlagen in der Vorlagensprache von Go, Text/Vorlage.](https://pkg.go.dev/text/template)

Dieser Abschnitt bietet einen Überblick über die Vorlagensprache von Go und das Schreiben von Vorlagen in Text/Vorlage.

## Punkt
<a name="v9-go-dot"></a>

Darin text/template befindet sich ein spezieller Cursor namens Punkt, der als geschrieben wird`.`. Sie können sich diesen Cursor als eine Variable vorstellen, deren Wert sich ändert, je nachdem, wo in der Vorlage er verwendet wird. Beispielsweise `.` bezieht sich eine Benachrichtigungsvorlage zu Beginn auf das `ExtendedData` Objekt, das eine Reihe von Feldern enthält`Alerts`, darunter `Status``GroupLabels`,`CommonLabels`, `CommonAnnotations` und`ExternalURL`. Punkt kann sich jedoch auf etwas anderes beziehen, wenn es in einer Liste verwendet wird, wenn `range` es in einer Liste verwendet wird, wenn es innerhalb einer verwendet wird oder wenn Feature-Vorlagen geschrieben werden`with`, die in anderen Vorlagen verwendet werden sollen. Beispiele dafür finden Sie in [Vorlagen für Benachrichtigungen erstellen](v9-alerting-create-templates.md) und alle Daten und Funktionen in der[Vorlage – Referenz](v9-alerting-template-reference.md).

## Tags öffnen und schließen
<a name="v9-go-openclosetags"></a>

In text/template beginnen `{{` und enden Vorlagen mit, `}}` unabhängig davon, ob die Vorlage eine Variable druckt oder Kontrollstrukturen wie if-Anweisungen ausführt. Dies unterscheidet sich von anderen Template-Sprachen wie Jinja, wo das Drucken einer Variablen und und `{{` Kontrollstrukturen `}}` und verwenden. `{%` `%}`

## Print (Ausgabe)
<a name="v9-go-print"></a>

Um den Wert von etwas zu drucken, verwende `{{` und. `}}` Sie können den Wert eines Punkts, ein Punktfeld, das Ergebnis einer Funktion und den Wert einer [Variablen](#v9-go-variables) drucken. Um beispielsweise das `Alerts` Feld zu drucken, auf das sich der Punkt bezieht, würden `ExtendedData` Sie Folgendes schreiben:

```
{{ .Alerts }}
```

## Iterieren Sie über Warnmeldungen
<a name="v9-go-iterate-alerts"></a>

Um nur die Beschriftungen jeder Warnung und nicht alle Informationen über die Warnung zu drucken, können Sie a verwenden, um die Warnungen in `range` folgenden Schritten zu iterieren: `ExtendedData`

```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
```

Innerhalb des Bereichs bezieht sich der Punkt nicht mehr auf`ExtendedData`, sondern auf eine`Alert`. Sie können `{{ .Labels }}` es verwenden, um die Beschriftungen der einzelnen Warnmeldungen zu drucken. Das funktioniert, weil `{{ range .Alerts }}` sich der Punkt so ändert, dass er sich auf die aktuelle Warnung in der Liste der Benachrichtigungen bezieht. Wenn der Bereich abgeschlossen ist, wird der Punkt auf den Wert zurückgesetzt, den er vor dem Beginn des Bereichs hatte. In diesem Beispiel ist das`ExtendedData`:

```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
{{/* does not work, .Labels does not exist here */}}
{{ .Labels }}
{{/* works, cursor was reset */}}
{{ .Status }}
```

## Iterieren Sie über Anmerkungen und Beschriftungen
<a name="v9-go-iterate-labels"></a>

Lassen Sie uns eine Vorlage schreiben, um die Beschriftungen jeder Warnung in dem Format zu drucken`The name of the label is $name, and the value is $value`, in dem sie den Namen `$name` und den Wert jedes Labels `$value` enthalten.

Verwenden Sie wie im vorherigen Beispiel einen Bereich, um über die Warnungen zu iterieren, sodass der Punkt auf die aktuelle Warnung in der Liste der Warnungen verweist, und verwenden Sie dann einen zweiten Bereich für die sortierten Beschriftungen, sodass der Punkt ein zweites Mal aktualisiert wird, sodass er auf das aktuelle Label verweist. `.Alerts` Verwenden Sie innerhalb des zweiten Bereichs `.Name` und`.Value`, um den Namen und den Wert jedes Labels zu drucken:

```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
The name of the label is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ range .Annotations.SortedPairs }}
The name of the annotation is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ end }}
```

## Wenn Aussagen
<a name="v9-go-if"></a>

Sie können if-Anweisungen in Vorlagen verwenden. Um beispielsweise zu drucken, `There are no alerts` wenn keine Warnmeldungen enthalten sind, würden `.Alerts` Sie Folgendes schreiben:

```
{{ if .Alerts }}
There are alerts
{{ else }}
There are no alerts
{{ end }}
```

## Mit
<a name="v9-go-with"></a>

With ähnelt if-Anweisungen, `with` aktualisiert jedoch im Gegensatz zu if-Anweisungen den Punkt so, dass er auf den Wert von with verweist:

```
{{ with .Alerts }}
There are {{ len . }} alert(s)
{{ else }}
There are no alerts
{{ end }}
```

## Variablen
<a name="v9-go-variables"></a>

Variablen in text/template müssen innerhalb der Vorlage erstellt werden. Um beispielsweise eine Variable zu erstellen, die `$variable` mit dem aktuellen Wert von Punkt aufgerufen wird, würden Sie Folgendes schreiben:

```
{{ $variable := . }}
```

Sie können `$variable` innerhalb eines Bereichs oder verwenden `with` und es bezieht sich auf den Wert von Punkt zu dem Zeitpunkt, als die Variable definiert wurde, und nicht auf den aktuellen Wert von Punkt.

Sie können beispielsweise keine Vorlage schreiben, die den zweiten `{{ .Labels }}` Bereich verwendet, da sich Punkt hier auf das aktuelle Label bezieht, nicht auf die aktuelle Warnung:

```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* does not work because in the second range . is a label not an alert */}}
There are {{ len .Labels }}
{{ end }}
{{ end }}
```

Sie können dies beheben, indem Sie eine Variable definieren, die `$alert` im ersten Bereich und vor dem zweiten Bereich aufgerufen wird:

```
{{ range .Alerts }}
{{ $alert := . }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* works because $alert refers to the value of dot inside the first range */}}
There are {{ len $alert.Labels }}
{{ end }}
{{ end }}
```

## Bereich mit Index
<a name="v9-go-rangeindex"></a>

Sie können den Index jeder Warnung innerhalb eines Bereichs abrufen, indem Sie Index- und Wertvariablen am Anfang des Bereichs definieren:

```
{{ $num_alerts := len .Alerts }}
{{ range $index, $alert := .Alerts }}
This is alert {{ $index }} out of {{ $num_alerts }}
{{ end }}
```

## Definieren Sie Vorlagen
<a name="v9-go-define"></a>

Sie können Vorlagen definieren, die in anderen Vorlagen verwendet werden können, indem Sie `define` den Namen der Vorlage in doppelten Anführungszeichen verwenden. Sie sollten keine Vorlagen mit demselben Namen wie andere Vorlagen definieren, einschließlich Standardvorlagen wie `__subject``__text_values_list`,`__text_alert_list`, `default.title` und`default.message`. Wenn eine Vorlage mit demselben Namen wie eine Standardvorlage oder eine Vorlage in einer anderen Benachrichtigungsvorlage erstellt wurde, verwendet Grafana möglicherweise eine der beiden Vorlagen. Grafana verhindert nicht und zeigt auch keine Fehlermeldung an, wenn es zwei oder mehr Vorlagen mit demselben Namen gibt.

```
{{ define "print_labels" }}
{{ end }}
```

## Vorlagen einbetten
<a name="v9-go-embed"></a>

Sie können eine definierte Vorlage in Ihre Vorlage einbetten`template`, indem Sie den Namen der Vorlage in doppelten Anführungszeichen und den Cursor, der an die Vorlage übergeben werden soll, verwenden:

```
{{ template "print_labels" . }}
```

## Übergeben Sie Daten an Vorlagen
<a name="v9-go-passdata"></a>

Innerhalb einer Vorlage bezieht sich der Punkt auf den Wert, der an die Vorlage übergeben wird.

Wenn einer Vorlage beispielsweise eine Liste mit Auslösewarnungen übergeben wird, bezieht sich Punkt auf diese Liste von Auslösewarnungen:

```
{{ template "print_alerts" .Alerts }}
```

Wenn der Vorlage die sortierten Labels für eine Warnung übergeben werden, bezieht sich Punkt auf die Liste der sortierten Labels:

```
{{ template "print_labels" .SortedLabels }}
```

Dies ist nützlich, wenn Sie wiederverwendbare Vorlagen schreiben. Um beispielsweise alle Benachrichtigungen zu drucken, könnten Sie Folgendes schreiben:

```
{{ template "print_alerts" .Alerts }}
```

Um dann nur die Feuermeldungen auszudrucken, könnten Sie Folgendes schreiben:

```
{{ template "print_alerts" .Alerts.Firing }}
```

Das funktioniert, weil es sich bei beiden `.Alerts` um Listen von Warnmeldungen `.Alerts.Firing` handelt.

```
{{ define "print_alerts" }}
{{ range . }}
{{ template "print_labels" .SortedLabels }}
{{ end }}
{{ end }}
```

## Kommentare
<a name="v9-go-comments"></a>

Sie können Kommentare hinzufügen mit `{{/*` und`*/}}`:

```
{{/* This is a comment */}}
```

Um zu verhindern, dass Kommentare Zeilenumbrüche hinzufügen, verwende:

```
{{- /* This is a comment with no leading or trailing line breaks */ -}}
```

## Einrückung
<a name="v9-go-indentation"></a>

Sie können Einzüge, sowohl Tabulatoren als auch Leerzeichen, und Zeilenumbrüche verwenden, um die Lesbarkeit von Vorlagen zu verbessern:

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

Einrückungen in der Vorlage werden jedoch auch im Text vorhanden sein. Als nächstes werden wir sehen, wie man es entfernt.

## Entferne Leerzeichen und Zeilenumbrüche
<a name="v9-go-removespace"></a>

Wird text/template verwendet `{{-` und dient `-}}` zum Entfernen von führenden und nachfolgenden Leerzeichen und Zeilenumbrüchen.

Wenn Sie beispielsweise Einrückungen und Zeilenumbrüche verwenden, um eine Vorlage lesbarer zu machen:

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

Der Einzug und die Zeilenumbrüche werden auch im Text vorhanden sein:

```
    alertname = "Test"

    grafana_folder = "Test alerts"
```

Sie können den Einzug und die Zeilenumbrüche aus dem Text entfernen, indem Sie `}}` zu `-}}` Beginn jedes Bereichs wechseln:

```
{{ range .Alerts -}}
  {{ range .Labels.SortedPairs -}}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

Der Einzug und die Zeilenumbrüche in der Vorlage fehlen jetzt im Text:

```
alertname = "Test"
grafana_folder = "Test alerts"
```

# Vorlagen für Benachrichtigungen erstellen
<a name="v9-alerting-create-templates"></a>

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

Erstellen Sie wiederverwendbare Benachrichtigungsvorlagen, die Sie an Ihre Kontaktstellen senden können.

Sie können Ihrer Benachrichtigungsvorlage eine oder mehrere Vorlagen hinzufügen.

Der Name Ihrer Benachrichtigungsvorlage muss eindeutig sein. Sie können nicht zwei Vorlagen mit demselben Namen in derselben Benachrichtigungsvorlage oder in verschiedenen Benachrichtigungsvorlagen haben. Vermeiden Sie es, Vorlagen mit demselben Namen wie Standardvorlagen zu definieren, z. B.: `__subject``__text_values_list`,`__text_alert_list`, `default.title` und`default.message`.

Auf der Registerkarte Kontaktstellen finden Sie eine Liste Ihrer Benachrichtigungsvorlagen.

## Vorlagen für Benachrichtigungen erstellen
<a name="v9-alerting-creating-templates"></a>

**Um eine Benachrichtigungsvorlage zu erstellen**

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

1. Wählen Sie einen Namen für die Benachrichtigungsvorlage, z. `email.subject` B.

1. Schreiben Sie den Inhalt der Vorlage in das Inhaltsfeld.

   Beispiel:

   ```
   {{ if .Alerts.Firing -}}
      {{ len .Alerts.Firing }} firing alerts
      {{ end }}
      {{ if .Alerts.Resolved -}}
      {{ len .Alerts.Resolved }} resolved alerts
      {{ end }}
   ```

1. Klicken Sie auf Speichern.

   `{{ define "email.subject" }}`(wo `email.subject` ist der Name Ihrer Vorlage) und `{{ end }}` wird automatisch am Anfang und Ende des Inhalts hinzugefügt.

**Um eine Benachrichtigungsvorlage zu erstellen, die mehr als eine Vorlage enthält:**

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

1. Geben Sie einen Namen für die gesamte Benachrichtigungsvorlage ein. Beispiel, `email`.

1. Schreiben Sie jede Vorlage in das Feld Inhalt, einschließlich `{{ define "name-of-template" }}` und `{{ end }}` am Anfang und Ende jeder Vorlage. Sie können für jede Vorlage in der Benachrichtigungsvorlage aussagekräftige Namen verwenden, z. B. `email.subject` oder`email.message`. Verwenden Sie in diesem Fall nicht den Namen der Benachrichtigungsvorlage, den Sie oben eingegeben haben.

   In den folgenden Abschnitten finden Sie detaillierte Beispiele für Vorlagen, die Sie erstellen könnten.

1. Klicken Sie auf Speichern.

## Eine Vorlage für den Betreff einer E-Mail erstellen
<a name="v9-alerting-create-template-subject"></a>

Erstellen Sie eine Vorlage für den Betreff einer E-Mail, die die Anzahl der ausgelösten und gelösten Benachrichtigungen enthält, wie in diesem Beispiel:

```
1 firing alerts, 0 resolved alerts
```

**Um eine Vorlage für den Betreff einer E-Mail zu erstellen**

1. Erstellen Sie eine Vorlage namens `email.subject` mit dem folgenden Inhalt:

   ```
   {{ define "email.subject" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Verwenden Sie die Vorlage bei der Erstellung Ihrer Kontaktpunktintegration, indem Sie sie in das Feld **Betreff** mit dem `template` Schlüsselwort einfügen.

   ```
   {{ template "email.subject" . }}
   ```

## Erstellen Sie eine Vorlage für die Nachricht einer E-Mail
<a name="v9-alerting-create-template-message"></a>

Erstellen Sie eine Vorlage für die Nachricht einer E-Mail, die eine Zusammenfassung aller ausgelösten und gelösten Alarme enthält, wie in diesem Beispiel:

```
There are 2 firing alerts, and 1 resolved alerts

Firing alerts:

- alertname=Test 1 grafana_folder=GrafanaCloud has value(s) B=1
- alertname=Test 2 grafana_folder=GrafanaCloud has value(s) B=2

Resolved alerts:

- alertname=Test 3 grafana_folder=GrafanaCloud has value(s) B=0
```

**Um eine Vorlage für die Nachricht einer E-Mail zu erstellen**

1. Erstellen Sie eine Benachrichtigungsvorlage `email` mit zwei Vorlagen im Inhalt: `email.message_alert` und`email.message`.

   Die `email.message_alert` Vorlage wird verwendet, um die Bezeichnungen und Werte für jede ausgelöste und behobene Warnung zu drucken, wobei die `email.message` Vorlage die Struktur der E-Mail enthält.

   ```
   {{- define "email.message_alert" -}}
   {{- range .Labels.SortedPairs }}{{ .Name }}={{ .Value }} {{ end }} has value(s)
   {{- range $k, $v := .Values }} {{ $k }}={{ $v }}{{ end }}
   {{- end -}}
   
   {{ define "email.message" }}
   There are {{ len .Alerts.Firing }} firing alerts, and {{ len .Alerts.Resolved }} resolved alerts
   
   {{ if .Alerts.Firing -}}
   Firing alerts:
   {{- range .Alerts.Firing }}
   - {{ template "email.message_alert" . }}
   {{- end }}
   {{- end }}
   
   {{ if .Alerts.Resolved -}}
   Resolved alerts:
   {{- range .Alerts.Resolved }}
   - {{ template "email.message_alert" . }}
   {{- end }}
   {{- end }}
   
   {{ end }}
   ```

1. Verwenden Sie die Vorlage bei der Erstellung Ihrer Kontaktpunktintegration, indem Sie sie in das **Textfeld** mit dem `template` Schlüsselwort einfügen.

   ```
   {{ template "email.message" . }}
   ```

## Eine Vorlage für den Titel einer Slack-Nachricht erstellen
<a name="v9-alerting-create-template-slack-title"></a>

Erstelle eine Vorlage für den Titel einer Slack-Nachricht, die die Anzahl der ausgelösten und gelösten Alerts enthält, wie im folgenden Beispiel:

```
1 firing alerts, 0 resolved alerts
```

**Um eine Vorlage für den Titel einer Slack-Nachricht zu erstellen**

1. Erstelle eine Vorlage namens `slack.title` mit dem folgenden Inhalt:

   ```
   {{ define "slack.title" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Verwenden Sie die Vorlage bei der Erstellung Ihrer Kontaktpunktintegration, indem Sie sie in das **Titelfeld** mit dem `template` Schlüsselwort einfügen.

   ```
   {{ template "slack.title" . }}
   ```

## Eine Vorlage für den Inhalt einer Slack-Nachricht erstellen
<a name="v9-alerting-create-template-slack-message"></a>

Erstelle eine Vorlage für den Inhalt einer Slack-Nachricht, die eine Beschreibung aller ausgelösten und gelösten Alerts enthält, einschließlich ihrer Labels, Anmerkungen und Dashboard-URL:

```
1 firing alerts:

[firing] Test1
Labels:
- alertname: Test1
- grafana_folder: GrafanaCloud
Annotations:
- description: This is a test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1

1 resolved alerts:

[firing] Test2
Labels:
- alertname: Test2
- grafana_folder: GrafanaCloud
Annotations:
- description: This is another test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1
```

**Um eine Vorlage für den Inhalt einer Slack-Nachricht zu erstellen**

1. Erstelle ein Template namens `slack` mit zwei Templates im Inhalt: `slack.print_alert` und`slack.message`.

   Die `slack.print_alert` Vorlage wird zum Drucken der Beschriftungen, Anmerkungen und der Dashboard-URL verwendet, während die `slack.message` Vorlage die Struktur der Benachrichtigung enthält.

   ```
   {{ define "slack.print_alert" -}}
   [{{.Status}}] {{ .Labels.alertname }}
   Labels:
   {{ range .Labels.SortedPairs -}}
   - {{ .Name }}: {{ .Value }}
   {{ end -}}
   {{ if .Annotations -}}
   Annotations:
   {{ range .Annotations.SortedPairs -}}
   - {{ .Name }}: {{ .Value }}
   {{ end -}}
   {{ end -}}
   {{ if .DashboardURL -}}
     Go to dashboard: {{ .DashboardURL }}
   {{- end }}
   {{- end }}
   
   {{ define "slack.message" -}}
   {{ if .Alerts.Firing -}}
   {{ len .Alerts.Firing }} firing alerts:
   {{ range .Alerts.Firing }}
   {{ template "slack.print_alert" . }}
   {{ end -}}
   {{ end }}
   {{ if .Alerts.Resolved -}}
   {{ len .Alerts.Resolved }} resolved alerts:
   {{ range .Alerts.Resolved }}
   {{ template "slack.print_alert" .}}
   {{ end -}}
   {{ end }}
   {{- end }}
   ```

1. Verwenden Sie die Vorlage bei der Erstellung Ihrer Kontaktpunktintegration, indem Sie sie in das Feld **Textkörper mit dem Schlüsselwort einfügen**. `template`

   ```
   {{ template "slack.message" . }}
   ```

## Template sowohl für E-Mail als auch für Slack mit gemeinsam genutzten Vorlagen
<a name="v9-alerting-create-shared-templates"></a>

Anstatt separate Benachrichtigungsvorlagen für jeden Kontaktpunkt wie E-Mail und Slack zu erstellen, kannst du dieselbe Vorlage gemeinsam nutzen.

Wenn du beispielsweise eine E-Mail mit diesem Betreff und eine Slack-Nachricht mit diesem Titel senden möchtest`1 firing alerts, 0 resolved alerts`, kannst du eine gemeinsame Vorlage erstellen.

**Um eine gemeinsame Vorlage zu erstellen**

1. Erstellen Sie eine Vorlage namens `common.subject_title` mit dem folgenden Inhalt:

   ```
   {{ define "common.subject_title" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Führen Sie für E-Mails die Vorlage im Betreff-Feld Ihrer E-Mail-Kontaktpunkt-Integration aus:

   ```
   {{ template "common.subject_title" . }}
   ```

1. Für Slack führe die Vorlage im Titelfeld deiner Slack-Kontaktpunkt-Integration aus:

   ```
   {{ template "common.subject_title" . }}
   ```

## Verwenden von Benachrichtigungsvorlagen
<a name="v9-alerting-use-notification-templates"></a>

Verwenden Sie Vorlagen in Kontaktpunkten, um Ihre Benachrichtigungen zu personalisieren.

**Um eine Vorlage beim Erstellen einer Kontaktstelle zu verwenden**

1. Wählen Sie im Menü **„Benachrichtigungen**“ die Option **Kontaktstellen** aus, um eine Liste der vorhandenen Kontaktstellen anzuzeigen.

1. Wählen Sie **Kontaktstelle hinzufügen**. Alternativ können Sie eine bestehende Kontaktstelle bearbeiten, indem Sie neben der Kontaktstelle, die Sie **bearbeiten** möchten, auf das Symbol Bearbeiten (Stift) klicken.

1. Geben Sie die Vorlagen, die Sie verwenden möchten, in ein oder mehrere Felder ein, z. B. **Nachricht** oder **Betreff**. Um eine Vorlage einzugeben, verwenden Sie das Formular `{{ template "template_name" . }}` und *template\$1name* ersetzen Sie es durch den Namen der Vorlage, die Sie verwenden möchten.

1. Klicken Sie auf **Kontaktstelle speichern**.

# Vorlage – Referenz
<a name="v9-alerting-template-reference"></a>

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

Dieser Abschnitt enthält Referenzinformationen für die Erstellung Ihrer Vorlagen.

## Vorlagendaten
<a name="v9-alerting-template-data"></a>

Die folgenden Daten werden an Nachrichtenvorlagen übergeben.


| Name | Typ | Hinweise | 
| --- | --- | --- | 
|  `Receiver`  |  Zeichenfolge  |  Name der Kontaktstelle, an die die Benachrichtigung gesendet wird.  | 
|  `Status`  |  Zeichenfolge  |  wird ausgelöst, wenn mindestens ein Alarm ausgelöst wird, andernfalls behoben.  | 
|  `Alerts`  |  Warnung  |  Liste der Alarmobjekte, die in dieser Benachrichtigung enthalten sind (siehe unten).  | 
|  `GroupLabels`  |  KeyValue  |  Labels, nach denen diese Alerts gruppiert wurden.  | 
|  `CommonLabels`  |  KeyValue  |  Bezeichnungen, die allen in dieser Benachrichtigung enthaltenen Warnungen gemeinsam sind.  | 
|  `CommonAnnotations`  |  KeyValue  |  Anmerkungen, die allen in dieser Benachrichtigung enthaltenen Warnungen gemeinsam sind.  | 
|  `ExternalURL`  |  Zeichenfolge  |  Backlink zu der Grafana, die die Benachrichtigung gesendet hat. Wenn Sie einen externen Alertmanager verwenden, verlinken Sie zurück zu diesem Alertmanager.  | 

Der `Alerts` Typ stellt zwei Funktionen zum Filtern der zurückgegebenen Warnungen zur Verfügung.
+ `Alerts.Firing`— Gibt eine Liste von Auslösewarnungen zurück.
+ `Alerts.Resolved`— Gibt eine Liste der behobenen Alarme zurück.

**Warnung (Typ)**

Der Warnungstyp enthält die folgenden Daten.


| Name | Typ | Hinweise | 
| --- | --- | --- | 
|  Status  |  Zeichenfolge  |  `firing` oder `resolved`.  | 
|  Labels  |  KeyValue  |  Eine Reihe von Bezeichnungen, die der Warnung beigefügt sind.  | 
|  Anmerkungen  |  KeyValue  |  Eine Reihe von Anmerkungen, die der Warnung beigefügt sind.  | 
| Werte | KeyValue | Die Werte aller Ausdrücke, einschließlich der klassischen Bedingungen | 
|  StartsAt  |  Zeit.Zeit  |  Uhrzeit, zu der der Alarm ausgelöst wurde.  | 
|  EndsAt  |  Zeit. Zeit  |  Wird nur gesetzt, wenn die Endzeit einer Warnung bekannt ist. Andernfalls wird ein konfigurierbarer Timeout-Zeitraum ab dem Zeitpunkt seit dem Empfang der letzten Warnung festgelegt.  | 
|  Generator-URL  |  Zeichenfolge  |  Ein Backlink zu Grafana oder einem externen Alertmanager.  | 
|  Silence-URL  |  Zeichenfolge  |  Ein Link zum Stummschalten der Warnung (mit vorgefüllten Bezeichnungen für diese Warnung). Nur für von Grafana verwaltete Benachrichtigungen.  | 
|  Dashboard-URL  |  Zeichenfolge  |  Link zum Grafana-Dashboard, falls die Warnungsregel zu einer gehört. Nur für von Grafana verwaltete Benachrichtigungen.  | 
|  Panel-URL  |  Zeichenfolge  |  Link zum Grafana-Dashboard-Panel, falls die Warnungsregel zu einer gehört. Nur für von Grafana verwaltete Benachrichtigungen.  | 
|  Fingerabdruck  |  Zeichenfolge  |  Fingerabdruck, der zur Identifizierung der Warnung verwendet werden kann.  | 
|  ValueString  |  Zeichenfolge  |  Eine Zeichenfolge, die die Bezeichnungen und den Wert jedes reduzierten Ausdrucks in der Warnung enthält.  | 

 **ExtendedData**

Das ExtendedData Objekt enthält die folgenden Eigenschaften.


| Name | Art | Description | Beispiel | 
| --- | --- | --- | --- | 
|  Empfänger  |  `string`  |  Der Name der Kontaktstelle, die die Benachrichtigung sendet.  |  `{{ .Receiver }}`  | 
|  Status  |  `string`  |  Der Status ist `firing if at least one alert is firing, otherwise resolved.`  |  `{{ .Status }}`  | 
|  Benachrichtigungen  |  `[]Alert`  |  Liste aller ausgelösten und gelösten Alarme in dieser Benachrichtigung.  |  `There are {{ len .Alerts }} alerts`  | 
|  Feuerwarnungen  |  `[]Alert`  |  Liste aller Feuerwarnungen in dieser Benachrichtigung.  |  `There are {{ len .Alerts.Firing }} firing alerts`  | 
|  Behobene Warnungen  |  `[]Alert`  |  Liste aller gelösten Warnungen in dieser Benachrichtigung.  |  `There are {{ len .Alerts.Resolved }} resolved alerts`  | 
|  GroupLabels  |  `KeyValue`  |  Die Labels, die diese Warnungen in dieser Benachrichtigung gruppieren.  |  `{{ .GroupLabels }}`  | 
|  CommonLabels  |  `KeyValue`  |  Die Bezeichnungen, die allen Benachrichtigungen in dieser Benachrichtigung gemeinsam sind.  |  `{{ .CommonLabels }}`  | 
|  CommonAnnotations  |  `KeyValue`  |  Die Anmerkungen, die allen Warnungen in dieser Benachrichtigung gemeinsam sind.  |  `{{ .CommonAnnotations }}`  | 
|  Externe URL  |  `string`  |  Ein Link zum Grafana-Workspace oder Alertmanager, der diese Benachrichtigung gesendet hat.  |  `{{ .ExternalURL }}`  | 

**KeyValue Typ**

Der `KeyValue` Typ besteht aus einer Reihe von key/value Zeichenkettenpaaren, die Beschriftungen und Anmerkungen darstellen.

Neben dem direkten Zugriff auf die als `KeyValue` gespeicherten Daten gibt es auch Methoden zum Sortieren, Entfernen und Transformieren der Daten.


| Name | Argumente | Rückgabewert | Hinweise | Beispiel | 
| --- | --- | --- | --- | --- | 
|  SortedPairs  |    |  Sortierte Liste von Zeichenkettenpaaren aus Schlüssel und Wert  |    | `{{ .Annotations.SortedPairs }}` | 
|  Remove  |  [] Zeichenfolge  |  KeyValue  |  Gibt eine Kopie der Key/Value Map ohne die angegebenen Schlüssel zurück.  | `{{ .Annotations.Remove "summary" }}` | 
|  Namen  |    |  [] Zeichenfolge  |  Liste der Labelnamen  | `{{ .Names }}` | 
|  Werte  |    |  [] Zeichenfolge  |  Liste der Labelwerte  | `{{ .Values }}` | 

**Time (Zeit)**

Die Zeit stammt aus dem [https://pkg.go.dev/time#Time](https://pkg.go.dev/time#Time)Go-Paket. Sie können eine Uhrzeit in verschiedenen Formaten drucken. Um beispielsweise die Uhrzeit zu drucken, zu der eine Warnung ausgelöst wurde`Monday, 1st January 2022 at 10:00AM`, in diesem Format schreiben Sie die folgende Vorlage:

```
{{ .StartsAt.Format "Monday, 2 January 2006 at 3:04PM" }}
```

Eine Referenz für das Zeitformat von Go finden Sie [hier](https://pkg.go.dev/time#pkg-constants).

## Funktionen der Vorlage
<a name="v9-alerting-template-functions"></a>

Mithilfe von Vorlagenfunktionen können Sie Beschriftungen und Anmerkungen verarbeiten, um dynamische Benachrichtigungen zu generieren. Die folgenden Funktionen sind verfügbar.


| Name | Argumenttyp | Rückgabetyp | Description | 
| --- | --- | --- | --- | 
|  `humanize`  |  Zahl oder Zeichenfolge  |  Zeichenfolge  |  Konvertiert eine Zahl mithilfe metrischer Präfixe in ein besser lesbares Format.  | 
|  `humanize1024`  |  Zahl oder Zeichenfolge  |  Zeichenfolge  |  Wie Humanize, verwendet aber 1024 statt 1000 als Basis.  | 
|  `humanizeDuration`  |  Zahl oder Zeichenfolge  |  Zeichenfolge  |  Konvertiert eine Dauer in Sekunden in ein besser lesbares Format.  | 
|  `humanizePercentage`  |  Zahl oder Zeichenfolge  |  Zeichenfolge  |  Konvertiert einen Verhältniswert in einen Bruchteil von 100.  | 
|  `humanizeTimestamp`  |  Zahl oder Zeichenfolge  |  Zeichenfolge  |  Konvertiert einen Unix-Zeitstempel in Sekunden in ein besser lesbares Format.  | 
|  `title`  |  Zeichenfolge  |  Zeichenfolge  |  Strings.Title schreibt das erste Zeichen jedes Worts groß.  | 
|  `toUpper`  |  Zeichenfolge  |  Zeichenfolge  |  Zeichenketten. ToUpper, wandelt alle Zeichen in Großbuchstaben um.  | 
|  `toLower`  |  Zeichenfolge  |  Zeichenfolge  |  Zeichenketten. ToLower, wandelt alle Zeichen in Kleinbuchstaben um.  | 
|  `match`  |  Muster, Text  |  Boolesch  |  Regexp. MatchString Testet auf eine nicht verankerte Regexp-Übereinstimmung.  | 
|  `reReplaceAll`  |  Muster, Ersatz, Text  |  Zeichenfolge  |  Regexp. ReplaceAllString Regexp-Substitution, nicht verankert.  | 
|  `graphLink`  |  string — JSON-Objekt mit Feldern und `expr` `datasource`  |  Zeichenfolge  |  Gibt den Pfad zur grafischen Ansicht in Explore für den angegebenen Ausdruck und die angegebene Datenquelle zurück.  | 
|  `tableLink`  |  string — JSON-Objekt mit `expr` und `datasource` -Feldern  |  Zeichenfolge  |  Gibt den Pfad zur tabellarischen Ansicht in Explore für den angegebenen Ausdruck und die angegebene Datenquelle zurück.  | 
|  `args`  |  [] Schnittstelle \$1\$1  |  map [string] Schnittstelle \$1\$1  |  Konvertiert eine Liste von Objekten in eine Map mit Schlüsseln, zum Beispiel arg0, arg1. Verwenden Sie diese Funktion, um mehrere Argumente an Vorlagen zu übergeben.  | 
|  `externalURL`  |  nichts  |  Zeichenfolge  |  Gibt eine Zeichenfolge zurück, die die externe URL darstellt.  | 
|  `pathPrefix`  |  nichts  |  Zeichenfolge  |  Gibt den Pfad der externen URL zurück.  | 

Die folgende Tabelle zeigt Beispiele für die Verwendung der einzelnen Funktionen.


| Funktion | TemplateString | Input | Expected | 
| --- | --- | --- | --- | 
|  humanisieren  |  \$1\$1value humanisieren\$1  |  1234567,0  |  1,235 M  | 
|  humanisieren Sie 1024  |  \$1humanise1024 \$1value\$1  |  1048576,0  |  1 Minuten  | 
|  Dauer humanisieren  |  \$1humanizeDuration \$1value\$1  |  899,99  |  14 m 59 s  | 
|  Prozentsatz humanisieren  |  \$1HumanizePercentage \$1value\$1  |  0,1234567  |  12,35%  | 
|  Zeitstempel humanisieren  |  \$1HumanizeTimestamp \$1value\$1  |  1435065584,128  |  2015-06-23 13:19:44.128 \$10000 UTC  | 
|  Titel  |  \$1\$1wert \$1 Titel\$1  |  ein B C  |  Ein Bb Cc  | 
|  toUpper  |  \$1\$1value \$1 toUpper\$1  |  ein B C  |  EIN B C  | 
|  toLower  |  \$1\$1value \$1 toLower\$1  |  ein B C  |  ein b c  | 
|  match  |  \$1entspricht „a\$1“ \$1labels.instance\$1  |  aa  |  true  | 
|  reReplaceAll  |  \$1\$1 reReplaceAll „localhost :( .\$1)“ „meine.domain: \$11“ \$1labels.instance\$1\$1  |  localhost: 3000  |  meine.domain: 3000  | 
|  GraphLink  |  \$1\$1GraphLink „\$1\$1" expr\$1“:\$1 "hoch\$1“,\$1 "Datenquelle\$1“:\$1 "gdev-prometheus\$1"\$1“\$1\$1  |    |  /erkunden? left= ["now-1h“, "now“, "gdev-prometheus“, \$1"datasource“ :"gdev-prometheus“, "expr“ :"up“, "instant“ :false, "range“ :true\$1]  | 
|  Link zur Tabelle  |  \$1\$1TableLink „\$1\$1" expr\$1“:\$1 "nach oben\$1“,\$1 "Datenquelle\$1“:\$1 "gdev-prometheus\$1"\$1“\$1\$1  |    |  /erkunden? left= ["now-1h“, "now“, "gdev-prometheus“, \$1"datasource“ :"gdev-prometheus“, "expr“ :"up“, "instant“ :true, "range“ :false\$1]  | 
|  args  |  \$1\$1definiere „x"\$1\$1 \$1\$1.arg0\$1\$1 \$1\$1.arg1\$1\$1 \$1\$1end\$1\$1 \$1\$1Vorlage „x“ (Argumente 1 „2")\$1\$1  |    |  1 2  | 
|  Externe URL  |  \$1externe URL\$1  |    |  http://localhost/path/prefix  | 
|  Pfad-Präfix  |  \$1Pfadpräfix\$1  |    |  /Pfad/Präfix  | 

# Stummschalten von Warnmeldungen für Prometheus-Datenquellen
<a name="v9-alerting-silences"></a>

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

*Für externe Alert Manager-Datenquellen (einschließlich Amazon Managed Service for Prometheus) können Sie Warnmeldungen mit einer Stille unterdrücken.* Eine Stille verhindert nur, dass Benachrichtigungen erstellt werden: Stummschaltungen verhindern nicht, dass Warnungsregeln ausgewertet werden, und sie verhindern nicht, dass Warnungsinstanzen auf der Benutzeroberfläche angezeigt werden. Wenn Sie eine Warnung stummschalten, geben Sie ein Zeitfenster an, in dem sie unterdrückt werden soll.

Sie können Stummschaltungen für eine externe AlertManager-Datenquelle konfigurieren.

**Anmerkung**  
Um Warnmeldungen in regelmäßigen Zeitintervallen oder für andere Datenquellen (z. B. während regulärer Wartungsperioden) zu unterdrücken, verwenden Sie [Timings stummschalten](v9-alerting-notification-muting.md) anstelle von Stummschaltungen.

**Um eine Stille hinzuzufügen**

1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Warnsymbol** (Glocke), um die Warnseite zu öffnen.**

1. Wählen Sie **Stille**, um eine Seite mit einer vorhandenen Liste zu öffnen. [Mit Kontaktstellen arbeiten](v9-alerting-contact-points.md)

1. **Wählen Sie den externen Alertmanager aus der Dropdown-Liste Alertmanager aus.**

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

1. Wählen Sie das Start- und Enddatum **unter Start und Ende der Stille** aus, um anzugeben, wann die Stille in Kraft treten und wann sie enden soll.

   Als Alternative zur Festlegung einer Endzeit können Sie im Feld **Dauer** angeben, wie lange die Stille durchgesetzt wird. Dadurch wird die Endzeit im Feld **Start und Ende der Stille** automatisch aktualisiert.

1. Geben Sie in den Feldern **Name** und **Wert** ein oder mehrere *passende Labels* ein. Matcher bestimmen, für welche Regeln das Schweigen gilt. Der Labelabgleich wird im Anschluss an dieses Verfahren ausführlicher erörtert.

1. Fügen Sie optional einen **Kommentar** hinzu oder ändern Sie den **Ersteller** so, dass er den Besitzer der Stille festlegt.

1. Wählen Sie „**Erstellen**“, um die Stille zu erzeugen.

Sie können eine bestehende Stille bearbeiten, indem Sie das **Bearbeiten-Symbol** (Stift) wählen.

**Labelabgleich für die Unterdrückung von Alarmen**

Wenn Sie eine Stille erstellen, erstellen Sie im Rahmen der Stille eine Reihe von *passenden Bezeichnungen*. Dabei handelt es sich um eine Reihe von Regeln für Bezeichnungen, die übereinstimmen müssen, damit die Warnung unterdrückt wird. Die passenden Beschriftungen bestehen aus drei Teilen:
+ **Bezeichnung** — Der Name der Bezeichnung, der zugeordnet werden soll. Er muss exakt mit dem Labelnamen der Warnung übereinstimmen.
+ **Operator** — Der Operator, der verwendet wird, um den Labelwert mit dem passenden Labelwert zu vergleichen. Die verfügbaren Operatoren sind:
  + `=`Wählen Sie Labels aus, deren Wert genau mit der angegebenen Zeichenfolge übereinstimmt.
  + `!=`Wählen Sie Labels aus, deren Wert nicht mit der angegebenen Zeichenfolge übereinstimmt.
  + `=~`Wählen Sie Labels aus, deren Wert mit dem regex-interpretierten Wert der angegebenen Zeichenfolge übereinstimmt (die angegebene Zeichenfolge wird als regulärer Ausdruck interpretiert).
  + `!=`Wählen Sie Beschriftungen aus, die nicht mit dem angegebenen regulären Ausdruck übereinstimmen.
+ **Wert** — Der Wert, dem der Labelwert zugeordnet werden soll. Er kann je nach ausgewähltem Operator als Zeichenfolge oder als regulärer Ausdruck übereinstimmen.

Eine Stille endet am angegebenen Enddatum, Sie können die Unterdrückung jedoch jederzeit manuell beenden.

**Um eine Stille manuell zu beenden**

1. Wählen Sie auf der Seite **„Benachrichtigungen**“ die Option „**Stille**“, um die Liste der vorhandenen Pausen anzuzeigen.

1. **Wählen Sie die Stille aus, die Sie beenden möchten, und wählen Sie Stille aufheben.** Dadurch wird die Unterdrückung von Alarmen beendet.
**Anmerkung**  
Durch das Aufheben der Stummschaltung wird die Unterdrückung von Alarmen beendet, als ob die Endzeit für die aktuelle Uhrzeit festgelegt wäre. Stille, die (automatisch oder manuell) beendet wurde, werden fünf Tage lang beibehalten und in der Liste aufgeführt. Sie können eine Stille nicht manuell aus der Liste entfernen.

**Einen Link zum Formular zur Erstellung von Stille erstellen**

Sie können eine URL zum Formular zur Erstellung von Stille erstellen, wobei die Details bereits ausgefüllt sind. Bediener können dies verwenden, um einen Alarm während eines Betriebsereignisses schnell zu unterdrücken.

Wenn Sie einen Link zu einem Silence-Formular erstellen, verwenden Sie einen `matchers` Abfrageparameter, um die entsprechenden Bezeichnungen anzugeben, und einen `comment` Abfrageparameter, um einen Kommentar anzugeben. Der `matchers` Parameter erfordert einen oder mehrere Werte im Formular`[label][operator][value]`, getrennt durch Kommas.

**Beispiel-URL**

Verwenden Sie eine URL wie die folgende, um einen Link zu einem `cluster!~europe-.*` Silence-Formular mit passenden Bezeichnungen `severity=critical` und einem Kommentar`Silencing critical EU alerts`, der besagt, zu verlinken. *mygrafana*Ersetzen Sie durch den Hostnamen Ihrer Grafana-Instanz.

```
https://mygrafana/alerting/silence/new?matchers=severity%3Dcritical%2Ccluster!~europe-*&comment=Silence%20critical%20EU%20alert
```

Um eine Verknüpfung zu einer neuen Silence-Seite für einen externen Alertmanager herzustellen, fügen Sie einen `alertmanager` Abfrageparameter mit dem Alertmanage-Datenquellennamen hinzu, z. B. `alertmanager=myAlertmanagerdatasource`

# Timings stummschalten
<a name="v9-alerting-notification-muting"></a>

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

Eine Stummschaltung ist ein wiederkehrendes Zeitintervall, in dem keine neuen Benachrichtigungen für eine Richtlinie generiert oder gesendet werden. Verwenden Sie sie, um zu verhindern, dass Warnmeldungen für einen bestimmten und sich wiederholenden Zeitraum ausgelöst werden, z. B. während eines regulären Wartungszeitraums.

Ähnlich wie bei Stummschaltungen verhindern auch Stummschaltungen nicht, dass Warnungsregeln ausgewertet werden, und sie verhindern auch nicht, dass Warnungsinstanzen auf der Benutzeroberfläche angezeigt werden. Sie verhindern lediglich, dass Benachrichtigungen erstellt werden.

Sie können von Grafana verwaltete Stummschaltezeiten sowie Stummschaltezeiten für eine externe Alertmanager-Datenquelle konfigurieren.

**Stummschaltungen im Vergleich zu Stummschaltungen**

In der folgenden Tabelle werden die Unterschiede zwischen Stummschaltezeiten und Stummschaltungen hervorgehoben.


| Timing stummschalten | Stumm | 
| --- | --- | 
|  Verwendet Zeitintervalldefinitionen, die sich wiederholen können.  |  Hat eine feste Start- und Endzeit.  | 
|  Wird erstellt und dann zu den Benachrichtigungsrichtlinien hinzugefügt.  |  Verwendet Labels, um mit einer Warnung abzugleichen, um zu bestimmen, ob stummgeschaltet werden soll oder nicht.  | 
|  Funktioniert mit Grafana-Alerting und externen Alertmanagern.  |  Funktioniert nur mit externen Alertmanagern.  | 

**Um ein Timing zur Stummschaltung zu erstellen**

1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** zu öffnen.**

1. **Wählen Sie Benachrichtigungsrichtlinien.**

1. Wählen Sie im Drop-down-Menü **Alertmanager** den Alertmanager aus, den Sie bearbeiten möchten.

1. **Wählen Sie im Bereich **Timings für die Stummschaltung die Schaltfläche Timing** für Stummschaltung hinzufügen aus.**

1. Wählen Sie das Zeitintervall aus, für das die Stummschaltung gelten soll.

1. Wählen Sie „**Senden**“, um die Dauer der Stummschaltung zu erstellen.

**Um einer Benachrichtigungsrichtlinie einen Zeitpunkt für die Stummschaltung hinzuzufügen**

1. Wählen Sie die Benachrichtigungsrichtlinie aus, zu der Sie die Stummschaltung hinzufügen möchten, und klicken Sie auf die Schaltfläche **Bearbeiten**.

1. Wählen Sie in der Dropdownliste **für** die Dauer der Stummschaltung die Zeiten für die Stummschaltung aus, die Sie der Richtlinie hinzufügen möchten.

   Wählen Sie die Schaltfläche Richtlinie **speichern**.

**Zeitintervalle**

Ein Zeitintervall ist eine Definition für einen Zeitbereich. Wenn während dieses Intervalls eine Warnung ausgelöst wird, wird sie unterdrückt. Bereiche werden unterstützt mit `:` (zum Beispiel`monday:thursday`). Ein Timing für die Stummschaltung kann mehrere Zeitintervalle enthalten. Ein Zeitintervall besteht aus mehreren Feldern (Details in der folgenden Liste), die alle übereinstimmen müssen, damit die Alerts unterdrückt werden. Wenn Sie beispielsweise Wochentage und einen Zeitraum zwischen 8:00 `monday:friday` und 9:00 Uhr angeben, werden Benachrichtigungen von Montag bis Freitag von 8 bis 9 Uhr unterdrückt, am Samstag jedoch nicht von 8 bis 9 Uhr.
+ **Zeitraum — Die Tageszeit, zu** der Benachrichtigungen unterdrückt werden sollen. Besteht aus zwei Unterfeldern: **Startzeit** und **Endzeit.** Ein Beispiel für die Zeit ist`14:30`. Die Uhrzeit wird in 24-Stunden-Notation in UTC angegeben.
+ **Wochentage** — Die Wochentage. Dabei kann es sich um einen einzelnen Tag handeln`monday`, z. B. um einen Bereich`monday:friday`, oder um eine durch Kommas getrennte Liste von Tagen, z. B. `monday, tuesday, wednesday`
+ **Monate** — Die Monate, die ausgewählt werden sollen. Sie können Monate mit numerischen Bezeichnungen oder mit dem vollständigen Monatsnamen angeben, `1` oder `january` beide geben Januar an. Sie können einen einzelnen Monat, einen Bereich von Monaten oder eine durch Kommas getrennte Liste von Monaten angeben.
+ **Tage des Monats** — Die Daten innerhalb eines Monats. Die Werte können im Bereich von `1` - liegen`31`. Negative Werte geben die Tage des Monats in umgekehrter Reihenfolge an, `-1` stellen also den letzten Tag des Monats dar. Tage des Monats können als einzelner Tag, als Bereich von Tagen oder als durch Kommas getrennte Liste von Tagen angegeben werden.
+ **Jahre** — Das Jahr oder die Jahre für das Intervall. Beispiel, `2023:2025`.

Jedes dieser Elemente kann eine Liste sein, und mindestens ein Element im Element muss erfüllt sein, um eine Übereinstimmung zu erhalten. Wenn Sie also Jahre auf festlegen`2023:2025, 2027`, gilt dies für die Jahre 2023, 2024, 2025 und 2027 (aber nicht 2026).

Wenn ein Feld leer gelassen wird, entspricht jeder Zeitpunkt dem Feld. Ein Zeitpunkt muss allen Feldern entsprechen, um einem vollständigen Zeitintervall zu entsprechen.

Wenn Sie eine genaue Dauer angeben möchten, geben Sie alle für diese Dauer erforderlichen Optionen an. Wenn Sie beispielsweise ein Zeitintervall für den ersten Montag des Monats, für März, Juni, September und Dezember, zwischen 12:00 und 24:00 Uhr UTC erstellen möchten, könnte Ihre Zeitintervallspezifikation wie folgt lauten:
+ Zeitbereich:
  + Startzeit: `12:00`
  + Endzeit: `24:00`
+ Wochentage: `monday`
+ Monate: `3, 6, 9, 12`
+ Tage des Monats: `1:7`

# Warnungsgruppen anzeigen und nach Warnungsgruppen filtern
<a name="v9-alerting-viewfiltergroups"></a>

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

Warnungsgruppen zeigen gruppierte Alerts aus einer Alertmanager-Instanz an. Standardmäßig werden Warnungsregeln in Benachrichtigungsrichtlinien nach den Labelschlüsseln für die Stammrichtlinie gruppiert. Durch die Gruppierung allgemeiner Warnungsregeln in einer einzigen Warnungsgruppe wird verhindert, dass doppelte Warnungsregeln ausgelöst werden.

Sie können Warnungsgruppen anzeigen und auch nach Warnungsregeln filtern, die bestimmten Kriterien entsprechen.

**Um Warnungsgruppen anzuzeigen**

1. Klicken Sie im Grafana-Menü auf das **Warnsymbol** (Glocke), um die Warnseite mit den vorhandenen Benachrichtigungen zu öffnen.

1. Klicken Sie auf **Warnungsgruppen, um die Seite mit den vorhandenen Gruppen** zu öffnen.

1. Wählen Sie in der **Alertmanager-Dropdownliste** einen externen Alertmanager als Datenquelle aus.

1. Wählen Sie im Drop-down-Menü „**Benutzerdefiniert gruppieren nach“ eine Kombination von** Bezeichnungen aus, um eine andere Gruppierung als die Standardgruppierung anzuzeigen. Dies ist nützlich, um Ihre Gruppierung von Benachrichtigungsrichtlinien zu debuggen und zu überprüfen.

Wenn eine Warnung keine Bezeichnungen enthält, die entweder in der Gruppierung der Stammrichtlinie oder in der benutzerdefinierten Gruppierung angegeben wurden, wird die Warnung einer Catch-All-Gruppe mit dem Header von hinzugefügt. `No grouping`

**Um nach Label zu filtern**
+ Geben Sie **unter Suchen** ein vorhandenes Label ein, um Benachrichtigungen anzuzeigen, die dem Label entsprechen.

  Beispiel, `environment=production,region=~US|EU,severity!=warning`.

**Um nach Bundesland zu filtern**
+ Wählen Sie unter **Staaten den** Status Aktiv, Unterdrückt oder Nicht verarbeitet aus, um Benachrichtigungen anzuzeigen, die Ihrem ausgewählten Status entsprechen. Alle anderen Benachrichtigungen sind ausgeblendet.

# Benachrichtigungsfehler anzeigen
<a name="v9-alerting-viewnotificationerrors"></a>

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

Sehen Sie sich Benachrichtigungsfehler an und erfahren Sie, warum sie nicht gesendet oder empfangen wurden.

**Anmerkung**  
Diese Funktion wird nur für Grafana Alertmanager unterstützt.

**Um Benachrichtigungsfehler anzuzeigen**

1. Klicken Sie im Grafana-Menü auf das **Warnsymbol** (Glocke), um die Warnseite mit den vorhandenen Benachrichtigungen zu öffnen.

1. Wählen Sie **Kontaktstellen**, um eine Liste der vorhandenen Kontaktstellen anzuzeigen.

   Wenn eine Kontaktstelle ausfällt, wird der Benutzer in einer Meldung in der rechten Ecke des Bildschirms darauf hingewiesen, dass und wie viele Fehler vorliegen.

1. Klicken Sie auf eine Kontaktstelle, um die Einzelheiten der Fehler für diese Kontaktstelle anzuzeigen.

   Fehlerdetails werden angezeigt, wenn Sie den Mauszeiger über das Fehlersymbol bewegen.

   Wenn eine Kontaktstelle über mehr als eine Integration verfügt, werden alle Fehler für jede der aufgelisteten Integrationen angezeigt.

1. Überprüfen Sie in der Spalte Health den Status der Benachrichtigung.

   Dies kann entweder „OK“, „Keine Versuche“ oder „Fehler“ lauten.