

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

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

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 10 von Grafana verwendet.

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

# Dashboards in Grafana-Version 10
<a name="v10-dashboards"></a>

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

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

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

**Topics**
+ [Verwenden von Dashboards](v10-dash-using-dashboards.md)
+ [Dashboards erstellen](v10-dash-building-dashboards.md)
+ [Verwaltung von Dashboards](v10-dash-managing-dashboards.md)
+ [Playlisten verwalten](v10-dash-managing-playlists.md)
+ [Dashboards und Panels teilen](v10-dash-sharing.md)
+ [Variablen](v10-dash-variables.md)
+ [Bewertung der Dashboard-Nutzung](v10-dash-assess-dashboard-usage.md)
+ [Probleme mit Dashboards beheben](v10-dash-troubleshoot.md)
+ [Durchsuchen von Dashboards in Grafana-Version 10](v10-search.md)

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

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

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

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

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

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



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

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

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

**Fokussiertes Panel**

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

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

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

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

**Zeiteinheiten und relative Bereiche**

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

Mit dem Minus-Operator können Sie in der Zeit zurückgehen, relativ zum aktuellen Datum und zur aktuellen Uhrzeit, oder`now`. Wenn Sie den gesamten Zeitraum der Einheit (Tag, Woche oder Monat) anzeigen möchten, fügen Sie den Wert `/<time unit>` an das Ende an. Um Geschäftsperioden, Nutzungs `fQ (fiscal quarter)` - und `fy (fiscal year)` Zeiteinheiten anzuzeigen.

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

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


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

**Anmerkung**  
 Grafana Alerting unterstützt die folgenden Syntaxen nicht:  
`now+n`für future Zeitstempel.
`now-1n/n`für *Anfang von n bis Ende von n*, weil dies ein absoluter Zeitstempel ist.

**Allgemeine Steuerelemente für den Zeitbereich**

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

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

**Aktualisieren Sie die Dashboards**

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

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

**Steuern Sie den Zeitraum mithilfe einer URL**

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

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

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

Nachdem Sie einen Grafana-Workspace erstellt und sich angemeldet haben, können Sie Dashboards erstellen und Einstellungen an Ihre Bedürfnisse anpassen. Ein Dashboard besteht aus [Panels mit](v10-panels-viz.md) Visualisierungen. Jedem Panel ist eine Abfrage zugeordnet, mit der Daten aus einem von Ihnen abgerufen werden können. [Verbinden zu Datenquellen](AMG-data-sources.md)

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

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

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

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

**Ein Dashboard erstellen**

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

 Um ein Dashboard zu erstellen:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

**Ein vorhandenes Dashboard wird kopiert**

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

**Um ein vorhandenes Dashboard zu kopieren**

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

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

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

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

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

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

**Konfiguration sich wiederholender Zeilen**

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

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

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

**Um sich wiederholende Zeilen zu konfigurieren**

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

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

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

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

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

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

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

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

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

**Um ein Panel zu verschieben**

1. Öffnen Sie das -Dashboard.

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

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

1. Öffnen Sie das -Dashboard.

1. Um die Größe des Bedienfelds anzupassen, ziehen Sie an der unteren rechten Ecke des Bedienfelds. Sie können die Größe eines Dashboard-Panels an Ihre Bedürfnisse anpassen.

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

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

Sie können vorkonfigurierte Dashboards in Ihren Amazon Managed Grafana-Arbeitsbereich importieren.

**Um ein Dashboard zu importieren**

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

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

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

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

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

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

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

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

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

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

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

**Ein Dashboard portabel machen**

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

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

**Um ein Dashboard zu exportieren**

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

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

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

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

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

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

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

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

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

1. Öffnen Sie ein Dashboard im Bearbeitungsmodus.

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

**Ändern der Zeiteinstellungen im Dashboard**

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

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

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

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

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

1. 
   + **Zeitzone** — Geben Sie die lokale Zeitzone des Dienstes oder Systems an, das Sie überwachen. Dies kann hilfreich sein, wenn Sie ein System oder einen Dienst überwachen, der in mehreren Zeitzonen betrieben wird.
     + **Standard** — Grafana verwendet die standardmäßig ausgewählte Zeitzone für das Benutzerprofil, das Team oder die Organisation. Wenn für das Benutzerprofil, ein Team, dem der Benutzer angehört, oder die Organisation keine Zeitzone angegeben ist, verwendet Grafana die lokale Browserzeit.
     + **Lokale Browserzeit** — Die Zeitzone, die für den Browser des betrachtenden Benutzers konfiguriert ist, wird verwendet. Dies ist normalerweise dieselbe Zeitzone, die auf dem Computer eingestellt ist.
     + Verwenden Sie die [Standard-Zeitzonen nach ISO 8601](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), einschließlich UTC.
   + **Automatische Aktualisierung** — Passen Sie die angezeigten Optionen für die relative Zeit und die Optionen für die automatische Aktualisierung an. Die Einträge sind durch Kommas getrennt und akzeptieren jede gültige Zeiteinheit.
   + **Jetzt verzögern** — Überschreiben Sie die `now` Zeit, indem Sie eine Zeitverzögerung eingeben. Verwenden Sie diese Option, um bekannten Verzögerungen bei der Datenaggregation Rechnung zu tragen und Nullwerte zu vermeiden.
   + **Zeitauswahl ausblenden** — Wählen Sie diese Option, wenn Sie nicht möchten, dass das Dashboard die Zeitauswahl anzeigt.

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

**Hinzufügen einer Annotationsabfrage**

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

**Um eine Annotationsabfrage hinzuzufügen**

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

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

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

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

Die Benutzeroberfläche des Abfrage-Editors ändert sich je nach der ausgewählten Datenquelle. Einzelheiten zum Erstellen einer Abfrage finden Sie in der [Datenquellendokumentation](AMG-data-sources.md). Oder für Datenquellen-Plugins, die Sie über das installieren[Finde Plugins im Plugin-Katalog](grafana-plugins.md#plugin-catalog), können Sie die [Dokumentation auf der Grafana Labs-Website](https://grafana.com/docs/grafana/v10.3/datasources/) verwenden.

**Eine Variable hinzufügen**

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

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

**Um eine Variable hinzuzufügen**

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

1. Fügen Sie im Abschnitt **Allgemein** den Namen der Variablen hinzu. Dies ist der Name, den Sie später in Abfragen verwenden werden.

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

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

**Einen Link hinzufügen**

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

**Um einen Link hinzuzufügen**

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

1. Geben Sie einen Titel ein und wählen Sie im Feld **Typ** die Option **Dashboard** oder **Link** aus.

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

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

**JSON-Modell des Dashboards anzeigen**

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

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

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

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

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

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

**Variablen als Abfrageparameter übergeben**

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

Zum Beispiel in dieser URL: 

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

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

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

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

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

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

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

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

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

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

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

Zum Beispiel in dieser URL:

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

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

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

**Steuern des Zeitbereichs mithilfe der URL**

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

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

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

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

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

**Ein Bibliotheksfenster erstellen**

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

**Um ein Bibliotheksfenster zu erstellen**

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

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

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

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

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

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

1. Speichern Sie das Dashboard.

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

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

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

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

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

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

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

1. Wählen Sie im leeren Dashboard die Option **\$1 Bibliothek importieren** aus. Sie sehen eine Liste Ihrer Bibliotheks-Panels.

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

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

**Die Verknüpfung eines Bibliotheksfensters aufheben**

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

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

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

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

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

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

1. Wählen Sie den Titel des Bedienfelds aus (oder bewegen Sie den Mauszeiger auf eine beliebige Stelle im Bedienfeld), um das Aktionsmenü in der oberen rechten Ecke des Bedienfelds anzuzeigen.

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

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

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

**Eine Liste von Bibliotheksfenstern anzeigen**

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

**Um eine Liste der Bibliotheksfenster anzuzeigen**

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

1. Wählen Sie **Bibliotheksfenster aus.** Sie können eine Liste der zuvor definierten Bibliotheksfenster sehen.

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

**Löschen eines Bibliotheksfensters**

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

**Um ein Bibliotheksfenster zu löschen**

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

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

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

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

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

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

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

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

**Vergleich von zwei Dashboard-Versionen**

Um zwei Dashboard-Versionen zu vergleichen, wählen Sie die beiden Versionen aus der Liste aus, die Sie vergleichen möchten. Klicken Sie auf **Versionen vergleichen**, um den Unterschied zwischen den beiden Versionen zu sehen. Dadurch wird die Ansicht der Versionsunterschiede geöffnet. Standardmäßig wird eine Zusammenfassung der Änderungen in Textform angezeigt.

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

**Eine zuvor gespeicherte Dashboard-Version wiederherstellen**

Wenn Sie eine zuvor gespeicherte Dashboard-Version wiederherstellen müssen, können Sie entweder auf die Schaltfläche **Wiederherstellen** rechts neben einer Zeile in der Dashboard-Versionsliste klicken oder in der <x>Vergleichsansicht **auf die** Schaltfläche In Version wiederherstellen** klicken. Wenn Sie eine dieser Optionen auswählen, werden Sie aufgefordert, die Wiederherstellung zu bestätigen.

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

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

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

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

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

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

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

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

**Steuern Sie den Zeitraum mithilfe einer URL**

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

**Links zum Dashboard**

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

Dashboard-Links können auch als Verknüpfungen zu externen Systemen verwendet werden, z. B. um ein GitHub Problem mit dem aktuellen Dashboard-Namen einzureichen.

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

**Links zu Dashboards hinzufügen**

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

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

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

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

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

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

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

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

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

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

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

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

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

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

     Das Variablenformat lautet wie folgt:

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

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

**Einen Dashboard-Link aktualisieren**

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

**Um einen Dashboard-Link zu aktualisieren**

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

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

**Einen Dashboard-Link duplizieren**

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

**Löschen eines Dashboard-Links**

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

**Links zu Bedienfeldern**

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

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

  1. Bewegen Sie den Mauszeiger über das Panel, zu dem Sie einen Link hinzufügen möchten.

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

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

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

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

  1. Geben Sie die **URL** ein, auf die Sie verlinken möchten. Drücken Sie `Ctrl+Space` (oder`Cmd+Space`) und wählen Sie das URL-Feld aus, um die verfügbaren Variablen zu sehen. Durch das Hinzufügen von Vorlagenvariablen zu Ihrem Panel-Link leitet der Link den Benutzer zum richtigen Kontext weiter, in dem die entsprechenden Variablen bereits festgelegt sind.

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

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

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

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

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

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

  1. Nehmen Sie nach Bedarf Änderungen vor.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

**Um eine Anmerkung hinzuzufügen**

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

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

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

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

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

**Anmerkungen zur Region**

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

**Um eine Regionsanmerkung hinzuzufügen**

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

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

1.  Klicken Sie auf **Speichern**. 

**Um eine Anmerkung zu bearbeiten**

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

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

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

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

**Um eine Anmerkung zu löschen**

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

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

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

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

**Um eine neue Annotationsabfrage hinzuzufügen**

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

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

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

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

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

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

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

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

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

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

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

1. Konfigurieren Sie die Abfrage.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

**Abfragen nach Tag filtern**

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

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

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

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

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

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

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

1. Navigieren Sie zu einem Dashboard.

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

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

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

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

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

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

Im Folgenden wird jedes Feld im Dashboard-JSON beschrieben.


| Name | Usage | 
| --- | --- | 
| `id` | eindeutiger numerischer Bezeichner für das Dashboard (generiert von der Datenbank) | 
| `uid` | eindeutige Dashboard-ID, die von jedem generiert werden kann. string (8-40) | 
| `title` | aktueller Titel des Dashboards | 
| `tags` | mit dem Dashboard verknüpfte Tags, eine Reihe von Zeichenketten | 
| `style` | Thema des Dashboards, wie `dark` oder `light` | 
| `timezone` | Zeitzone des Dashboards, wie `utc` oder `browser` | 
| `editable` | ob ein Dashboard editierbar ist oder nicht | 
| `graphTooltip` | 0 für kein gemeinsames Fadenkreuz oder Tooltip (Standard), 1 für gemeinsames Fadenkreuz, 2 für gemeinsames Fadenkreuz und gemeinsamen Tooltip | 
| `time` | Zeitbereich für das Dashboard, z. B. oder `last 6 hours` `last 7 days` | 
| `timepicker` | Timepicker-Metadaten, Einzelheiten finden Sie im Abschnitt [Timepicker](#v10-dash-json-panels) | 
| `templating` | [Metadaten mit Vorlagen erstellen, weitere Informationen finden Sie im Abschnitt Templating](#v10-dash-json-panels) | 
| `annotations` | Metadaten zu Anmerkungen, wie Sie sie [hinzufügen können, finden Sie unter Anmerkungen](v10-dash-annotations.md) | 
| `refresh` | Intervall für automatische Aktualisierung | 
| `schemaVersion` | Version des JSON-Schemas (Integer), die jedes Mal erhöht wird, wenn ein Grafana-Update Änderungen an diesem Schema vornimmt | 
| `version` | Version des Dashboards (Integer), die bei jeder Aktualisierung des Dashboards inkrementiert wird | 
| `panels` | Anordnung der Bedienfelder (weitere Informationen finden Sie im nächsten Abschnitt) | 

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

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

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

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

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

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

**Timepicker**

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

**Schablonen erstellen**

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

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

In der folgenden Tabelle wird die Verwendung der Vorlagenfelder beschrieben.


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

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

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

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

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

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

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

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

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

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

**USE-Methode**

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

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

**RED-Methode**

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

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

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

**Die vier goldenen Signale**

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

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

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

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

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

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

**Niedrig — Standardstatus**

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

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

**Mittel — methodische Dashboards**

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

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

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

**Hoch — optimierte Nutzung**

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

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

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

**Bevor Sie beginnen**

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

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

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

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

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

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

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

**Haben Sie eine Überwachungsstrategie**

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

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

**Schreiben Sie es auf**

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

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

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

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

**Bevor Sie beginnen**

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

**Strategische Beobachtbarkeit**

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

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

**Reifegrad**

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

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

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

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

Auf der Seite **Dashboards** Ihres Workspace (verfügbar, indem Sie im linken Menü **Dashboards** auswählen) können Sie Dashboard-Verwaltungsaufgaben ausführen, einschließlich der Organisation Ihrer Dashboards in Ordnern.

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

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

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

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

Ordner helfen Ihnen dabei, Dashboards zu organisieren und zu gruppieren, was nützlich ist, wenn Sie viele Dashboards haben oder mehrere Teams dieselbe Grafana-Instanz verwenden. Unterordner ermöglichen es Ihnen, eine verschachtelte Hierarchie in Ihrer Dashboard-Organisation zu erstellen.

**Voraussetzungen**

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

**So erstellen Sie einen Dashboard-Ordner**

1. Melden Sie sich bei Grafana an. 

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

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

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

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

**Um den Namen eines Ordners zu bearbeiten**

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

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

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

   Der neue Ordnername wird automatisch gespeichert.

**Ordnerberechtigungen**

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

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

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

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

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

1. Aktualisieren Sie die Berechtigungen wie gewünscht.

Änderungen werden automatisch gespeichert.

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

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

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

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

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

**Um auf eine Playlist zuzugreifen**

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

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

**Eine Playlist starten**

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

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

**Um eine Playlist zu starten**

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

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

   Das Dialogfeld „Playlist starten“ wird geöffnet.

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

1. Klicken Sie auf **Start**<playlist name>.

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


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

**Steuerung einer Playlist**

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


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

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

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

**Um eine Playlist zu erstellen**

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

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

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

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

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

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

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

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

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

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

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

**Um eine Playlist zu speichern**

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

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

1. Wähle die Playlist deiner Wahl.

1. Bearbeiten Sie die Playlist.

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

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

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

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

**Um eine Playlist zu bearbeiten**

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

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

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

**Um eine Playlist zu löschen**

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

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

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

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

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

**Um ein Dashboard zu entfernen**

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

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

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

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

**Um eine Playlist im Anzeigemodus zu teilen**

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

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

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

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

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

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

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

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

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

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

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

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

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

**Um ein Dashboard zu teilen**

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

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

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

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

**Einen direkten Link teilen**

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

**Um einen direkten Link zu teilen**

1. Wählen Sie **Kopieren** aus. Diese Aktion kopiert die Standard- oder die verkürzte URL in die Zwischenablage.

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

**Einen Snapshot veröffentlichen**

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

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

**Um einen Snapshot zu veröffentlichen**

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

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

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

**Ein Dashboard exportieren**

Grafana-Dashboards können einfach exportiert und importiert werden. Weitere Informationen finden Sie in den Abschnitten Import und Export unter. [Dashboards erstellen](v10-dash-building-dashboards.md)

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

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

**Um ein Panel zu teilen**

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

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

**Verwenden Sie einen direkten Link**

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

**Um einen direkten Link zu verwenden**

1. Wählen Sie **Kopieren**, um die Standard-URL oder die verkürzte URL in die Zwischenablage zu kopieren. 

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

**Einen Schnappschuss eines Panels veröffentlichen**

Ein Panel-Snapshot ist ein öffentlich zugänglicher Teil eines interaktiven Panels. Grafana entfernt sensible Daten und hinterlässt nur die sichtbaren metrischen Daten und Seriennamen, die im Dashboard eingebettet sind. Auf Panel-Snapshots kann jeder mit dem Link zugreifen.

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

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

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

1. Wählen Sie **Lokaler Snapshot** aus. Grafana generiert den Link des Snapshots.

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

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

**Erstellen eines Bibliotheksfensters**

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

**Um ein Bibliotheksfenster zu erstellen**

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

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

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

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

1. Speichern Sie das Dashboard.

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

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

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

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

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

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

**Vorlagen**

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

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

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

**Beispiele**

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

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

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

**Bewährte Methoden für verschiedene Varianten**
+ Variablen-Dropdownlisten werden in der Reihenfolge angezeigt, in der sie in der Variablenliste in den **Dashboard-Einstellungen** aufgeführt sind.
+ Platzieren Sie die Variablen, die Sie häufig ändern werden, ganz oben, sodass sie zuerst angezeigt werden (ganz links im Dashboard).
+ Variablen wählen standardmäßig den obersten Wert in der Drop-down-Liste aus. Wenn Sie stattdessen einen leeren Wert wählen möchten, ändern Sie die Variableneinstellungen wie folgt:

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

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

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

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

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

In der folgenden Tabelle sind die Variablentypen in Grafana aufgeführt.


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

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

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

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

**Um allgemeine Optionen einzugeben**

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

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

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

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

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

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

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

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

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

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

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

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

**Um eine Abfragevariable hinzuzufügen**

1. Geben Sie allgemeine Optionen wie oben ein.

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

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

1. Geben Sie im Feld **Abfrage** eine Abfrage ein.
   + Das Abfragefeld variiert je nach Datenquelle. Einige Datenquellen verfügen über benutzerdefinierte Abfrageeditoren.
   + Die Abfrage muss Werte mit dem Namen `__text` und zurückgeben`__value`. In SQL können Sie beispielsweise eine Abfrage wie verwenden`SELECT hostname AS __text, id AS __value from MyTable`. Abfragen für andere Sprachen variieren je nach Syntax.
   + Wenn Sie mehr Platz in einem Abfrage-Editor für ein einzelnes Eingabefeld benötigen, bewegen Sie den Mauszeiger über die Linien in der unteren rechten Ecke des Felds und ziehen Sie es nach unten, um es zu erweitern.

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

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

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

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

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

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

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

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

**Um eine benutzerdefinierte Variable hinzuzufügen**

1. Geben Sie allgemeine Optionen wie oben ein.

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

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

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

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

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

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

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

1. Geben Sie allgemeine Optionen wie oben ein.

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

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

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

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

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

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

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

**Um eine konstante Variable hinzuzufügen**

1. Geben Sie allgemeine Optionen wie oben ein.

1. Geben Sie im Feld **Wert** den Variablenwert ein. Sie können Buchstaben, Zahlen und Symbole eingeben. Sie können sogar Platzhalter verwenden, wenn Sie das [Rohformat](v10-dash-variable-syntax.md#v10-dash-variable-syntax-raw) verwenden.

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

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

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

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

**Um eine Datenquellenvariable hinzuzufügen**

1. Geben Sie allgemeine Optionen wie oben ein.

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

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

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

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

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

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

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

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

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

**Um eine Intervallvariable hinzuzufügen**

1. Geben Sie allgemeine Optionen wie oben ein.

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

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

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

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

**Beispiele für Intervallvariablen**

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

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

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

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

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

1. Geben Sie allgemeine Optionen wie oben ein.

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

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

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

**Erstellen Sie Ad-hoc-Filter**

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

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

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

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

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

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

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

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

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

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

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

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

**Problembehandlung bei Variablen mit mehreren Werten**

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

Wenn Sie nicht möchten, dass Grafana dieses automatische Regex-Escaping und Formatieren durchführt, müssen Sie einen der folgenden Schritte ausführen:
+ **Deaktivieren Sie die Optionsoptionen **Mehrere Werte oder Alle** einbeziehen.**
+ Verwenden Sie das [Rohformat](v10-dash-variable-syntax.md#v10-dash-variable-syntax-raw).

### Option „Alle einschließen“
<a name="v10-dash-variable-add-multi-all"></a>

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

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

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

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

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

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

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

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

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

Diese Variable ist der Name des aktuellen Dashboards.

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

*Verkettete Variablen*, auch *verknüpfte Variablen* oder *verschachtelte Variablen* genannt, sind Abfragevariablen mit einer oder mehreren anderen Variablen in ihrer Variablenabfrage.

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

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

**Bewährte Methoden und Tipps**

Die folgenden Methoden erleichtern die Verwendung Ihrer Dashboards und Variablen.

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

**Variable Reihenfolge**

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

**Berücksichtigung der Komplexität**

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

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

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

Auf der Variablenseite können Sie Variablen hinzufügen und bestehende Variablen verwalten. Außerdem können Sie Variablen [überprüfen](v10-dash-variable-add-inspect.md) und feststellen, ob eine Variable in anderen Variablen oder im Dashboard referenziert (oder verwendet) wird.

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

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

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

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

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

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

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

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

```
backend_01
backend_02
backend_03
backend_04
```

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

Regex:

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

Ergebnis:

```
backend_01
backend_02
```

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

Regex:

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

Ergebnis:

```
01
02
```

**Filtern und modifizieren - Prometheus-Beispiel**

Für diese Liste von Optionen:

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

Dieser reguläre Ausdruck:

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

Gibt diese Ergebnisse zurück:

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

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

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

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

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

Hat den folgenden Regex durchlaufen:

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

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

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

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

# Variablen untersuchen
<a name="v10-dash-variable-add-inspect"></a>

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

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

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

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

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

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

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

**Erweiterte Optionen für das Variablenformat**

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

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

**Allgemeine Syntax**

Syntax: `${var_name:option}`

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

**CSV**

Formatiert Variablen mit mehreren Werten als kommagetrennte Zeichenfolge.

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

**Verteilt - OpenTSDB**

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

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

**Doppeltes Anführungszeichen**

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

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

**Glob - Graphit**

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

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

**JSON**

Formatiert Variablen mit mehreren Werten als kommagetrennte Zeichenfolge.

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

**Lucene - Elasticsearch**

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

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

**Prozentualer Code**

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

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

**Pfeife**

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

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

**Roh**

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

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

**Regex**

Formatiert Variablen mit mehreren Werten in eine Regex-Zeichenfolge.

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

**Einfaches Anführungszeichen**

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

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

**SQL-String**

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

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

**Text**

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

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

**Abfrageparameter**

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

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

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

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

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

**Einblicke in das Dashboard**

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

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

**Einblicke in die Datenquelle**

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

**Um Einblicke in Datenquellen zu erhalten**

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

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

1. Wählen Sie eine Datenquelle aus.

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

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

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

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

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

In der Suchansicht können Sie Insights-Daten verwenden, um die am häufigsten verwendeten, defekten und ungenutzten Dashboards zu finden. Sie können Dashboards nach folgenden Kriterien sortieren.
+ Ansichten
+ Fehler
+ Ansichten
+ Zeit der Erstellung
+ Uhrzeit aktualisiert

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

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

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

## Das Dashboard ist langsam
<a name="v10-dash-dashboard-is-slow"></a>
+ Versuchen Sie, Dutzende (oder Hunderte oder Tausende) von Zeitreihen in einem Diagramm darzustellen? Dies kann dazu führen, dass der Browser verzögert wird. Versuchen Sie, Funktionen wie `highestMax` (in Graphite) zu verwenden, um die Anzahl der zurückgegebenen Serien zu reduzieren.
+ Manchmal können Seriennamen sehr groß sein. Dies führt zu größeren Antwortgrößen. Versuchen Sie`alias`, die Größe der zurückgegebenen Seriennamen zu reduzieren.
+ Fragen Sie viele Zeitreihen oder einen langen Zeitraum ab? Beide Bedingungen können dazu führen, dass Grafana oder Ihre Datenquelle viele Daten abruft, was das Dashboard verlangsamen kann. Versuchen Sie, einen oder beide dieser Faktoren zu reduzieren.
+ Ihre Netzwerkinfrastruktur könnte stark belastet sein. Wenn die Langsamkeit nicht konstant ist, kann dies das Problem sein.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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](v10-panels-editor-overview.md)
+ [Die Ansicht „Panel inspizieren“](v10-panels-panel-inspector.md)
+ [Daten abfragen und transformieren](v10-panels-query-xform.md)
+ [Panel-Optionen konfigurieren](v10-panels-configure-panel-options.md)
+ [Standardoptionen konfigurieren](v10-panels-configure-standard-options.md)
+ [Eine Legende konfigurieren](v10-panels-configure-legend.md)
+ [Datenverknüpfungen konfigurieren](v10-panels-configure-data-links.md)
+ [Wertezuordnungen konfigurieren](v10-panels-configure-value-mappings.md)
+ [Schwellenwerte konfigurieren](v10-panels-configure-thresholds.md)
+ [Feldüberschreibungen konfigurieren](v10-panels-configure-overrides.md)
+ [Visualisierungen verfügbar in Grafana-Version 10](v10-panels-viz.md)

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

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

Im Panel-Editor können Sie alle Elemente einer Visualisierung aktualisieren, einschließlich der Datenquelle, der Abfragen, des Zeitbereichs und der Anzeigeoptionen.

Um einem neuen Dashboard ein Panel hinzuzufügen, wählen Sie **\$1 Visualisierung hinzufügen** in der Mitte des Dashboards aus. Um einem vorhandenen Dashboard ein Panel hinzuzufügen, wählen Sie in der Dashboard-Kopfzeile **Hinzufügen** und wählen Sie im Drop-down-Menü **Visualisierung** aus. Sie können auch ein vorhandenes Panel aus demselben oder einem anderen Dashboard kopieren und einfügen.

## Panel-Menü
<a name="v10-panels-editor-menu"></a>

Um auf den Panel-Editor zuzugreifen, bewegen Sie den Mauszeiger über die obere rechte Ecke eines beliebigen Panels. **Wählen Sie das angezeigte Bedienfeldmenüsymbol und dann Bearbeiten aus.**

Über das Bedienfeldmenü haben Sie auch Zugriff auf die folgenden Aktionen:
+ **Ansicht** — Sehen Sie sich das Panel im Vollbildmodus an.
+ **Bearbeiten** — Öffnen Sie den Panel-Editor, um die Fenster- und Visualisierungsoptionen zu bearbeiten.
+ **Teilen** — Geben Sie das Panel als Link oder Bibliotheksfenster frei.
+ **Erkunden** — Öffnet das Panel in **Explore**, in dem Sie sich auf Ihre Anfrage konzentrieren können.
+ **Inspizieren** — Öffnet die **Inspect-Schublade**, in der Sie die Paneldaten, Statistiken, Metadaten, JSON und Abfragen überprüfen können.
  + **Daten** — Öffnen Sie die **Inspect-Schublade** auf der Registerkarte „**Daten**“.
  + **Abfrage** — Öffnet die **Inspect-Schublade** auf der Registerkarte „**Abfrage**“.
  + **Panel JSON** — Öffnet die **Inspect-Schublade** auf der Registerkarte **JSON**.
+ **Erweiterungen** — Greifen Sie auf andere Aktionen zu, die von installierten Anwendungen bereitgestellt werden, z. B. das Melden eines Vorfalls. Diese Option wird nur angezeigt, wenn Sie App-Plugins installiert haben, die eine Erweiterung zum Panel-Menü hinzufügen.
+ **Mehr** — Greifen Sie auf andere Panel-Aktionen zu.
  + **Duplizieren** — Erstellen Sie eine Kopie des Panels. Bei duplizierten Panels werden Daten getrennt vom ursprünglichen Panel abgefragt. Wenn Sie dieselben Abfrageergebnisse verwenden möchten, können Sie die `Dashboard` Datenquelle im zweiten Bereich verwenden.
  + **Kopieren** — Kopiert das Panel in die Zwischenablage.
  + **Bedienfeld „Bibliothek erstellen“** — Erstellen Sie ein Bedienfeld, das in andere Dashboards importiert werden kann.
  + **Warnung erstellen** — Öffnet die Seite zur Konfiguration der Warnungsregeln in **Alerting**, auf der Sie eine von [Grafana verwaltete Warnung auf der Grundlage der](v10-alerts.md) Panel-Abfragen erstellen können.
  + **Legende ausblenden — Blendet die Panel-Legende** aus.
  + **Hilfe anfordern** — Senden Sie einen Snapshot oder Paneldaten an den technischen Support von Grafana Labs.
+ **Entfernen** — Entfernen Sie das Panel vom Armaturenbrett.

## Bedienfeld-Editor
<a name="v10-panels-editor-view"></a>

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:
  + **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](v10-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 gleiche Größe wie 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. Weitere Informationen finden Sie unter [Daten abfragen und transformieren](v10-panels-query-xform.md). Wenn Sie zum ersten Mal ein Dashboard erstellen, werden Sie aufgefordert, eine Datenquelle auszuwählen. Auf dieser Registerkarte können Sie die Datenquelle oder die Abfrage aktualisieren.
  + **Registerkarte „Transformieren“** — Wenden Sie Datentransformationen an. Weitere Informationen finden Sie unter [Daten abfragen und transformieren](v10-panels-query-xform.md).
  + **Registerkarte „Warnung“** — Schreiben Sie Warnungsregeln. Weitere Informationen finden Sie unter [Benachrichtigungen in Grafana-Version 10](v10-alerts.md).
+ Anzeigeoptionen für Bedienfelder — Der Abschnitt mit den Anzeigeoptionen enthält Registerkarten, auf denen Sie fast jeden Aspekt Ihrer Datenvisualisierung konfigurieren können. Die Details variieren je nach ausgewähltem Visualisierungstyp.

## Das Panel, die Schublade prüfen
<a name="v10-panels-editor-inspect"></a>

Die Inspect-Schublade 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.

**Anmerkung**  
Nicht alle Bedienfeldtypen enthalten alle Registerkarten. 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:
+ Das Fenster zur Inspektion der Schublade wird auf der rechten Seite als Schublade angezeigt. Wählen Sie den Pfeil in der oberen rechten Ecke, um das Schubladenfenster zu vergrößern oder zu verkleinern.
+ **Registerkarte „Daten“** — Zeigt die von der Abfrage zurückgegebenen Rohdaten mit angewendeten Transformationen an. 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 alle Fehler an, die von einer Abfrage zurückgegeben wurden. Die Registerkarte ist nur sichtbar, wenn eine Abfrage einen Fehler zurückgibt.

# Die Ansicht „Panel inspizieren“
<a name="v10-panels-panel-inspector"></a>

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

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 Amazon Managed 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 Panel-Typen 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:** oben im Fenster angezeigt. Wählen Sie den Pfeil in der oberen rechten Ecke, um den Bereich zu vergrößern oder zu verkleinern.

1. **Registerkarte „Daten“** — Zeigt die von der Abfrage zurückgegebenen Rohdaten mit angewendeten Transformationen an. Feldoptionen wie Überschreibungen und Wertzuordnungen 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, die an den Server gesendet werden, wenn Grafana die Datenquelle abfragt.

1. **Registerkarte „Fehler“** — Zeigt alle Fehler an. Nur sichtbar, wenn eine Abfrage einen Fehler zurückgibt.

## Unformatierte Abfrageergebnisse werden heruntergeladen
<a name="v10-panels-raw-query-results"></a>

Amazon Managed Grafana generiert eine CSV-Datei, die Ihre Daten enthält, einschließlich aller Transformationen dieser Daten. Sie können wählen, ob Sie sich die Daten ansehen möchten, bevor oder nachdem das Panel Feldoptionen oder Feldoptionsüberschreibungen angewendet hat.

**Um unformatierte Abfrageergebnisse herunterzuladen**

1. Bearbeiten Sie das Fenster, das die Abfragedaten enthält, die Sie herunterladen möchten.

1. Wählen Sie im Abfrage-Editor **Query Inspector** aus.

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

   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. Wählen Sie eine Spaltenüberschrift aus, um die Daten neu anzuordnen.

1. Um Daten anzuzeigen, bevor das System Feldüberschreibungen anwendet, aktivieren Sie die Option **Formatierte** Daten.

1. Um eine CSV-Datei herunterzuladen, die speziell für Excel formatiert ist, wählen Sie die Option Für Excel **herunterladen**.

1. Wählen Sie **Download CSV (CSV herunterladen)** aus.

## Überprüfen der Abfrageleistung
<a name="v10-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.

**Um die Abfrageleistung zu überprüfen**

1. Bearbeiten Sie den Bereich, der die Abfrage mit der Leistung enthält, die Sie überprüfen möchten.

1. Wählen Sie im Abfrage-Editor **Query Inspector** aus.

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

Statistiken werden im schreibgeschützten Format angezeigt.

## Prüfung von Abfrageanforderung und -antwort
<a name="v10-panels-query-request-response"></a>

Sie können Abfrageanforderungs- und Antwortdaten überprüfen, 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. Wählen Sie im Abfrage-Editor **Query Inspector** aus.

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

   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.

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

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

Amazon Managed 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.

**Topics**
+ [Informationen zu Abfragen](#v10-panels-query-xform-about)
+ [Navigieren Sie auf der Registerkarte „Abfrage“](#v10-panels-query-xform-navigate)
+ [Eine Abfrage hinzufügen](#v10-panels-query-xform-add)
+ [Abfragen verwalten](#v10-panels-query-xform-manage)
+ [Abfrageoptionen](#v10-panels-query-xform-options)
+ [Ausdrucksabfragen schreiben](v10-panels-query-xform-expressions.md)
+ [Abfrageergebnisse mit einem anderen Panel teilen](v10-panels-query-share.md)
+ [Transformieren von Daten](v10-panels-xform.md)
+ [Problembehandlung bei Abfragen](v10-panels-query-troubleshoot.md)
+ [Berechnungsarten](v10-panels-calculation-types.md)

## Informationen zu Abfragen
<a name="v10-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, einschließlich Informationen zu Abfragen und Syntax, finden Sie in der Datenquellendokumentation:
+ Informationen zu den in Amazon Managed Grafana enthaltenen Datenquellen finden Sie unter [Integrierte Datenquellen](AMG-data-sources-builtin.md).
+ Informationen zu den in Grafana Enterprise enthaltenen Datenquellen finden Sie unter[Connect zu Unternehmensdatenquellen her](AMG-data-sources-enterprise.md).
+ Für andere Datenquellen-Plugins, die Sie über das installieren[Finde Plugins im Plugin-Katalog](grafana-plugins.md#plugin-catalog), ist die Dokumentation in der Liste im Plugin-Katalog verlinkt.

**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.** Weitere Informationen finden Sie unter [Verbinden zu Datenquellen](AMG-data-sources.md).

## Navigieren Sie auf der Registerkarte „Abfrage“
<a name="v10-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](v10-panels-query-xform-expressions.md).

## Eine Abfrage hinzufügen
<a name="v10-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](#v10-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="v10-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, Abfragen entfernen, Abfragen neu anordnen und die Hilfe für den Abfrage-Editor ein- und ausschalten.

## Abfrageoptionen
<a name="v10-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 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.
+ **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](v10-dash-variable-add.md#v10-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/v10-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/v10-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="v10-panels-query-xform-expressions"></a>

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

Mit serverseitigen Ausdrücken können Sie Daten, die von Abfragen zurückgegeben werden, mit mathematischen und anderen Operationen bearbeiten. Ausdrücke erzeugen neue Daten und manipulieren nicht die von Datenquellen zurückgegebenen Daten.

## Über Ausdrücke
<a name="v10-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 am häufigsten von [Grafana-Benachrichtigungen](v10-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 numerische Daten zurückgeben. Sie arbeiten auch mit [mehrdimensionalen Daten](getting-started-grafanaui.md#time-series-dimensions). Zum Beispiel eine Abfrage, die mehrere Reihen zurückgibt, wobei jede Serie 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. 

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:

Die folgende Beispieltabelle 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.


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

**Operationen**

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

**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 wie folgt 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:
+ Zahl <Operation>Zahl = Zahl
+ <Operation>Zahlenreihe = Serie
+ Serie <Operation>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 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 ist für diese Prüfung erforderlich, da 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`)), die neu berechnet 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.

*Ersetzt nicht-numerisch*

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** to — Die Zeitdauer, für die beispielsweise das Resampling durchgeführt werden soll. `10s` Einheiten können `s` Sekunden, `m` Minuten, `h` Stunden, `d` Tage, `w` Wochen und `y` Jahre sein.
+ **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** füllt mit dem letzten bekannten Wert
  + mit dem nächsten **bekannten Wert auffüllen**
  + **fillna** zum Füllen leerer Beispielfenster mit NaNs

## Schreiben Sie einen Ausdruck
<a name="v10-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="v10-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. [Konfigurieren Sie die verwalteten Warnungsregeln von Grafana](v10-alerting-configure-grafanamanaged.md)

Wenn ein Ausdruck für mehrere Abfragen verwendet wird, verlangt die Expression Engine, dass alle Abfragen einen identischen Zeitstempel zurückgeben. Wenn Sie beispielsweise mathematische Berechnungen verwenden, um das Ergebnis mehrerer SQL-Abfragen zu kombinieren, die jeweils verwendet werden`SELECT NOW() AS "time"`, funktioniert der Ausdruck nur, wenn alle Abfragen einen identischen Zeitstempel ergeben, was nicht immer der Fall ist. `NOW()` Um dieses Problem zu lösen, können Sie es durch einen beliebigen Zeitstempel `NOW()` ersetzen, z. B. `SELECT 1 AS "time"` oder durch einen anderen gültigen UNIX-Zeitstempel.

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

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

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

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

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

   Wenn Sie keine Datenquelle zur Verfügung haben, verwenden Sie die **Grafana-Datenquelle**, die 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="v10-panels-xform"></a>

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

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="v10-panels-xform-types"></a>

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

## Reihenfolge der Transformationen
<a name="v10-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="v10-panels-xform-add"></a>

Die folgenden Schritte führen Sie durch das Hinzufügen einer Transformation zu Daten. Diese Dokumentation enthält keine Schritte für jeden Transformationstyp.

**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. Bewegen Sie den Mauszeiger über einen beliebigen Teil des Bedienfelds, um das Aktionsmenü in der oberen rechten Ecke anzuzeigen.

1. Wählen Sie im Aktionsmenü **Bearbeiten** aus.

1. Wählen Sie die Registerkarte **Transformieren** 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="v10-panels-xform-debug"></a>

Um die Eingabe- und Ausgaberesultsets der Transformation zu sehen, wählen Sie das Debug-Symbol (Bug) auf der rechten Seite der Transformationszeile. Dadurch werden die Eingabedaten und das Ergebnis der Transformation als Ausgabe angezeigt.

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

## Deaktivieren Sie eine Transformation
<a name="v10-panels-xform-disable"></a>

Sie können eine Transformation deaktivieren oder ausblenden, indem Sie oben rechts in der Transformationszeile auf das Symbol zum Einblenden (Augen) klicken. Dadurch werden die für diese spezifische Transformation angewendeten Aktionen deaktiviert. Dies kann dazu beitragen, Probleme zu identifizieren, wenn Sie mehrere Transformationen nacheinander ändern.

## Filtern Sie eine Transformation
<a name="v10-panels-xform-filter"></a>

Wenn Ihre Transformation mehr als eine Abfrage verwendet, können Sie diese filtern und die ausgewählte Transformation nur auf eine der Abfragen anwenden. Wählen Sie dazu das Filtersymbol oben rechts in der Transformationszeile. Dadurch wird ein Drop-down-Menü mit einer Liste der im Panel verwendeten Abfragen geöffnet. Von hier aus können Sie die Abfrage auswählen, die Sie transformieren möchten.

Sie können auch nach Anmerkungen (einschließlich Exemplaren) filtern, um Transformationen auf sie anzuwenden. Wenn Sie dies tun, ändert sich die Liste der Felder entsprechend den Feldern in der Anmerkung oder im Beispiel-Tooltip.

Das Filtersymbol wird immer angezeigt, wenn Ihr Panel mehr als eine Abfrage oder Datenquelle enthält (d. h. Fenster- oder Annotationsdaten). Es funktioniert jedoch möglicherweise nicht, wenn vorherige Transformationen zum Zusammenführen der Ausgaben der Abfragen angewendet werden. Das liegt daran, dass eine Transformation die Ausgabe der vorherigen verwendet.

## Löscht eine Transformation
<a name="v10-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 **Transformieren**.

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

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

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

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

## Fügen Sie ein Feld aus der Berechnung hinzu
<a name="v10-panels-xform-funcs-add"></a>

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 Operation** — Wendet grundlegende binäre Operationen (z. B. Summe oder Multiplikation) auf Werte in einer einzelnen Zeile aus zwei ausgewählten Feldern an.
  + **Unäre Operation** — Wendet grundlegende unäre Operationen auf Werte in einer einzelnen Zeile aus einem ausgewählten Feld an. Die verfügbaren Operationen sind:
    + **Absoluter Wert (abs)** — Gibt den absoluten Wert eines bestimmten Ausdrucks zurück. Er stellt die Entfernung von Null als positive Zahl dar.
    + **Natürliches Exponential (exp)** — Gibt *e* potenziert mit einem bestimmten Ausdruck zurück.
    + **Natürlicher Logarithmus (ln)** — Gibt den natürlichen Logarithmus eines bestimmten Ausdrucks zurück.
    + **Floor (floor)** — Gibt die größte Ganzzahl zurück, die kleiner oder gleich einem bestimmten Ausdruck ist.
    + **Decke (Decke) —** gibt die kleinste Ganzzahl zurück, die größer oder gleich einem bestimmten Ausdruck ist.
  + **Kumulative Funktionen** — Wendet Funktionen auf die aktuelle Zeile und alle vorherigen Zeilen an.
    + **Summe** — Berechnet die Gesamtsumme bis einschließlich der aktuellen Zeile.
    + **Mittelwert** — Berechnet den Mittelwert bis einschließlich der aktuellen Zeile.
  + **Fensterfunktionen** — Wenden Sie Fensterfunktionen an. Das Fenster kann entweder hinten oder *mittig* *angeordnet* sein. Bei einem nachfolgenden Fenster ist die aktuelle Zeile die letzte Zeile im Fenster. Bei einem zentrierten Fenster wird das Fenster auf der aktuellen Zeile zentriert. Bei gleichmäßigen Fenstergrößen wird das Fenster zwischen der aktuellen Zeile und der vorherigen Zeile zentriert.
    + **Mittelwert** — Berechnet den gleitenden Mittelwert oder den gleitenden Durchschnitt.
    + ****— Berechnet die gleitende Standardabweichung.
    + **Varianz — Berechnet** die gleitende Varianz.
  + **Zeilenindex** — Fügt ein Feld mit dem Zeilenindex ein.
+ **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. Wählen Sie das Feld aus, um eine Liste mit Berechnungsoptionen anzuzeigen, mit denen Sie das neue Feld erstellen können. Informationen zu verfügbaren Berechnungen finden Sie unter [Berechnungstypen](v10-panels-calculation-types.md).
+ **Operation** — Wenn Sie den Modus **Binäre Operation** oder **Unäre Operation** wählen, werden die Felder **Operation** angezeigt. Mit diesen Feldern können Sie grundlegende mathematische Operationen mit Werten in einer einzigen Zeile aus zwei ausgewählten Feldern ausführen. Sie können numerische Werte auch für binäre Operationen verwenden.
+ **Als Perzentil** — Wenn Sie den Modus **Zeilenindex** wählen, wird der Schalter **Als Perzentil** angezeigt. Mit diesem Schalter können Sie den Zeilenindex als Prozentsatz der Gesamtzahl der Zeilen transformieren.
+ **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.

**Anmerkung**  
**Kumulative Funktionen** und **Fensterfunktionen** sind aktuell in der öffentlichen Vorschau verfügbar. Grafana Labs bietet eingeschränkten Support, und es können wichtige Änderungen vorgenommen werden, bevor die Funktion allgemein verfügbar gemacht wird.

## Verketten Sie Felder
<a name="v10-panels-xform-funcs-concat"></a>

**Felder verketten**

Verwenden Sie diese Transformation, um alle Felder aus allen Frames zu einem Ergebnis zu kombinieren.

Wenn Sie beispielsweise separate Abfragen haben, die Temperatur- und Verfügbarkeitsdaten (Abfrage A) sowie Luftqualitätsindex- und Fehlerinformationen (Abfrage b) abrufen, ergibt die Anwendung der verketteten Transformation einen konsolidierten Datenrahmen mit allen relevanten Informationen in einer Ansicht.

Betrachten Sie die beiden folgenden Punkte.

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

Diese Transformation vereinfacht den Prozess der Zusammenführung von Daten aus verschiedenen Quellen und bietet eine umfassende Ansicht für die Analyse und Visualisierung.

## Config aus Abfrageergebnissen
<a name="v10-panels-xform-funcs-config"></a>

**Config aus Abfrageergebnissen**

Verwenden Sie diese Transformation, um eine Abfrage auszuwählen und Standardoptionen wie **Min.**, **Max**., **Einheit** und **Schwellenwerte** zu extrahieren und sie auf andere Abfrageergebnisse anzuwenden. Dies ermöglicht eine dynamische Visualisierungskonfiguration auf der Grundlage der von einer bestimmten Abfrage zurückgegebenen Daten.

**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 die Felder oder Reihen aus, auf die die Konfiguration angewendet werden soll.
+ Auf **Optionen anwenden** — Geben Sie je nach Ihrer Auswahl unter **Anwenden** auf einen Feldtyp an oder verwenden Sie einen regulären Feldnamen.

**Tabelle mit Feldzuordnungen**

Unter den Konfigurationsoptionen finden Sie die Tabelle mit der Feldzuweisung. In dieser Tabelle sind alle Felder aufgeführt, die in den von der Konfigurationsabfrage zurückgegebenen Daten gefunden wurden, zusammen mit den Optionen **Verwenden als** und **Auswählen**. Sie ermöglicht die Steuerung der Zuordnung von Feldern zu Konfigurationseigenschaften. Bei mehreren Zeilen können Sie auswählen, welcher Wert ausgewählt werden soll.

Das folgende Beispiel zeigt eine Eingabeabfrage und eine Abfrage, die als Feldkonfiguration verwendet wird.

*Eingabeabfrage*


| Zeit | Wert | 
| --- | --- | 
| 1626178119127 | 10 | 
| 1626178119129 | 30 | 

*Konfigurationsabfrage*


| Zeit | Wert | 
| --- | --- | 
| 1626178119127 | 100 | 
| 1626178119129 | 100 | 

*Ausgabeabfrage (wie Eingabe, aber jetzt mit Konfiguration für das Wertefeld)*


| Zeit | Wert (Konfiguration: Max=100) | 
| --- | --- | 
| 1626178119127 | 10 | 
| 1626178119129 | 30 | 

Für jedes Feld ist jetzt eine maximale Konfigurationsoption festgelegt. Optionen wie **Min.**, **Max.**, **Einheit** und **Schwellenwerte** sind Teil der Feldkonfiguration. Falls festgelegt, werden sie von der Visualisierung anstelle von Optionen verwendet, die manuell im Optionsbereich des Panel-Editors konfiguriert wurden.

**Wertezuordnungen**

Sie können ein Abfrageergebnis auch in Wertzuordnungen umwandeln. Mit dieser Option definiert jede Zeile im Ergebnis der Konfigurationsabfrage eine einzelne Wertezuordnungszeile. Sehen Sie sich das folgende Beispiel an.

*Ergebnis der Konfigurationsabfrage*


| Wert | Text | Farbe | 
| --- | --- | --- | 
| L | Niedrig | Blau | 
| M | Mittel | Grün | 
| H | Hoch | red | 

*Geben Sie in der Feldzuordnung Folgendes an:*


| Feld | Verwenden Sie als | Select | 
| --- | --- | --- | 
| Wert | Wertezuordnungen/Wert | Alle Werte | 
| Text | Wertezuordnungen//Text | Alle Werte | 
| Farbe | Wertezuordnungen//Farbe | Alle Werte | 

Grafana erstellt Wertzuordnungen aus Ihrem Abfrageergebnis und wendet sie auf die tatsächlichen Datenabfrageergebnisse an. Sie sollten sehen, dass Werte entsprechend den Ergebnissen der Konfigurationsabfrage zugeordnet und eingefärbt werden.

## Feldtyp konvertieren
<a name="v10-panels-xform-funcs-convert"></a>

Verwenden Sie diese Transformation, um den Feldtyp des angegebenen Felds zu ändern.

Diese Transformation hat die folgenden Optionen:
+ **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 durch eine Zeichenfolge anzugeben, z. B. `yyyy-mm-dd` oder`DD MM YYYY hh:mm:ss`.
  + **Boolean** — macht die Werte zu Boolean.
  + **Enum** — macht die Werte zu Aufzählungen.
    + Zeigt eine Tabelle zur Verwaltung der Aufzählungen an.
  + **Andere** — versucht, die Werte als JSON zu analysieren.

Stellen Sie sich zum Beispiel die folgende Abfrage vor, die geändert werden könnte, indem Sie das Zeitfeld als **Uhrzeit** und das Datumsformat als `YYYY` auswählen.


| Zeit | Markieren | Wert | 
| --- | --- | --- | 
| 01.07.2017 | über | 25 | 
| 2018-08-02 | unten | 22 | 
| 2019-09-02 | unten | 29 | 
| 2020-10-04 | über | 22 | 

Das Ergebnis:


| Zeit | Mark | Wert | 
| --- | --- | --- | 
| 2017-01-01 00:00:00 | über | 25 | 
| 2018-01-01 00:00:00 | unten | 22 | 
| 2019-01-01 00:00:00 | unten | 29 | 
| 2020-01-01 00:00:00 | über | 22 | 

Diese Transformation ermöglicht es Ihnen, Ihre Datentypen flexibel anzupassen und so die Kompatibilität und Konsistenz Ihrer Visualisierungen sicherzustellen.

## Extrahieren Sie Felder
<a name="v10-panels-xform-funcs-extract"></a>

Verwenden Sie diese Transformation, um eine Datenquelle auszuwählen und Inhalte daraus in verschiedenen Formaten zu extrahieren. Diese Transformation hat die folgenden Felder:
+ **Quelle** — Wählen Sie das Feld für die Datenquelle aus.
+ **Format** — Wählen Sie eine der folgenden Optionen:
  + **JSON** — Analysiert JSON-Inhalte aus der Quelle.
  + **Schlüssel\$1Wert-Paare** — Analysieren Sie Inhalte im Format `a=b` oder `c:d` aus der Quelle.
  + **Automatisch** — Felder werden automatisch erkannt.
+ **Alle Felder ersetzen** — (Optional) Wählen Sie diese Option, um alle anderen Felder auszublenden und nur Ihr berechnetes Feld in der Visualisierung anzuzeigen.
+ **Zeit beibehalten** — (optional) Nur verfügbar, wenn „**Alle Felder ersetzen**“ aktiviert ist. Behält das Zeitfeld in der Ausgabe bei.

Betrachten Sie den folgenden Datensatz:

**Beispiel für einen Datensatz**


| Zeitstempel | json\$1data | 
| --- | --- | 
| 1636678740000000000 | \$1"Wert“: 1\$1 | 
| 1636678680000000000 | \$1"Wert“: 5\$1 | 
| 1636678620000000000 | \$1"Wert“: 12\$1 | 

Sie könnten die Daten so vorbereiten, dass sie von einem [Zeitreihen-Panel](v10-panels-time-series.md) mit dieser Konfiguration verwendet werden:
+ Quelle: json\$1data
+ Format: JSON
  + Feld: Wert
  + Alias: my\$1value
+ Ersetze alle Felder: true
+ Zeit speichern: wahr

Dadurch wird die folgende Ausgabe generiert:

**Transformierte Daten**


| Zeitstempel | my\$1value | 
| --- | --- | 
| 1636678740000000000 | 1 | 
| 1636678680000000000 | 5 | 
| 1636678620000000000 | 12 | 

Mit dieser Transformation können Sie Daten auf verschiedene Arten extrahieren und formatieren. Sie können das Extraktionsformat an Ihre spezifischen Datenanforderungen anpassen.

## Suchen Sie nach Feldern aus der Ressource
<a name="v10-panels-xform-funcs-lookup"></a>

Verwenden Sie diese Transformation, um einen Feldwert anzureichern, indem Sie zusätzliche Felder aus einer externen Quelle nachschlagen.

Diese Transformation umfasst die folgenden Felder:
+ **Feld** — Wählen Sie ein Textfeld aus Ihrem Datensatz aus.
+ **Suche** — Wählen Sie aus **Ländern**, **US-Bundesstaaten** und **Flughäfen**.

**Anmerkung**  
Diese Transformation unterstützt nur Geodaten.

Wenn Sie beispielsweise über diese Daten verfügen:

**Beispiel für einen Datensatz**


| Speicherort | Werte | 
| --- | --- | 
| AL | 0 | 
| AK | 10 | 
| Arizona | 5 | 
| Arkansas | 1 | 
| Irgendwo | 5 | 

Mit dieser Konfiguration:
+ Feld: Standort
+ Suche: US-Bundesstaaten

Sie erhalten die folgende Ausgabe:

**Transformierte Daten**


| Speicherort | ID (ID) | Name | Lng | Lat | Werte | 
| --- | --- | --- | --- | --- | --- | 
| AL | AL | Alabama | -80,891064 | 12,448457 | 0 | 
| EICHE | AK | Arkansas | -100,891064 | 24,448457 | 10 | 
| Arizona |  |  |  |  | 5 | 
| Arkansas |  |  |  |  | 1 | 
| Irgendwo |  |  |  |  | 5 | 

Mit dieser Transformation können Sie Ihre Daten erweitern, indem Sie zusätzliche Informationen aus externen Quellen abrufen und so einen umfassenderen Datensatz für die Analyse und Visualisierung bereitstellen.

## Filtern Sie Daten nach Query-RefID
<a name="v10-panels-xform-funcs-queryrefid"></a>

Verwenden Sie diese Transformation, um eine oder mehrere Abfragen in Panels mit mehreren Abfragen auszublenden.

Grafana zeigt die Abfrage-Identifikationsbuchstaben in dunkelgrauem Text an. Wählen Sie 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 Werten filtern
<a name="v10-panels-xform-funcs-values"></a>

Verwenden Sie diese Transformation, um Datenpunkte direkt in Ihrer Visualisierung selektiv zu filtern. Diese Transformation bietet Optionen zum Ein- oder Ausschließen von Daten auf der Grundlage einer oder mehrerer Bedingungen, die auf ein ausgewähltes Feld angewendet werden.

Diese Transformation ist sehr 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 — Entspricht**, 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.

Zusätzliche verfügbare 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 | 
| --- | --- | --- | 
| 2020-07-07 11:34:23 | 32 | 101 | 
| 07.07.2020 11:34:22 | 28 | 125 | 
| 07.07.2020 11:34:21 | 26 | 110 | 
| 07.07.2020 11:34:20 | 23 | 98 | 
| 2020-07-07 10:32:24 | 31 | 95 | 
| 07.07.2020 10:31:22 | 20 | 85 | 
| 2020-07-07 09:30:57 | 19 | 101 | 

Wenn Sie die Datenpunkte mit einer Temperatur unter 30 °C **einbeziehen**, sieht die Konfiguration wie folgt aus:
+ Filtertyp: 'Einschließen'
+ Bedingung: Zeilen, in denen „Temperatur“ mit „Niedriger als“ 30 „übereinstimmt

Und Sie erhalten das folgende Ergebnis, in dem nur die Temperaturen unter 30 °C enthalten sind:

**Transformierte Daten**


| Zeit | Temperatur | Höhe | 
| --- | --- | --- | 
| 2020-07-07 11:34:22 | 28 | 125 | 
| 07.07.2020 11:34:21 | 26 | 110 | 
| 07.07.2020 11:34:20 | 23 | 98 | 
| 2020-07-07 10:31:22 | 20 | 85 | 
| 2020-07-07 09:30:57 | 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: Zeilen einschließen, die die Bedingungen „Allen entsprechen“
+ Bedingung 1: Zeilen, in denen „Temperatur“ mit „Niedriger“ als „30“ übereinstimmt
+ Bedingung 2: Zeilen, in denen „Höhe“ mit „Größer“ als „100“ übereinstimmt

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 **alle Bedingungen erfüllen** oder eine der von Ihnen **hinzugefügten** Bedingungen erfüllen.

Im obigen Beispiel haben wir **Match All** ausgewählt, weil wir die Zeilen mit einer Temperatur unter 30 °C *UND* einer Höhe über 100 einbeziehen wollten. Wenn wir stattdessen die Zeilen mit einer Temperatur unter 30 °C *ODER* einer Höhe ü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.

Mit dieser vielseitigen Transformation zur Datenfilterung können Sie Datenpunkte auf der Grundlage bestimmter Bedingungen selektiv ein- oder ausschließen. Passen Sie die Kriterien an, um Ihre Datenpräsentation an Ihre individuellen Analyseanforderungen anzupassen.

## Filtern Sie Felder nach Namen
<a name="v10-panels-xform-funcs-name"></a>

Verwenden Sie diese Transformation, um Teile Ihrer Abfrageergebnisse zu entfernen. Es gibt drei Möglichkeiten, Feldnamen zu filtern:
+ Geben Sie einen regulären Ausdruck ein.
+ Wählen Sie die eingeschlossenen Felder manuell aus.
+ Verwenden Sie eine Dashboard-Variable.

*Verwenden Sie einen regulären Ausdruck*

Wenn Sie mit einem regulären Ausdruck filtern, werden Feldnamen eingeschlossen, die dem regulären Ausdruck entsprechen. Wenn Sie beispielsweise den regulären Ausdruck verwenden, `'prod.*'` würden nur die Felder zurückgegeben, die mit beginnen `prod`

Der reguläre Ausdruck kann unter Verwendung der folgenden Syntax eine interpolierte Dashboard-Variable enthalten. `${variableName}`

*Wählen Sie die enthaltenen Felder manuell aus*

Wählen Sie Feldnamen aus oder wählen Sie sie ab, um sie aus dem Ergebnis zu entfernen. Wenn auch ein regulärer Ausdruck enthalten ist, werden Felder, denen der Ausdruck entspricht, eingeschlossen, auch wenn sie deaktiviert sind.

*Verwenden Sie eine Dashboard-Variable*

Wählen Sie **Von Variable aus**, damit Sie eine Dashboard-Variable auswählen können, die zum Einschließen von Feldern verwendet wird. Durch die Einrichtung einer Dashboard-Variablen mit mehreren Auswahlmöglichkeiten können dieselben Felder in mehreren Visualisierungen angezeigt werden.

Diese Transformation bietet Flexibilität bei der Anpassung Ihrer Abfrageergebnisse, sodass sie sich auf die spezifischen Felder konzentrieren können, die Sie für eine effektive Analyse und Visualisierung benötigen.

## Zeichenfolge formatieren
<a name="v10-panels-xform-funcs-string"></a>

Verwenden Sie diese Transformation, um die Ausgabe eines Zeichenkettenfeldes anzupassen. Diese Transformation hat die folgenden Felder:
+ **Großbuchstaben** — Formatiert die gesamte Zeichenfolge in Großbuchstaben.
+ **Kleinbuchstaben** — Formatiert die gesamte Zeichenfolge in Kleinbuchstaben.
+ **Satzschreibung** — Formatiert das erste Zeichen der Zeichenfolge in Großbuchstaben.
+ **Groß-/Kleinschreibung des Titels** — Formatiert das erste Zeichen jedes Worts in der Zeichenfolge in Großbuchstaben.
+ **Pascal-Großschreibung** — Formatiert das erste Zeichen jedes Worts in der Zeichenfolge in Großbuchstaben und schließt keine Leerzeichen zwischen Wörtern ein.
+ **Camel case** — Formatiert das erste Zeichen jedes Worts in der Zeichenfolge mit Ausnahme des ersten Worts in Großbuchstaben und schließt keine Leerzeichen zwischen Wörtern ein.
+ **Snake case** — Formatiert alle Zeichen in der Zeichenfolge in Kleinbuchstaben und verwendet Unterstriche anstelle von Leerzeichen zwischen Wörtern.
+ **Kebab case** — Formatiert alle Zeichen in der Zeichenfolge in Kleinbuchstaben und verwendet Bindestriche anstelle von Leerzeichen zwischen Wörtern.
+ **Kürzen** — Entfernt alle führenden und nachfolgenden Leerzeichen aus der Zeichenfolge.
+ **Teilzeichenfolge** — Gibt eine Teilzeichenfolge der Zeichenfolge zurück, wobei die angegebenen Start- und Endpositionen verwendet werden.

Diese Transformation bietet eine bequeme Möglichkeit, die Darstellung von Zeichenkettendaten zu standardisieren und anzupassen, um sie besser visualisieren und analysieren zu können.

**Anmerkung**  
Diese Transformation befindet sich derzeit in der öffentlichen Vorschau. Grafana Labs bietet eingeschränkten Support, und es können wichtige Änderungen vorgenommen werden, bevor die Funktion allgemein verfügbar gemacht wird.

## Zeit formatieren
<a name="v10-panels-xform-funcs-time"></a>

Verwenden Sie diese Transformation, um die Ausgabe eines Zeitfeldes anzupassen. Die Ausgabe kann mithilfe von [Zeichenketten im Format Moment.js](https://momentjs.com/docs/#/displaying/) formatiert werden. Wenn Sie beispielsweise nur das Jahr eines Zeitfeldes anzeigen möchten, kann die Formatzeichenfolge 'YYYY' verwendet werden, um das Kalenderjahr anzuzeigen (z. B. 1999 oder 2012).

**Vor der Transformation:**


| Zeitstempel | Veranstaltung | 
| --- | --- | 
| 1636678740000000000 | System starten | 
| 1636678680000000000 | Benutzer-Anmeldung | 
| 1636678620000000000 | Daten aktualisiert | 

**Nach dem Anwenden von 'YYYY-MM-DD hh:mm:ss':**


| Zeitstempel | Veranstaltung | 
| --- | --- | 
| 2021-11-12 14:25:40 | System starten | 
| 2021-11-12 14:24:40 | Benutzer-Anmeldung | 
| 2021-11-12 14:23:40 | Daten aktualisiert | 

Mit dieser Transformation können Sie die Zeitdarstellung in Ihren Visualisierungen anpassen und so für Flexibilität und Präzision bei der Anzeige von Zeitdaten sorgen.

**Anmerkung**  
Diese Transformation ist in Workspaces, die mit Grafana v10 kompatibel sind, als Alpha-Funktion verfügbar.

## Gruppierung nach
<a name="v10-panels-xform-funcs-group"></a>

Diese Transformation gruppiert die Daten nach einem bestimmten Feldwert (Spaltenwert) und verarbeitet Berechnungen für jede Gruppe. Wählen Sie diese Option aus, 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 zum Beispiel 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.

## Gruppierung zur Matrix
<a name="v10-panels-xform-funcs-groupmatrix"></a>

Verwenden Sie diese Transformation, um drei Felder, die als Eingabe für die **Wertfelder **Spalte**, **Zeile** und Zelle** aus der Abfrageausgabe verwendet werden, zu kombinieren und eine Matrix zu generieren. Die Matrix wird wie folgt berechnet:

**Ursprüngliche Daten**


| Server ID | CPU-Temperatur | Status des Servers | 
| --- | --- | --- | 
| Server 1 | 82 | OK | 
| Server 2 | 88,6 | OK | 
| Server 3 | 59,6 | Herunterfahren | 

Wir können eine Matrix generieren, indem wir die Werte von `Server Status` als Spaltennamen, die `Server ID` Werte als Zeilennamen und den `CPU Temperature` AS-Inhalt jeder Zelle verwenden. Der Inhalt jeder Zelle wird für die bestehende Kombination aus Spalten (`Server Status`) und Zeilen (`Server ID`) angezeigt. Für die restlichen Zellen können Sie auswählen, welcher Wert zwischen **Null**, **Wahr**, **Falsch** oder **Leer** angezeigt werden soll.

**Ausgabe**


|  IDServer Serverstatus | OK | Herunterfahren | 
| --- | --- | --- | 
| Server 1 | 82 |  | 
| Server 2 | 88,6 |  | 
| Server 3 |  | 59,6 | 

Verwenden Sie diese Transformation, um eine Matrix zu erstellen, indem Sie Felder aus Ihren Abfrageergebnissen angeben. Die Matrixausgabe spiegelt die Beziehungen zwischen den Einzelwerten in diesen Feldern wider. Auf diese Weise können Sie komplexe Beziehungen in einem klaren und strukturierten Matrixformat darstellen.

## Von der Gruppe zur verschachtelten Tabelle
<a name="v10-panels-xform-funcs-grouptable"></a>

Verwenden Sie diese Transformation, um die Daten nach einem bestimmten Feldwert (Spaltenwert) zu gruppieren und die Berechnung für jede Gruppe durchzuführen. Es werden Datensätze generiert, die denselben gruppierten Feldwert verwenden und in einer verschachtelten Tabelle angezeigt werden.

Um eine Statistik für ein Feld zu berechnen, aktivieren Sie das Kästchen neben dem Feld und wählen Sie die Option **Berechnen**. Dadurch wird ein weiteres Auswahlfeld mit Statistiken hinzugefügt, die ausgewählt werden sollen.

Die folgende Tabelle zeigt Beispieldaten.


| 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 besteht aus zwei Schritten. Geben Sie zunächst 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 Sie beispielsweise nach dem `Server ID` Feld gruppieren, gruppiert Grafana die Daten auf diese Weise:


| Server ID | Daten | 
| --- | --- | 
| Zeit | CPU-Temperatur | Status des Servers | 
| --- | --- | --- | 
| Zeit | CPU-Temperatur | Status des Servers | 
| --- | --- | --- | 
| Zeit | CPU-Temperatur | Status des Servers | 
| --- | --- | --- | 
| Server 1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| Server 2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| Server 3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| 07.07.2020 11:34:20 UHR | 80 | Herunterfahren | 
| 07.07.2020 09:28:06 UHR | 80 | OK | 
| 07.07.2020 09:23:07 UHR | 86 | OK | 
| 07.07.2020 10:32:20 UHR | 90 | Überlastung | 
| 07.07.2020 9:30:05 UHR | 88 | OK | 
| 07.07.2020 09:25:05 UHR | 88 | OK | 
| 07.07.2020 11:34:20 UHR | 62 | OK | 
| 07.07.2020 10:31:22 UHR | 55 | OK | 
| 07.07.2020 09:30:57 UHR | 62 | Rebooting | 

Nachdem Sie das Feld ausgewählt haben, nach dem 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. Beispielsweise möchten Sie möglicherweise die durchschnittliche CPU-Temperatur für jeden dieser Server berechnen. Fügen Sie dazu die Mittelwertberechnung hinzu, die auf das Feld CPU-Temperatur angewendet wurde, um das folgende Ergebnis zu erhalten:


| Server ID | CPU-Temperatur (Mittelwert) |  | 
| --- | --- | --- | 
| Zeit | Serverstatus | 
| --- | --- | 
| Zeit | Status des Servers | 
| --- | --- | 
| Zeit | Status des Servers | 
| --- | --- | 
| Server 1 | 82 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| Server 2 | 88,6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| Server 3 | 59,6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| 07.07.2020 11:34:20 UHR | Herunterfahren | 
| 07.07.2020 09:28:06 UHR | OK | 
| 07.07.2020 09:23:07 UHR | OK | 
| 07.07.2020 10:32:20 UHR | Überlastung | 
| 07.07.2020 9:30:05 UHR | OK | 
| 07.07.2020 09:25:05 UHR | OK | 
| 07.07.2020 11:34:20 UHR | OK | 
| 07.07.2020 10:31:22 UHR | OK | 
| 07.07.2020 09:30:57 UHR | Rebooting | 

## Heatmap erstellen
<a name="v10-panels-xform-funcs-heatmap"></a>

Verwenden Sie diese Transformation, um Histogrammdaten für die Visualisierung von Trends im Zeitverlauf vorzubereiten. Ähnlich wie bei der Heatmap-Visualisierung werden bei dieser Transformation Histogramm-Metriken in zeitliche Bereiche umgewandelt.

**X-Bucket**

Diese Einstellung bestimmt, wie die X-Achse in Buckets aufgeteilt wird.
+ **Größe** — Geben Sie im Eingabefeld ein Zeitintervall an. Beispiel: Ein Zeitbereich von `1h` erzeugt Zellen mit einer Breite von einer Stunde auf der X-Achse.
+ **Anzahl** — Verwenden Sie diese Option für non-time-related Reihen, um die Anzahl der Elemente in einem Bucket zu definieren.

**Y-Bucket**

Diese Einstellung bestimmt, wie die Y-Achse in Bereiche aufgeteilt wird.
+ **Linear (Linear)**
+ **Logarithmisch** — Wählen Sie zwischen logarithmischer Basis 2 oder logarithmischer Basis 10.
+ **Symlog** — Verwendet eine symmetrische logarithmische Skala. Wählen Sie zwischen Log-Basis 2 und Log-Basis 10, wobei negative Werte berücksichtigt werden können.

Nehmen wir an, Sie haben den folgenden Datensatz:


| Zeitstempel | Wert | 
| --- | --- | 
| 2023-01-01 12:00:00 | 5 | 
| 2023-01-01 12:15:00 | 10 | 
| 2023-01-01 12:30:00 | 15 | 
| 2023-01-01 12:45:00 | 8 | 
+ Wenn X Bucket auf `Size: 15m` und Y Bucket auf eingestellt ist`Linear`, organisiert das Histogramm Werte in Zeitintervallen von 15 Minuten auf der X-Achse und linear auf der Y-Achse.
+ Für X Bucket as `Count: 2` und Y Bucket as `Logarithmic (base 10)` gruppiert das Histogramm Werte in Gruppen von zwei auf der X-Achse und verwendet eine logarithmische Skala auf der Y-Achse.

## Histogramm
<a name="v10-panels-xform-funcs-histogram"></a>

Verwenden Sie diese Transformation, um ein Histogramm auf der Grundlage von Eingabedaten zu erstellen, mit dem Sie die Verteilung der Werte visualisieren können.
+ **Bucket-Größe** — Der Bereich zwischen den niedrigsten und höchsten Elementen in einem Bucket (xMin bis xMax).
+ **Bucket-Offset** — Der Offset für non-zero-based Buckets.
+ **Reihen kombinieren** — Erstellen Sie ein einheitliches Histogramm unter Verwendung aller verfügbaren Reihen.

**Originaldaten**

Serie 1:


| A | B | C | 
| --- | --- | --- | 
| 1 | 3 | 5 | 
| 2 | 4 | 6 | 
| 3 | 5 | 7 | 
| 4 | 6 | 8 | 
| 5 | 7 | 9 | 

Serie 2:


| C | 
| --- | 
| 5 | 
| 6 | 
| 7 | 
| 8 | 
| 9 | 

**Ausgabe**


| X-Min | X Max | A | B | C | C | 
| --- | --- | --- | --- | --- | --- | 
| 1 | 2 | 1 | 0 | 0 | 0 | 
| 2 | 3 | 1 | 0 | 0 | 0 | 
| 3 | 4 | 1 | 1 | 0 | 0 | 
| 4 | 5 | 1 | 1 | 0 | 0 | 
| 5 | 6 | 1 | 1 | 1 | 1 | 
| 6 | 7 | 0 | 1 | 1 | 1 | 
| 7 | 8 | 0 | 1 | 1 | 1 | 
| 8 | 9 | 0 | 0 | 1 | 1 | 
| 9 | 10 | 0 | 0 | 1 | 1 | 

Visualisieren Sie die Verteilung der Werte anhand des generierten Histogramms und erhalten Sie so Einblicke in die Streuung und Dichte der Daten.

## Nach Feld verknüpfen
<a name="v10-panels-xform-funcs-joinfield"></a>

Verwenden Sie diese Transformation, um mehrere Ergebnisse in einer einzigen Tabelle zusammenzuführen und so die Konsolidierung von Daten aus verschiedenen Abfragen zu ermöglichen.

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 | 

## Über Labels beitreten
<a name="v10-panels-xform-funcs-joinlabel"></a>

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 breite Tabelle mit einem gemeinsamen **Label-Feld** konvertieren möchten.
+ **Verbinden** — Wählen Sie das Label aus, das zwischen den verfügbaren oder in allen Zeitreihen gemeinsamen Labels verknüpft werden soll.
+ **Wert** — Der Name für das Ausgabeergebnis.

**Beispiel**

Eingabe 1: `series1{what='Temp', cluster='A', job='J1'}`


| Zeit | Wert | 
| --- | --- | 
| 1 | 10 | 
| 2 | 200 | 

Eingang 2: `series2{what='Temp', cluster='B', job='J1'}`


| Zeit | Wert | 
| --- | --- | 
| 1 | 10 | 
| 2 | 200 | 

Eingang 3: `series3{what='Speed', cluster='B', job='J1'}`


| Zeit | Wert | 
| --- | --- | 
| 22 | 22 | 
| 28 | 77 | 

Config:

```
value: 'what'
```

Ausgabe:


| Cluster | Auftrag | Temporäre Dateien | Geschwindigkeit | 
| --- | --- | --- | --- | 
| A | J1 | 10 |  | 
| A | J1 | 200 |  | 
| B | J1 | 10 | 22 | 
| B | J1 | 200 | 77 | 

Kombinieren und organisieren Sie Zeitreihendaten effektiv mit dieser Transformation, um umfassende Einblicke zu erhalten.

## Beschriftungen für Felder
<a name="v10-panels-xform-funcs-labelstofields"></a>

Verwenden Sie diese Transformation, um Zeitreihenergebnisse mit Beschriftungen oder Tags in eine Tabelle umzuwandeln, einschließlich der Schlüssel und Werte der einzelnen Labels im Ergebnis. Zeigen Sie Beschriftungen entweder als Spalten- oder als Zeilenwerte an, um die Datenvisualisierung zu verbessern.

Bei einem Abfrageergebnis aus zwei Zeitreihen:
+ Serie 1 — Beschriftungen`Server=Server A`, `Datacenter=EU`
+ Serie 2 — Etiketten`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.

Um dies zu verdeutlichen, finden Sie hier ein Beispiel mit zwei Abfragen, die Zeitreihen ohne überlappende Beschriftungen zurückgeben.
+ Serie 1 — Beschriftungen `Server=ServerA`
+ Serie 2 — Etiketten `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 | 

## Limit
<a name="v10-panels-xform-funcs-limit"></a>

Verwenden Sie diese Transformation, um die Anzahl der angezeigten Zeilen einzuschränken und so eine fokussiertere Ansicht Ihrer Daten zu ermöglichen. Dies ist besonders nützlich, wenn Sie mit großen Datensätzen arbeiten.

Im Folgenden finden Sie ein Beispiel, das die Auswirkungen der **Limit-Transformation** auf eine Antwort aus einer Datenquelle veranschaulicht:


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

Diese Transformation hilft Ihnen, die visuelle Präsentation Ihrer Daten so anzupassen, dass der Schwerpunkt auf den relevantesten Daten liegt.

## Reihen/Tabellen zusammenführen
<a name="v10-panels-xform-funcs-merge"></a>

Verwenden Sie diese Transformation, um das Ergebnis mehrerer Abfragen zu einem einzigen Ergebnis zu kombinieren. Dies ist besonders nützlich, wenn Sie die Tabellenfenster-Visualisierung verwenden. Die Transformation führt Werte in derselben Zeile zusammen, wenn gemeinsam genutzte Felder dieselben Daten enthalten.

Im Folgenden finden Sie ein Beispiel dafür, wie sich die Transformation zum **Zusammenführen von Serien/Tabellen** auf zwei Abfragen auswirkt, die Tabellendaten zurückgeben:

*Abfrage A:*


| Zeit | Aufgabe | Verfügbarkeit | 
| --- | --- | --- | 
| 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 | 

Bei dieser Transformation werden Werte aus Abfrage A und Abfrage B in einer einheitlichen Tabelle kombiniert, wodurch die Darstellung für bessere Einblicke verbessert wird.

## Organisieren Sie Felder nach Namen
<a name="v10-panels-xform-funcs-organize"></a>

Verwenden Sie diese Transformation, um Felder umzubenennen, neu anzuordnen oder auszublenden, die von einer einzelnen Abfrage in Ihrem Panel zurückgegeben wurden. 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.

**Felder transformieren**

Grafana zeigt eine Liste der Felder an, die von der Abfrage zurückgegeben wurden. Sie können:
+ **Feldreihenfolge ändern** — Ziehen Sie ein Feld an eine neue Position in der Liste.
+ **Feld ein- oder ausblenden** — Verwenden Sie das Augensymbol neben dem Feldnamen, um die Sichtbarkeit eines Felds umzuschalten.
+ **Felder umbenennen** — Geben Sie einen neuen Namen in das Feld **Umbenennen** ein.

**Beispiel**

Angesichts dieses ersten Abfrageergebnisses:


| Zeit | Metrik | Wert | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | Temperatur | 25 | 
| 07.07.2020 11:34:20 | Feuchtigkeit | 22 | 
| 2020-07-07 10:32:20 | Feuchtigkeit | 29 | 

Sie könnten eine Änderung beim Umbenennen eines Felds anwenden, um Folgendes zu erstellen:


| Zeit | Sensor | Lesen | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | Temperatur | 25 | 
| 07.07.2020 11:34:20 | Feuchtigkeit | 22 | 
| 2020-07-07 10:32:20 | Feuchtigkeit | 29 | 

Mit dieser Transformation können Sie die Anzeige von Abfrageergebnissen anpassen und so eine klare und aufschlussreiche Darstellung Ihrer Daten in Grafana sicherstellen.

## Partition nach Werten
<a name="v10-panels-xform-funcs-partition"></a>

Verwenden Sie diese Transformation, um die grafische Darstellung mehrerer Reihen zu optimieren, ohne dass mehrere Abfragen mit unterschiedlichen `WHERE` Klauseln erforderlich sind.

**Anmerkung**  
Diese Funktion ist in Arbeitsbereichen verfügbar, die mit Grafana-Version 9 und höher kompatibel sind.

Dies ist besonders nützlich, wenn Sie eine Metrik-SQL-Tabelle verwenden, wie in diesem Beispiel:


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

Mit dem Transformator „*Partition nach Werten*“ können Sie eine einzelne Abfrage ausführen und die Ergebnisse nach eindeutigen Werten in einer oder mehreren Spalten (Feldern) 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 | 

Diese Transformation vereinfacht den Prozess und erhöht die Flexibilität bei der Visualisierung mehrerer Serien innerhalb derselben Zeitreihenvisualisierung.

## Bereiten Sie Zeitreihen vor
<a name="v10-panels-xform-funcs-preparetimeseries"></a>

Verwenden Sie diese Transformation, um Probleme zu beheben, wenn eine Datenquelle Zeitreihendaten in einem Format zurückgibt, das mit der gewünschten Visualisierung nicht kompatibel ist. Mit dieser Transformation können Sie Zeitreihendaten zwischen Breit- und Langformaten konvertieren.

**Zeitreihen mit mehreren Frames**

Verwenden Sie diese Option, um den Zeitreihen-Datenrahmen vom Breitformat in das Langformat umzuwandeln. Dies ist besonders hilfreich, wenn Ihre Datenquelle Zeitreiheninformationen in einem Format bereitstellt, das für eine optimale Kompatibilität mit Ihrer Visualisierung umgestaltet werden muss.

*Beispiel*

Diese Eingabe:


| Zeitstempel | Value1 | Value2 | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | 10 | 20 | 
| 2023-01-01 01:00:00 | 15 | 25 | 

Könnte umgewandelt werden in:


| Zeitstempel | Variable | Wert | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | Value1 | 10 | 
| 2023-01-01 00:00:00 | Value2 | 20 | 
| 2023-01-01 01:00:00 | Value1 | 15 | 
| 2023-01-01 01:00:00 | Value2 | 25 | 

**Breite Zeitreihen**

Verwenden Sie diese Option, um den Zeitreihen-Datenrahmen vom Langformat in das Breitformat umzuwandeln. Dies ist besonders hilfreich, wenn Ihre Datenquelle Zeitreihendaten in einem langen Format liefert und Ihre Visualisierung ein breites Format erfordert.

*Beispiel*

Diese Eingabe:


| Zeitstempel | Variable | Wert | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | Value1 | 10 | 
| 2023-01-01 00:00:00 | Value2 | 20 | 
| 2023-01-01 01:00:00 | Value1 | 15 | 
| 2023-01-01 01:00:00 | Value2 | 25 | 

Könnte umgewandelt werden in:


| Zeitstempel | Value1 | Value2 | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | 10 | 20 | 
| 2023-01-01 01:00:00 | 15 | 25 | 

## Reduzieren
<a name="v10-panels-xform-funcs-reduce"></a>

Verwenden Sie diese Transformation, wendet eine Berechnung auf jedes Feld im Datenrahmen an und gibt einen einzelnen Wert zurück. Diese Transformation ist besonders nützlich, um mehrere Zeitreihendaten in einem kompakteren, zusammengefassten Format zu konsolidieren. Zeitfelder werden entfernt, wenn diese Transformation angewendet wird.

Betrachten Sie die Eingabe:

Abfrage A:


| Zeit | Temporäre Dateien | Betriebszeit | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | 12.3 | 256122 | 
| 2020-07-07 11:24:20 | 15,4 | 1230233 | 

Anfrage B:


| Zeit | AQI | Fehler | 
| --- | --- | --- | 
| 07.07.2020 11:34:20 | 6,5 | 15 | 
| 07.07.2020 11:24:20 | 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
<a name="v10-panels-xform-funcs-rename"></a>

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`

Durch diese Transformation können Sie Ihre Daten an Ihre Visualisierungsanforderungen anpassen und Ihre Dashboards informativer und benutzerfreundlicher gestalten.

## Von Zeilen zu Feldern
<a name="v10-panels-xform-funcs-row"></a>

Verwenden Sie diese Transformation, um Zeilen in separate Felder umzuwandeln. 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 **Verwenden als**). 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) | 
| --- | --- | 
| 100 | 200 | 

Die zusätzlichen Beschriftungen können jetzt im Feldanzeigenamen 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.

Diese Transformation ermöglicht die Umwandlung von Zeilen in einzelne Felder, erleichtert die dynamische Feldkonfiguration und ordnet zusätzliche Felder Beschriftungen zu.

## Reihen zu Zeilen
<a name="v10-panels-xform-funcs-series"></a>

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 | 
| --- | --- | 
| 2020-07-07 11:34:20 | 25 | 
| 07.07.2020 10:31:22 | 22 | 
| 2020-07-07 09:30:05 | 19 | 

*Anfrage B:*


| Zeit | Feuchtigkeit | 
| --- | --- | 
| 2020-07-07 11:34:20 | 24 | 
| 07.07.2020 10:32:20 | 29 | 
| 07.07.2020 09:30:57 | 33 | 

Hier ist das Ergebnis nach der Anwendung der Transformation „Serie auf Zeilen“.


| Zeit | Metrik | Wert | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | Temperatur | 25 | 
| 07.07.2020 11:34:20 | Feuchtigkeit | 22 | 
| 2020-07-07 10:32:20 | Feuchtigkeit | 29 | 
| 2020-07-07 10:31:22 | Temperatur | 22 | 
| 2020-07-07 09:30:57 | Feuchtigkeit | 33 | 
| 2020-07-07 09:30:05 | Temperatur | 19 | 

Diese Transformation erleichtert die Konsolidierung von Ergebnissen aus mehreren Zeitreihenabfragen und bietet einen optimierten und einheitlichen Datensatz für eine effiziente Analyse und Visualisierung in einem tabellarischen Format.

## Sortieren nach
<a name="v10-panels-xform-funcs-sort"></a>

Verwenden Sie diese Transformation, um jeden Frame innerhalb eines Abfrageergebnisses nach einem bestimmten Feld zu sortieren, sodass Ihre Daten leichter zu verstehen und zu analysieren sind. Indem Sie das gewünschte Feld für die Sortierung konfigurieren, können Sie die Reihenfolge steuern, in der die Daten in der Tabelle oder Visualisierung dargestellt werden.

Verwenden Sie den **Umkehrschalter**, um die Werte innerhalb des angegebenen Feldes in umgekehrter Reihenfolge zu ordnen. Diese Funktion ist besonders nützlich, wenn Sie schnell zwischen aufsteigender und absteigender Reihenfolge wechseln möchten, um Ihren analytischen Anforderungen gerecht zu werden.

In einem Szenario, in dem Zeitreihendaten aus einer Datenquelle abgerufen werden, kann die Transformation „**Sortieren nach**“ angewendet werden, um die Datenrahmen auf der Grundlage des Zeitstempels entweder in aufsteigender oder absteigender Reihenfolge anzuordnen, je nach den analytischen Anforderungen. Diese Funktion stellt sicher, dass Sie auf einfache Weise durch Zeitreihendaten navigieren und diese interpretieren können, sodass Sie aus der organisierten und visuell kohärenten Präsentation wertvolle Erkenntnisse gewinnen können.

## Dreidimensional
<a name="v10-panels-xform-funcs-spatial"></a>

Verwenden Sie diese Transformation, um räumliche Operationen auf Abfrageergebnisse anzuwenden.
+ **Aktion** — Wählen Sie eine Aktion aus:
  + **Räumliches Feld vorbereiten** — Legen Sie ein Geometriefeld fest, das auf den Ergebnissen anderer Felder basiert.
    + **Positionsmodus** — Wählen Sie einen Positionsmodus aus (diese Optionen gelten für die Modi **Wert berechnen** und **Transformieren** gemeinsam):
      + **Automatisch** — Identifiziert Standortdaten automatisch anhand von Standardfeldnamen.
      + **Koordinaten** — Geben Sie Felder für Breitengrad und Längengrad an.
      + **Geohash** — Geben Sie ein Geohash-Feld an.
      + **Nachschlagen** — Geben Sie die Ortsverzeichnisfelder an.
  + **Wert berechnen** — Verwenden Sie die Geometrie, um ein neues Feld zu definieren ()heading/distance/area.
    + **Funktion** — Wählen Sie eine mathematische Operation, die auf die Geometrie angewendet werden soll:
      + **Überschrift** — Berechnet die Richtung (Richtung) zwischen zwei Punkten.
      + **Fläche** — Berechnet die Fläche, die von einem durch die Geometrie definierten Polygon eingeschlossen ist.
      + **Entfernung** — Berechnet den Abstand zwischen zwei Punkten.
  + **Transformieren** — Wendet räumliche Operationen auf die Geometrie an.
    + **Operation** — Wählen Sie eine Operation aus, die auf die Geometrie angewendet werden soll:
      + **Als Linie** — Erzeugt ein einzelnes Linien-Feature mit einem Scheitelpunkt in jeder Zeile.
      + **Liniengenerator** — Erzeugt eine Linie zwischen zwei Punkten.

Diese Transformation ermöglicht es Ihnen, Geodaten zu bearbeiten und zu analysieren, wodurch Operationen wie das Erstellen von Linien zwischen Punkten, das Berechnen räumlicher Eigenschaften und mehr ermöglicht werden.

## Umwandlung von Zeitreihen in Tabellen
<a name="v10-panels-xform-funcs-seriestotable"></a>

Verwenden Sie diese Transformation, um Zeitreihenergebnisse in eine Tabelle zu konvertieren und einen Zeitreihen-Datenrahmen in ein **Trendfeld** umzuwandeln. Das **Trendfeld** kann dann mit dem [Sparkline-Zelltyp](v10-panels-table.md#v10-panels-table-cell-type) gerendert werden, wodurch für jede Tabellenzeile eine Inline-Sparkline generiert wird. Wenn es mehrere Zeitreihenabfragen gibt, führt jede zu einem separaten Tabellendatenrahmen. Diese können mithilfe von Join- oder Merge-Transformationen verknüpft werden, um eine einzelne Tabelle mit mehreren Sparklines pro Zeile zu erzeugen.

Für jeden generierten **Trend-Feldwert** kann eine Berechnungsfunktion ausgewählt werden. Die Standardeinstellung ist **Letzter Wert ungleich Null**. Dieser Wert wird neben der Sparkline angezeigt und zum Sortieren von Tabellenzeilen verwendet.

## Regressionsanalyse
<a name="v10-panels-xform-funcs-regression"></a>

Verwenden Sie diese Transformation, um einen neuen Datenrahmen mit Werten zu erstellen, die von einem statistischen Modell vorhergesagt wurden. Dies ist nützlich, um einen Trend in chaotischen Daten zu finden. Es funktioniert, indem eine mathematische Funktion an die Daten angepasst wird, wobei entweder lineare oder polynomiale Regression verwendet wird. Der Datenrahmen kann dann in einer Visualisierung verwendet werden, um eine Trendlinie anzuzeigen.

Es gibt zwei verschiedene Modelle:
+  **Lineare Regression** — Passt eine lineare Funktion an die Daten an.
+  **Polynomielle Regression** — Passt eine Polynomfunktion an die Daten an.

**Anmerkung**  
Diese Transformation befindet sich derzeit in der öffentlichen Vorschau. Grafana Labs bietet eingeschränkten Support, und es können wichtige Änderungen vorgenommen werden, bevor die Funktion allgemein verfügbar gemacht wird.

# Problembehandlung bei Abfragen
<a name="v10-panels-query-troubleshoot"></a>

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

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](v10-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.

# Berechnungsarten
<a name="v10-panels-calculation-types"></a>

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

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 Werte | Array mit allen Werten | 
| Alle eindeutigen Werte | Array mit allen Einzelwerten | 
| 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 | 
| Erste | Erster Wert in einem Feld | 
| Erste\$1 (nicht Null) | Erstens, kein Nullwert in einem Feld (schließt auch aus NaNs) | 
| Letzte | Letzter Wert in einem Feld | 
| Letztes\$1 (nicht Null) | Letzter Wert, kein Nullwert in einem Feld (schließt auch aus NaNs) | 
| 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 | 

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

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

Ein Grafana-Panel ist eine visuelle Darstellung von Daten, die Sie anpassen können, indem Sie eine Datenquellenabfrage definieren, Daten transformieren und formatieren und Visualisierungseinstellungen konfigurieren.

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
+ Sehen Sie sich ein Panel-JSON-Modell an
+ Konfigurieren Sie sich wiederholende Zeilen und Bereiche

## Bearbeiten eines Panels
<a name="v10-panels-edit-a-panel"></a>

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

**Um ein Panel zu bearbeiten**

1. Öffnen Sie das Dashboard, das das Panel enthält, das 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. Wählen Sie das Menü und dann **Bearbeiten** aus.

   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="v10-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 Bedienfeldanzeige den Abschnitt **Bedienfeld-Optionen**.

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

   Der in dieses Feld eingegebene Text wird in einem Tooltip 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 in den Feldern **Titel** und **Beschreibung** definiert haben](v10-dash-variables.md), aber keine globalen Variablen.](v10-dash-variable-add.md#v10-dash-variable-add-global)

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

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

**So zeigen Sie ein Panel-JSON-Modell an**

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. Wählen Sie im Menü **Inspect > Panel JSON** aus.

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 die Datenstruktur des Panels an, einschließlich aller Transformationen, Feldkonfigurationen und Override-Konfigurationen, die angewendet wurden.

1. Um das JSON zu untersuchen, wählen Sie **>**, um Teile des JSON-Modells zu erweitern oder zu reduzieren.

## Konfiguration von sich wiederholenden Panels
<a name="v10-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. Weitere Informationen zu sich wiederholenden Bedienfeldern finden Sie unter[Dashboards erstellen](v10-dash-creating.md).

**Anmerkung**  
Bei wiederholten 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.

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

**Um sich wiederholende Panels zu konfigurieren**

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

1. Wählen Sie im Bereich „Anzeigeoptionen“ die Option „**Bedienfeldoptionen“ > „Wiederholungsoptionen**“.

1. Wählen Sie eine **Richtung** aus.
   + Wählen Sie **horizontal**, um die Paneele anzuordnen side-by-side. Grafana passt die Breite eines wiederholten Panels an. Sie können andere Panels in einer Reihe nicht mit einem sich wiederholenden Panel 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="v10-panels-configure-standard-options"></a>

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

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 weiter unten in diesem Thema.

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

**Um Standardoptionen zu konfigurieren**

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

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

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

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

1. Um eine Vorschau Ihrer Änderung anzuzeigen, wählen Sie außerhalb des Felds das Optionsfeld aus, das Sie gerade bearbeiten, oder drücken Sie die **EINGABETASTE**.

**Definitionen der Standardoptionen**

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**  
Grafana Labs arbeitet 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="v10-panels-standard-options-unit"></a>

Hier können Sie auswählen, welche Einheit ein Feld verwenden soll. Wählen Sie das Feld **Einheit** aus 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="v10-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 sollte.
+ **Zeit:** <format>Geben Sie für benutzerdefinierte Datums- und Uhrzeitformate beispielsweise ein`time:YYYY-MM-DD`. Informationen zur [Formatsyntax](https://momentjs.com/docs/#/displaying/) und zu den Optionen finden Sie unter Format in der *Dokumentation zu Moment.js*.
+ **si:** <base scale><unit characters>für benutzerdefinierte SI-Einheiten. Beispiel: `si: mF`. Dies 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="v10-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.

### Einheiten skalieren
<a name="v10-panels-standard-options-scale-units"></a>

Standardmäßig skaliert Grafana die Einheit automatisch auf der Grundlage der Größe des Werts. Wenn Sie beispielsweise einen Wert von 0,14 kW haben, zeigt Grafana ihn als 140 W an. Ein anderes Beispiel ist, dass 3000 kW als drei MW angezeigt werden. Wenn Sie dieses Verhalten deaktivieren möchten, können Sie den Schalter **Maßstabseinheiten** ausschalten.

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

Ermöglicht die Festlegung des Mindestwerts, der bei der Berechnung von prozentualen Schwellenwerten verwendet wird. Lassen Sie das Feld leer, um den Mindestwert automatisch zu berechnen.

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

Ermöglicht es Ihnen, den Höchstwert festzulegen, der bei der Berechnung des prozentualen Schwellenwerts verwendet wird. Lassen Sie das Feld leer, um den Höchstwert automatisch zu berechnen.

## Feld Min/Max
<a name="v10-panels-standard-options-fieldminmax"></a>

Standardmäßig basieren die berechneten Mindest- und Höchstwerte in allen Reihen und Feldern auf dem Minimum und Maximum. Wenn Sie das Feld min/max aktivieren, werden die Mindest- oder Höchstwerte für jedes Feld einzeln berechnet, basierend auf dem Minimum oder Maximum dieses Felds.

## Dezimalzahlen
<a name="v10-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="v10-panels-standard-options-displayname"></a>

Ermöglicht es Ihnen, den Anzeigetitel aller Felder festzulegen. Sie können [Variablen](v10-dash-variables.md) im Feldtitel 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.

Gegeben ist ein Feld mit dem Namen und den `Temp` Bezeichnungen: `{"Loc"="PBI", "Sensor"="3"}`


| Ausdruck-Syntax | Beispiel | Rendert zu | Erklärung | 
| --- | --- | --- | --- | 
| \$1\$1\$1\$1field.displayName\$1 | Entspricht der Syntax | Temp \$1Loc="PBI", Sensor="3"\$1 | Zeigt den Feldnamen und die Beschriftungen an, \$1\$1 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 | Temp | 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\$1values\$1 | Entspricht 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="v10-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 | 
| Schattierungen einer Farbe | Wählt Farbtöne einer einzigen Farbe aus, 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 | 
| Klassische Palette (nach Seriennamen) | Grafana weist die Farbe auf der Grundlage des Namens der Serie zu. Nützlich, wenn die zu visualisierenden Seriennamen von den verfügbaren Daten abhängen. | 
| Green-Yellow-Red (nach Wert) | Kontinuierliches Farbschema | 
| Red-Yellow-Green (nach Wert) | Kontinuierliches Farbschema | 
| Blue-Yellow-Red (nach Wert) | Kontinuierliches Farbschema | 
| Gelb-Rot (nach Wert) | Kontinuierliches Farbschema | 
| Blau-Lila (nach Wert) | Kontinuierliches Farbschema | 
| Gelb-Blau (nach Wert) | Kontinuierliches Farbschema | 
| Blautöne (nach Wert) | Kontinuierliches Farbschema (der Hintergrund des Bedienfelds wird blau) | 
| Rottöne (nach Wert) | Kontinuierliches Farbschema (Hintergrundfarbe des Bedienfelds wird rot) | 
| Grüntöne (nach Wert) | Kontinuierliches Farbschema (Farbe des Bedienfelds wird grün) | 
| Violett (nach Wert) | Kontinuierliches Farbschema (Hintergrundfarbe des Bedienfelds wird lila) | 

## Kein Wert
<a name="v10-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 (-).

# Eine Legende konfigurieren
<a name="v10-panels-configure-legend"></a>

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

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

Legenden werden für die folgenden Visualisierungen unterstützt:
+ [Balkendiagramm](v10-panels-bar-chart.md)
+ [Kerzenständer](v10-panels-candlestick.md)
+ [Histogramm](v10-panels-histogram.md)
+ [Kreisdiagramm](v10-panels-piechart.md)
+ [Zeitplan des Bundesstaates](v10-panels-state-timeline.md)
+ [Verlauf des Status](v10-panels-status-history.md)
+ [Zeitreihen](v10-panels-time-series.md)
+ [Trend](v10-panels-trend.md)

[Geomaps](v10-panels-geomap.md) und [Heatmaps](v10-panels-heatmap.md) haben auch Legenden, aber sie bieten nur die Wahl, ob eine Legende angezeigt werden soll oder nicht, und sie unterstützen keine anderen Legendenoptionen.

## Legendenoptionen
<a name="v10-panels-legend-options"></a>

Sie finden die folgenden Optionen im Bereich **Legende** im Bearbeitungsbereich des Bedienfelds.

**Anmerkung**  
Nicht alle der aufgelisteten Optionen gelten für alle Visualisierungen mit Legenden.

**Sichtbarkeit**

Stellen Sie ein, ob die Legende angezeigt wird oder nicht. Verwenden Sie den Schalter, um eine Legende ein- oder auszuschalten.

**Mode (Modus)**

Stellen Sie das Format ein, in dem die Legende angezeigt wird. Wählen Sie aus folgenden Optionen aus:
+ **Liste**
+ **Tabelle**

Wenn Sie eine Legende als Tabelle formatieren, werden möglicherweise auch andere Informationen zur Legende angezeigt, z. B. zugehörige Werte oder deren Position in der Visualisierung.

**Platzierung**

Legen Sie fest, wo in der Visualisierung eine Legende angezeigt wird. Wählen Sie aus folgenden Optionen aus:
+ **Bottom**
+ **Rechts**

**Width (Breite)**

Wenn Sie die Platzierung der Legende auf **Rechts** setzen, wird die Option **Breite** verfügbar. Lassen Sie das Feld leer, damit Grafana die Breite der Legende automatisch festlegen kann, oder geben Sie einen Wert in das Feld ein.

**Werte**

Sie können einer Visualisierung mehr Kontext hinzufügen, indem Sie einer Legende Seriendatenwerte oder [Berechnungen](v10-panels-calculation-types.md) hinzufügen. Sie können beliebig viele Werte hinzufügen. Nachdem Sie Ihre Änderungen übernommen haben, können Sie durch die Legende blättern, um alle Werte zu sehen.

## Die Farbe einer Datenreihe ändern
<a name="v10-panels-legend-change-color"></a>

Standardmäßig legt Grafana die Farbe Ihrer Seriendaten fest, Sie können sie jedoch über die Panellegende ändern.

**Um die Farbe einer Datenreihe zu ändern**

1. Navigieren Sie zu dem Bereich, den Sie aktualisieren möchten.

1. Wählen Sie in der Legende die Farbleiste aus, die der Serie zugeordnet ist.

1. Wählen Sie auf der Registerkarte **Farben** eine voreingestellte Farbe aus oder legen Sie auf der Registerkarte Benutzerdefiniert mithilfe der Auswahltaste oder der RGB-Werte eine **benutzerdefinierte** Farbe fest.

1. Speichern Sie das Dashboard.

## Isolieren von Seriendaten in einer Visualisierung
<a name="v10-panels-legend-isolate"></a>

Visualisierungen können oft visuell komplex sein und viele Datenreihen umfassen. Sie können die Ansicht vereinfachen, indem Sie Seriendaten mithilfe der Legende aus der Visualisierung entfernen, wodurch die Daten, die Sie sehen möchten, isoliert werden. Wenn Sie dies tun, erstellt Grafana automatisch eine neue Überschreibung auf der Registerkarte **Override**.

**Um Seriendaten in einer Visualisierung zu isolieren**

1. Navigieren Sie zu dem Bereich, den Sie aktualisieren möchten.

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 wieder 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 Ihre Änderungen zu speichern, sodass sie allen Zuschauern des Panels angezeigt werden, speichern Sie das Dashboard.

Um zur Standardansicht zurückzukehren, die alle Daten enthält, klicken Sie zweimal auf eine beliebige Reihenbezeichnung.

## Serien sortieren
<a name="v10-panels-legend-sort"></a>

Wenn Sie eine Legende als Tabelle formatieren und ihr Werte hinzufügen, können Sie die Datenreihen in der Tabelle nach diesen Werten sortieren.

**Um Datenreihen zu sortieren**

1. Navigieren Sie zu dem Bereich, den Sie aktualisieren möchten.

1. Bewegen Sie den Mauszeiger über einen beliebigen Teil des Panels, an dem Sie arbeiten möchten, um das Menü in der oberen rechten Ecke des Panels anzuzeigen.

1. Wählen Sie im Menü „**Bearbeiten“**.

1. Scrollen Sie im Bearbeitungsbereich des Bedienfelds zum Abschnitt „**Legende**“.

1. Wählen Sie unter **Werte** den Wert oder die Formel aus, die Sie anzeigen möchten.

   In der Legende werden jetzt Werte angezeigt.

1. Wählen Sie die Überschrift des Berechnungsnamens in der Legendentabelle aus, um die Werte in der Tabelle in aufsteigender oder absteigender Reihenfolge zu sortieren.

**Anmerkung**  
Diese Funktion wird nur in den folgenden Bereichen unterstützt: Balkendiagramm, Histogramm, Zeitreihe.

# Datenverknüpfungen konfigurieren
<a name="v10-panels-configure-data-links"></a>

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

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önnen Sie einen Datenlink zu einem oder zwei von ihnen hinzufügen. Sie können Bedienfelder auch mithilfe von Datenlinks verknüpfen.

Auf den Link selbst kann je nach Visualisierung auf unterschiedliche Weise zugegriffen werden. Für die Zeitreihenvisualisierung wählen Sie beispielsweise einen Datenpunkt oder eine Datenlinie. Bei großflächigen Visualisierungen wie Statistik, Messanzeige oder Balkenanzeige können Sie eine beliebige Stelle in der Visualisierung wählen, um das Kontextmenü zu öffnen.

Wenn es in der Visualisierung nur einen Datenlink gibt, wird bei Auswahl einer beliebigen Stelle in der Visualisierung der Link und nicht das Kontextmenü geöffnet.

**Unterstützte Visualisierungen**
+ Balkendiagramm
+ Balkenmaß
+ Kerzen
+ Leinwand
+ Messinstrument
+ Geomap
+ Heatmap
+ Histogramm
+ Kreisdiagramm
+ Stat
+ Zeitplan des Bundesstaates
+ Verlauf des Status
+ Tabelle
+ Zeitreihen
+ Trend

## Datenverbindungsvariablen
<a name="v10-panels-data-link-variables"></a>

Mit Variablen in Datenlinks können Sie Personen zu einem detaillierten Dashboard mit beibehaltenen Datenfiltern weiterleiten. Sie könnten beispielsweise eine Variable verwenden, um eine Bezeichnung, einen Zeitraum, eine Serie oder eine Variablenauswahl anzugeben.

Um eine Liste der verfügbaren Variablen anzuzeigen, geben Sie `$` das Feld für die **Datenlink-URL** ein.

Sie können auch Vorlagenvariablen in Ihren Datenlinks verwenden URLs, siehe[Variablen](v10-dash-variables.md).

### Variablen im Bedienfeld „Zeitbereich“
<a name="v10-panels-time-range-panel-variables"></a>

Mit diesen Variablen können Sie den aktuellen Zeitraum in die Datenlink-URL aufnehmen.
+ `__url_time_range`— Zeitbereich des aktuellen Dashboards (d. h.`?from=now-6h&to=now`)
+ `$__from` – Weitere Informationen finden Sie unter [Globale Variablen](v10-dash-variable-add.md#v10-dash-variable-add-global).
+ `$__to` – Weitere Informationen finden Sie unter [Globale Variablen](v10-dash-variable-add.md#v10-dash-variable-add-global).

### Serienvariablen
<a name="v10-panels-series-variables"></a>

Serienspezifische Variablen sind im `__series` Namespace verfügbar:
+ `__series.name`— Serienname zur URL

### Feldvariablen
<a name="v10-panels-field-variables"></a>

Feldspezifische Variablen sind im Namespace verfügbar: `__field`
+ `__field.name`— der Name des Feldes
+ `__field.labels.<LABEL>`— Der Wert des Labels für die URL. Wenn Ihr Etikett Punkte enthält, verwenden Sie die `__field.labels["<LABEL>"]` Syntax.

### Wertvariablen
<a name="v10-panels-value-variables"></a>

Wertspezifische Variablen sind im `__value` Namespace verfügbar:
+ `__value.time`— Zeitstempel des Werts (Unix-MS-Epoche) zur URL (d. h. `?time=1560268814105`
+ `__value.raw`— Rohwert
+ `__value.numeric`— numerische Darstellung eines Werts
+ `__value.text`— Textdarstellung eines Werts
+ `__value.calc`— Name der Berechnung, wenn der Wert das Ergebnis einer Berechnung ist

Die Verwendung wertspezifischer Variablen in Datenlinks kann je nach eingestellter Option im Tooltip-Modus zu unterschiedlichen Ergebnissen führen.

### Datenvariablen
<a name="v10-panels-data-variables"></a>

Um auf Werte aus anderen Feldern zuzugreifen, verwenden Sie:
+ `__data.fields[i]`— Wert des Feldes `i` (in derselben Zeile).
+ `__data.fields["NameOfField"]`— Wert des Feldes, das den Namen anstelle des Index verwendet.
+ `__data.fields[i].labels.cluster`— Greifen Sie auf die Beschriftungen eines anderen Feldes zu.

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

`${var-myvar:queryparam}`— wo `var-myvar` ist der Name der Vorlagenvariablen, 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=value1 | 
| hat mehrere Werte ausgewählt | var-myvar=value1&var-myvar=value2 | 
| ausgewählt All | var-myvar=All | 

Wenn Sie der URL alle Variablen des aktuellen Dashboards hinzufügen möchten, verwenden Sie`${__all_variables}`.

## Einen Datenlink hinzufügen
<a name="v10-panels-add-a-datalink"></a>

Sie können Datenlinks zu Ihren Panels hinzufügen.

1. Navigieren Sie zu dem Bereich, zu dem Sie den Datenlink hinzufügen möchten.

1. Zeigen Sie mit der Maus auf das Bedienfeld, um das Menüsymbol in der oberen rechten Ecke anzuzeigen.

1. Wählen Sie im Menü „**Bearbeiten“, um den Panel-Editor** zu öffnen.

1. Scrollen Sie im **Panel-Bearbeitungsbereich** nach unten zum Bereich **Datenlinks** und erweitern Sie ihn.

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

1. Geben Sie in dem sich öffnenden Dialogfeld einen **Titel** ein. Dies ist eine für Menschen lesbare Bezeichnung für den Link, die auf der Benutzeroberfläche angezeigt wird.

1. Geben Sie die **URL** oder Variable ein, auf die Sie verlinken möchten.

   Um eine Datenverknüpfungsvariable hinzuzufügen, wählen Sie das **URL-Feld** aus und geben Sie dann die Eingabetaste ein `$` oder drücken Sie Strg\$1Leertaste oder Befehlstaste\$1Leertaste, um eine Liste der verfügbaren Variablen anzuzeigen.

1. Wenn der Link in einer neuen Registerkarte geöffnet werden soll, wählen Sie In einer neuen Registerkarte **öffnen** aus.

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

1. Speichern Sie Ihre Änderungen im Dashboard.

# Wertezuordnungen konfigurieren
<a name="v10-panels-configure-value-mappings"></a>

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

Neben Feldüberschreibungen ist die Wertzuweisung eine Technik, mit der Sie die Darstellung von Daten in einer Visualisierung ändern können.

Bei der Zuordnung von Werten wird die in den [Standardoptionen](v10-panels-configure-standard-options.md) des Bedienfeldeditors festgelegte Einheitenformatierung, wie z. B. die Farbe oder die Anzahl der angezeigten Dezimalstellen, umgangen. Wenn Wertezuordnungen in einem Panel vorhanden sind, zeigt Grafana eine Zusammenfassung dieser Zuordnungen im Bereich **Wertzuordnungen** des Panel-Editors an.

**Unterstützte Visualisierungen**
+ Balkendiagramm
+ Balkenmessgerät
+ Kerzen
+ Leinwand
+ Messinstrument
+ Geomap
+ Histogramm
+ Kreisdiagramm
+ Stat
+ Zeitleiste des Bundesstaates
+ Verlauf des Status
+ Tabelle
+ Zeitreihen
+ Trend

## Arten von Wertezuordnungen
<a name="v10-panels-value-mappings-types"></a>

Grafana unterstützt die folgenden Wertzuordnungstypen:
+ **Wert** — Ordnet einem Text und einer Farbe bestimmte Werte zu. Sie können beispielsweise eine Wertezuordnung so konfigurieren, dass alle Instanzen des Werts als und `Perfection!` nicht als Zahl `10` angezeigt werden. Verwenden Sie eine **Wertezuordnung**, wenn Sie einen einzelnen Wert formatieren möchten.
+ **Bereich** — Ordnet numerische Bereiche Text und einer Farbe zu. Wenn ein Wert beispielsweise innerhalb eines bestimmten Bereichs liegt, können Sie eine Bereichswertzuweisung so konfigurieren, dass `High` statt der Zahl die Zahl angezeigt `Low` wird. Verwenden Sie die **Bereichszuordnung**, wenn Sie mehrere fortlaufende Werte formatieren möchten.
+ **Regex — Ordnet** reguläre Ausdrücke Text und einer Farbe zu. Wenn ein Wert beispielsweise ist`www.example.com`, können Sie eine Regex-Wertezuordnung so konfigurieren, dass Grafana die Domain anzeigt `www` und kürzt. Verwenden Sie das **Regex-Mapping**, wenn Sie den Text und die Farbe eines Werts mit einem regulären Ausdruck formatieren möchten.
+ **Spezial** — Ordnet spezielle Werte wie `Null` `NaN` (keine Zahl) und boolesche Werte wie und einem Text `true` und einer Farbe `false` zu. Sie können beispielsweise eine spezielle Wertezuordnung so konfigurieren, dass `null` Werte als angezeigt werden. `N/A` Verwenden Sie die **Zuordnung „Spezial**“, wenn Sie ungewöhnliche, boolesche oder leere Werte formatieren möchten.

## Eine Wertezuordnung hinzufügen
<a name="v10-panels-value-mappings-add"></a>

Sie können Ihren Panels Wertezuordnungen hinzufügen.

**Um eine Wertezuordnung hinzuzufügen**

1. Navigieren Sie zu dem Bereich, den Sie aktualisieren möchten.

1. Bewegen Sie den Mauszeiger über einen beliebigen Teil des Bedienfelds, um ein Menü in der oberen rechten Ecke des Bedienfelds anzuzeigen.

1. Wählen Sie im Menü „**Bearbeiten“**.

1. Wählen Sie im Abschnitt **Wertezuordnungen** die Option **Wertzuordnungen hinzufügen** aus.

1. Wählen Sie **Neue Zuordnung hinzufügen und wählen Sie dann eine** der folgenden Optionen aus:
   + **Wert** — Geben Sie einen einzelnen Wert ein, der zugeordnet werden soll.
   + **Bereich** — Geben Sie die Anfangs- und Endwerte eines abzugleichenden Bereichs ein.
   + **Regex** — Geben Sie ein Muster für reguläre Ausdrücke ein, nach dem gesucht werden soll.
   + **Spezial** — Wählen Sie einen speziellen Wert für den Abgleich aus.

1. (Optional) Geben Sie den Anzeigetext ein.

1. (Optional) Stellen Sie die Farbe ein.

1. Wählen Sie „**Aktualisieren**“, um die Wertezuordnung zu speichern.

Nachdem Sie eine Zuordnung hinzugefügt haben, ersetzt die Schaltfläche **Wertezuordnungen bearbeiten** die Schaltfläche **Wertezuordnungen hinzufügen**. Wählen Sie die Schaltfläche „Bearbeiten“, um Zuordnungen hinzuzufügen oder zu aktualisieren.

# Schwellenwerte konfigurieren
<a name="v10-panels-configure-thresholds"></a>

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

In Dashboards ist ein Schwellenwert ein Wert oder Grenzwert, den Sie für eine Metrik festlegen und der visuell wiedergegeben wird, wenn er erreicht oder überschritten wird. Schwellenwerte sind eine Möglichkeit, Ihre Visualisierungen auf der Grundlage von Abfrageergebnissen bedingt zu gestalten und einzufärben.

Sie können Schwellenwerte verwenden, um:
+ Färben Sie Rasterlinien oder Rasterflächenbereiche in einer Zeitreihenvisualisierung ein.
+ Färben Sie den Hintergrund- oder Werttext in einer Statistikvisualisierung ein.
+ Definieren Sie Regionen und Regionalfarben in einer Statuszeitleiste.
+ Farbige Linien in einer Zeitreihenvisualisierung.
+ Färben Sie die Markierungen für Messgerät und Schwellenwerte in einem Messgerät ein.
+ Farbmarkierungen in einer Geomap.
+ Färben Sie den Zellentext oder den Hintergrund in einer Tabelle ein.

**Unterstützte Visualisierungen**
+ Balkendiagramm
+ Balkenmaß
+ Kerzen
+ Leinwand
+ Messinstrument
+ Geomap
+ Histogramm
+ Stat
+ Zeitleiste des Bundesstaates
+ Verlauf des Status
+ Tabelle
+ Zeitreihen
+ Trend

## Standardschwellenwerte
<a name="v10-panels-thresholds-default"></a>

Bei Visualisierungen, die Schwellenwerte unterstützen, hat Grafana die folgenden Standardeinstellungen für Schwellenwerte:
+ 80 = rot
+ Basis = grün
+ Modus = Absolut
+ Schwellenwerte anzeigen = Aus (für einige Visualisierungen)

  Weitere Informationen finden Sie unter [Schwellenwerte anzeigen](#v10-panels-thresholds-show).

## Optionen für Schwellenwerte
<a name="v10-panels-thresholds-options"></a>

Sie können die folgenden Optionen festlegen, um genauer zu definieren, wie Schwellenwerte aussehen.

### Wert der Schwellenwerte
<a name="v10-panels-thresholds-value"></a>

Diese Zahl ist der Wert, der den Schwellenwert auslöst. In diesem Feld können Sie auch die Farbe festlegen, die dem Schwellenwert zugeordnet ist.

Der **Basiswert** steht für minus Unendlich. Standardmäßig ist er auf die Farbe Grün eingestellt, was im Allgemeinen die „gute“ Farbe ist.

### Modus „Schwellenwerte“
<a name="v10-panels-thresholds-mode"></a>

Es gibt zwei Schwellenwert-Modi:
+ **Absolute** Schwellenwerte werden durch eine Zahl definiert. Zum Beispiel 80 auf einer Skala von 1 bis 150.
+ **Prozentuale** Schwellenwerte werden relativ zum Mindest- oder Höchstwert definiert. Zum Beispiel 80 Prozent.

### Schwellenwerte anzeigen
<a name="v10-panels-thresholds-show"></a>

**Anmerkung**  
Diese Option wird nur für Balkendiagramm-, Kerzendiagramm-, Zeitreihen- und Trendvisualisierungen unterstützt.

Legen Sie mit den folgenden Optionen fest, ob und wie Schwellenwerte in der Visualisierung angezeigt werden.
+ **Aus** — Die Schwellenwerte werden nicht angezeigt.
+ **Als Linien** — Die Schwellenwerte werden in der Visualisierung als horizontale Linien angezeigt.
+ **Als Linien (gestrichelt)** — Die Schwellenwerte werden als gestrichelte horizontale Linien angezeigt.
+ **Als gefüllte Bereiche** — Die Schwellenwerte werden als horizontale Bereiche angezeigt.
+ **Als gefüllte Bereiche und Linien** — Die Schwellenwerte werden als horizontale Bereiche angezeigt, die durch Linien getrennt sind.
+ **Als gefüllte Bereiche und Linien (gestrichelt)** — Die Schwellenwerte werden als horizontale Bereiche angezeigt, die durch gestrichelte Linien getrennt sind.

## Einen Schwellenwert hinzufügen
<a name="v10-panels-thresholds-add"></a>

Sie können einer Visualisierung beliebig viele Schwellenwerte hinzufügen. Grafana sortiert Schwellenwerte automatisch vom höchsten zum niedrigsten.

**Um einen Schwellenwert hinzuzufügen**

1. Navigieren Sie zu dem Bereich, den Sie aktualisieren möchten.

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

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

1. Scrollen Sie zum Bereich **Schwellenwerte** oder geben Sie `Thresholds` in der Suchleiste oben im Bearbeitungsbereich des Bedienfelds die Eingabe ein.

1. Wählen Sie **\$1 Schwellenwert hinzufügen**.

1. Geben Sie einen neuen Schwellenwert ein, oder verwenden Sie die Aufwärts- und Abwärtspfeile auf der rechten Seite des Felds, um den Wert schrittweise zu erhöhen oder zu verringern.

1. Klicken Sie auf den farbigen Kreis links neben dem Schwellenwert, um den Farbwähler zu öffnen, in dem Sie die Schwellenwertfarbe aktualisieren können.

1. **Wählen Sie unter **Schwellenwertmodus** entweder **Absolut** oder Prozentual aus.**

1. Legen Sie unter **Schwellenwerte anzeigen** fest, wie der Schwellenwert angezeigt wird, oder deaktivieren Sie ihn.

Um einen Schwellenwert zu löschen, navigieren Sie zu dem Bereich, der den Schwellenwert enthält, und wählen Sie das Papierkorbsymbol neben dem Schwellenwert, den Sie entfernen möchten.

# Feldüberschreibungen konfigurieren
<a name="v10-panels-configure-overrides"></a>

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

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 enthalten, `bytes` indem Sie mithilfe des **Regex-Matchers Felder mit Namen, die dem Namen entsprechen, eine Überschreibung hinzufügen und dann der Überschreibungsregel** die Option Einheit hinzufügen.

## Beispiel 1: Temperatur formatieren
<a name="v10-panels-overrides-format-temperature"></a>

Nehmen wir an, dass unsere Ergebnismenge ein Datenrahmen ist, der aus zwei Feldern besteht: `time` und`temperature`.


| 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: Formatieren Sie Temperatur und Luftfeuchtigkeit
<a name="v10-panels-overrides-format-humidity"></a>

Nehmen wir an, dass unsere Ergebnismenge ein Datenrahmen ist, der aus vier Feldern besteht: `time``high temp`,`low temp`, und`humidity`.


| 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% | 

## Hinzufügen einer Feldüberschreibung
<a name="v10-panels-overrides-add-a-field"></a>

Mit einer Feldüberschreibungsregel können die Visualisierungseinstellungen für ein bestimmtes Feld oder eine Reihe angepasst werden.

**Um eine Feldüberschreibung hinzuzufügen**

1. Bearbeiten Sie den Bereich, dem Sie eine Überschreibung hinzufügen möchten.

1. Wählen Sie im Seitenbereich mit den Bedienfeldoptionen unten im Bereich die Option **Feldüberschreibung hinzufügen** aus.

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. Dadurch werden Felder ausgewählt, die überschrieben werden sollen, aber die Felder werden nicht umbenannt. Verwenden Sie dazu die Transformation [Umbenennen durch](v10-panels-xform-functions.md) Regex.
   + **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. Wählen Sie **Überschreibungseigenschaft hinzufügen** aus.

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 **Überschreibungseigenschaft hinzufügen** wählen, oder Sie können **Überschreibung hinzufügen** wählen und ein anderes Feld auswählen, zu dem Überschreibungen hinzugefügt werden sollen.

1. Wenn Sie fertig sind, wählen Sie **Speichern**, um alle Panel-Änderungen im Dashboard zu speichern.

## Löschen einer Feldüberschreibung
<a name="v10-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.

**Um ein Feld zu löschen, überschreiben Sie es**

1. Bearbeiten Sie den Bereich, der die Überschreibung enthält, die Sie löschen möchten.

1. Scrollen Sie im Seitenbereich mit den Bedienfeldoptionen nach unten, bis Sie die Überschreibungen sehen.

1. Wählen Sie die Überschreibung aus, die Sie löschen möchten, und wählen Sie dann das zugehörige Papierkorbsymbol.

## Feldüberschreibungen anzeigen
<a name="v10-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.

**Anmerkung**  
Die Überschreibungseinstellungen, die auf der Registerkarte **Alle** angezeigt werden, entsprechen den Einstellungen, die auf der Registerkarte **Überschreibungen** angezeigt werden.

## Bearbeiten einer Feldüberschreibung
<a name="v10-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.

**Um eine Feldüberschreibung zu bearbeiten**

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 das **X** neben der Eigenschaft auswählen.
   + Fügen Sie eine Überschreibungseigenschaft hinzu, indem **Sie Überschreibungseigenschaft hinzufügen** wählen.

# Visualisierungen verfügbar in Grafana-Version 10
<a name="v10-panels-viz"></a>

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

Grafana bietet eine Vielzahl von Visualisierungen zur Unterstützung verschiedener Anwendungsfälle. In diesem Abschnitt der Dokumentation werden die integrierten Visualisierungen, 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 [Zeitreihen](v10-panels-time-series.md) Panel.

**Anmerkung**  
Wenn Sie sich nicht sicher sind, welche Visualisierung Sie auswählen sollen, kann Grafana Visualisierungsvorschläge auf der Grundlage der Panel-Abfrage bereitstellen. Wenn Sie eine Visualisierung auswählen, zeigt Grafana eine Vorschau mit dieser angewendeten Visualisierung an.
+ Grafiken und Diagramme
  + [Zeitreihen](v10-panels-time-series.md) sind die Standard- und Hauptvisualisierung von Diagrammen.
  + [Zeitleiste](v10-panels-state-timeline.md) für Statusänderungen im Laufe der Zeit.
  + [Statusverlauf](v10-panels-status-history.md) für den periodischen Status im Zeitverlauf.
  + Das [Balkendiagramm](v10-panels-bar-chart.md) zeigt alle kategorialen Daten.
  + Das [Histogramm](v10-panels-histogram.md) berechnet die Wertverteilung und zeigt sie in einem Balkendiagramm.
  + [Heatmap](v10-panels-heatmap.md) visualisiert Daten in zwei Dimensionen, die in der Regel für das Ausmaß eines Phänomens verwendet werden.
  + [Kreisdiagramme](v10-panels-piechart.md) werden in der Regel dort verwendet, wo Proportionalität wichtig ist.
  + [Candlestick](v10-panels-candlestick.md) wird in der Regel für Finanzdaten verwendet, bei denen der Schwerpunkt auf Bewegung liegt. price/data 
  + [Bei Gauge](v10-panels-gauge.md) handelt es sich um ein herkömmliches abgerundetes Bild, das anzeigt, wie weit eine einzelne Metrik von einem Schwellenwert entfernt ist.
  + [Trend](v10-panels-trend.md) für Datensätze mit einem sequentiellen, numerischen X, das nicht der Zeit entspricht.
  + Das [XY-Diagramm](v10-panels-xychart.md) bietet eine Möglichkeit, beliebige X- und Y-Werte in einem Diagramm zu visualisieren.
+ Statistiken und Zahlen
  + [Statistik](v10-panels-stat.md) für große Statistiken und optionale Sparkline.
  + Die [Balkenlehre](v10-panels-bar-gauge.md) ist eine horizontale oder vertikale Balkenlehre.
+ Misc (Verschiedenes)
  + Die [Tabelle](v10-panels-table.md) ist die wichtigste und einzige Tabellenvisualisierung.
  + [Logs](v10-panels-logs.md) ist die Hauptvisualisierung für Logs.
  + [Knotendiagramm](v10-panels-node-graph.md) für gerichtete Graphen oder Netzwerke.
  + [Traces](v10-panels-traces.md) ist die Hauptvisualisierung für Spuren.
  + Der [Flammengraph](v10-panels-flamegraph.md) ist die Hauptvisualisierung für die Profilerstellung.
  + [Geomap](v10-panels-geomap.md) hilft Ihnen bei der Visualisierung von Geodaten.
  + [Datagrid](v10-panels-datagrid.md) ermöglicht das Erstellen und Bearbeiten von Daten und dient als Datenquelle für andere Panels.
+ Widgets
  + Die [Dashboard-Liste](v10-panels-dashboard-list.md) kann Dashboards auflisten.
  + Die [Warnungsliste](v10-panels-alert-list.md) kann Warnmeldungen auflisten.
  + [Text](v10-panels-text.md) kann Markdown und HTML enthalten.
  + [Nachrichten](v10-panels-news.md) können RSS-Feeds anzeigen.

## Holen Sie sich mehr
<a name="v10-panels-getmore"></a>

Sie können weitere Visualisierungstypen hinzufügen, indem Sie Panel-Plugins von der installieren[Finde Plugins im Plugin-Katalog](grafana-plugins.md#plugin-catalog).

## Beispiele
<a name="v10-panels-examples"></a>

In den folgenden Abschnitten finden Sie Beispiele für Visualisierungen.

## Diagramme
<a name="v10-panels-ex-graphs"></a>

Für zeitbasierte Linien-, Flächen- und Balkendiagramme empfehlen wir die standardmäßige [Zeitreihenvisualisierung](v10-panels-time-series.md).

![\[Ein Bild mit Beispielen für Zeitreihenvisualisierungen in Grafana.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/time_series_example.png)


[Verwenden Sie für kategoriale Daten ein Balkendiagramm.](v10-panels-bar-chart.md)

![\[Ein Bild mit Beispielen für Balkendiagramm-Visualisierungen in Grafana.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/barchart_example.png)


## Große Zahlen und Statistiken
<a name="v10-panels-ex-numbers"></a>

Eine [Statistikvisualisierung](v10-panels-stat.md) zeigt einen großen Statistikwert mit einer optionalen Grafiksparkline. Sie können die Hintergrund- oder Wertfarbe mithilfe von Schwellenwerten oder Farbskalen steuern.

![\[Ein Bild, das ein Beispiel für eine Statistikvisualisierung in Grafana zeigt.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/stat_panel_example.png)


## Messinstrument
<a name="v10-panels-ex-gauge"></a>

Wenn Sie einen Wert so darstellen möchten, dass er sich auf einen Mindest- und Höchstwert bezieht, haben Sie zwei Möglichkeiten. Zunächst ein [Standard-Radialmessgerät](v10-panels-gauge.md):

![\[Ein Bild, das ein Beispiel für eine Messgerät-Visualisierung in Grafana zeigt.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/gauge_example.png)


Zweitens verfügt Grafana auch über eine horizontale oder vertikale [Balkenanzeige](v10-panels-bar-gauge.md) mit drei verschiedenen Anzeigemodi.

![\[Ein Bild, das ein Beispiel für eine Messgerät-Visualisierung in Grafana zeigt.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/bar_gauge_example.png)


## Tabelle
<a name="v10-panels-ex-table"></a>

Verwenden Sie eine Tabellenvisualisierung, um Daten in einem [Tabellenlayout](v10-panels-table.md) anzuzeigen.

![\[Ein Bild, das ein Beispiel für eine Tabellenvisualisierung in Grafana zeigt.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/table_example.png)


## Kreisdiagramm
<a name="v10-panels-ex-piechart"></a>

Verwenden Sie eine [Kreisdiagrammvisualisierung](v10-panels-piechart.md), um reduzierte Reihen oder Werte in einer Reihe aus einer oder mehreren Abfragen in Bezug zueinander anzuzeigen.

![\[Ein Bild, das ein Beispiel für eine Kreisdiagrammvisualisierung in Grafana zeigt.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/pie_chart_example.png)


## Heatmaps
<a name="v10-panels-ex-heatmaps"></a>

Verwenden Sie eine [Heatmap-Visualisierung](v10-panels-heatmap.md), um die Wertverteilung im Laufe der Zeit darzustellen.

![\[Ein Bild, das ein Beispiel für eine Heatmap-Visualisierung in Grafana zeigt.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/heatmap_example.jpg)


## Zeitleiste des Bundesstaates
<a name="v10-panels-ex-state"></a>

Eine [Statuszeitleiste](v10-panels-state-timeline.md) zeigt diskrete Zustandsänderungen im Laufe der Zeit. Bei Verwendung mit Zeitreihen werden Schwellenwerte verwendet, um numerische Werte in Regionen mit diskreten Zuständen umzuwandeln.

![\[Ein Bild, das ein Beispiel für eine Statuszeitleistenvisualisierung in Grafana zeigt.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/state_timeline_example.png)


# Liste der Warnmeldungen
<a name="v10-panels-alert-list"></a>

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

Verwenden Sie Warnungslisten, um Ihre Benachrichtigungen anzuzeigen. Sie können die Liste so konfigurieren, dass der aktuelle Status angezeigt wird. Weitere Informationen zu Warnmeldungen finden Sie unter[Benachrichtigungen in Grafana-Version 10](v10-alerts.md).

Verwenden Sie diese Einstellungen, um Ihre Visualisierung zu verfeinern.

## Optionen
<a name="v10-panels-alert-list-options"></a>
+ **Gruppenmodus** — Wählen Sie zwischen der **Standardgruppierung**, um Warnungsinstanzen nach ihrer Warnungsregel gruppiert anzuzeigen, und der **benutzerdefinierten 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
  + **Zeit (asc)** — Die neuesten aktiven Alert-Instanzen zuerst.
  + **Zeit (desc)** — Die ältesten aktiven Alert-Instanzen zuerst.
+  **Benachrichtigungen von diesem Dashboard** — Zeigt nur Alarme aus dem Dashboard an, in dem sich die Warnungsliste befindet.

## Filter
<a name="v10-panels-alert-filter"></a>

Mit diesen Optionen können Sie die Anzeige von Alarmen auf diejenigen beschränken, die der von Ihnen ausgewählten Abfrage, dem Ordner oder den von Ihnen ausgewählten 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 Warnungen aus der ausgewählten Datenquelle.

## Zustandsfilter
<a name="v10-panels-alert-state-filter"></a>

Wählen Sie aus, welche Warnungsstatus in diesem Bereich angezeigt werden sollen.
+ Alarmieren/Abfeuern
+ Ausstehend
+ Keine Daten
+ Normal
+ Fehler

# Liste der Anmerkungen
<a name="v10-panels-annotations"></a>

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

Die Liste der Anmerkungen enthält eine Liste verfügbarer Anmerkungen, 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="v10-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="v10-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 Erstellungszeit 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 in der Visualisierung selbst live zu filtern.

## Verhalten von Links
<a name="v10-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
<a name="v10-panels-bar-chart"></a>

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

Mit Balkendiagrammen können Sie kategoriale Daten grafisch darstellen.

![\[Ein Bild mit Beispielen für Balkendiagramm-Visualisierungen in Grafana.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/barchart_example.png)


## Unterstützte Datumsformate
<a name="v10-panels-bar-chart-formats"></a>

Es wird nur ein Datenrahmen unterstützt, und er 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.

### Visualisierung von Zeitreihen oder mehreren Ergebnismengen
<a name="v10-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="v10-panels-bar-chart-options"></a>

Verwenden Sie diese Optionen, um Ihre Visualisierung 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.

**Dreht die Beschriftungen der X-Achse**

 Wenn das Diagramm vertikal ausgerichtet ist, dreht diese Einstellung die Beschriftungen unter den Balken. Diese Einstellung ist nützlich, wenn die Beschriftungen von Balkendiagrammen lang sind und sich überlappen.

**Maximale Länge der Hilfsstrichbeschriftung auf der X-A**

Legt die maximale Länge der Beschriftungen für Balkendiagramme fest. Beschriftungen, die länger als die maximale Länge sind, werden mit Ellipsen gekürzt.

**Mindestabstand für 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.

**Breite der Gruppe**

Steuert die Breite von Gruppen.
+ `0 = Minimum width`
+ `1 = Maximum width`

**Breite des Balkens**

Steuert die Breite der Balken.
+ `0 = Minimum width`
+ `1 = Maximum width`

**Radius des Balkens**

Steuert den Radius der Balken.
+ `0 = Minimum radius`
+ `0.5 = Maximum radius`

**Beim Bewegen des Mauszeigers den gesamten Bereich hervorheben**

Steuert, ob der gesamte umliegende Bereich des Balkens hervorgehoben wird, wenn Sie den Mauszeiger über den Balken bewegen.

**Linienbreite**

Steuert die Linienbreite der Balken.

**Deckkraft füllen**

Steuert die Deckkraft der Füllungen der Balken.

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

**Größe des Textes**

Geben Sie einen Wert ein, um die Größe des Textes in Ihrem Balkendiagramm zu ändern.

## Legendenoptionen
<a name="v10-panels-bar-chart-legend"></a>

**Legendenmodus**

Verwenden Sie diese Einstellungen, um zu definieren, wie die Legende in Ihrer Visualisierung angezeigt wird. Weitere Informationen finden Sie unter [Eine Legende konfigurieren](v10-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.

**Werte der Legende**

Wählen Sie Seriendatenwerte oder Standardberechnungen aus, die in der Legende angezeigt werden sollen. Sie können mehr als eine haben. Weitere Informationen finden Sie unter [Eine Legende konfigurieren](v10-panels-configure-legend.md).

## Achsenoptionen
<a name="v10-panels-bar-chart-axis"></a>

Verwenden Sie die folgenden Feldeinstellungen, um die Anzeige Ihrer Achsen zu verfeinern. Einige Feldoptionen wirken sich erst 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.

Um Achsen selektiv auszublenden, [fügen Sie Feldüberschreibungen hinzu](v10-panels-configure-overrides.md), die auf bestimmte Felder abzielen.

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

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

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. Weitere Informationen finden Sie unter [Standardoptionen konfigurieren](v10-panels-configure-standard-options.md).

**Zeigen Sie mehrere Y-Achsen an**

In einigen Fällen möchten Sie möglicherweise mehrere Y-Achsen anzeigen. Wenn Sie beispielsweise über einen Datensatz verfügen, der sowohl Temperatur als auch Luftfeuchtigkeit im Zeitverlauf zeigt, möchten Sie möglicherweise zwei Y-Achsen mit unterschiedlichen Einheiten für diese beiden Reihen anzeigen.

Sie können dies tun, indem Sie [Feldüberschreibungen hinzufügen](v10-panels-configure-overrides.md). Folgen Sie den Schritten so oft wie nötig, um so viele Y-Achsen hinzuzufügen, wie Sie benötigen.

# Balkenlehre
<a name="v10-panels-bar-gauge"></a>

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

Balkenanzeigen vereinfachen Ihre Daten, indem sie jedes Feld auf einen einzigen Wert reduzieren. 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.

![\[Ein Bild, das ein Beispiel für eine Balkenmesservisualisierung in Grafana zeigt.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/bar_gauge_example.png)


## Wertoptionen
<a name="v10-panels-bar-gauge-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 [Berechnungstypen](v10-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.

## Optionen für die Balkenanzeige
<a name="v10-panels-bar-gauge-options"></a>

Passen Sie an, wie die Balkenanzeige angezeigt wird.

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

**Anzeige der Werte**

Wählen Sie einen Wertanzeigemodus.
+ **Wertfarbe — Die** Wertfarbe wird durch den Wert bestimmt.
+ **Textfarbe — Die** Wertfarbe ist die Standardtextfarbe.
+ **Versteckt** — Werte sind ausgeblendet.

**Platzierung des Namens**

Wählen Sie einen Modus für die Platzierung von Namen.

**Anmerkung**  
Diese Option gilt nur, wenn die Balkenleiste horizontal ausgerichtet ist. Wenn die Balkenleiste vertikal ausgerichtet ist, werden die Namen immer am unteren Rand jeder Balkenleiste platziert.
+ **Auto** — Grafana bestimmt die beste Platzierung.
+ **Oben** — Die Namen werden oben auf jeder Balkenanzeige platziert.
+ **Links** — Die Namen werden links neben jeder Balkenleiste platziert.

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

**Größe des Balkens**

Wählen Sie einen Balkengrößenmodus.
+ **Automatisch** — Grafana bestimmt die beste Balkenstärke.
+ **Manuell** — Konfigurieren Sie die Größe des Balkenmaßes manuell.

**Minimale Breite**

Begrenzen Sie die Mindestbreite der Balkenspalte, wenn das Messgerät vertikal ausgerichtet ist.

Zeigt automatisch die Bildlaufleiste auf der X-Achse an, wenn eine große Datenmenge vorhanden ist.

**Anmerkung**  
Diese Option gilt nur, wenn die Balkengröße auf manuell eingestellt ist.

**Mindesthöhe**

Begrenzen Sie die Mindesthöhe der Balkenreihe, wenn das Messgerät horizontal ausgerichtet ist.

Zeigt automatisch die Scrollleiste auf der Y-Achse an, wenn eine große Datenmenge vorhanden ist.

**Anmerkung**  
Diese Option gilt nur, wenn die Balkengröße auf manuell eingestellt ist.

**Max. Höhe**

Begrenzen Sie die maximale Höhe der Balkenreihe, wenn das Messgerät horizontal ausgerichtet ist.

Zeigt automatisch die Scrollleiste auf der Y-Achse an, wenn eine große Datenmenge vorhanden ist.

**Anmerkung**  
Diese Option gilt nur, wenn die Balkengröße auf manuell eingestellt ist.

# Kerzen
<a name="v10-panels-candlestick"></a>

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

Mit der Candlestick-Visualisierung 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.

![\[Ein Bild, das ein Beispiel für eine Candlestick-Visualisierung in Grafana zeigt.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/candlestick-panel-example.png)


Candlestick-Visualisierungen bauen auf der Grundlage von auf und beinhalten viele gängige Konfigurationseinstellungen. [Zeitreihen](v10-panels-time-series.md)

## Mode
<a name="v10-panels-candlestick-mode"></a>

Mit den Modusoptionen können Sie umschalten, welche Dimensionen für die Visualisierung verwendet werden.
+ **Kerzen** — Beschränken Sie die Abmessungen des Panels auf die Abmessungen „Öffnen“, „Hoch“, „Niedrig“ und „Schließen“, die bei Candlestick-Visualisierungen verwendet werden.
+ **Volumen** — Beschränken Sie die Panelabmessung auf die Volumendimension.
+ **Beide** — Das Standardverhalten für das Candlestick-Panel. Es umfasst sowohl Candlestick- als auch Volumenvisualisierungen.

## Kerzen-Stil
<a name="v10-panels-candlestick-style"></a>
+ **Kerzen** — Der Standardanzeigestil, erzeugt Visualisierungen im Kerzenstil zwischen den Dimensionen „Öffnen“ und „Schließen“.
+ **OHLC-Balken** — Zeigt die Öffnungs-, Hoch-, Niedrig- und Schließwerte der vier Kerndimensionen an.

## Farbstrategie
<a name="v10-panels-candlestick-color"></a>
+ **Seit dem Öffnen** — Das Standardverhalten. 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 Schlusskurs größer oder gleich dem Wert beim Öffnen ist, wird die *Aufwärtsfarbe* verwendet.
+ **Seit dem letzten Schlusskurs** — Eine alternative Anzeigemethode, 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 Schlusskurs ist, wird die *Aufwärtsfarbe* 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
<a name="v10-panels-candlestick-updown"></a>

Mit den Optionen „**Farbe nach oben**“ und „**Farbe nach unten**“ wird ausgewählt, welche Farben verwendet werden, wenn sich die Preise nach oben oder unten bewegen. 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
<a name="v10-panels-candlestick-ohlc"></a>

Das Candlestick-Panel versucht, Felder der entsprechenden Dimension zuzuordnen.
+ **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)

**Anmerkung**  
In der Candlestick-Legende werden diese Werte nicht angezeigt.

Um diese Dimensionen richtig zuzuordnen, muss die Tabelle mit den Abfrageergebnissen aus Ihren Daten *mindestens* die folgenden Spalten enthalten.
+ `timestamp`
+ `open`
+ `high`
+ `low`
+ `close`

Wenn Ihre Daten diesen Dimensionen aus irgendeinem Grund nicht zugeordnet werden können (z. B. weil die Spaltennamen nicht identisch sind), können Sie sie manuell zuordnen, indem Sie die Felder **Öffnen**, **Hoch**, **Niedrig** und **Schließen** unter den **Candlestick-Optionen** im Panel-Editor verwenden.

## Zusätzliche Felder
<a name="v10-panels-candlestick-other"></a>

**Zusätzliche Felder**

Das Candlestick-Panel basiert auf der Zeitreihenvisualisierung. Es kann zusätzliche Datendimensionen visualisieren, die über die Dimensionen Öffnen, Hoch, Niedrig, Schlusskurs und Volumen hinausgehen. Mit den Optionen „**Einschließen**“ und „**Ignorieren**“ können auch andere enthaltene Daten wie einfache gleitende Durchschnitte, Bollinger-Bänder und mehr visualisiert werden. Dabei werden dieselben Stile und Konfigurationen verwendet, die auch in der [Zeitreihen](v10-panels-time-series.md) verfügbar sind.

# Leinwand
<a name="v10-panels-canvas"></a>

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

Leinwände kombinieren die Leistungsfähigkeit von Grafana mit der Flexibilität benutzerdefinierter Elemente. Leinwände sind erweiterbare, in Form von 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="v10-panels-canvas-elements"></a>

Sie können diese Elemente zu Ihrer Leinwand hinzufügen. Durch das Hinzufügen mehrerer und verschiedener Arten von Elementen können Sie eine Visualisierung auf eine Weise anpassen, die mit keiner anderen Visualisierung möglich ist.

**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 auf das Bedienfeld ausgelöst werden kann. Im Bearbeitungsmodus können Sie auswählen, welche Felddaten Sie anzeigen möchten.

**Text**

Mit dem Textelement können Sie ganz einfach Text zur Leinwand hinzufügen. Das Element unterstützt auch einen Bearbeitungsmodus, der entweder durch Doppelklicken oder durch die Menüoption Bearbeiten im Kontextmenü ausgelöst wird.

**Ellipse**

Mit dem Ellipsenelement können Sie der Leinwand eine einfache Ellipse hinzufügen. Ein Ellipsenelement kann Text (sowohl feste Daten als auch Felddaten) anzeigen, und seine Hintergrundfarbe kann auf der Grundlage von Datenschwellenwerten geändert werden.

**Rechteck**

Mit dem rechteckigen Element können Sie der Leinwand ein einfaches Rechteck hinzufügen. Ein rechteckiges Element kann Text (sowohl feste Daten als auch Felddaten) anzeigen, und seine Hintergrundfarbe kann auf der Grundlage von Datenschwellenwerten geändert werden.

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

**herstellen**

Mit dem Serverelement können Sie auf einfache Weise einen einzelnen Server, einen Stapel von Servern, eine Datenbank oder ein Terminal darstellen. Serverelemente unterstützen Statusfarbe, Lampenfarbe und eine Glühbirnenblinkrate, die alle durch feste Werte oder Feldwerte konfigurierbar sind.

**Button**

Mit dem Button-Element können Sie der Leinwand eine einfache Schaltfläche hinzufügen. Schaltflächenelemente unterstützen das Auslösen einfacher, nicht authentifizierter API-Aufrufe. Die API-Einstellungen befinden sich im Button-Element-Editor. Sie können auch Vorlagenvariablen im API-Editor übergeben.

**Anmerkung**  
Die Auswahl einer Schaltfläche löst nur dann einen API-Aufruf aus, wenn die Inline-Bearbeitung deaktiviert ist. Siehe [Bearbeitung der Leinwand](#v10-panels-canvas-editing).

## Verbindungen
<a name="v10-panels-canvas-connections"></a>

Beim Erstellen einer Zeichenfläche können Sie Elemente miteinander verbinden, um komplexere Visualisierungen zu erstellen. Sie können Verbindungen herstellen, indem Sie vom Verbindungsanker eines Elements zum Verbindungsanker eines anderen Elements ziehen. Sie können auch Verbindungen zum Hintergrund der Leinwand herstellen. Verbindungsanker werden angezeigt, wenn Sie den Mauszeiger über ein Element bewegen und die Inline-Bearbeitung aktiviert ist. Um eine Verbindung zu entfernen, wählen Sie die Verbindung aus und drücken `Delete` Sie dann oder. `Backspace`

Sie können sowohl die Größe als auch die Farbe von Verbindungen auf der Grundlage fester Werte oder Feldwerte festlegen. Rufen Sie dazu den Schalttafelbearbeitungsmodus auf, wählen Sie die Verbindung aus und ändern Sie die Verbindungseigenschaften im Bereichseditor.

## Bearbeitung der Leinwand
<a name="v10-panels-canvas-editing"></a>

**Inline-Editor**

Sie können Ihre Leinwand im Dashboard-Modus inline bearbeiten.

**Schwenken und zoomen**

Sie und schalten das Schwenken und Zoomen auf einer Leinwand ein. Auf diese Weise können Sie komplexere Designs erstellen und darin navigieren.

**Anmerkung**  
Pan and Zoom ist derzeit in der Vorschauversion von Grafana Labs verfügbar. Der Support ist begrenzt und wichtige Änderungen können vor der allgemeinen Verfügbarkeit vorgenommen werden.

**Kontextmenü**

Über das Kontextmenü können Sie häufig auftretende Aufgaben schnell und effizient ausführen. 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 (oder etwas Ähnliches) auf das Bedienfeld 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="v10-panels-canvas-options"></a>

**Inline-Bearbeitung**

Mit dem Umschalter für die Inline-Bearbeitung können Sie das Canvas-Bedienfeld sperren oder entsperren. Wenn diese Option deaktiviert ist, wird das Leinwandfenster *gesperrt*, wodurch Elemente an ihrem Platz fixiert werden und unbeabsichtigte Änderungen verhindert werden.

**Datenverknüpfungen**

Leinwände unterstützen [Datenlinks](v10-panels-configure-data-links.md). Gehen Sie wie folgt vor, um eine Datenverknüpfung für ein Metrikwertelement zu erstellen und sie für alle Elemente anzuzeigen, die den Feldnamen verwenden.

**Um eine Datenverknüpfung für ein Element zu erstellen**

1. Legen Sie fest, dass ein Element mit einem Feldwert verknüpft werden soll.

1. Schalten Sie den Schalter für die Inline-Bearbeitung aus.

1. Erstellen Sie eine Überschreibung für **Felder mit Namen** und wählen Sie den Elementfeldnamen aus der Liste aus.

1. Wählen Sie die Schaltfläche **\$1 Überschreibungseigenschaft hinzufügen**.

1. Wählen Sie in **der Liste Datenlinks > Datenlinks** aus.

1. Wählen Sie **\$1 Link hinzufügen**, fügen Sie einen Titel und eine URL für den Datenlink hinzu.

1. Zeigen Sie mit der Maus auf das Element, um den Tooltip für die Datenverknüpfung anzuzeigen.

1. Wählen Sie das Element aus, um den Datenlink öffnen zu können.

Wenn mehrere Elemente denselben Feldnamen verwenden und Sie steuern möchten, für welche Elemente der Datenlink angezeigt wird, können Sie mithilfe der [Fügen Sie ein Feld aus der Berechnung hinzu](v10-panels-xform-functions.md#v10-panels-xform-funcs-add) Transformation einen eindeutigen Feldnamen erstellen. Der Alias, den Sie in der Transformation erstellen, wird als Feld angezeigt, das Sie mit einem Element verwenden können.

# Dashboard-Liste
<a name="v10-panels-dashboard-list"></a>

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

Mit Dashboard-Listen können Sie dynamische Links zu anderen Dashboards anzeigen. 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.
+ **Aktuellen Zeitraum einbeziehen** — Wählen Sie diese Option, um den Zeitraum des aktuellen Dashboards auf die Dashboard-Links zu übertragen. Wenn der Benutzer einen Link auswählt, wird das verknüpfte Dashboard geöffnet, wobei der angegebene Zeitraum bereits festgelegt ist.
+ **Aktuelle Vorlagenvariablenwerte einbeziehen** — Wählen Sie diese Option, um Vorlagenvariablen, die derzeit als Abfrageparameter verwendet werden, in einen Link aufzunehmen. Wenn der Benutzer einen Link auswählt, werden alle passenden Vorlagen im verknüpften Dashboard auf die Werte aus der Liste gesetzt. Weitere Informationen finden Sie unter [URL-Variablen für das Dashboard](v10-dash-dashboard-url-variables.md).
+ **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 **Query** 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 die Tags 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.

# Datengitter
<a name="v10-panels-datagrid"></a>

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

**Anmerkung**  
Die Datengitter-Visualisierung wird derzeit von Grafana Labs in der Vorschau angezeigt. Der Support ist begrenzt und wichtige Änderungen können vor der allgemeinen Verfügbarkeit vorgenommen werden.

Datagrids bieten Ihnen die Möglichkeit, Daten in Grafana zu erstellen, zu bearbeiten und zu optimieren. Daher kann dieses Panel als Datenquelle für andere Panels in einem Dashboard dienen.

![\[Ein Bild, das ein Beispiel für eine Datagrid-Visualisierung in Grafana zeigt.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/datagrid-panel-example.png)


Damit können Sie Daten bearbeiten, die aus einer beliebigen Datenquelle abgefragt wurden, Sie können mit einem leeren Fenster beginnen oder Daten aus einer per Drag & Drop gezogenen Datei abrufen. Anschließend können Sie das Bedienfeld als einfache tabellarische Visualisierung verwenden oder die Daten modifizieren — und sie sogar ganz entfernen —, um ein leeres Blatt zu erstellen.

Durch die Bearbeitung des Datensatzes wird die Datenquelle so geändert, dass sie die integrierte **Grafana-Datenquelle** verwendet, wodurch die alten Datenquelleneinstellungen und die zugehörigen Abfragen ersetzt werden, während gleichzeitig der aktuelle Datensatz in das Dashboard-Modell kopiert wird.

Sie können das Panel dann als Datenquelle für andere Panels verwenden, indem Sie die integrierte **Dashboard-Datenquelle** verwenden, um die Datagrid-Daten abzurufen. Dies bietet ein interaktives Dashboard-Erlebnis, in dem Sie die Daten ändern und sehen können, wie sich die Änderungen in anderen Bereichen widerspiegeln.

Weitere Informationen zu den Datenquellen **Grafana** und **Dashboard** finden Sie unter[Spezielle Datenquellen](AMG-data-sources.md#AMG-data-sources-special).

## Kontextmenü
<a name="v10-panels-datagrid-context"></a>

Um die Bedienung zu vereinfachen, verfügt das Datagrid über ein Kontextmenü, auf das Sie zugreifen können, indem Sie mit der rechten Maustaste auf eine Zelle, eine Spaltenüberschrift oder eine Zeilenauswahl klicken. Je nach Status Ihres Datagrid bietet das Kontextmenü verschiedene Optionen, darunter die folgenden.
+ Löscht oder löscht alle Zeilen und Spalten.
+ Entfernen Sie alle vorhandenen Daten (damit Ihr Datagrid leer wird).
+ Trigger-Suchfunktion, mit der Sie Stichwörter innerhalb des Datensatzes finden können.

Durch das Löschen einer Zeile oder Spalte werden die Daten aus dem Datagrid entfernt, während beim Löschen einer Zeile oder Spalte nur die Daten aus den Zellen entfernt werden, sodass die Zeile oder Spalte intakt bleibt.

**Kopfzeilenmenü**

Sie können auch auf ein Header-Menü zugreifen, indem Sie das Dropdown-Symbol neben dem Header-Titel auswählen. Von hier aus können Sie eine Spalte nicht nur löschen oder löschen, sondern sie auch umbenennen, fixieren oder den Feldtyp der Spalte konvertieren.

## Serie auswählen
<a name="v10-panels-datagrid-selectseries"></a>

Wenn es mehrere Serien gibt, können Sie das Datagrid so einrichten, dass der bevorzugte Datensatz angezeigt wird. Verwenden Sie dazu das Drop-down-Menü **Serie auswählen** in den Paneloptionen.

## Datagrids verwenden
<a name="v10-panels-datagrid-using"></a>

Datagrids bieten verschiedene Möglichkeiten, mit Ihren Daten zu interagieren. Sie können Zeilen und Spalten bearbeiten, verschieben, löschen und entfernen, die integrierte Suchfunktion verwenden, um nach bestimmten Daten zu suchen, Feldtypen konvertieren oder das horizontale Scrollen in einer bestimmten Spalte fixieren.

**Daten hinzufügen**

Sie können einem Datagrid Daten hinzufügen, indem Sie eine neue Spalte oder Zeile erstellen.

**Um eine neue Spalte hinzuzufügen**

1. Wählen Sie in einem vorhandenen Fenster die Schaltfläche **\$1** in der Tabellenüberschrift nach der letzten Spalte.

1. Fügen Sie einen Namen für die neue Spalte hinzu.

1. Wählen Sie eine beliebige Stelle außerhalb des Felds aus oder drücken Sie`Enter`, um die Spalte zu speichern.

Jetzt können Sie in jeder Zelle Daten hinzufügen.

Um eine neue Zeile hinzuzufügen, klicken Sie auf die Schaltfläche **\$1** hinter der letzten Zeile. Die Schaltfläche befindet sich in jeder Zelle nach der letzten Zeile. Wenn Sie sie auswählen, wird eine neue Zeile erstellt und gleichzeitig die Zelle aktiviert, die Sie ausgewählt haben.

**Daten bearbeiten**

Sie können Spalten und Zeilen nach Bedarf verschieben.

**Um eine Spalte zu verschieben**

1. Halten Sie die Kopfzeile der Spalte gedrückt, die verschoben werden soll.

1. Ziehen Sie die Spalte an die gewünschte Position.

1. Lassen Sie die Spalte los, um die Bewegung abzuschließen.

Um eine Zeile zu verschieben, wählen Sie die Zeilenauswahl in der Zahlenspalte ganz links im Raster aus, halten Sie sie gedrückt und ziehen Sie sie an die gewünschte Position. Lassen Sie die Zeile los, um die Bewegung abzuschließen.

**Mehrere Zellen auswählen**

Sie können mehrere Zellen auswählen, indem Sie eine einzelne Zelle auswählen und die Maus über andere Zellen ziehen. Diese Auswahl kann verwendet werden, um die Daten aus den ausgewählten Zellen zu kopieren oder sie mit der `Delete` Taste zu löschen.

**Löschen oder Löschen mehrerer Zeilen oder Spalten**

Um mehrere Zeilen zu löschen oder zu löschen, können Sie wie folgt vorgehen.

**Um mehrere Zeilen oder Spalten zu löschen oder zu löschen**

1. Bewegen Sie den Mauszeiger über die Zahlenspalte (links von der ersten Spalte im Raster), um das Zeilen-Kontrollkästchen anzuzeigen.

1. Wählen Sie die Kontrollkästchen für die Zeilen aus, mit denen Sie arbeiten möchten. Um mehrere aufeinanderfolgende Zeilen auszuwählen, halten Sie die `Shift` Taste gedrückt, während Sie auf die erste und letzte Zeile klicken. Um nicht aufeinanderfolgende Zeilen auszuwählen, halten Sie die Taste `Ctrl` (oder`Cmd`) gedrückt, während Sie auf die gewünschten Zeilen klicken.

1. Klicken Sie mit der rechten Maustaste (oder gleichwertig), um das Kontextmenü aufzurufen.

1. **Wählen Sie **Zeilen löschen oder Zeilen löschen** aus.**

Dieselben Regeln gelten für Spalten, wenn Sie auf die Spaltenüberschriften klicken.

Um alle Zeilen zu löschen, verwenden **Sie das Kontrollkästchen Alle auswählen** in der oberen linken Ecke des Datenrasters. Dadurch werden alle Zeilen ausgewählt und Sie können sie über das Kontextmenü löschen.

# Flammendiagramm
<a name="v10-panels-flamegraph"></a>

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

Mit Flame-Diagrammen können Sie Profiling-Daten visualisieren. Mithilfe dieser Visualisierung kann das Profil als Flammendiagramm, Tabelle oder beides dargestellt werden.

![\[Ein Bild, das ein Beispiel für eine Flammengraph-Visualisierung in Grafana zeigt.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/flamegraph-panel-example.png)


## Flammendiagrammmodus
<a name="v10-panels-flamegraph-mode"></a>

Ein Flammendiagramm macht sich den hierarchischen Charakter der Profilerstellung von Daten zunutze. Es fasst Daten in einem Format zusammen, anhand dessen Sie leicht erkennen können, welche Codepfade bei der Speichermessung die meisten Systemressourcen beanspruchen, z. B. CPU-Zeit, zugewiesene Objekte oder Speicherplatz. Jeder Block im Flame-Graph steht für einen Funktionsaufruf in einem Stapel, und seine Breite entspricht seinem Wert.

Bei ausgegrauten Abschnitten handelt es sich um eine Reihe von Funktionen, die einen relativ kleinen Wert darstellen und aus Leistungsgründen zu einem Abschnitt zusammengefasst sind.

Wenn Sie mit der Maus auf eine bestimmte Funktion zeigen, wird eine QuickInfo angezeigt, die Ihnen zusätzliche Daten zu dieser Funktion anzeigt, z. B. den Wert der Funktion, den Prozentsatz des Gesamtwerts und die Anzahl der Stichproben mit dieser Funktion.

**Drop-down-Aktionen**

Sie können auf eine Funktion klicken, um ein Drop-down-Menü mit zusätzlichen Aktionen anzuzeigen: 
+ **Fokusblock** — Wenn Sie **Fokusblock** wählen, wird der Block oder die Funktion auf 100% der Breite des Flammendiagramms gesetzt, und alle untergeordneten Funktionen werden so angezeigt, dass ihre Breite im Verhältnis zur Breite der übergeordneten Funktion aktualisiert wird. Dadurch ist es einfacher, kleinere Teile des Flammendiagramms genauer zu untersuchen.
+ **Funktionsname kopieren** — Wenn Sie **Funktionsname kopieren** wählen, wird der vollständige Name der Funktion, für die der Block steht, kopiert.
+ **Sandwich-Ansicht** — In der Sandwich-Ansicht können Sie den Kontext der angeklickten Funktion anzeigen. Sie zeigt alle Aufrufer der Funktion oben und alle Aufrufer unten. Dies zeigt den aggregierten Kontext der Funktion. Wenn die Funktion also an mehreren Stellen im Flammendiagramm vorhanden ist, werden alle Kontexte in der Sandwich-Ansicht angezeigt und aggregiert.

**Statusleiste**

 In der Statusleiste werden Metadaten über das Flame-Diagramm und die aktuell vorgenommenen Änderungen angezeigt, z. B. welcher Teil des Diagramms im Fokus ist oder welche Funktion in der Sandwich-Ansicht angezeigt wird. Klicken Sie in der Statusleiste auf das **X**, um die Änderung zu entfernen.

## Symbolleiste
<a name="v10-panels-flamegraph-toolbar"></a>

**Suche**

Sie können das Suchfeld verwenden, um Funktionen mit einem bestimmten Namen zu finden. Alle Funktionen im Flammendiagramm, die der Suche entsprechen, bleiben farbig, während die übrigen Funktionen ausgegraut sind.

**Farbschemaauswahl**

Sie können zwischen Farbfunktionen anhand ihres Werts oder ihres Paketnamens wechseln, um Funktionen aus demselben Paket visuell miteinander zu verknüpfen.

**Text ausrichten**

Richten Sie den Text entweder links oder rechts aus, um wichtige Teile des Funktionsnamens anzuzeigen, wenn er nicht in den Block passt.

**Auswahlmenü für die Visualisierung**

Sie können wählen, ob nur das Flammendiagramm, nur die Tabelle oder beide gleichzeitig angezeigt werden sollen.

## Modus „Top-Tabelle“
<a name="v10-panels-flamegraph-toptablemode"></a>

Die obere Tabelle zeigt die Funktionen aus dem Profil im Tabellenformat. Die Tabelle hat drei Spalten: Symbole, Selbst und Summe. Die Tabelle ist standardmäßig nach Selbstzeit sortiert, kann aber durch Klicken auf die Spaltenüberschriften nach Gesamtzeit oder Symbolnamen neu angeordnet werden. Jede Zeile steht für aggregierte Werte für die angegebene Funktion, wenn die Funktion an mehreren Stellen im Profil vorkommt.

Es gibt auch Aktionsschaltflächen auf der linken Seite für jede Zeile. Die erste Schaltfläche sucht nach dem Funktionsnamen, während die zweite Schaltfläche die Sandwich-Ansicht der Funktion anzeigt.

## Daten-API
<a name="v10-panels-flamegraph-dataapi"></a>

Um das Flame-Diagramm zu rendern, müssen Sie die Datenrahmendaten mithilfe eines [Nested-Set-Modells](https://wikipedia.org/wiki/Nested_set_model) formatieren.

Ein verschachteltes Set-Modell stellt sicher, dass jedes Element des Flame-Graphen nur anhand seiner Verschachtelungsebene als Ganzzahlwert, seiner Metadaten und seiner Reihenfolge im Datenrahmen codiert wird. Das bedeutet, dass die Reihenfolge der Elemente signifikant ist und korrekt sein muss. Die Reihenfolge ist ein Durchqueren der Elemente im Flammendiagramm, wobei das Diagramm neu erstellt wird, ohne dass Werte variabler Länge im Datenrahmen wie in einem Array für Kinder erforderlich sind.

Erforderliche Felder:


| Feldname | Typ | Description | 
| --- | --- | --- | 
| level | number | Die Verschachtelungsebene des Elements. Mit anderen Worten, wie viele Elemente sich zwischen diesem Element und dem obersten Element des Flammendiagramms befinden. | 
| value | number | Der absolute oder kumulative Wert des Elements. Dies entspricht der Breite des Elements in der Grafik. | 
| Bezeichnung | Zeichenfolge | Das Etikett, das für den jeweiligen Artikel angezeigt werden soll. | 
| self | number | Eigenwert, der normalerweise der kumulative Wert des Elements abzüglich der Summe der kumulativen Werte seiner unmittelbar untergeordneten Elemente ist. | 

# Messinstrument
<a name="v10-panels-gauge"></a>

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

Messgeräte sind Visualisierungen mit einem einzigen Wert, mit denen ein Messgerät für jede Reihe, Spalte oder Zeile wiederholt werden kann.

![\[Ein Bild, das ein Beispiel für eine Messgerät-Visualisierung in Grafana zeigt.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/gauge_example.png)


## Wertoptionen
<a name="v10-panels-gauge-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. [Berechnungsarten](v10-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
<a name="v10-panels-gauge-gauge"></a>

Passen Sie an, wie das Messgerät angezeigt wird.

**Orientation (Ausrichtung)**

Wählen Sie eine Stapelrichtung.
+ **Automatisch** — Messgeräte werden in Zeilen und Spalten angezeigt.
+ **Horizontal** — Messgeräte werden von oben nach unten angezeigt.
+ **Vertikal** — Messgeräte werden von links nach rechts angezeigt.

**Beschriftungen für Schwellenwerte anzeigen**

Steuert, ob Schwellenwerte angezeigt werden.

**Schwellenwertmarkierungen anzeigen**

Steuert, ob ein Schwellenband außerhalb des inneren Messbereiches angezeigt wird.

**Größe des Messgeräts**

Wählen Sie einen Messgrößenmodus
+ **Automatisch** — Grafana bestimmt die beste Messgröße.
+ **Manuell** — Konfigurieren Sie die Messgröße manuell.

**Minimale Breite**

Stellen Sie die Mindestbreite von vertikal ausgerichteten Messgeräten ein.

Wenn Sie eine Mindestbreite festlegen, wird die Bildlaufleiste auf der X-Achse automatisch angezeigt, wenn eine große Datenmenge vorhanden ist.

**Anmerkung**  
Diese Option gilt nur, wenn die Messgröße auf manuell eingestellt ist.

**Minimale Höhe**

Stellen Sie die Mindesthöhe horizontal ausgerichteter Messgeräte ein.

Wenn Sie eine Mindesthöhe festlegen, wird die Scrollleiste der Y-Achse automatisch angezeigt, wenn eine große Datenmenge vorhanden ist.

**Anmerkung**  
Diese Option gilt nur, wenn die Messgröße auf manuell eingestellt ist.

**Neutral**

Stellen Sie den Startwert ein, ab dem jedes Messgerät gefüllt werden soll.

## Größe des Textes
<a name="v10-panels-gauge-textsize"></a>

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.

# Geomap
<a name="v10-panels-geomap"></a>

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

Mit Geomaps 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.

**Anmerkung**  
Sie können Ihre eigenen Geodaten zusätzlich zu den Grundkarten-Layern hinzufügen, die von bereitgestellt werden. AWS Die Grundkarten-Layer müssen alle von stammen. [https://tiles.maps.search-services.aws.a2z.com](https://tiles.maps.search-services.aws.a2z.com) 

![\[Ein Bild, das ein Beispiel für eine Geomap-Visualisierung in Grafana zeigt.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/geomap-panel-example.png)


## Kartenansicht
<a name="v10-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 *allen 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 in relativer Prozentzahl über die DatenausDEHNUNG hinaus 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üd-Ost-Asien**
    + **Ost-Asien**
    + **Australien**
    + **Ozeanien**
+ **Zoom** legt die anfängliche Zoomstufe fest.

## Kartenebenen
<a name="v10-panels-geomap-layers"></a>

Geomaps unterstützen 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“](#v10-panels-geomap-markers)rendert an jedem Datenpunkt eine Markierung.
+ [Heatmap-Ebene](#v10-panels-geomap-heatmap)visualisiert eine Heatmap der Daten.
+ [GeoJSON-Ebene](#v10-panels-geomap-geojson)rendert statische Daten aus einer GeoJSON-Datei.
+ [Ebene „Nacht/Tag“ (Alpha)](#v10-panels-geomap-nightday)rendert eine Nacht- oder Tagesregion.
+ [Routenebene (Vorschau)](#v10-panels-geomap-route)rendert Datenpunkte als Route.
+ [Ebene „Fotos“ (Vorschau)](#v10-panels-geomap-photos)rendert an jedem Datenpunkt ein Foto.
+ [Netzwerkebene (Vorschau)](#v10-panels-geomap-network)visualisiert anhand der Daten ein Netzwerkdiagramm.

Es gibt auch zwei experimentelle (oder Alpha-) Layertypen.
+ **Symbol am letzten Punkt (Alpha)** rendert ein Symbol am letzten Datenpunkt.
+ **Dynamic GeoJSON (Alpha)** stylt eine GeoJSON-Datei auf der Grundlage von Abfrageergebnissen.

**Anmerkung**  
Ebenen, die in der öffentlichen *Vorschau als Vorschau* oder *Alpha* gekennzeichnet sind. Grafana Labs bietet begrenzten Support, und es können wichtige Änderungen vorgenommen werden, bevor die Funktion allgemein verfügbar gemacht wird.

**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. Wenn Sie eine Ebene hinzufügen, werden Sie aufgefordert, einen Layer-Typ auszuwählen. Sie können den Ebenentyp jederzeit während der Panel-Konfiguration ändern.
+ 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 **Neu anordnen** ( dots/grab sechs Ziehpunkte) können Sie die Reihenfolge der Ebenen ändern. Daten auf höheren Ebenen werden über Daten auf niedrigeren Ebenen angezeigt. Die Visualisierung aktualisiert die Reihenfolge der Ebenen beim Ziehen und Ablegen, um die Auswahl der Ebenenreihenfolge zu vereinfachen.

Sie können einem einzelnen Geomap-Panel mehrere Datenebenen hinzufügen, um umfangreiche, detaillierte Visualisierungen zu erstellen.

**Ort**

Geomaps 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*:, `latitude` `lat`
  + *Längengrad*: `longitude``lng`, `lon`
  + *Suche*: `lookup`
+ **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="v10-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.
+ **Größe** konfiguriert die Größe der Markierungen. Die Standardeinstellung ist`Fixed size`, wodurch alle Markergrößen unabhängig von den Daten gleich sind. Es besteht jedoch auch die Möglichkeit, die Größe der Markierungen auf der Grundlage der Daten zu ändern, die dem ausgewählten Feld entsprechen. `Min`und die `Max` Markergröße muss so eingestellt werden, dass die Markerebene innerhalb dieses Bereichs skaliert werden kann.
+ Mit **Symbol** können Sie das Symbol, 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. einfachen Symbolen oder der Unicon-Bibliothek. Sie können auch eine URL angeben, die ein Bild-Asset enthält. Das Bild muss eine skalierbare Vektorgrafik (SVG) sein.
+ **Symbol Vertical Align** konfiguriert die vertikale Ausrichtung des Symbols relativ zum Datenpunkt. Beachten Sie, dass der Drehwinkel des Symbols zuerst um den Datenpunkt herum angewendet wird und dann die vertikale Ausrichtung relativ zur Drehung des Symbols angewendet wird.
+ Bei der **horizontalen Ausrichtung des Symbols** wird die horizontale Ausrichtung des Symbols relativ zum Datenpunkt konfiguriert. Beachten Sie, dass der Drehwinkel des Symbols zuerst um den Datenpunkt herum angewendet wird und dann die horizontale Ausrichtung relativ zur Drehung des Symbols angewendet wird.
+ **Farbe** konfiguriert die Farbe der Markierungen. In der `Fixed color` Standardeinstellung wird allen Markierungen eine bestimmte Farbe zugewiesen. Es besteht auch die Möglichkeit, bedingte Farben festzulegen, die von den ausgewählten Felddatenpunktwerten und dem im Abschnitt **Standardoptionen** festgelegten Farbschema abhängen.
+ Mit der **Fülldeckkraft** wird die Transparenz der einzelnen Markierungen konfiguriert.
+ Mit dem **Drehwinkel** wird der Drehwinkel der einzelnen Markierungen konfiguriert. Die Standardeinstellung ist **Fester Wert**, wodurch sich alle Markierungen unabhängig von den Daten um denselben Winkel drehen. Es besteht jedoch auch die Möglichkeit, die Drehung der Markierungen auf der Grundlage von Daten festzulegen, die einem ausgewählten Feld entsprechen.
+ **Textlabel** konfiguriert eine Textbeschriftung für jede Marke.
+ Mit „**Legende anzeigen**“ können Sie die Legende für die Ebenen ein- und ausschalten.
+ Mit der Option **„QuickInfo anzeigen“** können Sie die QuickInfos für die Ebene ein- und ausschalten.

## Heatmap-Ebene
<a name="v10-panels-geomap-heatmap"></a>

Die Heatmap-Ebene gruppiert verschiedene Datenpunkte, um Orte mit unterschiedlicher Dichte zu visualisieren.

![\[Ein Bild, das ein Beispiel für eine Heatmap mit der Geomap-Visualisierung in Grafana zeigt.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/geomap-heatmap-example.png)


Um eine Heatmap-Ebene hinzuzufügen:

Wählen Sie im 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. Bei einem **festen Wert** bleibt der Gewichtungswert für alle Datenpunkte konstant. Dieser Wert sollte im Bereich von 0 bis 1 liegen. Ähnlich wie bei Markierungen gibt es in der Dropdownliste eine alternative Option, mit der die Gewichtswerte automatisch in Abhängigkeit von den Datenwerten skaliert werden.
+ **Radius** konfiguriert die Größe der Heatmap-Cluster.
+ **Blur** konfiguriert den Grad der Unschärfe auf jedem Cluster.
+ **Opacity konfiguriert die Opazität** jedes Clusters.
+ Mit der Option **„QuickInfo anzeigen“ können Sie zwischen den QuickInfos** für die Ebene hin- und herschalten.

## GeoJSON-Ebene
<a name="v10-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.
+ Mit der Option **„QuickInfo anzeigen“** können Sie zwischen den QuickInfos für den Layer hin- und herschalten.

## Ebene „Nacht/Tag“ (Alpha)
<a name="v10-panels-geomap-nightday"></a>

Die Ebene Night /Day zeigt Nacht- und Tagesregionen auf der Grundlage des aktuellen Zeitbereichs an.

![\[Ein Bild, das ein Beispiel für eine Nacht-/Tag-Ebene zeigt, die die Geomap-Visualisierung in Grafana verwendet.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/geomap-day-night-example.png)


**Optionen**
+ Mit „**Anzeigen**“ wird die Zeitquelle vom Zeitbereich des Panels umgeschaltet.
+ **Farbe für den Nachtbereich** wählt die Farbe für den Nachtbereich aus.
+ **Sonne anzeigen** schaltet das Sonnensymbol um.
+ **Opazität** von 0 (transparent) bis 1 (undurchsichtig).
+ Mit der Option **„QuickInfo anzeigen“** können Sie die QuickInfos für die Ebene ein- und ausschalten.

**Anmerkung**  
Weitere Informationen finden Sie unter [Erweiterungen](https://viglino.github.io/ol-ext/examples/layer/map.daynight.html) für -. OpenLayers DayNight

## Routenebene (Vorschau)
<a name="v10-panels-geomap-route"></a>

Die Routenebene rendert Datenpunkte als Route.

**Anmerkung**  
Der Routen-Layer befindet sich derzeit in der öffentlichen Vorschau. Grafana Labs bietet begrenzten Support, und es können wichtige Änderungen vorgenommen werden, bevor die Funktion allgemein verfügbar gemacht wird.

![\[Ein Bild, das ein Beispiel für einen Routen-Layer zeigt, der die Geomap-Visualisierung in Grafana verwendet.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/geomap-route-layer-example.png)


**Optionen**
+ **Die Größe** legt die Dicke der Route fest. Standardmäßig ein fester Wert. Wenn Felddaten ausgewählt sind, können Sie den Mindest- und Maximalbereich festlegen, in dem Felddaten skaliert werden können.
+ **Farbe** legt die Farbe der Route fest. Standardmäßig ist die Farbe auf eine feste Farbe eingestellt. Sie können die Farbe auch an Felddaten binden.
+ Die **Deckkraft der Füllung** konfiguriert die Opazität der Route.
+ **Textlabel** konfiguriert eine Textbeschriftung für jede Route.
+ **Arrow** konfiguriert das Pfeildesign, das entlang der Route angezeigt wird, in der Reihenfolge der Daten.
  + **Keine**
  + **Vorwärts**
  + **Rückwärts**
+ Mit der Option **„QuickInfo anzeigen**“ können Sie die QuickInfos für die Ebene ein- und ausschalten.

**Anmerkung**  
Weitere Informationen finden Sie unter [Erweiterungen für OpenLayers — Flow Line Style](http://viglino.github.io/ol-ext/examples/style/map.style.gpxline.html).

## Ebene „Fotos“ (Vorschau)
<a name="v10-panels-geomap-photos"></a>

Die Fotoebene rendert an jedem Datenpunkt ein Foto.

**Anmerkung**  
Die Ebene „Fotos“ befindet sich derzeit in der öffentlichen Vorschau. Grafana Labs bietet begrenzten Support, und es können wichtige Änderungen vorgenommen werden, bevor die Funktion allgemein verfügbar gemacht wird.

**Optionen**
+ Mit **Image Source Field** können Sie ein Zeichenkettenfeld auswählen, das Bilddaten als Base64-kodierte Bildbinärdatei () enthält. `data:image/png;base64,...`
+ **Kind** legt den Rahmenstil für die Bilder fest. Wählen Sie aus folgenden Optionen aus:
  + **Square (Quadrat)**
  + **Circle**
  + **Verankert**
  + **Folio**
+ **Zuschneiden** schaltet ein oder aus, ob die Bilder passgenau zugeschnitten werden.
+ Mit der Option „**Schatten**“ wird ein Feld, das hinter den Bildern liegt, umgeschaltet.
+ **Rahmen** legt die Rahmengröße für Bilder fest.
+ Die **Rahmenfarbe** legt die Rahmenfarbe von Bildern fest.
+ Der **Radius** legt die Gesamtgröße von Bildern in Pixeln fest.
+ Mit der Option **„QuickInfo anzeigen**“ können Sie die QuickInfos für die Ebene ein- und ausschalten.

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

## Netzwerkebene (Vorschau)
<a name="v10-panels-geomap-network"></a>

Die Netzwerkschicht rendert ein Netzwerkdiagramm. Dieser Layer unterstützt dasselbe Datenformat, das von der Knotengraph-Visualisierung unterstützt wird, mit der Hinzufügung von Geodaten, die in den Knotendaten enthalten sind. Die Geodaten werden verwendet, um die Knoten auf der Karte zu lokalisieren und zu rendern.

**Anmerkung**  
Die Netzwerkebene befindet sich derzeit in der öffentlichen Vorschauversion. Grafana Labs bietet begrenzten Support, und es können wichtige Änderungen vorgenommen werden, bevor die Funktion allgemein verfügbar gemacht wird.

![\[Ein Bild mit Beispielen für Netzwerkvisualisierungen innerhalb einer Geomap in Grafana.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/geomap-network-layer-example.png)


**Anmerkung**  
Die Netzwerkebene befindet sich derzeit in der öffentlichen Vorschau. Grafana Labs bietet begrenzten Support, und es können wichtige Änderungen vorgenommen werden, bevor die Funktion allgemein verfügbar gemacht wird.

**Optionen**
+ Der **Pfeil** legt die Pfeilrichtung fest, die für jede Kante angezeigt werden soll, wobei „Vorwärts“ von der Quelle zum Ziel bedeutet. Wählen Sie aus folgenden Optionen aus:
  + **Keine**
  + **Vorwärts**
  + **Rückwärts**
  + **Beides**
+ Mit „**Legende anzeigen**“ können Sie die Legende für den Layer ein- und ausschalten. Die Legende unterstützt nur Knotendaten.
+ Mit der Option **„QuickInfo anzeigen“** können Sie zwischen den QuickInfos für den Layer hin- und herschalten.

**Knotenstile**
+ **Größe** konfiguriert die Größe der Knoten. Die Standardeinstellung ist **Feste Größe**, wodurch alle Knotengrößen unabhängig von den Daten gleich sind. Es besteht jedoch auch die Möglichkeit, die Größe der Knoten auf der Grundlage von Daten zu bestimmen, die einem ausgewählten Feld entsprechen. **Minimale** und **maximale** Knotengrößen müssen so eingestellt werden, dass die Knoten innerhalb dieses Bereichs skaliert werden können.
+ **Farbe** konfiguriert die Farbe der Knoten. Die Standardeinstellung ist **Feste Farbe**, wodurch allen Knoten eine bestimmte Farbe zugewiesen wird. Es besteht auch die Möglichkeit, bedingte Farben festzulegen, die von den ausgewählten Felddatenpunktwerten und dem im Abschnitt **Standardoptionen** festgelegten Farbschema abhängen.
+ Mit **Symbol** können Sie das Symbol, das Symbol oder die Grafik auswählen, um Ihren Daten zusätzlichen visuellen Kontext zu verleihen. Wählen Sie aus Elementen, die in Grafana enthalten sind, wie z. B. einfache Symbole 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.
+ Die **Füllundurchlässigkeit** konfiguriert die Transparenz jedes Knotens.
+ Der **Drehwinkel** konfiguriert den Drehwinkel jedes Knotens. Die Standardeinstellung ist **Fester Wert**, wodurch sich alle Knoten unabhängig von den Daten um denselben Winkel drehen. Es besteht jedoch auch die Möglichkeit, die Drehung der Knoten auf der Grundlage von Daten festzulegen, die einem ausgewählten Feld entsprechen.
+ **Textlabel** konfiguriert eine Textbeschriftung für jeden Knoten.

**Kantenstile**
+ **Größe** konfiguriert die Linienbreite der Kanten. Die Standardeinstellung ist **Feste Größe**, wodurch alle Kantenlinienbreiten unabhängig von den Daten gleich sind. Es besteht jedoch auch die Möglichkeit, die Kanten anhand der Daten zu dimensionieren, die einem ausgewählten Feld entsprechen. **Minimale** und **maximale** Kantengrößen müssen so eingestellt werden, dass die Kanten innerhalb dieses Bereichs skaliert werden können.
+ **Farbe** konfiguriert die Farbe der Kanten. Die Standardeinstellung ist **Feste Farbe**, wodurch allen Kanten eine bestimmte Farbe zugewiesen wird. Es besteht auch die Möglichkeit, bedingte Farben festzulegen, die von den ausgewählten Felddatenpunktwerten und dem im Abschnitt **Standardoptionen** festgelegten Farbschema abhängen.
+ Mit der **Füllundurchlässigkeit** wird die Transparenz der einzelnen Kanten konfiguriert.
+ Bei der **Textbeschriftung** wird für jede Kante eine Textbeschriftung konfiguriert.

## CARTO-Ebene
<a name="v10-panels-geomap-carto"></a>

CARTO-Layer werden in Amazon Managed Grafana nicht unterstützt.

## XYZ-Kachelebene
<a name="v10-panels-geomap-xyz"></a>

XYZ-Kachel-Layer werden in Amazon Managed Grafana nicht unterstützt.

## Öffnen Sie die Street Map-Ebene
<a name="v10-panels-geomap-osm"></a>

Offene Street Map-Layer (mit Ausnahme der standardmäßigen Basedmap) werden in Amazon Managed Grafana nicht unterstützt.

## ArcGIS-Layer
<a name="v10-panels-geomap-arcgis"></a>

ArcGIS-Layer werden in Amazon Managed Grafana nicht unterstützt.

## Steuerelemente für Karten
<a name="v10-panels-geomap-controls"></a>

Der Bereich Kartensteuerungen enthält verschiedene Optionen für Karteninformationen und Werkzeug-Overlays.

**Zoom**

Optionen für Zoomsteuerungen.

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

# Heatmap
<a name="v10-panels-heatmap"></a>

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

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)

![\[Ein Bild, das ein Beispiel für eine Heatmap-Visualisierung in Grafana zeigt.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/heatmap_example.jpg)


## Aus Daten berechnen
<a name="v10-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.
+ **symlog — Symlog-Skala**.

## Y-Achsen
<a name="v10-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.

**Zeigt mehrere Y-Achsen an**

In einigen Fällen möchten Sie möglicherweise mehrere Y-Achsen anzeigen. Wenn Sie beispielsweise über einen Datensatz verfügen, der sowohl Temperatur als auch Luftfeuchtigkeit im Zeitverlauf zeigt, möchten Sie möglicherweise zwei Y-Achsen mit unterschiedlichen Einheiten für diese beiden Reihen anzeigen.

Sie können dies tun, indem Sie [Feldüberschreibungen hinzufügen](v10-panels-configure-overrides.md). Folgen Sie den Schritten so oft wie nötig, um so viele Y-Achsen hinzuzufügen, wie Sie benötigen.

## Colors (Farben)
<a name="v10-panels-heatmap-colors"></a>

Das Farbspektrum steuert die Zuordnung zwischen der Anzahl der Werte (in jedem Bucket) und der jedem Bucket 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="v10-panels-heatmap-cell"></a>

Verwenden Sie diese Einstellungen, um Ihre Visualisierung zu verfeinern.

## Zusätzliche Anzeigeoptionen
<a name="v10-panels-heatmap-options"></a>

**Tooltip**
+ **Tooltip anzeigen** — Zeigt den Heatmap-Tooltip an.
+ **Histogramm anzeigen** — Zeigt ein Y-Achsen-Histogramm im Tooltip an. Ein Histogramm stellt die Verteilung der Bucket-Werte für einen bestimmten Zeitstempel dar.
+ **Farbskala anzeigen** — Zeigt eine Farbskala im Tooltip an. Die Farbskala stellt die Zuordnung zwischen Bucket-Wert und Farbe 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.

# Histogramm
<a name="v10-panels-histogram"></a>

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

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.

![\[Ein Bild, das ein Beispiel für eine Histogramm-Visualisierung in Grafana zeigt.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/histogram-example.png)


## Unterstützte Formate
<a name="v10-panels-histogram-formats"></a>

Die Histogramm-Visualisierung unterstützt Zeitreihen und beliebige Tabellenergebnisse mit einem oder mehreren numerischen Feldern.

## Optionen anzeigen
<a name="v10-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.

**Linienbreite**

Steuert die Linienbreite der Balken.

**Deckkraft füllen**

Steuert die Deckkraft der Füllung der Balken.

**Verlaufsmodus**

Stellen Sie den Modus der Verlaufsfüllung ein. 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.

## Optionen für die Legende
<a name="v10-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. Weitere Informationen zur Legende finden [Sie unter Eine Legende konfigurieren](v10-panels-configure-legend.md).

**Legendenmodus**

Verwenden Sie diese Einstellungen, um zu definieren, wie die Legende in Ihrer Visualisierung angezeigt wird.
+  **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](v10-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.

# Protokolle
<a name="v10-panels-logs"></a>

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

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="v10-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 [Protokollebene](v10-explore-logs.md#v10-explore-log-level).

## Details protokollieren
<a name="v10-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.

# Neuigkeiten
<a name="v10-panels-news"></a>

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

Die Nachrichtenvisualisierung zeigt einen RSS-Feed an. Standardmäßig werden Artikel aus dem Grafana Labs-Blog angezeigt. Benutzer können dies ändern, indem sie eine andere RSS-Feed-URL eingeben.

Geben Sie die URL eines RSS im Bereich **Anzeige** ein. Dieser Visualisierungstyp akzeptiert keine anderen Abfragen, und Benutzer sollten nicht erwarten, die RSS-Feed-Daten mithilfe dieser Visualisierung in irgendeiner Weise filtern oder abfragen zu können.

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

# Knotendiagramm
<a name="v10-panels-node-graph"></a>

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

Knotengraphen können gerichtete Graphen oder Netzwerke visualisieren. Sie verwenden ein Layout mit gerichteter Kraft, um die Knoten effektiv zu positionieren, sodass sie bei der Darstellung komplexer Infrastrukturkarten, Hierarchien oder Verlaufsdiagramme helfen können.

## Datenvoraussetzungen
<a name="v10-panels-node-graph-requirements"></a>

Ein Knotendiagramm erfordert eine bestimmte Form der Daten, um seine Knoten und Kanten anzeigen zu können. Nicht jede Datenquelle oder Abfrage kann mit diesem Diagramm visualisiert werden. Wenn Sie dies als Entwickler von Datenquellen verwenden möchten, lesen Sie den Abschnitt über die Daten-API.

Ein Knotendiagramm besteht aus *Knoten* und *Kanten*.
+ Ein *Knoten* wird als Kreis dargestellt. 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="v10-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="v10-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="v10-panels-node-graph-navigation"></a>

**Pan**

Sie können innerhalb des Knotendiagramms schwenken, indem Sie eine Position außerhalb eines Knotens oder einer Kante auswählen und den Mauszeiger ziehen.

**Vergrößern oder Verkleinern**

Sie können zoomen, indem Sie die Schaltflächen in der oberen linken Ecke des Knotendiagramms verwenden oder ein Mausrad oder eine andere Scroll-Eingabe mit der Taste `Ctrl` (oder`Cmd`) verwenden.

**Erkunden Sie 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 dieses Grenzwerts befinden, werden hinter auswählbaren 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.

**Rasteransicht**

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 (entweder `˄` oder`˅`) zeigt an, welche Statistik derzeit für die Sortierung und Sortierrichtung verwendet wird.

Wählen Sie einen Knoten aus und wählen Sie dann die Option **Im Grafiklayout anzeigen**, um zurück zum Grafiklayout mit Fokus auf dem ausgewählten Knoten zu wechseln und ihn im Kontext des vollständigen Diagramms anzuzeigen.

## Daten-API
<a name="v10-panels-node-graph-data-api"></a>

Für diese Visualisierung ist eine bestimmte Form der Daten erforderlich, die von der Datenquelle zurückgegeben werden müssen, 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, der die Knoten beschreibt, gesendet werden, 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 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. | 
| color | Zeichenkette/Zahl | Kann verwendet werden, um eine einzelne Farbe anzugeben, anstatt die `arc__` Felder zur Angabe von Farbabschnitten zu verwenden. Dabei kann es sich entweder um eine Zeichenfolge (es muss sich um eine akzeptable HTML-Farbzeichenfolge handeln) oder um eine Zahl handeln. In diesem Fall hängt das Verhalten von der `field.config.color.mode` Einstellung ab. Dies kann beispielsweise verwendet werden, um Verlaufsfarben zu erstellen, die durch einen Feldwert gesteuert werden. | 
| icon | Zeichenfolge | Name des Symbols, das im Knoten anstelle der Standardstatistiken angezeigt werden soll. Nur integrierte Grafana-Symbole sind zulässig (die verfügbaren Symbole finden Sie [hier).](https://developers.grafana.com/ui/latest/index.html?path=/story/docs-overview-icon--icons-overview) | 
| Kein Radius | number | Radiuswert in Pixeln. Wird zur Verwaltung der Knotengröße verwendet. | 
| markiert | Boolesch | Legt fest, ob der Knoten hervorgehoben werden soll. Verwenden Sie dies beispielsweise, um einen bestimmten Pfad im Diagramm darzustellen, indem Sie mehrere Knoten und Kanten hervorheben. Standardeinstellung: `false`. | 

# Kreisdiagramm
<a name="v10-panels-piechart"></a>

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

![\[Ein Bild, das ein Beispiel für eine Kreisdiagrammvisualisierung in Grafana zeigt.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/pie_chart_example.png)


Das Kreisdiagramm zeigt reduzierte 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="v10-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](v10-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 mindestens ein Feld aus, das in der Visualisierung angezeigt werden soll. 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="v10-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 mehr als eine 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.

## Legendenoptionen
<a name="v10-panels-piechart-legend"></a>

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

**Sichtbarkeit der Legende**

Verwenden Sie den Schalter **Sichtbarkeit**, um die Legende ein- oder auszublenden.

**Legendenmodus**

Stellen Sie den Anzeigemodus der Legende ein.
+ **Liste** — Zeigt die Legende als Liste an. Dies ist der Standardanzeigemodus der Legende.
+ **Tabelle** — Zeigt die Legende als Tabelle an.

**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 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](v10-panels-configure-legend.md).

# Stat
<a name="v10-panels-stat"></a>

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

Statistiken zeigen einen großen Statistikwert mit einer optionalen Grafiksparkline. Sie können die Hintergrund- oder Wertfarbe mithilfe von Schwellenwerten oder Überschreibungen steuern.

![\[Ein Bild, das ein Beispiel für eine Statistikvisualisierung in Grafana zeigt.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/stat_panel_example.png)


Standardmäßig zeigt eine Statistik eines der folgenden Elemente 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="v10-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="v10-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](v10-panels-calculation-types.md).
  + **Felder** — Wählen Sie die Felder aus, die in der Visualisierung 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 in der Visualisierung angezeigt werden.

## Statistikstile
<a name="v10-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 in der Visualisierung 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 angezeigt, auf den der Mauszeiger zeigt.
+ **Wert und Name** — Wert und Name werden immer angezeigt.
+ **Name** — Zeigt den Namen statt des Werts an. Der Wert wird im Tooltip angezeigt, auf den der Mauszeiger zeigt.
+ **Keine** — Nichts anzeigen (leer). Name und Wert werden im Hover-Tooltip angezeigt.

**Breites Layout**

Stellen Sie ein, ob das breite Layout aktiviert ist oder nicht. Das breite Layout ist standardmäßig aktiviert.
+ **An** — Das breite Layout ist aktiviert.
+ **Aus** — Das breite Layout ist ausgeschaltet.

**Anmerkung**  
Diese Option ist nur verfügbar, wenn der **Textmodus** auf **Wert und Name** eingestellt ist. Wenn das breite Layout aktiviert ist, werden der Wert und der Name side-by-side mit dem Wert auf der rechten Seite angezeigt, sofern das Bedienfeld breit genug ist. Wenn das breite Layout deaktiviert ist, wird der Wert immer unter dem Namen gerendert.

**Farbmodus**

Wählen Sie einen Farbmodus.
+ **Keine** — Dem Wert wird keine Farbe zugewiesen.
+ **Wert** — Wendet Farben auf den Wert- und Grafikbereich an.
+ **Hintergrundverlauf** — Wendet Farbe auf den Wert, den Grafikbereich und den Hintergrund an, wobei ein leichter Hintergrundverlauf entsteht.
+ **Einfarbiger Hintergrund** — Wendet Farbe auf den Wert, den Grafikbereich und den Hintergrund an, wobei eine einfarbige Hintergrundfarbe verwendet wird.

**Grafikmodus**

Wählen Sie einen Graphen- 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.

**Prozentuale Veränderung anzeigen**

Stellen Sie ein, ob die prozentuale Änderung angezeigt wird oder nicht. Standardmäßig wird es nicht angezeigt.

**Anmerkung**  
Diese Option ist nicht anwendbar, wenn die Einstellung **Anzeigen** unter **Wertoptionen** auf **Alle Werte** gesetzt ist.

## Größe des Textes
<a name="v10-panels-stat-textsize"></a>

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.

# Zeitleiste des Bundesstaates
<a name="v10-panels-state-timeline"></a>

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

Statuszeitleisten zeigen diskrete Zustandsänderungen im Laufe der Zeit. Jedes Feld oder jede Reihe wird als 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.

![\[Ein Bild, das ein Beispiel für Visualisierungen einer Statuszeitleiste in Grafana zeigt.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/state_timeline_example.png)


## Optionen für die Statuszeitleiste
<a name="v10-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.

**Nullwerte Connect**

Wählen Sie aus, wie Nullwerte, bei denen es sich um Lücken in den Daten handelt, im Diagramm angezeigt werden. Nullwerte können zu einer durchgehenden Linie verbunden oder auf einen Schwellenwert festgelegt werden, ab dem Lücken in den Daten nicht mehr miteinander verbunden sind.
+ **Nie** — Zeitreihendatenpunkte mit Lücken in den Daten werden nie miteinander verbunden.
+ **Immer** — Zeitreihendatenpunkte mit Lücken in den Daten sind immer miteinander verbunden.
+ **Schwellenwert** — Geben Sie einen Schwellenwert an, ab dem Lücken in den Daten nicht mehr miteinander verbunden sind. Dies kann nützlich sein, wenn die verbundenen Lücken in den Daten eine bekannte Größe haben oder innerhalb eines bekannten Bereichs liegen und Lücken außerhalb dieses Bereichs nicht mehr verbunden werden sollten.

**Werte trennen**

Wählen Sie aus, ob ein Schwellenwert festgelegt werden soll, über dem Werte in den Daten getrennt werden sollen.
+ **Nie** — Zeitreihendatenpunkte in den Daten werden niemals getrennt.
+ **Schwellenwert** — Geben Sie einen Schwellenwert an, ab dem Werte in den Daten getrennt werden. Dies kann nützlich sein, wenn die gewünschten Werte in den Daten eine bekannte Größe haben oder innerhalb eines bekannten Bereichs liegen und Werte außerhalb dieses Bereichs nicht mehr miteinander verknüpft werden sollen.

## Zuordnungen von Werten
<a name="v10-panels-state-timeline-valuemap"></a>

Um booleschen Werten oder Zeichenkettenwerten Farben zuzuweisen, verwenden Sie. [Wertezuordnungen konfigurieren](v10-panels-configure-value-mappings.md)

## Zeitreihendaten mit Schwellenwerten
<a name="v10-panels-state-timeline-threshold"></a>

Die Visualisierung kann auch mit Zeitreihendaten verwendet werden. In diesem Fall werden die Schwellenwerte verwendet, um die Zeitreihen in diskrete farbige Zustandsregionen umzuwandeln.

## Optionen für Legenden
<a name="v10-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 zu definieren, wie die Legende in Ihrer Visualisierung angezeigt wird. Weitere Informationen zur Legende finden Sie unter [Eine Legende konfigurieren](v10-panels-configure-legend.md).
+ **Liste** — Zeigt die Legende als Liste an. Das ist der Standardmodus.
+ **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](v10-panels-calculation-types.md) in der Legende angezeigt werden sollen. Sie können mehr als eine haben.

# Verlauf des Status
<a name="v10-panels-status-history"></a>

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

Statusverläufe zeigen periodische Zustände im Zeitverlauf. Jedes Feld oder jede Reihe wird als horizontale Zeile gerendert. Boxen werden gerendert und um jeden Wert zentriert.

## Unterstützte Daten
<a name="v10-panels-status-history-supporteddata"></a>

Ein Statusverlauf 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="v10-panels-status-history-options"></a>

Verwenden Sie diese Optionen, um die Visualisierung zu verfeinern.

**Werte anzeigen**

Steuert, ob Werte in den Wertefeldern gerendert werden. **Auto** rendert Werte, wenn ausreichend Platz vorhanden ist.

**Breite der Spalte**

Steuert die Breite der Boxen. 1 = maximaler Abstand und 0 = minimaler Abstand.

**Linienbreite**

Steuert die Linienbreite der Regionen der Bundesstaaten.

**Deckkraft füllen**

Steuert die Füllundurchlässigkeit von Regionen in Bundesstaaten.

## Wertezuordnungen
<a name="v10-panels-status-history-valuemap"></a>

Um booleschen Werten oder Zeichenkettenwerten Farben zuzuweisen, verwenden Sie. [Wertezuordnungen konfigurieren](v10-panels-configure-value-mappings.md)

## Zeitreihendaten mit Schwellenwerten
<a name="v10-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="v10-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 zu definieren, wie die Legende in Ihrer Visualisierung angezeigt wird. Weitere Informationen zur Legende finden Sie unter [Eine Legende konfigurieren](v10-panels-configure-legend.md).
+ **Liste** — Zeigt die Legende als Liste an. Das ist der Standardmodus.
+ **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](v10-panels-calculation-types.md) in der Legende angezeigt werden sollen. Sie können mehr als eine haben.

# Tabelle
<a name="v10-panels-table"></a>

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

Tabellen sind sehr flexibel und unterstützen mehrere Modi für Zeitreihen sowie für Tabellen, Anmerkungen und JSON-Rohdaten. Diese Visualisierung bietet auch Optionen zur Datumsformatierung, Wertformatierung und Farbgebung.

![\[Ein Bild, das ein Beispiel für eine Tabellenvisualisierung in Grafana zeigt.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/table_example.png)


**Anmerkung**  
Anmerkungen und Warnungen werden in Tabellen nicht unterstützt.

## Spalte sortieren
<a name="v10-panels-table-sort"></a>

Wählen Sie einen Spaltentitel, um die Sortierreihenfolge von Standard über absteigend bis aufsteigend zu ändern. Jedes Mal, wenn Sie die Spalte auswählen, ändert sich die Sortierreihenfolge zur nächsten Option im Zyklus. Sie können nach mehreren Spalten sortieren, indem Sie bei der Auswahl weiterer Spalten die `shift` Taste gedrückt halten.

## Optionen für Tabellen
<a name="v10-panels-table-options"></a>

**Kopfzeile anzeigen**

Aus Ihrer Datenquelle importierte Spaltennamen ein- oder ausblenden.

## Breite der Spalten
<a name="v10-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 eingeben`100`, werden alle Spalten auf eine Breite von 100 Pixeln festgelegt (die Änderung erfolgt, wenn Sie das Feld verlassen).

## Minimale Spaltenbreite
<a name="v10-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 das Minimum beispielsweise auf festlegen`75`, werden alle Spalten auf eine Breite von nicht weniger als 75 Pixeln skaliert.

Bei Geräten mit kleinem Bildschirm, wie Smartphones oder Tablets, können Sie den `150` Standardpixelwert auf reduzieren, `50` damit tabellenbasierte Bedienfelder in Dashboards korrekt dargestellt werden.

## Ausrichtung der Spalten
<a name="v10-panels-table-alignment"></a>

Wählen Sie aus, wie Grafana den Zellinhalt ausrichten soll.
+ Auto (Standard)
+ Links
+ zentrum
+ Rechts

## Zelltyp
<a name="v10-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.
+ *Einfach — Im Basismodus wird ein einfaches Messgerät angezeigt, wobei die Schwellenwerte die Farbe des Messgeräts definieren.*
+ *Gradient* — Die Schwellenwerte definieren einen Farbverlauf.
+ *LCD* — Das Messgerät ist in kleine Zellen aufgeteilt, die beleuchtet oder unbeleuchtet sind.

Darüber hinaus können Beschriftungen, die neben den Messgeräten angezeigt werden, so eingestellt werden, dass sie je nach Wert farbig sind, der Thementextfarbe entsprechen oder ausgeblendet werden.
+ **Farbe des Werts**
+ **Farbe des Textes**
+ **Versteckt**

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

**Sparkline**

Zeigt Werte an, die als Sparkline gerendert wurden. Erfordert [Zeitreihen für die Transformation von Tabellendaten](v10-panels-xform-functions.md#v10-panels-xform-funcs-series).

## Zellenwert überprüfen
<a name="v10-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="v10-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 unter [Tabellenspalten filtern](#v10-panels-table-filter).

## Paginierung
<a name="v10-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="v10-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 (Trichter) angezeigt.

**Spaltenwerte filtern**

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.

Wählen Sie aus mehreren Operatoren, um Spaltenwerte anzuzeigen:
+ **Enthält** — Entspricht einem Regex-Muster (standardmäßig Operator).
+ **Ausdruck** — Wertet einen booleschen Ausdruck aus. Das Zeichen `$` steht für den Spaltenwert im Ausdruck (z. B.). `$ >= 10 ≈& $ <= 12`
+ **Vergleichsoperatoren** — Sie können die typischen Vergleichsoperatoren verwenden:`=`,`!=`,`<`,`<=`,`>`,`>=`.

Aktivieren Sie das Kontrollkästchen über den Schaltflächen **OK** und **Abbrechen**, um alle angezeigten Werte zum Filter hinzuzufügen oder daraus zu entfernen.

**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="v10-panels-table-footer"></a>

Sie können den Tabellenfuß verwenden, um [Berechnungen](v10-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**.

# Text
<a name="v10-panels-text"></a>

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

Mithilfe von Textvisualisierungen können Sie Text oder HTML direkt in Ihre Dashboards aufnehmen. 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 bereinigter HTML-Code wiedergegeben.
+ **Code** — Mit dieser Einstellung werden Inhalte in einem schreibgeschützten Code-Editor wiedergegeben. 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.

# Zeitreihen
<a name="v10-panels-time-series"></a>

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

![\[Ein Bild mit Beispielen für Zeitreihenvisualisierungen in Grafana.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/time_series_example.png)


Zeitreihenvisualisierungen sind die Standard- und Hauptmethode, um Zeitreihendaten als Diagramm zu visualisieren. Sie können Serien als Linien, Punkte oder Balken rendern. Sie sind 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](v10-time-series-panel-tooltip.md)
+ [Legendenoptionen](v10-time-series-panel-legend.md)
+ [Grafikstile](v10-time-series-graph.md)
+ [Achsenoptionen](v10-time-series-axis.md)
+ [Farboptionen](v10-time-series-color.md)

# Tooltip-Optionen
<a name="v10-time-series-panel-tooltip"></a>

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

Die Tooltip-Optionen steuern die Informationsüberlagerung, die angezeigt wird, wenn Sie den Mauszeiger über Datenpunkte im Diagramm bewegen.

**Tooltip-Modus**
+ **Einzeln** — Der Hover-Tooltip zeigt nur eine einzige Serie an, nämlich die, ü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, wenn Sie mit der Visualisierung interagieren.

# Legendenoptionen
<a name="v10-time-series-panel-legend"></a>

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

Legendenoptionen steuern die Seriennamen und Statistiken, die unter oder rechts neben dem Diagramm angezeigt werden.

**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](v10-panels-configure-legend.md).
+ **Liste** — Zeigt die Legende als Liste an. Dies ist der Standardanzeigemodus einer 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](v10-panels-calculation-types.md) in der Legende angezeigt werden sollen. Sie können mehr als eine haben.

# Grafikstile
<a name="v10-time-series-graph"></a>

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

Verwenden Sie diese Option, um zu definieren, wie Ihre Zeitreihendaten angezeigt werden sollen. Sie können Überschreibungen verwenden, um mehrere Stile in derselben Grafik zu kombinieren.
+ **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
<a name="v10-time-series-graph-bar"></a>

Legt die Position des Balkens relativ zu einem Datenpunkt fest, an der der Punkt im Diagramm gezeichnet werden soll. Da ein Balken eine Breite hat, kann er vor, hinter oder in der Mitte des Punkts platziert werden. Für diese Option stehen folgende Optionen zur Verfügung:
+ ![\[An image showing a bar graph aligned before a point.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/bar-alignment-before.png)**Vorher** — Der Balken wird vor dem Punkt gezogen. Der Punkt befindet sich in der hinteren Ecke des Balkens.
+ ![\[An image showing a bar graph aligned around a point.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/bar-alignment-center.png)**Mitte** — Der Balken wird um den Punkt herum gezogen. Der Punkt wird in der Mitte des Balkens platziert. Dies ist die Standardeinstellung.
+ ![\[An image showing a bar graph aligned after a point.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/bar-alignment-after.png)**Nachher** — Der Balken wird hinter dem Punkt gezeichnet. Der Punkt wird an der vorderen Ecke des Balkens platziert.

## Linienbreite
<a name="v10-time-series-graph-linewidth"></a>

Die Linienbreite ist ein Schieberegler, der die Dicke für Serienlinien oder den Umriss für Balken steuert.

## Deckkraft füllen
<a name="v10-time-series-graph-fill"></a>

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
<a name="v10-time-series-graph-gradient"></a>

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](v10-panels-configure-standard-options.md#v10-panels-standard-options-color-scheme).

Die Optionen für den Verlaufsmodus sind:
+ **Keine** — Keine Verlaufsfüllung. Dies ist die Standardeinstellung.
+ **Deckkraft** — Ein Deckkraftverlauf, bei dem die Deckkraft der Füllung mit steigendem Wert der Y-Achse zunimmt.
+ **Farbton** — Ein subtiler Farbverlauf, der auf dem Farbton der Serienfarbe basiert.
+ **Schema** — Ein Farbverlauf, der durch Ihr Farbschema definiert wird. Diese Einstellung wird für den Füllbereich und die Linie verwendet. Weitere Informationen finden Sie unter [Farboptionen](v10-time-series-color.md).

Die Darstellung des Verlaufs wird durch die Einstellung für die **Deckkraft der Füllung** beeinflusst.

## Punkte anzeigen
<a name="v10-time-series-graph-showpoints"></a>

Mit den folgenden Optionen können Sie Ihre Visualisierung so konfigurieren, dass Punkte zu Linien oder Balken hinzugefügt werden.
+ **Auto** — Grafana bestimmt anhand der Dichte der Daten, ob Punkte angezeigt werden sollen. Punkte werden angezeigt, wenn die Dichte niedrig ist.
+ **Immer** — Punkte werden unabhängig von der Datendichte angezeigt.
+ **Nie** — Punkte werden nicht angezeigt.

## Punktgröße
<a name="v10-time-series-graph-pointsize"></a>

Legt die Größe der Punkte mit einem Durchmesser von 1 bis 40 Pixeln fest.

## Linieninterpolation
<a name="v10-time-series-graph-interpolation"></a>

Wählen Sie aus, wie Grafana die Serienlinie interpoliert.

![\[Ein Bild, das verschiedene Arten zeigt, Linien zwischen Punkten in Grafana zu zeichnen.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/line-interpolation.png)


Die Optionen sind:
+ **Linear** — Punkte sind durch gerade Linien verbunden.
+ **Glatt** — Punkte werden durch gekrümmte Linien verbunden, wodurch Übergänge zwischen Punkten geglättet werden.
+ **Schritt davor** — Die Linie wird als Schritte zwischen Punkten angezeigt. Punkte werden am Ende des Schritts gerendert.
+ **Schritt danach** — Die Linie wird als Schritte zwischen Punkten angezeigt. Punkte werden zu Beginn des Schritts gerendert.

## Line style (Linienstil)
<a name="v10-time-series-graph-linestyle"></a>

Legt den Stil der Linie fest. Um die Farbe zu ändern, verwenden Sie die Standardfeldoption für das Farbschema.

Für den Linienstil stehen folgende Optionen zur Auswahl:
+ **Durchgehend** — Zeigt eine durchgezogene Linie an. Dies ist die Standardeinstellung.
+ **Strich** — Zeigt eine gestrichelte Linie an. Wenn Sie diese Option wählen, wird eine Liste angezeigt, in der Sie die Länge und den Abstand (Länge, Abstand) für die Linienstriche auswählen können. Der Strichabstand ist standardmäßig auf 10, 10 eingestellt.
+ **Punkte** — Zeigt gepunktete Linien an. Wenn Sie diese Option wählen, wird eine Liste angezeigt, in der Sie die Lückenlänge für den Punktabstand auswählen können. Der Punktabstand ist standardmäßig auf 10 festgelegt.

## Nullwerte Connect
<a name="v10-time-series-graph-null"></a>

Wählen Sie aus, wie Nullwerte, bei denen es sich um Lücken in den Daten handelt, im Diagramm angezeigt werden. Nullwerte können so verbunden werden, dass sie eine durchgehende Linie bilden, oder sie können auf einen Schwellenwert festgelegt werden, ab dem Lücken in den Daten nicht mehr miteinander verbunden sind.

Für die Verbindung von Nullwerten stehen folgende Optionen zur Verfügung:
+ **Nie** — Zeitreihen-Datenpunkte mit Lücken in den Daten werden niemals miteinander verbunden.
+ **Immer** — Zeitreihendatenpunkte mit Lücken in den Daten sind immer miteinander verbunden.
+ **Schwellenwert** — Geben Sie einen Schwellenwert an, bei dessen Überschreitung Lücken in den Daten nicht mehr miteinander verbunden sind. Dies kann nützlich sein, wenn die verbundenen Lücken in den Daten eine bekannte Größe haben oder innerhalb eines bekannten Bereichs liegen und Lücken außerhalb des Bereichs nicht mehr verbunden werden sollen.

## Werte trennen
<a name="v10-time-series-graph-disconnect"></a>

Wählen Sie aus, ob eine Lücke zwischen Werten in den Daten hinzugefügt werden soll, deren Zeitabstand über einem bestimmten Schwellenwert liegt.

Für die Verbindungswerte stehen folgende Optionen zur Verfügung:
+ **Nie** — Zeitreihen-Datenpunkte werden niemals getrennt.
+ **Schwellenwert** — Geben Sie einen Schwellenwert an, ab dem Werte in den Daten getrennt werden. Dies kann nützlich sein, wenn die gewünschten Werte in den Daten eine bekannte Größe haben oder innerhalb eines bekannten Bereichs liegen und Werte außerhalb dieses Bereichs nicht mehr miteinander verknüpft werden sollen.

## Reihe stapeln
<a name="v10-time-series-graph-stack"></a>

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.

Für das Stapeln stehen folgende Optionen zur Verfügung:
+ **Aus** — Deaktiviert die Reihenstapelung.
+ **Normal** — Stapelt Serien übereinander.
+ **100%** — Prozentual gestapelt, wobei die Summe aller Serien zusammen 100% ergibt.

**Stapeln von Serien in Gruppen**

Sie können das Stapelverhalten überschreiben, um Serien in Gruppen zu stapeln. Weitere Informationen zum Erstellen einer Überschreibung finden Sie unter[Feldüberschreibungen konfigurieren](v10-panels-configure-overrides.md).

**So stapeln Sie Serien in Gruppen**

1. Bearbeiten Sie das Bedienfeld und wählen Sie „**Überschreibungen**“.

1. Erstellen Sie eine Feldüberschreibung für die Option „**Serie stapeln**“.

1. Wählen Sie im Stapelmodus **Normal** aus.

1. Benennen Sie die Stapelgruppe, in der die Serie erscheinen soll.

   Die Option für den Namen der Stapelgruppe ist nur verfügbar, wenn Sie eine Überschreibung erstellen.

## Füllen Sie das Folgende aus
<a name="v10-time-series-graph-fillbelow"></a>

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 Reihen mit den Bezeichnungen *Max* und *Min* haben, könnten Sie die Datenreihe *Max* auswählen und sie so überschreiben, dass sie **unterhalb der *Min-Reihe* Füllen** liegt. Dadurch würde nur der Bereich zwischen den beiden Serienlinien gefüllt.

# Achsenoptionen
<a name="v10-time-series-axis"></a>

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

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 drücken`Enter`.

## Zeitzone
<a name="v10-time-series-axis-timezone"></a>

Stellen Sie die gewünschten Zeitzonen ein, die entlang der X-Achse angezeigt werden sollen.

## Placement
<a name="v10-time-series-axis-placement"></a>

Wählen Sie die Platzierung der Y-Achse aus. Die Optionen sind:
+ **Auto** — 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 Achsen werden ausgeblendet.

Um Achsen selektiv auszublenden, [fügen Sie eine Feldüberschreibung](v10-panels-configure-overrides.md) hinzu, die auf bestimmte Felder abzielt.

## Label (Bezeichnung)
<a name="v10-time-series-axis-label"></a>

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
<a name="v10-time-series-axis-width"></a>

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 zu vergleichen, da die Achsen in visueller Nähe zueinander nicht verschoben oder gestreckt werden.

## Rasterlinien anzeigen
<a name="v10-time-series-axis-gridlines"></a>

Stellen Sie die Sichtbarkeit der Achsenrasterlinien ein.
+ **Automatisch** — Zeigt automatisch Rasterlinien basierend auf der Dichte der Daten an.
+ **Aktiviert** — Zeigt immer Rasterlinien an.
+ **Aus** — Zeigt niemals Rasterlinien an.

## Farbe
<a name="v10-time-series-axis-color"></a>

Legt die Farbe der Achse fest.
+ **Text** — Stellen Sie die Farbe auf der Grundlage der Thementextfarbe ein.
+ **Serie** — Stellen Sie die Farbe auf der Grundlage der Serienfarbe ein.

## Rand einblenden
<a name="v10-time-series-axis-border"></a>

Stellen Sie die Sichtbarkeit des Achsenrandes ein.

## Skalieren
<a name="v10-time-series-axis-scale"></a>

Legen Sie fest, wie die Werte der Y-Achse skaliert werden.
+ **Linear** — Teilt die Skala in gleiche Teile auf.
+ **Logarithmisch — Verwenden Sie eine logarithmische** Skala. Wenn Sie diese Option auswählen, wird eine Liste angezeigt, in der Sie eine binäre (Basis 2) oder eine allgemeine (Basis 10) logarithmische Skala auswählen können.
+ **Symlog** — Verwenden Sie eine symmetrische logarithmische Skala. Wenn Sie diese Option auswählen, wird eine Liste angezeigt, in der Sie eine binäre (Basis 2) oder eine allgemeine (Basis 10) logarithmische Skala auswählen können. Mit der Option „Linearer Schwellenwert“ können Sie den Schwellenwert festlegen, bei dem die Skala von linear zu logarithmisch wechselt.

## Zentrierter Nullpunkt
<a name="v10-time-series-axis-centered"></a>

Legt fest, dass die Y-Achse auf Null zentriert ist.

## Soft Min und Soft Max
<a name="v10-time-series-axis-softminmax"></a>

Stellen Sie eine **Soft-Min** - oder **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.

Die Einstellungen „Soft Min“ und „Soft Max“ können verhindern, dass kleine Abweichungen in den Daten vergrößert werden, wenn sie größtenteils flach sind. Im Gegensatz dazu tragen harte Min- und Max-Werte dazu bei, dass nützliche Details in den Daten nicht verdeckt werden, indem intermittierende Spitzen über einen bestimmten Punkt hinaus abgeschnitten werden.

Um feste Grenzwerte für die Y-Achse zu definieren, legen Sie Standardoptionen fest. min/max Weitere Informationen finden Sie unter [Standardoptionen konfigurieren](v10-panels-configure-standard-options.md).

## Transformieren
<a name="v10-time-series-axis-transform"></a>

Verwenden Sie diese Option, um die Serienwerte zu transformieren, ohne dass sich dies auf die Werte auswirkt, die in der QuickInfo, den Kontextmenüs oder der Legende angezeigt werden. 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.

**Anmerkung**  
Die Transformationsoption ist nur als Override verfügbar.

## Zeigen Sie mehrere Y-Achsen an
<a name="v10-time-series-axis-multiple"></a>

Es gibt einige Fälle, in denen Sie mehrere Y-Achsen anzeigen möchten. Wenn Sie beispielsweise über einen Datensatz verfügen, der sowohl Temperatur als auch Luftfeuchtigkeit im Zeitverlauf zeigt, könnten Sie für diese beiden Reihen zwei Y-Achsen mit unterschiedlichen Einheiten anzeigen.

Um mehrere Y-Achsen anzuzeigen, [fügen Sie eine Feldüberschreibung](v10-panels-configure-overrides.md#v10-panels-overrides-add-a-field) hinzu. Folgen Sie den Schritten so oft wie nötig, um so viele Y-Achsen hinzuzufügen, wie Sie benötigen.

# Farboptionen
<a name="v10-time-series-color"></a>

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

Standardmäßig verwendet das Diagramm die Standardoption [Farbschema](v10-panels-configure-standard-options.md#v10-panels-standard-options-color-scheme), um Serienfarben zuzuweisen. Sie können die Legende auch verwenden, um den Farbwähler zu öffnen, indem Sie das Farbsymbol für die Legendenserie auswählen. 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
<a name="v10-time-series-color-classic"></a>

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
<a name="v10-time-series-color-single"></a>

Verwenden Sie diesen Modus, um eine Farbe anzugeben. Sie können auch das farbige Liniensymbol neben jeder Serie in der Legende auswählen, 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
<a name="v10-time-series-color-byvalue"></a>

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
<a name="v10-time-series-color-gradient"></a>

Die Option **Verlaufsmodus** unter den **Grafikstilen** 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.

# Ablaufverfolgungen
<a name="v10-panels-traces"></a>

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

Mithilfe von Traces-Visualisierungen können Sie einer Anfrage folgen, während sie die Dienste in Ihrer Infrastruktur durchläuft. Die Traces-Visualisierung zeigt Trace-Daten in einem Diagramm an, sodass Sie sie einfach interpretieren können.

Weitere Informationen zu Traces und deren Verwendung finden Sie in der folgenden Dokumentation:
+ [Ablaufverfolgung in Explore](v10-explore-tracing.md)
+ [Tempo-Datenquelle](tempo-data-source.md)
+ [Erste Schritte mit Tempo](https://grafana.com/docs/tempo/latest/getting-started/) in der *Tempo-Dokumentation von Grafana Labs*.

## Hinzufügen eines Panels mit Tracing-Visualisierungen
<a name="v10-panels-traces-add"></a>

Sobald Sie Tracing-Daten in Ihrem Grafana-Stack verfügbar haben, können Sie Ihren Grafana-Dashboards Tracing-Panels hinzufügen.

Mithilfe einer Dashboard-Variablen können Sie eine Abfrage erstellen`traceID`, um bestimmte Traces für eine bestimmte Trace-ID anzuzeigen. Weitere Informationen zu Dashboard-Variablen finden Sie in der [Variablen-Dokumentation](v10-dash-variables.md). 

**Voraussetzungen**

Bevor Sie anfangen, benötigen Sie:
+ Ein Amazon Managed Grafana-Arbeitsbereich.
+ Eine [Tempo-Datenquelle](tempo-data-source.md), die mit Ihrem Workspace verbunden ist.

Um Traces-Daten in einem Dashboard anzuzeigen und zu analysieren, müssen Sie die Traces-Visualisierung zu Ihrem Dashboard hinzufügen und mit dem Panel-Editor eine Abfrage definieren. Die Abfrage bestimmt die Daten, die in der Visualisierung angezeigt werden. Weitere Informationen zum Panel-Editor finden Sie in der [Dokumentation zum Panel-Editor](v10-panels-editor-overview.md).

Bei diesem Verfahren können Sie mithilfe von Dashboard-Variablen und -Vorlagen eine Ablaufverfolgung eingeben IDs , die anschließend visualisiert werden kann. Sie verwenden eine Variable namens `traceId` und fügen sie als Vorlagenabfrage hinzu.

**Um eine Abfrage zur Visualisierung von Traces hinzuzufügen**

1. Erstelle in deinem Workspace ein neues Dashboard oder gehe zu einem vorhandenen Dashboard, in dem du Traces-Visualisierungen hinzufügen möchtest.

1. Wähle „**Visualisierung hinzufügen**“ aus einem neuen Dashboard oder wähle „**Bereich hinzufügen“** in einem vorhandenen Dashboard.

1. Wählen Sie die entsprechende Tracing-Datenquelle aus.

1. **Wählen Sie oben rechts im Panel-Editor die Registerkarte **Visualisierungen** und dann Traces aus.**

1. Geben Sie unter den **Panel-Optionen** einen **Titel** für Ihr Trace-Panel ein. Weitere Informationen zum Panel-Editor finden Sie unter[Panel-Optionen konfigurieren](v10-panels-configure-panel-options.md).

1. Wählen Sie im Abfrage-Editor die Registerkarte **TraceQL-Abfragetyp** aus.

1.  Geben Sie `${traceId}` in das TraceQL-Abfragefeld ein, um eine Dashboard-Variable zu erstellen. Diese Variable wird als Vorlagenabfrage verwendet.

1. Wählen Sie im Panel-Editor „**Anwenden**“, um das Panel zum Dashboard hinzuzufügen.

1. Gehen Sie zu den **Dashboard-Einstellungen** und fügen Sie eine neue Variable mit dem Namen `traceId` **Benutzerdefiniert** hinzu und geben Sie ihr bei Bedarf eine Bezeichnung. Wählen Sie **Anwenden**, um die Variable zum Dashboard hinzuzufügen.

1. Stellen Sie sicher, dass das Panel funktioniert, indem Sie eine gültige Trace-ID für die für das Trace-Panel verwendete Datenquelle verwenden und die ID in der Dashboard-Variablen bearbeiten.

## Hinzufügen von TraceQL mit Tabellenvisualisierungen
<a name="v10-panels-traces-traceql"></a>

Sie können einem Dashboard zwar eine Trace-Visualisierung hinzufügen, aber das manuelle Hinzufügen von Trace IDs als Dashboard-Variable ist umständlich. Es ist sinnvoller, stattdessen TraceQL-Abfragen verwenden zu können, um nach bestimmten Arten von Traces zu suchen und dann die entsprechenden Traces aus den passenden Ergebnissen auszuwählen.

**Voraussetzungen**

Bei diesem Verfahren wird davon ausgegangen, dass Sie das vorherige Verfahren abgeschlossen haben.

**Um TraceQL mit Tabellenvisualisierungen hinzuzufügen**

1. Wählen Sie in demselben Dashboard, in dem Sie die Trace-Visualisierung hinzugefügt haben, **Panel hinzufügen**, um ein neues Visualisierungsfenster hinzuzufügen.

1. Wählen Sie dieselbe Trace-Datenquelle aus, die Sie im vorherigen Abschnitt verwendet haben.

1. **Wählen Sie oben rechts im Panel-Editor die Registerkarte **Visualisierungen und** dann Tabelle aus.**

1. **Wählen Sie im Abfrage-Editor die Registerkarte TraceQL.**

1. Geben Sie unter den **Panel-Optionen** einen **Titel** für Ihr Trace-Panel ein.

1. Fügen Sie eine entsprechende TraceQL-Abfrage hinzu, um nach Spuren zu suchen, die Sie im Dashboard visualisieren möchten. Hier ist zum Beispiel eine einfache, statische Abfrage von einem Server namens*my-server*.

   ```
   { .service.name = "my-server" && .http.status_code=500 }
   ```

   Sie können die TraceQL-Abfrage als Vorlagenabfrage schreiben, um andere Dashboard-Variablen zu nutzen, sofern sie existieren. Auf diese Weise können Sie dynamische Abfragen auf der Grundlage dieser Variablen erstellen.

Wenn Ergebnisse von einer Abfrage zurückgegeben werden, werden die Ergebnisse in der Tabelle des Panels gerendert.

**Die Ergebnisse in der Traces-Visualisierung enthalten Links zur Explore-Seite, auf der der Trace gerendert wird.** Sie können weitere Links zu Traces in der Tabelle hinzufügen, die die `traceId` Dashboard-Variable ausfüllen, wenn sie ausgewählt ist, sodass die Ablaufverfolgung im selben Dashboard visualisiert wird.

Gehen Sie wie folgt vor, um eine Reihe von Datenlinks im Panel zu erstellen.

**Um eine Variable zu verwenden, um weitere Links zu Traces hinzuzufügen**

1. Wählen Sie im Menü auf der rechten Seite unter **Datenverknüpfungen** die Option **Link hinzufügen** aus.

1. Fügen Sie einen **Titel** für den Datenlink hinzu.

1. Finden Sie den Pfad zum Dashboard, indem Sie in der Adressleiste Ihres Browsers nachschauen, wenn das vollständige Dashboard gerendert wird. Da es sich um einen Link zu einem Dashboard im selben Grafana-Stack handelt, ist nur der Pfad des Dashboards erforderlich.

   Zum Beispiel, wenn Ihr Pfad wie folgt lautet:

   ```
   https://g-example.grafana-workspace.us-east-1.amazonaws.com/d/1234abcd5/my-dashboard?orgId=1
   ```

   Dann lautet der Pfad zum Dashboard:

   ```
   /d/1234abcd5/my-dashboard?orgId=1
   ```

1. Stellen Sie im **URL-Feld** einen Selbstreferenz auf das Dashboard her, das beide Bereiche enthält. Diese Selbstreferenz verwendet den Wert der ausgewählten Spur in der Tabelle, um die Dashboard-Variable auszufüllen. Verwenden Sie den Pfad für das Dashboard aus dem vorherigen Schritt und geben Sie dann den Wert für die `traceId` Verwendung der ausgewählten Ergebnisse aus der TraceQL-Tabelle ein. Die Trace-ID wird mithilfe des `traceID` Datenfeldes in den zurückgegebenen Ergebnissen angezeigt. Verwenden Sie diesen Wert also als Wert für die Dashboard-Variable. Beispiel:

   ```
   /d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}
   ```

1. Wählen Sie **Speichern**, um die Datenverknüpfung zu speichern.

1. **Wählen Sie im Panel-Editor „Anwenden“, um das Panel auf das Dashboard anzuwenden.**

1. Speichern Sie das Dashboard.

In der Tabellenvisualisierung sollte nun eine Liste der passenden Traces angezeigt werden. Wenn Sie die Felder **TraceID** oder **SpanID** auswählen, haben Sie die Möglichkeit, entweder die **Explore-Seite** zu öffnen, um den Trace zu visualisieren, oder dem Datenlink zu folgen. Die Auswahl eines anderen Felds (wie `Start time``Name`, oder`Duration`) folgt automatisch dem Datenlink, füllt die `traceId` Dashboard-Variable aus und zeigt dann den entsprechenden Trace im Trace-Bereich an. 

# Trend
<a name="v10-panels-trend"></a>

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

Trendvisualisierungen sollten für Datensätze verwendet werden, die ein sequentielles, numerisches X haben, das nicht der Zeit entspricht. Einige Beispiele hierfür sind Funktionsdiagramme, rpm/torque Kurven, Beziehungen zwischen Angebot und Nachfrage sowie Höhen- oder Herzfrequenzdiagramme entlang einer Rennstrecke (wobei X für Entfernung oder Dauer vom Start steht).

Trendvisualisierungen unterstützen alle visuellen Stile und Optionen, die in der [Zeitreihenvisualisierung](v10-panels-time-series.md) verfügbar sind, mit den folgenden Ausnahmen:
+ Keine Anmerkungen oder Zeitregionen
+ Kein gemeinsam genutzter Cursor (oder Fadenkreuz)
+ Keine X-Achse mit mehreren Zeitzonen
+ Es ist nicht möglich, den Zeitbereich des Dashboards per Drag-Auswahl zu ändern

**X-Feldauswahl**

Verwenden Sie diese Option, um ein Feld auszuwählen, das steigende numerische Werte enthält.

 Sie könnten beispielsweise Motorleistung und Drehmoment im Verhältnis zur Drehzahl darstellen, wobei die Geschwindigkeit auf der X-Achse und Leistung und das Drehmoment auf der Y-Achse aufgetragen werden.

# XY-Diagramm
<a name="v10-panels-xychart"></a>

XY-Diagramme bieten eine Möglichkeit, beliebige X- und Y-Werte in einem Diagramm zu visualisieren, sodass Sie die Beziehung zwischen zwei Variablen auf einfache Weise darstellen können. XY-Diagramme werden in der Regel zur Erstellung von Streudiagrammen verwendet. Sie können sie auch zur Erstellung von Blasendiagrammen verwenden, bei denen Feldwerte die Größe der einzelnen Blasen bestimmen.

![\[Ein Bild, das ein Beispiel für eine XY-Diagrammvisualisierung in Grafana zeigt.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/viz/xy-chart-example.png)


## Unterstützte Datumsformate
<a name="v10-panels-xychart-formats"></a>

Sie können jede Art von Tabellendaten mit mindestens zwei numerischen Feldern in einem XY-Diagramm verwenden. Für diese Art der Visualisierung sind keine Zeitdaten erforderlich.

## Panel-Optionen
<a name="v10-panels-xychart-paneloptions"></a>

Im Bereich **Panel-Optionen** des Panel-Editors legen Sie grundlegende Optionen wie den Titel und die Beschreibung des Panels fest. In diesem Abschnitt können Sie auch sich wiederholende Panels konfigurieren. Weitere Informationen finden Sie unter [Panel-Optionen konfigurieren](v10-panels-configure-panel-options.md).

## XY-Diagrammoptionen
<a name="v10-panels-xychart-options"></a>

**Zuordnung von Serien**

Legen Sie fest, wie Seriendaten im Diagramm abgebildet werden.
+ **Automatisch** — Generiert automatisch Serien aus allen verfügbaren Datenrahmen (oder Datensätzen). Sie können filtern, um nur einen Frame auszuwählen.
+ **Manuell** — Definieren Sie die Serie explizit, indem Sie aus verfügbaren Datenrahmen auswählen.

Abhängig von Ihrer Auswahl für das Serien-Mapping unterscheiden sich die Optionen für **Frame**, **X-Feld** und **Y-Feld**. In den Abschnitten Automatische und manuelle Serienzuweisung werden diese verschiedenen Optionen beschrieben.

**Optionen für die automatische Serienzuweisung**

Wenn Sie **Automatisch** als Serienzuordnungsmodus auswählen, sind die folgenden Optionen vorkonfiguriert, Sie können sie aber auch selbst definieren.
+ **Rahmen** — Standardmäßig zeigt ein XY-Diagramm alle Datenrahmen an. Sie können filtern, um nur einen Frame auszuwählen.
+ **X-Feld** — Wählen Sie aus, für welches Feld X steht. Standardmäßig ist dies das erste Zahlenfeld in jedem Datenrahmen.
+ **Y-Feld** — Nachdem das X-Feld festgelegt wurde, werden standardmäßig alle verbleibenden Zahlenfelder im Datenrahmen als Y-Felder bezeichnet. Sie können diese Option verwenden, um explizit auszuwählen, welche Felder für Y verwendet werden sollen.

  Die Reihen des Diagramms werden aus den Y-Feldern generiert. Um Änderungen an einer Reihe in einem XY-Diagramm vorzunehmen, überschreiben Sie das Y-Feld. Jedes Feld, das Sie im Feld Größe oder Farbe verwenden, generiert keine Datenreihe.

  Sie können auch Überschreibungen verwenden, um Y-Felder einzeln auszuschließen. Fügen Sie dazu für jedes Y-Feld, das Sie entfernen möchten, eine Überschreibung mit den folgenden Eigenschaften hinzu:
  + Typ der Außerkraftsetzung: **Felder mit Namen**
  + Eigenschaft überschreiben: **Serie > Im Bereich ausblenden**
  + Bereich: **Viz**

**Optionen für die manuelle Serienzuweisung**

Wenn Sie **Manuell** als Serienmodus auswählen, können Sie Serien hinzufügen, bearbeiten und löschen. Um eine Serie zu verwalten, wählen Sie das Feld **Serie** aus. Um die Serie umzubenennen, wählen Sie den Seriennamen aus.

Im **manuellen** Modus müssen Sie die folgenden Optionen festlegen:
+ **Rahmen** — Wählen Sie Ihren Datenrahmen oder Datensatz aus. Sie können so viele Frames hinzufügen, wie Sie möchten.
+ **X-Feld** — Wählen Sie aus, für welches Feld X steht.
+ **Y-Feld** — Wählen Sie aus, für welches Feld Y steht.

**Größe des Felds**

Verwenden Sie diese Option, um festzulegen, welche Feldwerte die Größe des Punktes im Diagramm steuern. Dieser Wert ist relativ zu den Mindest- und Höchstwerten aller Werte im Datenrahmen.

Wenn Sie diese Option auswählen, können Sie dann die Optionen für die minimale und maximale Punktgröße festlegen.

**Farbfeld**

Verwenden Sie diese Option, um festzulegen, welche Feldwerte die Farbe der Punkte im Diagramm steuern. Um die Farbwertoptionen unter den **Standardoptionen** zu verwenden, müssen Sie dieses Feld festlegen.

In der Regel wird diese Option verwendet, wenn im Diagramm nur eine Datenreihe angezeigt wird.

**Show (Anzeigen)**

Legen Sie fest, wie Werte in der Visualisierung dargestellt werden.
+ **Punkte** — Werte werden als Punkte angezeigt. Wenn Sie diese Option auswählen, wird auch die Option Punktgröße angezeigt.
+ **Linien** — Fügt eine Linie zwischen Werten hinzu. Wenn Sie diese Option auswählen, werden auch die Optionen für Linienstil und Linienstärke angezeigt.
+ **Beide** — Zeigt sowohl Punkte als auch Linien an.

**Punktgröße**

Legt die Größe aller Punkte im Diagramm fest, mit einem Durchmesser von einem bis 100 Pixeln. Die Standardgröße beträgt fünf Pixel. Sie können eine Überschreibung festlegen, um die Pixelgröße seriell (Y-Feld) festzulegen.

**Minimale/maximale Punktgröße**

**Verwenden Sie diese Optionen, um die minimale oder maximale Punktgröße zu steuern, wenn Sie die Feldoption Größe festgelegt haben.** Sie können diese Optionen für bestimmte Datenreihen überschreiben.

**Line style (Linienstil)**

Legen Sie den Stil der Linie fest. Um die Farbe zu ändern, verwenden Sie die Standardfeldoption für das Farbschema.
+ **Durchgehend** — Zeigt eine durchgezogene Linie an. Dies ist die Standardeinstellung.
+ **Strich** — Zeigt eine gestrichelte Linie an. Wenn Sie diese Option wählen, wird eine Dropdownliste angezeigt, in der Sie die Länge und den Abstand für die Linienstriche auswählen können. Standardmäßig sind Länge und Abstand auf `10, 10` eingestellt.
+ **Punkte** — Zeigt gepunktete Linien an. Wenn Sie diese Option wählen, wird eine Dropdownliste angezeigt, in der Sie den Punktabstand auswählen können. Standardmäßig ist der Punktabstand auf festgelegt `0, 10` (die erste Zahl steht für die Punktlänge und ist immer Null).

**Linienbreite**

Legt die Breite der Linien in Pixeln fest.

## Tooltip-Optionen
<a name="v10-panels-xychart-tooltipoptions"></a>

QuickInfo-Optionen steuern die Informationsüberlagerung, die angezeigt wird, wenn Sie den Mauszeiger über Datenpunkte im Diagramm bewegen.

**Tooltip-Modus**
+ **Einzeln** — Der Hover-Tooltip zeigt nur eine einzige Serie an, nämlich die, über der Sie den Mauszeiger bewegen.
+ **Versteckt** — Zeigt den Tooltip nicht an, wenn Sie mit der Visualisierung interagieren.

Verwenden Sie eine Überschreibung, um einzelne Serien in der QuickInfo auszublenden.

**Max. Höhe**

Stellen Sie die maximale Höhe des Tooltip-Felds ein. Die Standardeinstellung ist 600 Pixel.

## Legendenoptionen
<a name="v10-panels-xychart-legendoptions"></a>

Legendenoptionen steuern die Seriennamen und Statistiken, die unter oder rechts neben dem Diagramm angezeigt werden. Weitere Informationen zur Legende finden Sie unter[Eine Legende konfigurieren](v10-panels-configure-legend.md).

**Sichtbarkeit**

Schalten Sie den Schalter um, um die Legende ein- oder auszuschalten.

**Mode (Modus)**

Verwenden Sie diese Einstellungen, um zu definieren, wie die Legende in Ihrer Visualisierung angezeigt wird.
+ **Liste** — Zeigt die Legende als Liste an. Dies ist der Standardanzeigemodus einer Legende.
+ **Tabelle** — Zeigt die Legende als Tabelle an.

**Platzierung**

Wählen Sie aus, wo die Legende angezeigt werden soll.
+ **Unten** — Unter dem Diagramm.
+ **Rechts** — Rechts neben dem Diagramm.

**Werte**

Wählen Sie aus, welche der [Standardberechnungen](v10-panels-calculation-types.md) in der Legende angezeigt werden sollen. Sie können mehr als eine haben.

**Width (Breite)**

Steuern Sie, wie breit die Legende sein soll, wenn sie auf der rechten Seite der Visualisierung platziert wird. Diese Option wird nur angezeigt, wenn Sie die Platzierung der Legende auf **Rechts** setzen.

## Achsenoptionen
<a name="v10-panels-xychart-axis"></a>

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

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 drücken`Enter`.

**Platzierung (Y-Achse)**

Wählen Sie die Platzierung der Y-Achse aus. Die Optionen sind:
+ **Auto** — 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 Achsen ausblenden.

Um Achsen selektiv auszublenden, [fügen Sie eine Feldüberschreibung](v10-panels-configure-overrides.md) hinzu, die auf bestimmte Felder abzielt.

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

**Rasterlinien anzeigen**

Stellen Sie die Sichtbarkeit der Achsenrasterlinien ein.
+ **Automatisch** — Zeigt automatisch Rasterlinien basierend auf der Dichte der Daten an.
+ **Aktiviert** — Zeigt immer Rasterlinien an.
+ **Aus** — Zeigt niemals Rasterlinien an.

**Farbe**

Legt die Farbe der Achse fest.
+ **Text** — Stellen Sie die Farbe auf der Grundlage der Thementextfarbe ein.
+ **Serie** — Stellen Sie die Farbe auf der Grundlage der Serienfarbe ein.

**Rand einblenden**

Stellen Sie die Sichtbarkeit des Achsenrandes ein.

**Skalieren**

Legen Sie fest, wie die Werte der Y-Achse skaliert werden.
+ **Linear** — Teilt die Skala in gleiche Teile auf.
+ **Logarithmisch — Verwenden Sie eine logarithmische** Skala. Wenn Sie diese Option auswählen, wird eine Liste angezeigt, in der Sie eine binäre (Basis 2) oder eine allgemeine (Basis 10) logarithmische Skala auswählen können.
+ **Symlog** — Verwenden Sie eine symmetrische logarithmische Skala. Wenn Sie diese Option auswählen, wird eine Liste angezeigt, in der Sie eine binäre (Basis 2) oder eine allgemeine (Basis 10) logarithmische Skala auswählen können. Mit der Option „Linearer Schwellenwert“ können Sie den Schwellenwert festlegen, bei dem die Skala von linear zu logarithmisch wechselt.

*Zentrierter Nullpunkt*

Legt fest, dass die Y-Achse auf Null zentriert ist.

**Soft Min und Soft Max**

Stellen Sie eine **Soft-Min** - oder **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.

Die Einstellungen „Soft Min“ und „Soft Max“ können verhindern, dass kleine Abweichungen in den Daten vergrößert werden, wenn sie größtenteils flach sind. Im Gegensatz dazu tragen harte Min- und Max-Werte dazu bei, dass nützliche Details in den Daten nicht verdeckt werden, indem intermittierende Spitzen über einen bestimmten Punkt hinaus abgeschnitten werden.

Um feste Grenzwerte für die Y-Achse zu definieren, legen Sie Standardoptionen fest. min/max Weitere Informationen finden Sie unter [Standardoptionen konfigurieren](v10-panels-configure-standard-options.md).

**Transform**

Verwenden Sie diese Option, um die Serienwerte zu transformieren, ohne dass sich dies auf die Werte auswirkt, die in der QuickInfo, den Kontextmenüs oder der Legende angezeigt werden. 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.

**Anmerkung**  
Die Transformationsoption ist nur als Override verfügbar.

**Zeigt mehrere Y-Achsen an**

In einigen Fällen möchten Sie mehrere Y-Achsen anzeigen. Wenn Sie beispielsweise über einen Datensatz verfügen, der sowohl Temperatur als auch Luftfeuchtigkeit im Zeitverlauf zeigt, könnten Sie für diese beiden Reihen zwei Y-Achsen mit unterschiedlichen Einheiten anzeigen.

Um mehrere Y-Achsen anzuzeigen, [fügen Sie eine Feldüberschreibung](v10-panels-configure-overrides.md#v10-panels-overrides-add-a-field) hinzu. Folgen Sie den Schritten so oft wie nötig, um so viele Y-Achsen hinzuzufügen, wie Sie benötigen.

## Standardoptionen
<a name="v10-panels-xychart-standard"></a>

Mit den **Standardoptionen** im Panel-Editor können Sie ändern, wie Felddaten in Ihrer Visualisierung angezeigt werden. Wenn Sie eine Standardoption festlegen, wird die Änderung auf alle Felder oder Reihen angewendet. Eine detailliertere Steuerung der Anzeige von Feldern finden Sie unter. [Feldüberschreibungen konfigurieren](v10-panels-configure-overrides.md)

Sie können die folgenden Standardoptionen anpassen:
+ **Feld min/max** — Aktivieren Sie **Feld min/max**, damit Grafana das Minimum oder Max jedes Felds einzeln berechnet, basierend auf dem Minimal- oder Maximalwert des Feldes.
+ **Farbschema** — Legen Sie einzelne oder mehrere Farben für Ihre gesamte Visualisierung fest.

Weitere Informationen finden Sie unter [Standardoptionen konfigurieren](v10-panels-configure-standard-options.md).

## Datenverknüpfungen
<a name="v10-panels-xychart-datalinks"></a>

Datenlinks ermöglichen es Ihnen, Links zu anderen Bereichen, Dashboards und externen Ressourcen herzustellen und gleichzeitig den Kontext des Quellfensters beizubehalten. Sie können Links erstellen, die den Seriennamen oder sogar den Wert unter dem Cursor enthalten.

Stellen Sie für jede Datenverknüpfung die folgenden Optionen ein:
+ **Titel**
+ **URL**
+ **In einem neuen Tab öffnen**

Weitere Informationen finden Sie unter [Datenverknüpfungen konfigurieren](v10-panels-configure-data-links.md).

## Feldüberschreibungen
<a name="v10-panels-xychart-fieldoverrides"></a>

Mit Überschreibungen können Sie die Visualisierungseinstellungen für bestimmte Felder oder Reihen anpassen. Wenn Sie eine Überschreibungsregel hinzufügen, können Sie auf eine bestimmte Gruppe von Feldern abzielen und mehrere Optionen für die Anzeige dieser Felder definieren.

Wählen Sie eine der folgenden Überschreibungsoptionen:
+ **Felder mit Namen** — Wählen Sie ein Feld aus der Liste aller verfügbaren Felder aus.
+ **Felder, deren Name mit dem regulären Ausdruck übereinstimmt** — Geben Sie Felder an, die mit einem regulären Ausdruck überschrieben werden sollen.
+ **Felder mit Typ** — Wählen Sie Felder nach Typ aus, z. B. Zeichenfolge, Zahl oder Uhrzeit.
+ **Von der Abfrage zurückgegebene Felder** — Wählen Sie alle Felder aus, die von einer bestimmten Abfrage zurückgegeben wurden.
+ **Felder mit Werten** — Wählen Sie alle Felder aus, die von Ihrer definierten Reduzierungsbedingung zurückgegeben wurden, z. B. **Min.**, **Max.**, **Anzahl** oder **Summe**.

Weitere Informationen finden Sie unter [Feldüberschreibungen konfigurieren](v10-panels-configure-overrides.md).

# Erkunden Sie in Grafana-Version 10
<a name="v10-explore"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

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.

Auf dieser Seite können Sie mit der Erkundung Ihrer Daten beginnen. In den folgenden Themen finden Sie weitere Informationen zu bestimmten Funktionen und Verwendungsmöglichkeiten von Explore.
+ [Abfrageverwaltung in Explore](v10-explore-manage.md)
+ [Loggt sich in Explore ein](v10-explore-logs.md)
+ [Nachverfolgung in Explore](v10-explore-tracing.md)
+ [Korrelationseditor in Explore](v10-explore-correlations.md)
+ [Inspector in Explore](v10-explore-inspector.md)

## Fangen Sie an,
<a name="v10-explore-start"></a>

**Anmerkung**  
Um auf Explore zugreifen zu können, müssen Sie über eine Redakteur- oder Administratorrolle verfügen.

**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.

   Sie können auch „**Erweiterte Datenquellenauswahl öffnen**“ wählen, um weitere Optionen zu sehen, darunter das Hinzufügen einer Datenquelle (nur für Administratoren).

1. Schreiben Sie die Abfrage mit dem Abfrage-Editor, der von der ausgewählten Datenquelle bereitgestellt wird.

   Weitere Informationen zu Abfragen finden Sie unter[Daten abfragen und transformieren](v10-panels-query-xform.md).

1. Führen Sie die Abfrage mithilfe der Schaltfläche in der oberen rechten Ecke aus.

## Teilen und vergleichen
<a name="v10-explore-compare"></a>

Die geteilte Ansicht bietet eine einfache Möglichkeit, Visualisierungen zu vergleichen side-by-side oder verwandte Daten gemeinsam auf einer Seite zu betrachten.

**Öffnen Sie die geteilte Ansicht von oben**

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**“.

## Gliederung des Inhalts
<a name="v10-explore-outline"></a>

Die Inhaltsübersicht ist eine seitliche Navigationsleiste, in der Sie die Abfragen und Visualisierungen verfolgen können, die Sie in Explore erstellt haben. Sie ermöglicht es Ihnen, schnell zwischen ihnen zu navigieren.

Die Inhaltsgliederung funktioniert auch in einer geteilten Ansicht. Wenn Sie sich in der geteilten Ansicht befinden, wird die Inhaltsgliederung für jeden Bereich generiert.

**Um die Inhaltsgliederung zu öffnen**

1. Wählen Sie die Schaltfläche „**Gliederung**“ in der oberen linken Ecke des **Explorer-Bildschirms aus**.

1. Wählen Sie ein beliebiges Bedienfeldsymbol in der Inhaltsübersicht aus, um zu diesem Bereich zu gelangen.

## Teilen Erkunden URLs
<a name="v10-explore-shareurl"></a>

Wenn Sie Explore verwenden, wird die URL in der Adressleiste des Browsers aktualisiert, wenn Sie Änderungen an den Abfragen vornehmen. Sie können diese URL teilen oder mit einem Lesezeichen versehen.

**Anmerkung**  
Explore generiert möglicherweise relativ viel Zeit URLs. Sie können auch einen [verkürzten Link](#v10-explore-share) generieren und teilen, wenn die URL für Ihre Tools zu lang ist.

**Explore URLs aus externen Tools generieren**

Da Explore URLs eine definierte Struktur hat, können Sie eine URL aus externen Tools erstellen und in Grafana öffnen. Die URL-Struktur ist:

```
http://<workspace_url>/explore?panes=<panes>&schemaVersion=<schema_version>&orgId=<org_id>
```

Wobei:
+ `org_id`ist die Organisations-ID
+ `schema_version`ist die Schemaversion (sollte auf die neueste Version gesetzt werden, nämlich`1`.
+ `panes`ist ein URL-codiertes JSON-Objekt von Bereichen, wobei jeder Schlüssel die Bereichs-ID und jeder Wert ein Objekt ist, das dem folgenden Schema entspricht:

  ```
  {
    datasource: string; // the pane's root datasource UID, or `-- Mixed --` for mixed datasources
    queries: {
      refId: string; // an alphanumeric identifier for this query, must be unique within the pane, i.e. "A", "B", "C", etc.
      datasource: {
        uid: string; // the query's datasource UID ie: "AD7864H6422"
        type: string; // the query's datasource type-id, i.e: "loki"
      }
      // ... any other datasource-specific query parameters
    }[]; // array of queries for this pane
    range: {
      from: string; // the start time, in milliseconds since epoch
      to: string; // the end time, in milliseconds since epoch
    }
  }
  ```
**Anmerkung**  
Die `to` Felder `from` und akzeptieren auch relative Bereiche, wie im Thema beschrieben. [Zeitbereich für das Dashboard einstellen](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range)

## Verkürzten Link teilen
<a name="v10-explore-share"></a>

Mit der Funktion „Verkürzten Link teilen“ können Sie kleinere und einfachere URLs Dateien im Format /goto/:uid erstellen, anstatt für Abfrageparameter ein längeres Format 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. Wenn ein Link mindestens einmal verwendet wird, wird er nicht gelöscht.

**Teilen von verkürzten Links mit absoluter Zeit**

Für kurze Links gibt es zwei Optionen: Die relative Zeit (z. B. von vor zwei Stunden bis zur aktuellen Uhrzeit) oder die absolute Zeit (z. B. von 8 Uhr bis 10 Uhr). Wenn Sie einen verkürzten Link teilen, wird standardmäßig der ausgewählte Zeitraum kopiert, entweder relativ oder absolut. Wenn Sie die Dropdownschaltfläche neben der Schaltfläche „Verkürzten Link teilen“ auswählen und eine der Optionen unter **URL-Links zur Zeitsynchronisierung** auswählen, können Sie einen kurzen Link mit absoluter Uhrzeit erstellen, d. h. jeder, der den Link erhält, sieht dieselben Daten wie Sie, auch wenn er den Link zu einem anderen Zeitpunkt öffnet. Diese Option hat keinen Einfluss auf den Zeitraum, den Sie in Ihrer Explore-Ansicht ausgewählt haben.

# Abfrageverwaltung in Explore
<a name="v10-explore-manage"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Sie können die Abfragen verwalten, die Sie in Explore erstellt haben, einschließlich einer Historie der Abfragen, die Sie ausgeführt haben, und der Abfragen, die Sie mit einem Stern markiert haben.

## Verlauf der Abfragen
<a name="v10-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
<a name="v10-explore-manage-history-view"></a>

Mit dem Abfrageverlauf können Sie den Verlauf Ihrer Abfragen einsehen. Für jede einzelne Abfrage können Sie:
+ Führen Sie die Abfrage aus.
+ 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
<a name="v10-explore-manage-history-favorites"></a>

Alle Abfragen, die auf der Registerkarte Abfrageverlauf mit einem Stern markiert wurden, werden auf der Registerkarte Mit Stern 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
<a name="v10-explore-manage-history-sort"></a>

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 sortieren** aus.

1. Wählen Sie eine der folgenden Optionen aus:
   + **Neuste zuerst**
   + **Älteste zuerst**

## Der Abfrageverlauf wird gefiltert
<a name="v10-explore-manage-history-filter"></a>

Sie können Ihren Abfrageverlauf im Abfrageverlauf und auf der Registerkarte Als Favorit markiert nach einer bestimmten Datenquelle filtern.

**Um den Verlauf nach einer Datenquelle zu 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.

**Anmerkung**  
Abfragen, die mit der gemischten Datenquelle ausgeführt wurden, werden nur angezeigt, wenn nach Gemischt gefiltert wird, und nicht, wenn nach ihren individuellen Datenquellen gefiltert wird.

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 unteren Ziehpunkt ziehen.
+ Passen Sie das Enddatum an, indem Sie den oberen Ziehpunkt ziehen.

## Im Abfrageverlauf suchen
<a name="v10-explore-manage-history-search"></a>

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
<a name="v10-explore-manage-history-settings"></a>

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.

# Loggt sich in Explore ein
<a name="v10-explore-logs"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Mit Explore können Sie Ihre Logs in verschiedenen Datenquellen untersuchen, darunter:
+ [OpenSearch](using-opensearch-in-AMG.md)
+ [Amazon CloudWatch](using-amazon-cloudwatch-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, Protokolle mit anderen Telemetriesignalen wie Metriken, Traces oder Profilen zu korrelieren, indem Sie sie anzeigen. side-by-side

Die Ergebnisse von Protokollabfragen werden als einzelne Protokollzeilen und als Diagramm angezeigt, das das Protokollvolumen für den ausgewählten Zeitraum zeigt.

## Volumen der Protokolle
<a name="v10-explore-logs-volume"></a>

Wenn Sie mit Datenquellen arbeiten, die ein großes Protokollvolumen unterstützen, zeigt Explore automatisch ein Diagramm an, das die Protokollverteilung für alle eingegebenen Protokollabfragen zeigt. Diese Funktion wird derzeit von OpenSearch und Loki-Datenquellen unterstützt.

**Anmerkung**  
In Loki wird dieses gesamte Protokollvolumen durch eine metrische Abfrage wiedergegeben, was je nach abgefragtem Zeitraum teuer sein kann. Die Verarbeitung dieser Abfrage kann bei kleineren Loki-Installationen besonders schwierig sein. Um dies zu vermeiden, können Sie einen Proxy wie [Nginx](https://www.nginx.com/) vor Loki 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 des gesamten Protokollvolumens nicht unterstützt, berechnet das Protokollmodell eine Zeitreihe, indem es die Protokollzeilen zählt und sie auf der Grundlage eines automatisch berechneten Zeitintervalls in Buckets organisiert. Der Zeitstempel der ersten Protokollzeile wird verwendet, um den Beginn des Protokollvolumens in den Ergebnissen zu verankern. **Das Ende der Zeitreihe ist im Zielbereich der Zeitauswahl verankert.** Auf diese Weise können Sie Protokolldaten auch dann effizient analysieren und visualisieren, wenn die Datenquelle keine umfassende Unterstützung bietet.

## Protokolle
<a name="v10-explore-logs-overview"></a>

In den folgenden Abschnitten finden Sie detaillierte Erläuterungen zur Visualisierung und Interaktion mit einzelnen Protokollen in Explore.

## Log-Navigation
<a name="v10-explore-logs-navigation"></a>

Über die Log-Navigation auf der rechten Seite der Logzeilen können Sie ganz einfach zusätzliche Logs anfordern. Sie können dies tun, indem Sie unten in der Navigation auf die Schaltfläche **Ältere Protokolle** klicken. Dies ist besonders nützlich, wenn Sie das Zeilenlimit erreicht haben und mehr Logs sehen möchten. Jede Anfrage, die von der Navigation aus ausgeführt wird, wird dann in der Navigation als separate Seite angezeigt. Auf jeder Seite werden die eingehenden Protokollzeilen mit `to` Zeitstempel angezeigt`from`. Sie können frühere Ergebnisse sehen, indem Sie auf jede Seite klicken. Explore speichert die letzten fünf Anfragen, die über die Log-Navigation ausgeführt werden, sodass Sie beim Klicken auf die Seiten nicht dieselben Abfragen erneut ausführen müssen, was Zeit und Ressourcen spart.

## Optionen für die Visualisierung
<a name="v10-explore-log-visualization-options"></a>

 Sie können anpassen, wie Protokolle angezeigt werden, und auswählen, welche Spalten angezeigt werden. 


| Option | Description | 
| --- | --- | 
| 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 | Stellen Sie diese Option ein, true wenn das Display Zeilenumbruch verwenden soll. Wenn auf gesetztfalse, 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. Exakte Übereinstimmungen werden in der gesamten Zeile vorgenommen, mit Ausnahme von Datumsfeldern. Zahlenabgleiche werden in der Zeile vorgenommen, nachdem Zahlen wie Dauer, IP-Adressen usw. entfernt wurden. Die Signatur ist die aggressivste Deduplizierung, da sie alle Buchstaben und Zahlen sowie Übereinstimmungen in den verbleibenden Leerzeichen und Satzzeichen entfernt. | 
| Reihenfolge der Ergebnisse anzeigen | Sie können die Reihenfolge der empfangenen Protokolle von der standardmäßigen absteigenden Reihenfolge (neueste zuerst) in aufsteigender Reihenfolge (älteste zuerst) ändern. | 

## Laden Sie die Protokollzeilen herunter
<a name="v10-explore-download-log-lines"></a>

Verwenden Sie die Schaltfläche Herunterladen, um `txt` die Protokollergebnisse im `json` Oder-Format **herunterzuladen**. Mit dieser Funktion können Sie die Protokolldaten zur weiteren Analyse speichern oder sie in einem praktischen und zugänglichen Format mit anderen teilen.

## Metainformationen zu den Ergebnissen protokollieren
<a name="v10-explore-log-result-meta-information"></a>

Oberhalb der empfangenen Protokollzeilen finden Sie wichtige Metainformationen, darunter:
+ **Anzahl der empfangenen Protokolle** — Gibt die Gesamtzahl der für die aktuelle Abfrage oder den aktuellen Zeitraum empfangenen Protokolle an.
+ **Fehler** — Zeigt mögliche Fehler in Ihren Protokollergebnissen an.
+ **Allgemeine Bezeichnungen** — Zeigt allgemeine Beschriftungen an.
+ **Verarbeitete Byte insgesamt** — Stellt die Gesamtgröße der verarbeiteten Protokolldaten in Byte dar.

**Anmerkung**  
Die Verfügbarkeit bestimmter Metainformationen kann von der Datenquelle abhängen. Daher werden Ihnen möglicherweise nur einige dieser Details für bestimmte Datenquellen angezeigt.

## Auf der Flucht vor neuen Zeilen
<a name="v10-explore-log-escaping-newlines"></a>

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**“.

**Um fehlerhaft maskierte Sequenzen, die Explore erkannt hat, 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 erhaltenen Eingaben möglicherweise nicht korrekt ist. **Sie können die Ersetzungen rückgängig machen, indem Sie Escaping entfernen auswählen.**

## Protokollebene
<a name="v10-explore-log-level"></a>

Für die Protokolle, für die eine `level` Bezeichnung angegeben ist, verwenden wir den Wert dieser Bezeichnung, um die Protokollebene zu bestimmen und die Farbe jeder Protokollzeile entsprechend zu aktualisieren. Wenn das Protokoll keine angegebene Ebenenbezeichnung hat, versuchen wir herauszufinden, ob sein Inhalt mit einem der unterstützten Ausdrücke übereinstimmt (weitere Informationen finden Sie in der folgenden Tabelle). Die Protokollebene wird immer durch die erste Übereinstimmung bestimmt. Falls Grafana kein Log-Level-Feld ableiten kann, wird es mit einem unbekannten Log-Level visualisiert.

**Anmerkung**  
Wenn Sie eine Loki-Datenquelle verwenden und diese Teil Ihrer Protokollzeile `level` ist, können Sie Parser (JSON, logfmt, regex,..) verwenden, um die Ebeneninformationen in ein Level-Label zu extrahieren, das zur Bestimmung des Level-Werts verwendet wird. Auf diese Weise kann das Histogramm die verschiedenen Protokollstufen als separate Balken anzeigen.

**Unterstützte Protokollebenen und Zuordnung von Abkürzungen und Ausdrücken der Protokollebenen:** 


| Protokollebene | Farbe | Unterstützte Ausdrücke | 
| --- | --- | --- | 
| kritisch | lila | auffallend, tödlich, alarmiert, kritisch, kritisch | 
| error | red | Irrtum, Irrtum, Irrtum | 
| warning | Gelb | warnen, warnen | 
| info | Grün | Information, Information, Information, Hinweis | 
| debug | Blau | debuggen, debuggen | 
| trace | hellblau | trace | 
| unbekannt | grau | \$1 | 

## Markieren Sie die gesuchten Wörter
<a name="v10-explore-highlight-searched-words"></a>

Wenn Ihre Anfrage bestimmte Wörter oder Ausdrücke enthält, nach denen gesucht werden soll, hebt Explore diese zur besseren Sichtbarkeit in den Protokollzeilen hervor. Diese Hervorhebungsfunktion erleichtert es, die relevanten Inhalte in Ihren Logs zu identifizieren und sich darauf zu konzentrieren.

**Anmerkung**  
Die Fähigkeit, Suchbegriffe hervorzuheben, kann je nach Datenquelle variieren. Bei einigen Datenquellen ist die Markierung von Suchwörtern möglicherweise nicht verfügbar.

## Ansicht der Protokolldetails
<a name="v10-explore-log-details-view"></a>

In Explore hat jede Protokollzeile einen erweiterbaren Abschnitt mit der Bezeichnung *Protokolldetails*, der durch Auswahl der Protokollzeile geöffnet werden kann. Die Ansicht mit den Protokolldetails bietet zusätzliche Informationen und Erkundungsoptionen in Form von *Feldern* und *Links*, die an die Protokollzeilen angehängt sind, was eine robustere Interaktion und Analyse ermöglicht.

**Felder**

In der Ansicht „Protokolldetails“ können Sie angezeigte Felder auf zwei Arten filtern: als Positivfilter (um sich auf ein bestimmtes Feld zu konzentrieren) und als Negativfilter (um bestimmte Felder auszuschließen). Diese Filter aktualisieren die entsprechende Abfrage, die die Protokollzeile erzeugt hat, und fügen Gleichheits- und Ungleichheitsausdrücke entsprechend hinzu. Wenn die Datenquelle unterstützt wird, wie dies bei Loki und der Fall ist OpenSearch, überprüfen die Protokolldetails, ob das Feld bereits in der aktuellen Abfrage vorhanden ist und einen aktiven Status anzeigt (nur für positive Filter), sodass Sie es in der Abfrage ausschalten oder den Filterausdruck von positiv auf negativ ändern können.

Sie können anstelle der gesamten Protokollzeile eine Teilmenge von Feldern auswählen, die in der Protokollliste angezeigt werden sollen, indem Sie auf das Augensymbol klicken. Jedes Feld hat ein Statistiksymbol, mit dem Statistiken zu allen angezeigten Protokollen angezeigt werden.

**Links**

Grafana bietet die Funktionalität von Datenlinks oder Korrelationen, sodass Sie jeden Teil einer Protokollnachricht in einen internen oder externen Link konvertieren können. Diese Links können verwendet werden, um zu verwandten Daten oder externen Ressourcen zu navigieren, was eine nahtlose und bequeme Möglichkeit bietet, weitere Informationen zu erkunden.

## Kontext protokollieren
<a name="v10-explore-log-context"></a>

Unter Protokollkontext werden zusätzliche Kontextzeilen angezeigt, die einen Protokolleintrag umgeben, der einer bestimmten Suchabfrage entspricht. Dies kann hilfreich sein, um den Kontext des Protokolleintrags zu verstehen, und ähnelt dem `-C` Parameter im `grep` Befehl.

Möglicherweise stoßen Sie auf lange Textzeilen, die es schwierig machen, den Kontext der einzelnen Protokolleinträge zu lesen und zu analysieren. An dieser Stelle kann sich die **Option „Zeilen** umbrechen“ als nützlich erweisen. Wenn Sie diesen Schalter aktivieren, wird Grafana lange Textzeilen automatisch so umbrechen, dass sie in die sichtbare Breite des Viewers passen. Dies kann das Lesen und Verstehen der Protokolleinträge erleichtern. 

 Mit der Schaltfläche **In geteilter Ansicht öffnen** können Sie die Kontextabfrage für einen Protokolleintrag auf einem geteilten Bildschirm in der Explore-Ansicht ausführen. Wenn Sie auf diese Schaltfläche klicken, wird ein neuer Explore-Bereich geöffnet, in dem die Kontextabfrage neben dem Protokolleintrag angezeigt wird, sodass der umgebende Kontext leichter analysiert und verstanden werden kann.

Die Protokollkontextabfrage kann auch in einem neuen Browser-Tab geöffnet werden, indem Sie die Taste `Ctrl` (oder`Cmd`) drücken und gleichzeitig die Schaltfläche zum Öffnen des Kontextmodals auswählen. Beim Öffnen in einer neuen Registerkarte werden die zuvor ausgewählten Filter ebenfalls angewendet.

## Protokollzeile kopieren
<a name="v10-explore-copy-log-line"></a>

Sie können den Inhalt einer ausgewählten Protokollzeile ganz einfach in Ihre Zwischenablage kopieren, indem Sie auf die Schaltfläche **Protokollzeile kopieren** klicken.

## Link in die Protokollzeile kopieren
<a name="v10-explore-copy-link-to-log-line"></a>

Durch die Verknüpfung von Protokollzeilen in Grafana können Sie schnell zu bestimmten Protokolleinträgen navigieren, um eine genaue Analyse durchzuführen. Wenn Sie die Schaltfläche **Shortlink kopieren** für eine Protokollzeile wählen, können Sie eine Kurz-URL generieren und kopieren, die innerhalb eines absoluten Zeitbereichs direkten Zugriff auf den genauen Protokolleintrag bietet. Wenn Sie den Link öffnen, scrollt Grafana automatisch zur entsprechenden Protokollzeile und markiert sie mit einem blauen Hintergrund, sodass Sie die relevanten Informationen leicht identifizieren und sich darauf konzentrieren können.

**Anmerkung**  
Dies wird nur in Loki und anderen Datenquellen unterstützt, die ein `id` Feld bereitstellen.

## Live-Tracking
<a name="v10-explore-log-live-tailing"></a>

Um Echtzeitprotokolle aus unterstützten Datenquellen anzuzeigen, können Sie die Live-Tailing-Funktion in Explore nutzen.

**Um Logs in Echtzeit mit Live-Tailing anzusehen**

1. Wählen Sie in der Werkzeugleiste „Erkunden“ die Schaltfläche „**Live**“, um zur Live-Tail-Ansicht zu wechseln.

1. In der Live-Schwanzansicht werden neue Logs am unteren Bildschirmrand angezeigt. Sie haben einen verblassenden, kontrastierenden Hintergrund, sodass Sie leicht verfolgen können, was neu ist.

1. Wenn du das Live-Tailing pausieren und frühere Logs ohne Unterbrechungen erkunden möchtest, kannst du das tun, indem du die **Pause-Taste** wählst oder einfach durch die Log-Ansicht scrollst.

1. Um die Ansicht zu löschen und alle Logs von der Anzeige zu entfernen, wählen Sie die Schaltfläche Logs **löschen**. Durch diese Aktion wird die Protokollansicht zurückgesetzt und Sie haben einen Neuanfang, um mit der Protokollanalyse fortzufahren.

1. Um mit dem Live-Tailing fortzufahren und weiterhin Echtzeit-Logs anzusehen, wählen Sie die Schaltfläche „**Fortfahren**“.

1. Wenn Sie das Live-Tailing beenden und zur Standardansicht von Explore zurückkehren möchten, wählen Sie die Schaltfläche „**Stopp**“.

Mithilfe der Live-Tailing-Funktion können Sie die neuesten Logs genau verfolgen, sobald sie eintreffen. Dadurch können Sie Ereignisse in Echtzeit leichter überwachen und Probleme umgehend erkennen.

**Beispiel für Protokolle**

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.

**Wechseln Sie von Metriken zu Protokollen**

 Wenn Sie von einer Metrikdatenquelle, die implementiert `DataSourceWithQueryExportSupport` (wie Prometheus), zu einer Protokollierungsdatenquelle kommen, die dies unterstützt `DataSourceWithQueryImportSupport` (wie Loki), dann behält sie die Labels Ihrer Abfrage, die in den Protokollen vorhanden sind, bei und verwendet sie, um die Log-Streams abzufragen.

Beispielsweise ändert sich die folgende Prometheus-Abfrage `grafana_alerting_active_alerts{job='grafana'}` nach dem Wechsel zur Loki-Datenquelle zu. `{job='grafana'}` Dadurch wird ein Teil der Protokolle im ausgewählten Zeitraum zurückgegeben, der durchsucht werden kann. grepped/text 

# Nachverfolgung in Explore
<a name="v10-explore-tracing"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Sie können Explore verwenden, um Spuren aus Tracing-Datenquellen zu visualisieren.

Die folgenden Datenquellen werden unterstützt.
+ [Tempo](tempo-data-source.md) (unterstützte Aufnahmeformate: OpenTelemetry, Jaeger und Zipkin)
+ [Jaeger](jaeger-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.

## Abfrage-Editor
<a name="v10-explore-trace-queryeditor"></a>

Sie können Ablaufverfolgungsdaten mit dem Abfrage-Editor einer Datenquelle abfragen und suchen.

Jede Datenquelle kann über einen eigenen Abfrage-Editor verfügen. Der Abfrage-Editor für die Tempo-Datenquelle unterscheidet sich geringfügig vom Abfrage-Editor für die Jaeger-Datenquelle.

Informationen zum Abfragen der einzelnen Datenquellen finden Sie in der jeweiligen Dokumentation.
+ [Tempo](tempo-data-source.md)
+ [Jaeger](jaeger-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

## Erklärung von Trace View
<a name="v10-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 über den 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.

**Filter ausdehnen**

Mithilfe von Spanfiltern können Sie Ihre Spans im Trace-Timeline-Viewer filtern. Je mehr Filter Sie hinzufügen, desto spezifischer sind die gefilterten Bereiche.

Sie können einen oder mehrere der folgenden Filter hinzufügen:
+ Name des Ressourcendienstes
+ Spanischer Name
+ Dauer
+ Tags (dazu gehören Tags, Prozess-Tags und Protokollfelder)

Um nur die Bereiche anzuzeigen, die Sie gefunden haben, aktivieren Sie die Option **Nur Treffer anzeigen**.

**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 die Span-Zeile auswählen, werden die 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.

**Zu den 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.

Wählen Sie das Dokumentsymbol, um in Explore eine geteilte Ansicht mit der konfigurierten Datenquelle zu öffnen und die entsprechenden Protokolle für den Zeitraum abzufragen.

**Zu Metriken zurückverfolgen**

**Anmerkung**  
Diese Funktion befindet sich derzeit in der Beta-Phase

Sie können von einer Spanne in einer Trace-Ansicht direkt zu den für diese Spanne relevanten Metriken navigieren. Diese Funktion ist für Tempo-, Jaeger- und Zipkin-Datenquellen verfügbar. Einzelheiten zur Konfiguration finden Sie in der entsprechenden Dokumentation.

**Zu Profilen zurückverfolgen**

Mithilfe von Trace to Profiles können Sie die Fähigkeit von Grafana nutzen, verschiedene Signale zu korrelieren, indem Sie die Funktionalität zur Verknüpfung zwischen Traces und Profilen hinzufügen.

## Knotendiagramm
<a name="v10-explore-trace-node-graph"></a>

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.

## Ansicht „Service Graph“
<a name="v10-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 die [Seite mit der Ansicht des Service-Diagramms](https://grafana.com/docs/tempo/latest/metrics-generator/service-graph-view/) auch in der *Tempo-Dokumentation von Grafana Labs* sehen.

## Daten-API
<a name="v10-explore-trace-dataapi"></a>

Für diese Visualisierung ist eine bestimmte Form der Daten erforderlich, die von der Datenquelle zurückgegeben werden müssen, damit sie korrekt angezeigt werden können.

Die Datenquelle muss den Datenrahmen und das Datenset zurückgeben`frame.meta.preferredVisualisationType = 'trace'`.

**Struktur des Datenrahmens**

Erforderliche Felder;


| Feldname | Typ | Description | 
| --- | --- | --- | 
| TraceID | Zeichenfolge | Bezeichner für den gesamten Trace. Der Datenrahmen sollte nur eine Spur enthalten. | 
| spanische ID | Zeichenfolge | Bezeichner für die aktuelle Spanne. Die Spanne IDs sollte pro Trace eindeutig sein. | 
| SpanID der Eltern | Zeichenfolge | spanID des übergeordneten Bereichs, um die Beziehung zwischen untergeordnetem Elternteil in der Trace-Ansicht zu erstellen. Kann undefined für den Stammbereich ohne übergeordnetes Element verwendet werden. | 
| serviceName | Zeichenfolge | Name des Dienstes, zu dem dieser Span gehört. | 
| ServiceTags | TraceKeyValuePair[] | Liste der für den Dienst relevanten Tags. | 
| startTime | number | Startzeit der Spanne in Millisekunden Epochenzeit. | 
| duration | number | Dauer der Spanne in Millisekunden. | 

 Optionale Felder: 


| Feldname | Typ | Description | 
| --- | --- | --- | 
| Protokolle | TraceLog[] | Liste der Protokolle, die dem aktuellen Zeitraum zugeordnet sind. | 
| tags | TraceKeyValuePair[] | Liste der Tags, die dem aktuellen Zeitraum zugeordnet sind. | 
| warnings | Zeichenfolge [] | Liste der Warnungen, die mit der aktuellen Spanne verknüpft sind. | 
| StackTraces | Zeichenfolge [] | Liste der Stack-Traces, die dem aktuellen Span zugeordnet sind. | 
| errorIconColor | Zeichenfolge | Farbe des Fehlersymbols, falls Span mit markiert isterror: true. | 

Einzelheiten zu den Typen finden Sie [TraceSpanRow](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L28)unter [TraceKeyValuePair](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L4)und [TraceLog](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L12)weiter GitHub.

# Korrelationseditor in Explore
<a name="v10-explore-correlations"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Korrelationen ermöglichen es Benutzern, eine Verbindung zwischen zwei beliebigen Datenquellen herzustellen. Weitere Informationen, einschließlich eines Überblicks über Korrelationen, finden Sie unter. [Korrelationen in Grafana-Version 10](v10-correlations.md)

## Eine Korrelation erstellen
<a name="v10-explore-corr-create-a-correlation"></a>

Sie können Korrelationen auf der Explore-Seite erstellen.

**Um eine Korrelation zu erstellen**

1. Navigieren Sie in Ihrem Amazon Managed Grafana-Arbeitsbereich zur Explore-Seite.

1. Wählen Sie eine Datenquelle aus, die Sie als Quelle für eine neue Korrelation verwenden möchten.

1. Führen Sie eine Abfrage aus, die Daten in einer unterstützten Visualisierung generiert.
**Anmerkung**  
[Unterstützte Visualisierungen sind [Logs](v10-panels-logs.md) und Table.](v10-panels-table.md)

1. [Wählen Sie in der oberen Werkzeugleiste **\$1 Hinzufügen** und dann **Korrelation hinzufügen** (Sie können auch den **Korrelationseditor** aus der Befehlspalette auswählen).](v10-search.md#v10-search-palette)

   Explore befindet sich jetzt im Korrelationseditor-Modus, was durch einen blauen Rand und eine obere Leiste gekennzeichnet ist. Sie können den Correlations Editor beenden, indem Sie in der oberen Leiste **Beenden** wählen.

1. Sie können jetzt die folgenden neuen Korrelationen für die Visualisierung mit Links erstellen, die an die Daten angehängt sind und die Sie verwenden können, um eine neue Abfrage zu erstellen:
   + *Protokolle* — Links werden neben den Feldwerten in den Protokolldetails für jede Protokollzeile angezeigt.
   + *Tabelle* — jede Tabellenzelle ist ein Link.

1. Wählen Sie einen Link, um eine neue Korrelation hinzuzufügen. Links sind mit einem Feld verknüpft, das als Ergebnisfeld einer Korrelation verwendet wird. Weitere Details finden Sie unter [Konfiguration der Korrelation](v10-correlations-config.md).

1. Verwenden Sie in der sich öffnenden geteilten Ansicht den rechten Bereich, um die Zielabfragequelle der Korrelation einzurichten. Weitere Details finden Sie unter [Zielabfrage](v10-correlations-config.md#v10-correlations-config-target-query).

1. Erstellen Sie eine Zielabfrage mithilfe der [Variablensyntax](v10-dash-variable-syntax.md) mit Variablen aus der Liste oben im Bereich. Die Liste enthält Beispielwerte aus der ausgewählten Datenzeile.

1. Geben Sie eine Bezeichnung und eine Beschreibung an (optional). Ein Label wird als Name des Links in der Visualisierung verwendet und kann Variablen enthalten.

1. Stellen Sie Transformationen bereit (optional; Einzelheiten siehe unten).

1. Wählen Sie in der oberen Werkzeugleiste **Speichern**, um die Korrelation zu speichern und den Modus Korrelationseditor zu verlassen. Der Link, mit dem die Korrelation erstellt wurde, wird in jeder Zeile durch einen Datenlink ersetzt. Wenn der Link ausgewählt ist, wird die von Ihnen definierte Abfrage in einem anderen Bereich ausgeführt, wobei die Variablen dynamisch durch die Werte aus der ausgewählten Zeile ersetzt werden.

## Transformationen
<a name="v10-explore-corr-transformations"></a>

Mithilfe von Transformationen können Sie Werte extrahieren, die in einem Feld mit anderen Daten vorhanden sind. Mithilfe einer Transformation können Sie beispielsweise einen Teil einer Protokollzeile extrahieren, um ihn in einer Korrelation zu verwenden. Weitere Informationen zu Transformationen in Korrelationen finden Sie unter. [Korrelationstransformationen](v10-correlations-config.md#v10-correlations-config-transformations)

Nachdem Sie im Editor-Modus einen der generierten Links ausgewählt haben, können Sie Transformationen hinzufügen, indem Sie im Drop-down-Menü **Transformationen** die Option **Transformation hinzufügen** auswählen.

**Um eine Transformation in einer Korrelation zu verwenden**

1. Wählen Sie ein Feld aus, auf das die Transformation angewendet werden soll. Wählen Sie den Teil des Felds aus, den Sie für die Transformation verwenden möchten. Zum Beispiel eine Protokollzeile. Nach der Auswahl wird der Wert dieses Felds verwendet, um Sie bei der Erstellung der Transformation zu unterstützen.

1. Wählen Sie den Typ der Transformation aus. Die Optionen und relevanten Einstellungen finden [Korrelationstransformationen](v10-correlations-config.md#v10-correlations-config-transformations) Sie unter. 

1. Je nach Ihrer Auswahl werden möglicherweise eine oder mehrere Variablen aufgefüllt, oder Sie müssen möglicherweise weitere Spezifikationen in den angezeigten Optionen angeben.

1. Wählen Sie **Transformation zur Korrelation** hinzufügen aus, um die angegebenen Variablen zur Liste der verfügbaren Variablen hinzuzufügen.

**Anmerkung**  
Für reguläre Ausdrücke in diesem Dialogfeld werden die in anderen Dokumentationen `mapValue` genannten `Variable Name` hier aufgerufen. Grafana markiert jeden Text, der dem Ausdruck im Feldwert entspricht. Verwenden Sie Gruppen zur Erfassung regulärer Ausdrücke, um auszuwählen, welcher Teil des Treffers extrahiert werden soll. Wenn ein gültiger regulärer Ausdruck angegeben wird, werden die Variable und der Wert dieser Variablen unter dem `Variable Name` Feld angezeigt.

## Beispiele für Korrelationen
<a name="v10-explore-corr-examples"></a>

Die folgenden Beispiele zeigen, wie Korrelationen mithilfe des Korrelationseditors in Explore erstellt werden. Wenn Sie diesen Beispielen folgen möchten, stellen Sie sicher, dass Sie eine [Testdatenquelle](testdata-data-source.md) einrichten.

### Einen Text erstellen, um die Korrelation grafisch darzustellen
<a name="v10-explore-corr-text-to-graph"></a>

Dieses Beispiel zeigt, wie Sie mit dem Korrelationseditor in Explore eine Korrelation erstellen.

Korrelationen ermöglichen es Ihnen, die Ergebnisse einer Abfrage zu verwenden, um eine neue Abfrage in einer beliebigen Datenquelle auszuführen. In diesem Beispiel führen Sie eine Abfrage aus, die Tabellendaten rendert. Die Daten werden verwendet, um eine andere Abfrage auszuführen, die ein Diagrammergebnis liefert.

Um diesem Beispiel zu folgen, stellen Sie sicher, dass Sie eine [Testdatenquelle](testdata-data-source.md) eingerichtet haben.

**Um eine Korrelation zwischen Text und Diagramm zu erstellen**

1. Navigieren Sie in Grafana zu **Explore**.

1. Wählen Sie die **Testdatenquelle** aus dem Drop-down-Menü oben links auf der Seite aus.

1. Wählen Sie **\$1 Hinzufügen** im Drop-down-Menü auf der rechten Seite und wählen Sie Korrelation **hinzufügen** aus.

1. Explore befindet sich jetzt im Correlations Editor-Modus, was durch einen blauen Rand gekennzeichnet ist.

1. Wählen Sie das folgende Szenario aus dem Szenario-Dropdownmenü aus: **CSV-Datei**.

1. Wählen Sie die Datei **population\$1by\$1state.csv** aus. Jede Zelle ist ein Link, auf den Sie klicken können, um mit der Erstellung einer neuen Korrelation zu beginnen.

1. Klicken Sie auf eine beliebige Zelle in der `State` Spalte, um eine neue Korrelation zu erstellen, die diesem Eintrag einen Datenlink zuordnet. Wählen Sie `California` beispielsweise.

1. Wählen Sie in der geteilten Ansicht dieselbe Datenquelle aus, die Sie im linken Bereich ausgewählt haben. Der Helper über dem Abfrage-Editor enthält alle verfügbaren Variablen, die Sie für die Zielabfrage verwenden können. Variablen enthalten alle Datenfelder (Tabellenspalten) aus der ausgewählten Zeile.

1. Wählen Sie im Menü **Szenario** die Option **CSV-Metrikwerte** aus. Das `String Input` Feld im Abfrage-Editor enthält Variablen mit Populationswerten für jedes Jahr:`${1980},${2000},${2020}`. Dadurch wird ein Diagramm mit Variablenwerten generiert.

1. Geben Sie im Feld **Alias** des Abfrage-Editors Folgendes ein`${State}`.

   Führen Sie eine Abfrage aus, um zu überprüfen, ob anhand von Beispielwerten aus den Variablen ein Diagramm erstellt wird.

1. Wählen Sie **Speichern**, um die Korrelation zu speichern und den Korrelationseditor zu beenden.

   Nachdem die Korrelation gespeichert wurde, führt Explore die Abfrage im linken Bereich erneut aus. Wenn Sie auf einen Statusnamen klicken, wird die Abfrage auf der rechten Seite erneut ausgeführt, wobei Werte aus der Zeile in die CSV-Datei eingefügt werden, wodurch das Diagramm geändert wird. Die Abfrage wird jedes Mal, wenn Sie auf einen Bundesstaatsnamen klicken, mit aktualisierten Werten erneut ausgeführt.

Sie können dieselben Schritte auf jede Datenquelle anwenden. Korrelationen ermöglichen es Ihnen, Links in Visualisierungen zu erstellen, um dynamische Abfragen auf der Grundlage ausgewählter Daten auszuführen. In diesem Beispiel haben wir Daten verwendet, die von einer Abfrage zurückgegeben wurden, um eine neue Abfrage zu erstellen, die eine andere Visualisierung mit derselben Datenquelle generiert. Sie können jedoch Korrelationen zwischen beliebigen Datenquellen herstellen, um benutzerdefinierte Erkundungsabläufe zu erstellen.

### Korrelation zwischen Protokollen und Tabellen erstellen
<a name="v10-explore-corr-logs-to-table"></a>

In diesem Beispiel erstellen Sie eine Korrelation, um zu demonstrieren, wie Sie mithilfe von Transformationen Werte aus der Protokollzeile und einem anderen Feld extrahieren können.

Um diesem Beispiel zu folgen, stellen Sie sicher, dass Sie eine [Testdatenquelle](testdata-data-source.md) eingerichtet haben.

**Um eine Korrelation zwischen Protokollen und Tabellen zu erstellen**

1. Navigieren Sie in Grafana zu **Explore**.

1. Wählen Sie die **Testdatenquelle** aus dem Drop-down-Menü oben links auf der Seite aus.

1. Wählen Sie **\$1 Hinzufügen** im Drop-down-Menü auf der rechten Seite und wählen Sie Korrelation **hinzufügen** aus.

1. Explore befindet sich jetzt im Correlations Editor-Modus, was durch einen blauen Rand gekennzeichnet ist.

1. Wählen Sie im Menü **Szenario** die Option **Protokolle** aus.

1. Erweitern Sie eine Protokollzeile, um die Korrelationslinks zu sehen. Wählen Sie `Correlate with hostname`.

1. Explore wird in einer geteilten Ansicht geöffnet. Wählen Sie dieselbe Datenquelle aus, die Sie im linken Bereich ausgewählt haben. Der Helper über dem Abfrage-Editor enthält alle verfügbaren Variablen, die Sie für die Zielabfrage verwenden können.

1. Erweitern Sie den Abschnitt Transformationen und klicken Sie auf **Transformation hinzufügen**.

1. **Wählen Sie im Dropdownmenü **Feld** die Option Nachricht aus.** Die Protokollzeile wird als Beispieldaten angezeigt.

1. Wählen Sie unter **Typ** die Option **Logfmt** aus. Dadurch wird die Liste der Variablen aufgefüllt.

1. Wählen Sie **Transformation zur Korrelation hinzufügen** aus.

1. Wählen Sie erneut **Transformation hinzufügen** und wählen Sie unter **Feld** den **Hostnamen** aus.

1. Wählen Sie unter **Typ** die Option **Regulärer Ausdruck** aus.

1. Geben Sie unter **Ausdruck** Folgendes ein:`-([0-9]\*)`. Dadurch werden alle Zahlen rechts vom Bindestrich ausgewählt.

1. Geben Sie unter **Variablenname** Folgendes ein:`hostNumber`. Dadurch wird die Liste der Variablen aufgefüllt. 

1. Wählen Sie **Transformation zur Korrelation** hinzufügen aus, um sie zu den anderen Variablen hinzuzufügen.

1. Öffnen Sie im Datenquellen-Editor das Dropdownmenü **Szenario** und wählen Sie **CSV-Inhalt** aus.

1. Geben Sie im Textfeld unten Folgendes ein und speichern Sie die Korrelation:

   ```
   time,msg,hostNumber,status
   ${time},${msg},${hostNumber},${status}
   ```

   Dadurch wird die geteilte Ansicht geschlossen und die linke Abfrage erneut ausgeführt. Erweitern Sie eine beliebige Protokollzeile, um die Korrelationsschaltfläche zu sehen. Wenn Sie die Korrelationsschaltfläche wählen, öffnet sich die geteilte Ansicht mit `time` (einem Feld), `msg` (extrahiert mit *logfmt* aus der Protokollzeile), `host number` (extrahiert mit *Regex* aus der`hostname`) und `status` (extrahiert mit *logfmt* aus der Protokollzeile).

# Inspector in Explore
<a name="v10-explore-inspector"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

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="v10-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="v10-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**

Grafana generiert eine CSV-Datei in Ihrem Standard-Browser-Download-Speicherort. Sie können es im Viewer Ihrer Wahl öffnen.

1. Rufen Sie auf der Registerkarte **Inspector** Rohabfrageergebnisse ab, indem Sie den obigen Anweisungen folgen.

1. Verfeinern Sie die Abfrageeinstellungen, bis Sie die Rohdaten sehen, die Sie exportieren möchten.

1. Wählen Sie **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 generiert Grafana eine JSON-Datei für die Trace-Ergebnisse in einem der unterstützten Formate: Jaeger-, Zipkin- oder OTLP-Formate.

1. Öffnen Sie den Inspector.

1. Untersuchen Sie die Ergebnisse der Protokollabfrage. Verfeinern Sie die Ergebnisse, bis Sie die Rohprotokolle sehen, die Sie exportieren möchten.

1. Wählen Sie **Protokolle herunterladen**.

**Überprü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 werden im schreibgeschützten Format angezeigt.

**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.

# Korrelationen in Grafana-Version 10
<a name="v10-correlations"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Sie können interaktive Links für Explore-Visualisierungen erstellen, um Abfragen zu präsentierten Daten auszuführen, indem Sie Korrelationen einrichten.

Eine Korrelation definiert, wie Daten in einer Datenquelle verwendet werden, um Daten in einer anderen Datenquelle abzufragen. Hier einige Beispiele:
+ Ein in einer Protokolldatenquelle zurückgegebener Anwendungsname kann verwendet werden, um Metriken, die sich auf diese Anwendung beziehen, in einer Metrikdatenquelle abzufragen.
+ Ein von einer SQL-Datenquelle zurückgegebener Benutzername kann verwendet werden, um Protokolle abzufragen, die sich auf diesen bestimmten Benutzer in einer Protokolldatenquelle beziehen.

Explore verwendet benutzerdefinierte Korrelationen, um Links innerhalb der Visualisierungen anzuzeigen. Sie können auf einen Link klicken, um die zugehörige Abfrage auszuführen und die Ergebnisse in Explore Split View zu sehen.

Erkunden Sie Visualisierungen, die derzeit das Anzeigen von Links auf der Grundlage von Korrelationen unterstützen:
+ [Protokolle](v10-panels-logs.md)
+ [Tabelle](v10-panels-table.md)

[Sie können Korrelationen über die Seite **Administration > Plugins und Daten > Korrelationen** in Grafana oder direkt in Explore konfigurieren.](v10-explore-correlations.md)

**Topics**
+ [Konfiguration der Korrelation](v10-correlations-config.md)
+ [Erstellen Sie eine neue Korrelation](v10-correlations-create.md)

# Konfiguration der Korrelation
<a name="v10-correlations-config"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

 Jede Korrelation ist mit den folgenden Optionen konfiguriert: 

**Label (Bezeichnung)**  
Linkbezeichnung, die in der Visualisierung angezeigt wird.

**Beschreibung**  
Optionale Beschreibung.

**Quelldatenquelle**  
Die Quelle der Ergebnisse, für die Links angezeigt wurden.

**Feld „Ergebnisse“**  
Definiert, wo der Link in einer Visualisierung angezeigt wird.

**Zielabfrage**  
Die Zielabfrage wird ausgeführt, wenn auf einen Link geklickt wird.

**Transformationen**  
Optionale Manipulationen an den enthaltenen Quelldaten, die an die Zielabfrage übergeben wurden.

Einzelheiten zum Erstellen einer Korrelation finden Sie unter [Korrelation erstellen](v10-correlations-create.md).

## Quelldatenquelle und Ergebnisfeld
<a name="v10-correlations-config-source-and-result"></a>

In Explore-Visualisierungen werden Links für die Ergebnisse aus der Quelldatenquelle der Korrelation angezeigt. Einem der Felder aus dem in der Korrelationskonfiguration bereitgestellten Ergebnis (dem Ergebnisfeld) wird ein Link zugewiesen. Jede Visualisierung zeigt Felder mit Links auf unterschiedliche Weise an. 

## Zielabfrage
<a name="v10-correlations-config-target-query"></a>

Die Zielabfrage wird ausgeführt, wenn in der Visualisierung auf einen Link geklickt wird. Sie können den Abfrage-Editor der ausgewählten Zieldatenquelle verwenden, um die Zielabfrage anzugeben. Auf die Ergebnisse der Quelldaten kann innerhalb der Zielabfrage mit Variablen zugegriffen werden.

### Korrelationsvariablen
<a name="v10-correlations-config-variables"></a>

Sie können Variablen innerhalb der Zielabfrage verwenden, um auf die Quelldaten zuzugreifen, die sich auf die Abfrage beziehen. Korrelationen verwenden die [Grafana-Variablensyntax](v10-dash-variable-syntax.md). Variablen werden mit Werten aus den Quellergebnissen gefüllt, wenn der Link ausgewählt wird. Es gibt zwei Arten von Variablen, die Sie verwenden können:
+ [Feldvariablen](v10-panels-configure-data-links.md#v10-panels-data-link-variables) (um auf Feldwerte und Beschriftungen zuzugreifen).
+ Korrelationsvariablen (für den Zugriff auf Feldwerte und Transformationen).

Beispiel: Wenn die Quellergebnisse ein Feld mit dem Namen enthalten`employee`, kann auf den Wert des Felds zugegriffen werden mit:
+ Eine Feldvariable`${__data.fields.employee}`.
+ Eine Korrelationsvariable, die den obigen Feldwert zuordnet`${employee}`.

Neben der Zuordnung von Feldwerten zu kürzeren Variablennamen können mehr Korrelationsvariablen erstellt werden, indem Transformationen auf bestehende Felder angewendet werden.

Durch Korrelation wird nur dann eine Datenverknüpfung erstellt, wenn alle Variablen Werte in der ausgewählten Datenzeile haben. [Globale Variablen](v10-dash-variable-add.md#v10-dash-variable-add-global) bilden die Ausnahme von dieser Regel und müssen nicht aus den zurückgegebenen Daten ausgefüllt werden. Diese Variablen werden automatisch von Datenquellen interpoliert.

### Korrelationstransformationen
<a name="v10-correlations-config-transformations"></a>

Transformationen bieten eine Möglichkeit, mehr Variablen aus Feldwerten zu extrahieren. Die Ausgabe von Transformationen besteht aus einer Reihe neuer Variablen, auf die wie auf jede andere Variable zugegriffen werden kann.

Es gibt zwei Arten von Transformationen: logfmt und reguläre Ausdrücke.

Jede Transformation verwendet einen ausgewählten Feldwert als Eingabe. Die Ausgabe einer Transformation besteht aus einer Reihe neuer Variablen, die auf dem Typ und den Optionen der Transformation basieren.

### Logfmt-Transformation
<a name="v10-correlations-config-logfmt-transformation"></a>

[Die Logfmt-Transformation dekonstruiert einen Feldwert, der Text enthält, der mit logfmt-Schlüssel/Wert-Paaren formatiert ist.](https://brandur.org/logfmt) Jedes Paar wird zu einer Variablen, wobei der Schlüssel der Name der Variablen ist.

Die Logfmt-Transformation erfordert nur die Angabe des Eingabefeldnamens, wenn Sie möchten, dass die Transformation auf ein anderes Feld als das Ergebnisfeld angewendet wird. Beispielausgabevariablen für: `field = "host=srv001 endpoint=/test app=foo"`


| Name | value | 
| --- | --- | 
| Host | srv001 | 
| Endpunkt | /testen | 
| App | foo | 

### Transformation regulärer Ausdrücke
<a name="v10-correlations-config-regular-expression-transformation"></a>

Die Transformation für reguläre Ausdrücke dekonstruiert einen Feldwert auf der Grundlage des angegebenen regulären Ausdrucks.

Optionen für die Transformation regulärer Ausdrücke:

**field**  
Name des Eingabefeldes

**Ausdruck**  
Regulärer Ausdruck. Benannte Capture-Gruppen werden Variablen zugeordnet, die dem Gruppennamen entsprechen. Wenn nicht benannte übereinstimmende Gruppen verwendet werden, wird aus dem ersten Treffer eine Variable erstellt. Der Wert überschreibt die Variable, die dem Eingabefeld entspricht, oder es wird eine neue Variable erstellt, wenn MapValue angegeben wird (siehe Beispiele in der folgenden Tabelle).

**MapValue**  
Wird mit einfachen Regex-Gruppen ohne benannte passende Gruppen verwendet. Standardmäßig überschreibt die erste Übereinstimmung die Variable mit dem Namen des Felds, das als Eingabe verwendet wird. Um dieses Standardverhalten zu ändern, können Sie die MapValue-Eigenschaft angeben. Der angegebene Name wird verwendet, um eine neue Variable zu erstellen. Dies kann nützlich sein, wenn Ihre Zielabfrage sowohl den exakten Wert als auch einen Teil des mit der Transformation extrahierten Werts benötigt.

Beispiel: Angenommen, der ausgewählte Feldname ist `employee` und der Feldwert ist`John Doe`.

Verschiedene Ausgabevariablen, die auf den Optionen Expression und MapValue basieren:


| Ausdruck | MapValue | Ausgabevariablen | Kommentar | 
| --- | --- | --- | --- | 
| /\$1w\$1 (\$1w\$1)/ | - | employee=Doe | Kein MapValue angegeben. Die erste Übereinstimmung wird der vorhandenen Feldnamenvariablen () employee zugeordnet. | 
| /(\$1w\$1) (\$1w\$1)/ | Name | name=John | Die erste Übereinstimmung wird einer neuen Variablen namens zugeordnet. name  | 
| /(?\$1w\$1) (?\$1w\$1)/ | - | firstName=John, lastName=Doe | Wenn benannte Gruppen verwendet werden, sind dies die Namen der Ausgabevariablen und MapValue wird ignoriert. | 
| /(?\$1w\$1) (?\$1w\$1)/ | Name | firstName=John, lastName=Doe | Wie oben | 

# Erstellen Sie eine neue Korrelation
<a name="v10-correlations-create"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Sie können Korrelationen im Explore Correlations Editor oder auf der **Grafana-Verwaltungsseite** in Ihrem Amazon Managed Grafana-Arbeitsbereich erstellen.

**Voraussetzungen**

Sie müssen über die Berechtigung verfügen, neue Korrelationen hinzuzufügen. Nur Benutzer mit Schreibberechtigungen für Datenquellen können neue Korrelationen definieren.

## Eine Korrelation im Korrelationseditor von Explore erstellen
<a name="v10-correlations-create-explore"></a>

Sie können eine Korrelation im Explore-Korrelationseditor erstellen. Weitere Details finden Sie unter [Eine Korrelation erstellen](v10-explore-correlations.md#v10-explore-corr-create-a-correlation).

## Eine Korrelation auf der Administrationsseite erstellen
<a name="v10-correlations-create-administration"></a>

Sie können die **Verwaltungsseite** der Grafana-Konsole verwenden, um eine Korrelation zu erstellen.

**Um eine Korrelation auf der Administrationsseite zu erstellen**

1. Gehen Sie in Grafana zum **Administrationsbereich**.

1. Öffnen Sie unter **Plugins und Daten** die Seite **Korrelationen**.

1. Wählen Sie die Schaltfläche **Hinzufügen** in der oberen rechten Ecke.

1. Geben Sie eine **Bezeichnung** für die Korrelation an.

1. (Optional) Geben Sie eine **Beschreibung** ein.

1. Gehe zur nächsten Seite.

1. Geben Sie die **Zieldatenquelle** an.

1. Stellen Sie die **Zielabfrage** mithilfe von Variablen bereit.

1. Gehe zur nächsten Seite.

1. Geben Sie die **Quelldatenquelle** an.

1. Geben Sie **das Ergebnisfeld** an.

1. Fügen Sie Transformationen hinzu, wenn Sie Variablen benötigen, die keine Felder in der Quelldatenquelle sind.

1. Wählen Sie **Hinzufügen**, um eine neue Transformation hinzuzufügen.

1. Wählen Sie den Typ einer Transformation aus.

1. Konfigurieren Sie die Transformation je nach ausgewähltem Typ.

1. Speichern Sie die Korrelation.

Sie können eine Korrelation auf die gleiche Weise bearbeiten, aber bei der Bearbeitung können Sie die ausgewählten Datenquellen nicht ändern.

# Benachrichtigungen in Grafana-Version 10
<a name="v10-alerts"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Mit Grafana v10 bietet Amazon Managed Grafana Zugriff auf ein aktualisiertes Warnsystem, *Grafana Alerting, das Warninformationen in einer einzigen*, durchsuchbaren Ansicht zentralisiert. Grafana-Alerting wurde als optionale Funktion in Grafana v8 eingeführt und GrafanaLabs hat die Entfernung der älteren Warnmeldungen in Version 11 angekündigt.

**Anmerkung**  
Diese Dokumentation behandelt die Grafana-Warnung. Informationen zu älteren Warnmeldungen finden Sie unter. [Klassische Dashboard-Benachrichtigungen](old-alerts-overview.md)

Mit Grafana Alerting können Sie sofort nach ihrem Auftreten über Probleme in Ihren Systemen informiert werden.

Überwachen Sie Ihre eingehenden Metrikdaten oder Protokolleinträge und richten Sie Ihr Warnsystem so ein, dass es auf bestimmte Ereignisse oder Umstände achtet und dann Benachrichtigungen sendet, wenn diese Probleme gefunden werden.

Auf diese Weise machen Sie eine manuelle Überwachung überflüssig und bieten eine erste Verteidigungslinie gegen Systemausfälle oder Änderungen, die zu größeren Vorfällen führen könnten.

Mit Grafana Alerting erstellen Sie Abfragen und Ausdrücke aus mehreren Datenquellen — unabhängig davon, wo Ihre Daten gespeichert sind. So haben Sie die Flexibilität, Ihre Daten zu kombinieren und auf neue und einzigartige Weise auf Ihre Metriken und Protokolle zu warnen. Anschließend können Sie Ihre Benachrichtigungen in einer einzigen, konsolidierten Ansicht erstellen, verwalten und Maßnahmen ergreifen und so die Fähigkeit Ihres Teams verbessern, Probleme schnell zu identifizieren und zu lösen.

Mit den Warnregeln von Mimir und Loki können Sie Warnausdrücke näher an Ihren Daten und in großem Umfang ausführen, die alle über die Grafana-Benutzeroberfläche verwaltet werden, mit der Sie bereits vertraut sind.

**Anmerkung**  
Wenn Sie von einer früheren Version von Grafana migrieren, in der Sie die alte Grafana-Warnung verwendet haben, ist es möglicherweise hilfreich, die [Unterschiede zwischen der alten und der neuen Grafana-Warnung](v10-alerting-use-grafana-alerts.md#v10-alerting-diff-old-new) zu sehen.

## Die wichtigsten Funktionen und Vorteile
<a name="v10-alerting-key-features"></a>

**Eine Seite für alle Benachrichtigungen**

Auf einer einzigen Grafana-Warnseite werden sowohl von Grafana verwaltete Benachrichtigungen als auch Benachrichtigungen, die sich in Ihrer Promethus-kompatiblen Datenquelle befinden, an einem einzigen Ort zusammengefasst.

**Mehrdimensionale Warnmeldungen**

Mit Warnungsregeln können mehrere einzelne Warnungsinstanzen pro Warnungsregel erstellt werden, die als multidimensionale Warnungen bezeichnet werden. Dadurch erhalten Sie die Möglichkeit und Flexibilität, mit nur einer einzigen Warnungsregel einen Überblick über Ihr gesamtes System zu erhalten. Dazu fügen Sie Ihrer Abfrage Labels hinzu, um anzugeben, welche Komponente überwacht wird, und mehrere Warnungsinstanzen für eine einzelne Warnungsregel zu generieren. Wenn Sie beispielsweise jeden Server in einem Cluster überwachen möchten, wird eine mehrdimensionale Warnung für jede CPU ausgegeben, wohingegen eine Standardwarnung für den gesamten Server eine Warnung ausgibt.

**Benachrichtigungen weiterleiten**

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 verhindert, dass Benachrichtigungen erstellt werden, und halten nur für ein bestimmtes Zeitfenster an. Stille ermöglicht es Ihnen, den Empfang permanenter Benachrichtigungen aufgrund einer oder mehrerer Warnungsregeln 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**

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.

## Entwerfen Sie Ihr Warnsystem
<a name="v10-alerting-design"></a>

Es ist eine schwierige Aufgabe, komplexe IT-Systeme zu überwachen und zu verstehen, ob alles ordnungsgemäß läuft. Die Einrichtung eines effektiven Warnmanagementsystems ist daher unerlässlich, um Sie zu informieren, wenn etwas schief läuft, bevor sich dies auf Ihre Geschäftsergebnisse auswirkt.

Das Entwerfen und Konfigurieren eines funktionierenden Alert-Management-Setups erfordert Zeit.

Im Folgenden finden Sie einige Tipps, wie Sie ein effektives Alert-Management-Setup für Ihr Unternehmen einrichten können:

**Welche sind die wichtigsten Kennzahlen für Ihr Unternehmen, die Sie überwachen und auf die Sie aufmerksam machen möchten?**
+ Finden Sie Ereignisse, über die Sie Bescheid wissen sollten und die nicht so trivial oder häufig sind, dass die Empfänger sie ignorieren.
+ Benachrichtigungen sollten nur für große Ereignisse erstellt werden, die sofortige Aufmerksamkeit oder Intervention erfordern.
+ Denken Sie an Qualität vor Quantität.

**Welche Art von Warnung möchten Sie verwenden?**
+ Wählen Sie zwischen Grafana-Managed Alerting oder Grafana Mimir oder Loki-Managed Alerting oder beidem.

**Wie möchten Sie Ihre Benachrichtigungen und Benachrichtigungen organisieren?**
+ Seien Sie wählerisch, wen Sie für den Empfang von Benachrichtigungen einrichten. Erwägen Sie, sie an jemanden zu senden, der gerade auf Abruf ist, oder an einen bestimmten Slack-Kanal.
+ Automatisieren Sie so weit wie möglich mit der Alerting API oder Alerts as Code (Terraform).

**Wie können Sie die Alarmermüdung reduzieren?**
+ Vermeiden Sie laute, unnötige Warnmeldungen, indem Sie Stummschaltungen verwenden, die Zeit stummschalten oder die Auswertung von Alarmregeln pausieren.
+ Passen Sie Ihre Warnregeln kontinuierlich an, um deren Wirksamkeit zu überprüfen. Entfernen Sie Warnregeln, um doppelte oder ineffektive Benachrichtigungen zu vermeiden.
+ Denken Sie sorgfältig über Priorität und Schweregrad nach.
+ Überprüfen Sie kontinuierlich Ihre Schwellenwerte und Bewertungsregeln.

## Einschränkungen bei Grafana-Benachrichtigungen
<a name="v10-alerting-limitations"></a>
+ Beim Aggregieren von Regeln aus anderen Systemen kann das Grafana-Warnsystem Regeln aus allen verfügbaren Amazon Managed Service for Prometheus-, Prometheus-, Loki- und Alertmanager-Datenquellen abrufen. Es ist möglicherweise nicht in der Lage, Regeln aus anderen unterstützten Datenquellen abzurufen.

**Topics**
+ [Die wichtigsten Funktionen und Vorteile](#v10-alerting-key-features)
+ [Entwerfen Sie Ihr Warnsystem](#v10-alerting-design)
+ [Einschränkungen bei Grafana-Benachrichtigungen](#v10-alerting-limitations)
+ [-Übersicht](v10-alerting-overview.md)
+ [Alerting einrichten](v10-alerting-setup.md)
+ [Warnmeldungen konfigurieren](v10-alerting-configure.md)
+ [Verwalte deine Benachrichtigungen](v10-alerting-manage.md)

# -Übersicht
<a name="v10-alerting-overview"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Egal, ob Sie gerade erst anfangen oder ein erfahrener Benutzer von Grafana Alerting sind, erfahren Sie mehr über die Grundlagen und verfügbaren Funktionen, mit denen Sie Benachrichtigungen erstellen, verwalten und darauf reagieren können; und verbessern Sie die Fähigkeit Ihres Teams, Probleme schnell zu lösen.

## Prinzipien
<a name="v10-alerting-overview-principles"></a>

In Prometheus basierten Warnsystemen verfügen Sie über einen Alert-Generator, der Alerts generiert, und einen Alert-Empfänger, der Alerts empfängt. Zum Beispiel ist Prometheus ein Alarmgenerator und für die Auswertung von Warnungsregeln verantwortlich, während Alertmanager ein Alarmempfänger ist und für das Gruppieren, Sperren, Stummschalten und Senden von Benachrichtigungen über ausgelöste und gelöste Alarme verantwortlich ist.

Grafana Alerting basiert auf dem Prometheus-Modell zur Entwicklung von Warnsystemen. Es verfügt über einen internen Alarmgenerator, der für die Planung und Auswertung von Alarmregeln zuständig ist, sowie über einen internen Alarmempfänger, der für das Gruppieren, Sperren, Stummschalten und Senden von Benachrichtigungen zuständig ist. Grafana verwendet Prometheus nicht als Alert-Generator, da Grafana Alerting neben Prometheus auch mit vielen anderen Datenquellen arbeiten muss. Es verwendet jedoch Alertmanager als Alert-Empfänger.

Alarme werden an den Alarmempfänger gesendet, wo sie weitergeleitet, gruppiert, gesperrt, stummgeschaltet und benachrichtigt werden. In Grafana Alerting ist der Standard-Alert-Empfänger der in Grafana eingebettete Alertmanager, der als Grafana Alertmanager bezeichnet wird. [Sie können jedoch auch andere Alertmanager verwenden, und diese werden als externe Alertmanager bezeichnet.](v10-alerting-setup-alertmanager.md)

## Grundlagen
<a name="v10-alerting-overview-fundamentals"></a>

Im Folgenden finden Sie einen Überblick über die verschiedenen Teile der Grafana-Warnung.

### Warnungsregeln
<a name="v10-alerting-overview-alert-rules"></a>

Eine Warnregel besteht aus einer Reihe von Kriterien, die bestimmen, wann eine Warnung ausgelöst werden soll. Sie besteht aus einer oder mehreren Abfragen und Ausdrücken, einer Bedingung, die erfüllt sein muss, einem Intervall, das bestimmt, wie oft die Warnungsregel ausgewertet wird, und einer Dauer, über die die Bedingung erfüllt sein muss, damit eine Warnung ausgelöst wird.

Warnungsregeln werden über ihr Intervall hinweg ausgewertet, und für jede Warnungsregel können null, eine oder eine beliebige Anzahl von Alarmen gleichzeitig ausgelöst werden. Der Status einer Warnungsregel wird durch die höchste `severe` Alarmstufe bestimmt, die entweder Normal, Ausstehend oder Auslösend lauten kann. Wenn beispielsweise mindestens eine Warnung einer Warnungsregel ausgelöst wird, wird auch die Warnungsregel ausgelöst. Der Zustand einer Warnungsregel wird durch den Status ihrer letzten Bewertung bestimmt. Diese können OK, Fehler und sein NoData.

Ein sehr wichtiges Merkmal von Warnungsregeln ist, dass sie benutzerdefinierte Anmerkungen und Beschriftungen unterstützen. Diese ermöglichen es Ihnen, Benachrichtigungen mit zusätzlichen Metadaten wie Zusammenfassungen und Beschreibungen zu versehen und zusätzliche Beschriftungen hinzuzufügen, um Benachrichtigungen an bestimmte Benachrichtigungsrichtlinien weiterzuleiten.

### Benachrichtigungen
<a name="v10-alerting-overview-alerts"></a>

Warnmeldungen werden durch Gruppen von key/value Paaren, die als Labels bezeichnet werden, eindeutig identifiziert. Jeder Schlüssel ist ein Labelname und jeder Wert ist ein Labelwert. Beispielsweise könnte eine Warnung die Beschriftungen `foo=bar` und eine andere Warnung die Beschriftungen haben`foo=baz`. Eine Warnung kann viele Bezeichnungen haben, `foo=bar,bar=baz` z. B. kann sie dieselbe Bezeichnung nicht zweimal haben, z. `foo=bar,foo=baz` B. Zwei Alerts können auch nicht dieselben Labels haben, und wenn zwei Alerts dieselbe Bezeichnung wie `foo=bar,bar=baz` und haben, `foo=bar,bar=baz` dann wird eine der Alerts verworfen. Warnungen werden behoben, wenn die Bedingung in der Warnungsregel nicht mehr erfüllt ist oder die Warnungsregel gelöscht wird.

In Grafana Managed Alerts können sich Benachrichtigungen im Status Normal, Ausstehend, Warnung, Keine Daten oder Fehler befinden. In von Datenquellen verwalteten Warnmeldungen wie Mimir und Loki können Benachrichtigungen den Status Normal, Ausstehend und Warnung haben, jedoch nicht oder Fehler. NoData 

### Kontaktstellen
<a name="v10-alerting-overview-contact-points"></a>

Kontaktstellen bestimmen, wohin Benachrichtigungen gesendet werden. Möglicherweise haben Sie eine Kontaktstelle, die Benachrichtigungen an eine E-Mail-Adresse, an Slack, an ein Incident Management System (IRM) wie Grafana OnCall oder Pagerduty oder an einen Webhook sendet.

Die Benachrichtigungen, die von Kontaktstellen gesendet werden, können mithilfe von Benachrichtigungsvorlagen angepasst werden. Sie können Benachrichtigungsvorlagen verwenden, um den Titel, die Nachricht und die Struktur der Benachrichtigung zu ändern. Benachrichtigungsvorlagen sind nicht spezifisch für einzelne Integrationen oder Kontaktstellen.

### Richtlinien für Benachrichtigungen
<a name="v10-alerting-overview-notification-policies"></a>

Benachrichtigungsrichtlinien gruppieren Benachrichtigungen und leiten sie dann an Kontaktstellen weiter. Sie legen fest, wann Benachrichtigungen gesendet werden und wie oft Benachrichtigungen wiederholt werden sollen.

Benachrichtigungen werden mithilfe von Label-Matchern mit Benachrichtigungsrichtlinien abgeglichen. Dabei handelt es sich um menschenlesbare Ausdrücke, mit denen bestätigt wird, ob die Bezeichnungen der Warnung exakt übereinstimmen, ob sie nicht exakt übereinstimmen, ob sie den erwarteten Text enthalten oder nicht. Der Matcher `foo=bar` ordnet beispielsweise Warnungen mit der Bezeichnung zu, `foo=bar` während der Matcher Warnungen mit einem beliebigen Label namens foo mit einem Wert `foo=~[a-zA-Z]+` abgleicht, der dem regulären Ausdruck entspricht. `[a-zA-Z]+`

Standardmäßig kann eine Warnung nur einer Benachrichtigungsrichtlinie entsprechen. Mit dieser `continue` Funktion können jedoch Benachrichtigungen erstellt werden, die einer beliebigen Anzahl von Benachrichtigungsrichtlinien gleichzeitig entsprechen. Weitere Informationen zu Benachrichtigungsrichtlinien finden Sie unter [Benachrichtigungsrichtlinien](v10-alerting-explore-notifications-policies-details.md).

### Zeiten der Stille und Stummschaltung
<a name="v10-alerting-overview-silences-and-mute-timings"></a>

Stummschalten und Stummschalten ermöglichen es dir, Benachrichtigungen für bestimmte Benachrichtigungen oder sogar ganze Benachrichtigungsrichtlinien zu pausieren. Verwenden Sie eine Stummschaltung, um Benachrichtigungen spontan zu unterbrechen, z. B. während Sie an einer Lösung für eine Warnung arbeiten. Verwenden Sie die Stummschaltung, um Benachrichtigungen in regelmäßigen Intervallen zu unterbrechen, z. B. während regelmäßig geplanten Wartungsfenstern.

**Topics**
+ [Prinzipien](#v10-alerting-overview-principles)
+ [Grundlagen](#v10-alerting-overview-fundamentals)
+ [Datenquellen und Grafana-Alerting](v10-alerting-overview-datasources.md)
+ [Warnmeldungen bei numerischen Daten](v10-alerting-overview-numeric.md)
+ [Beschriftungen und Anmerkungen](v10-alerting-overview-labels.md)
+ [Über Warnungsregeln](v10-alerting-explore-rules.md)
+ [Alert-Manager](v10-alerting-explore-alertmanager.md)
+ [Kontaktstellen](v10-alerting-explore-contacts.md)
+ [Benachrichtigungen](v10-alerting-explore-notifications.md)
+ [Warnung bei hoher Verfügbarkeit](v10-alerting-explore-high-availability.md)

# Datenquellen und Grafana-Alerting
<a name="v10-alerting-overview-datasources"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Es gibt eine Reihe von Datenquellen, die mit Grafana Alerting kompatibel sind. Jede Datenquelle wird von einem Plugin unterstützt. Grafana-Alerting erfordert, dass Datenquellen-Plugins *Backend-Plugins* sind, um Regeln anhand der Datenquelle auszuwerten, da die Evaluierungs-Engine im Backend läuft. Plugins müssen außerdem angeben, dass sie mit Grafana-Alerting kompatibel sind.

Datenquellen werden im Laufe der Zeit hinzugefügt und aktualisiert. Es ist bekannt, dass die folgenden Datenquellen mit Grafana-Warnungen kompatibel sind.
+ [Stellen Sie eine Connect zu einer CloudWatch Amazon-Datenquelle her](using-amazon-cloudwatch-in-AMG.md)
+ [Stellen Sie eine Connect zu einer Azure Monitor-Datenquelle her](using-azure-monitor-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 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)
+ [Connect zu Amazon Managed Service for Prometheus und Open-Source-Prometheus-Datenquellen her](prometheus-data-source.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)

Ausführlichere Informationen zu Datenquellen und Datenquellen-Plugins in Amazon Managed Grafana finden Sie unter[Verbinden zu Datenquellen](AMG-data-sources.md).

# Warnmeldungen bei numerischen Daten
<a name="v10-alerting-overview-numeric"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

In 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.

## Tabellendaten
<a name="v10-alerting-numeric-tabular"></a>

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 einer 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
<a name="v10-alerting-numeric-tabexample"></a>

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="v10-alerting-overview-labels"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

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](v10-alerting-overview-labels-templating.md) Diese Art von Beschreibung wäre besser als Anmerkung geeignet.

## Labels
<a name="v10-alerting-overview-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.](v10-alerting-overview-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="v10-alerting-overview-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.](v10-alerting-overview-labels-templating.md)

**Topics**
+ [Labels](#v10-alerting-overview-labels-labels)
+ [Anmerkungen](#v10-alerting-overview-labels-annotations)
+ [So funktioniert der Labelabgleich](v10-alerting-overview-labels-matching.md)
+ [Etiketten in Grafana-Benachrichtigungen](v10-alerting-overview-labels-alerting.md)
+ [Vorlagen für Beschriftungen und Anmerkungen](v10-alerting-overview-labels-templating.md)

# So funktioniert der Labelabgleich
<a name="v10-alerting-overview-labels-matching"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Verwenden Sie 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 angeben, 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.

## Beispiel
<a name="v10-alerting-overview-labels-matching-ex"></a>

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.

## Beschriftungen ausschließen
<a name="v10-alerting-overview-labels-matching-exclude"></a>

Sie können auch Label-Matcher schreiben, um Labels auszuschließen.

Hier ist ein Beispiel, das zeigt, wie das Label `team` ausgeschlossen werden kann. Sie können zwischen jedem dieser Werte wählen, um das Label auszuschließen.
+ `team=""`
+ `team!~.+`
+ `team=~^$`

# Etiketten in Grafana-Benachrichtigungen
<a name="v10-alerting-overview-labels-alerting"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

In 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](v10-alerting-configure.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
<a name="v10-alerting-overview-labels-alerting-external"></a>

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
<a name="v10-alerting-overview-labels-alerting-reserved"></a>

**Anmerkung**  
Etiketten mit dem Präfix `grafana_` sind von Grafana für spezielle Zwecke reserviert. Wenn ein manuell konfiguriertes Label hinzugefügt wird, wird `grafana_` es im Kollisionsfall überschrieben.

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
<a name="v10-alerting-overview-labels-templating"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Sie können Vorlagen verwenden, um Daten aus Abfragen und Ausdrücken in Beschriftungen und Anmerkungen aufzunehmen. Möglicherweise möchten Sie den Schweregrad für eine Warnung auf der Grundlage des Werts der Abfrage festlegen oder das Instanzlabel aus der Abfrage in einer zusammenfassenden Anmerkung verwenden, damit Sie wissen, auf welchem Server eine hohe CPU-Auslastung herrscht.

Alle Vorlagen sollten in [Text/Vorlage](https://pkg.go.dev/text/template) geschrieben werden. Unabhängig davon, ob Sie eine Vorlage für ein Etikett oder eine Anmerkung erstellen, sollten Sie jede Vorlage direkt in das Etikett oder die Anmerkung schreiben, für die Sie eine Vorlage erstellen. Das bedeutet, dass Sie Vorlagen nicht gemeinsam mit Beschriftungen und Anmerkungen verwenden können. Stattdessen müssen Sie Vorlagen überall dort kopieren, wo Sie sie verwenden möchten.

Jede Vorlage wird immer dann ausgewertet, wenn die Warnungsregel ausgewertet wird, und zwar für jede Warnung separat. Wenn Ihre Warnungsregel beispielsweise eine Vorlage für eine Zusammenfassung enthält und die Warnungsregel 10 auslösende Alerts enthält, wird die Vorlage zehnmal ausgeführt, einmal für jede Warnung. Sie sollten versuchen, teure Berechnungen in Ihren Vorlagen so weit wie möglich zu vermeiden.

## Beispiele
<a name="v10-alerting-overview-labels-templating-examples"></a>

Anstatt ein vollständiges Tutorial zu schreiben, text/template, the following examples attempt to show the most common use-cases we have seen for templates. You can use these examples verbatim, or adapt them as necessary for your use case. For more information about how to write text/template schauen Sie sich die [Text-/Vorlagendokumentation](https://pkg.go.dev/text/template) an.

**Drucken Sie alle Etiketten kommagetrennt**

Um alle Etiketten durch Kommas getrennt zu drucken, drucken Sie die `$labels` Variable:

```
{{ $labels }}
```

Wenn zum Beispiel eine Warnung mit den Beschriftungen angezeigt wird `alertname=High CPU usage``instance=server1`, `grafana_folder=CPU alerts` und das würde Folgendes drucken: 

```
alertname=High CPU usage, grafana_folder=CPU alerts, instance=server1
```

**Anmerkung**  
Wenn Sie klassische Bedingungen verwenden, enthält `$labels` diese Option keine Labels aus der Abfrage. Weitere Informationen finden Sie in [der Variablen \$1labels](#v10-alerting-overview-labels-templating-the-labels-variable).

**Druckt alle Etiketten, eines pro Zeile**

Um alle Etiketten zu drucken, eines pro Zeile, verwenden Sie a, `range` um über jedes key/value Paar zu iterieren und sie einzeln zu drucken. `$k`Bezieht sich hier auf den Namen und `$v` bezieht sich auf den Wert des aktuellen Labels: 

```
{{ range $k, $v := $labels -}}
{{ $k }}={{ $v }}
{{ end }}
```

Wenn zum Beispiel eine Warnung mit den Beschriftungen angezeigt `alertname=High CPU usage` wird`instance=server1`, `grafana_folder=CPU alerts` und das würde Folgendes ausgeben:

```
alertname=High CPU usage
grafana_folder=CPU alerts
instance=server1
```

**Anmerkung**  
Wenn Sie klassische Bedingungen verwenden, enthält `$labels` diese Option keine Labels aus der Abfrage. Weitere Informationen finden Sie in [der Variablen \$1labels](#v10-alerting-overview-labels-templating-the-labels-variable).

**Drucken Sie ein einzelnes Etikett**

Um ein einzelnes Etikett zu drucken, verwenden Sie die `index` Funktion mit der `$labels` Variablen: 

```
The host {{ index $labels "instance" }} has exceeded 80% CPU usage for the last 5 minutes
```

Bei einer Warnung mit dem Etikett würde dies `instance=server1` beispielsweise Folgendes drucken:

```
The host server1 has exceeded 80% CPU usage for the last 5 minutes
```

**Anmerkung**  
Wenn Sie klassische Bedingungen verwenden, enthält `$labels` diese Option keine Labels aus der Abfrage. Weitere Informationen finden Sie in [der Variablen \$1labels](#v10-alerting-overview-labels-templating-the-labels-variable).

**Gibt den Wert einer Abfrage aus**

Um den Wert einer Sofortabfrage zu drucken, können Sie ihre Ref-ID mit der `index` Funktion und der `$values` Variablen drucken: 

```
{{ index $values "A" }}
```

Bei einer Sofortabfrage, die beispielsweise den Wert 81.2345 zurückgibt, wird Folgendes gedruckt:

```
81.2345
```

Um den Wert einer Bereichsabfrage zu drucken, müssen Sie ihn zunächst mit einem Reduce-Ausdruck von einer Zeitreihe auf einen Instantvektor reduzieren. Anschließend können Sie das Ergebnis des Reduzierungsausdrucks drucken, indem Sie stattdessen dessen Ref-ID verwenden. Wenn der Reduce-Ausdruck beispielsweise den Durchschnitt von A annimmt und die Referenz-ID B hat, würden Sie schreiben: 

```
{{ index $values "B" }}
```

**Gibt den humanisierten Wert einer Abfrage aus**

Um den humanisierten Wert einer Sofortabfrage zu drucken, verwenden Sie die `humanize` Funktion:

```
{{ humanize (index $values "A").Value }}
```

Bei einer Sofortabfrage, die beispielsweise den Wert 81.2345 zurückgibt, wird Folgendes gedruckt: 

```
81.234
```

Um den humanisierten Wert einer Bereichsabfrage zu drucken, müssen Sie ihn zunächst von einer Zeitreihe auf einen Instantvektor mit einem Reduce-Ausdruck reduzieren. Anschließend können Sie das Ergebnis des Reduce-Ausdrucks drucken, indem Sie stattdessen dessen Ref-ID verwenden. Wenn der Reduce-Ausdruck beispielsweise den Durchschnitt von A annimmt und die Referenz-ID B hat, würden Sie schreiben: 

```
{{ humanize (index $values "B").Value }}
```

**Drucken Sie den Wert einer Abfrage als Prozentsatz**

Um den Wert einer Sofortabfrage als Prozentsatz zu drucken, verwenden Sie die `humanizePercentage` Funktion:

```
{{ humanizePercentage (index $values "A").Value }}
```

Diese Funktion erwartet, dass der Wert eine Dezimalzahl zwischen 0 und 1 ist. Wenn der Wert stattdessen eine Dezimalzahl zwischen 0 und 100 ist, können Sie ihn entweder in Ihrer Abfrage oder mithilfe eines mathematischen Ausdrucks durch 100 teilen. Wenn es sich bei der Abfrage um eine Bereichsabfrage handelt, müssen Sie sie zunächst mit einem Reduce-Ausdruck von einer Zeitreihe auf einen Instantvektor reduzieren.

**Legen Sie anhand des Werts einer Abfrage einen Schweregrad fest**

Verwenden Sie eine if-Anweisung und die Vergleichsfunktion „Größer als“, um anhand des Werts einer Abfrage einen Schweregrad festzulegen. Achten Sie darauf, Dezimalzahlen (`80.0`,, usw.) zu verwenden `50.0``0.0`, wenn Sie Vergleiche durchführen, `$values` da text/template Typenzwang nicht unterstützt wird. [Eine Liste aller unterstützten Vergleichsfunktionen finden Sie hier.](https://pkg.go.dev/text/template#hdr-Functions)

```
{{ if (gt $values.A.Value 80.0) -}}
high
{{ else if (gt $values.A.Value 50.0) -}}
medium
{{ else -}}
low
{{- end }}
```

**Drucken Sie alle Etiketten aus einem klassischen Zustand**

Sie können diese Option nicht verwenden`$labels`, um Etiketten aus der Abfrage zu drucken, wenn Sie klassische Bedingungen verwenden, und müssen `$values` stattdessen verwenden. Der Grund dafür ist, dass bei klassischen Bedingungen diese Bezeichnungen verworfen werden, um eindimensionales Verhalten zu erzwingen (maximal eine Warnung pro Warnungsregel). Wenn die klassischen Bedingungen diese Beschriftungen nicht verwerfen würden, würden Abfragen, die viele Zeitreihen zurückgaben, dazu führen, dass Warnungen ständig zwischen Auslösen und Auflösen hin und her schwanken, da sich die Beschriftungen bei jeder Auswertung der Warnungsregel ändern würden.

Stattdessen enthält die `$values` Variable die reduzierten Werte aller Zeitreihen für alle ausgelösten Bedingungen. Wenn Sie beispielsweise eine Warnungsregel mit einer Abfrage A haben, die zwei Zeitreihen zurückgibt, und einer klassischen Bedingung B mit zwei Bedingungen, dann `$values` würde sie `B0``B1`, `B2` und enthalten`B3`. Wenn die klassische Bedingung B nur eine Bedingung hätte, `$values` würde sie nur `B0` UND enthalten`B1`.

Verwenden Sie die folgende Vorlage, um alle Beschriftungen aller Brennzeitreihen zu drucken (achten Sie darauf, den regulären Ausdruck durch die Ref-ID der klassischen Bedingung zu ersetzen`B`, falls diese anders ist): 

```
{{ range $k, $v := $values -}}
{{ if (match "B[0-9]+" $k) -}}
{{ $k }}: {{ $v.Labels }}{{ end }}
{{ end }}
```

Zum Beispiel würde eine klassische Bedingung für zwei Zeitreihen, die eine einzige Bedingung überschreiten, ausgegeben: 

```
B0: instance=server1
B1: instance=server2
```

Wenn die klassische Bedingung zwei oder mehr Bedingungen hat und eine Zeitreihe mehrere Bedingungen gleichzeitig überschreitet, werden ihre Bezeichnungen für jede Bedingung, die überschritten wird, dupliziert: 

```
B0: instance=server1
B1: instance=server2
B2: instance=server1
B3: instance=server2
```

Wenn Sie eindeutige Beschriftungen drucken müssen, sollten Sie in Betracht ziehen, Ihre Warnungsregeln stattdessen von eindimensional auf mehrdimensional zu ändern. Sie können dies tun, indem Sie Ihre klassische Bedingung durch Reduce-Ausdrücke und mathematische Ausdrücke ersetzen.

**Druckt alle Werte aus einer klassischen Bedingung**

Um alle Werte einer klassischen Bedingung zu drucken, nehmen Sie das vorherige Beispiel und `$v.Labels` ersetzen Sie es durch`$v.Value`: 

```
{{ range $k, $v := $values -}}
{{ if (match "B[0-9]+" $k) -}}
{{ $k }}: {{ $v.Value }}{{ end }}
{{ end }}
```

Zum Beispiel würde eine klassische Bedingung für zwei Zeitreihen, die eine einzige Bedingung überschreiten, Folgendes ausgeben: 

```
B0: 81.2345
B1: 84.5678
```

Wenn die klassische Bedingung zwei oder mehr Bedingungen hat und eine Zeitreihe mehrere Bedingungen gleichzeitig überschreitet, enthält `$values` sie die Werte aller Bedingungen: 

```
B0: 81.2345
B1: 92.3456
B2: 84.5678
B3: 95.6789
```

## Variablen
<a name="v10-alerting-overview-labels-templating-variables"></a>

Die folgenden Variablen stehen Ihnen bei der Erstellung von Vorlagen für Beschriftungen und Anmerkungen zur Verfügung:

### Die labels-Variable
<a name="v10-alerting-overview-labels-templating-the-labels-variable"></a>

Die `$labels` Variable enthält alle Labels aus der Abfrage. Angenommen, Sie haben eine Abfrage, die die CPU-Auslastung für alle Ihre Server zurückgibt, und Sie haben eine Warnungsregel, die ausgelöst wird, wenn einer Ihrer Server in den letzten 5 Minuten die CPU-Auslastung von 80% überschritten hat. Sie möchten der Warnung eine zusammenfassende Anmerkung hinzufügen, die Ihnen mitteilt, auf welchem Server eine hohe CPU-Auslastung herrscht. Mit der `$labels` Variablen können Sie eine Vorlage schreiben, die einen für Menschen lesbaren Satz druckt, wie zum Beispiel: 

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes
```

**Anmerkung**  
Wenn Sie eine klassische Bedingung verwenden, enthält `$labels` sie keine Labels aus der Abfrage. Bei klassischen Bedingungen werden diese Bezeichnungen verworfen, um eindimensionales Verhalten zu erzwingen (höchstens eine Warnung pro Warnungsregel). Wenn Sie Beschriftungen aus der Abfrage in Ihrer Vorlage verwenden möchten, folgen Sie dem vorherigen Beispiel *Alle Beschriftungen aus einer klassischen Bedingung drucken*.

### Die Wertvariable
<a name="v10-alerting-overview-labels-templating-the-value-variable"></a>

Die `$value` Variable ist eine Zeichenfolge, die die Bezeichnungen und Werte aller Sofortabfragen, Schwellenwerte, Reduktionsausdrücke und mathematische Ausdrücke sowie klassische Bedingungen in der Warnungsregel enthält. Sie enthält nicht die Ergebnisse von Bereichsabfragen, da diese zwischen 10 und 10.000 Zeilen oder Metriken zurückgeben können. Wenn dies der Fall wäre, könnte eine einzelne Warnung für besonders große Abfragen 10 Sekunden Speicher MBs beanspruchen, und Grafana würde sehr schnell der Speicher ausgehen.

Um die `$value` Variable in der Zusammenfassung zu drucken, würden Sie etwa Folgendes schreiben: 

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes: {{ $value }}
```

Und es würde ungefähr so aussehen:

```
CPU usage for instance1 has exceeded 80% for the last 5 minutes: [ var='A' labels={instance=instance1} value=81.234 ]
```

`var='A'`Bezieht sich hier auf die Sofortabfrage mit der Referenz-ID A, `labels={instance=instance1}` bezieht sich auf die Labels und `value=81.234` bezieht sich auf die durchschnittliche CPU-Auslastung in den letzten 5 Minuten.

Wenn Sie nur einen Teil der Zeichenfolge statt der vollständigen Zeichenfolge drucken möchten, verwenden Sie die `$values` Variable. Sie enthält dieselben Informationen wie`$value`, aber in einer strukturierten Tabelle, und ist viel einfacher zu verwenden, als einen regulären Ausdruck zu schreiben, der nur dem gewünschten Text entspricht.

### Die Variablen „Werte“
<a name="v10-alerting-overview-labels-templating-the-values-variable"></a>

Bei der `$values` Variablen handelt es sich um eine Tabelle, die die Bezeichnungen und Fließkommawerte aller Sofortabfragen und Ausdrücke enthält, die nach ihrer Referenz IDs indexiert sind.

Um den Wert der Sofortabfrage mit der Referenz-ID A zu drucken:

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes: {{ index $values "A" }}
```

Bei einer Warnung mit den Beschriftungen `instance=server1` und einer Sofortabfrage mit dem Wert würde dies `81.2345` beispielsweise Folgendes ausgeben:

```
CPU usage for instance1 has exceeded 80% for the last 5 minutes: 81.2345
```

Wenn es sich bei der Abfrage in Ref ID A um eine Bereichsabfrage und nicht um eine Sofortabfrage handelt, fügen Sie einen Reduce-Ausdruck mit Ref ID B hinzu und ersetzen Sie ihn durch `(index $values "A")``(index $values "B")`:

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes: {{ index $values "B" }}
```

## Funktionen
<a name="v10-alerting-overview-labels-templating-functions"></a>

Bei der Erstellung von Vorlagen für Beschriftungen und Anmerkungen stehen Ihnen die folgenden Funktionen zur Verfügung:

**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.

```
{{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.

```
{{ externalURL }}
```

```
https://example.com/grafana
```

**GraphLink**

Die `graphLink` Funktion gibt den Pfad zur grafischen Ansicht [Erkunden Sie in Grafana-Version 10](v10-explore.md) für den angegebenen Ausdruck und die angegebene Datenquelle zurück.

```
{{ 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.

```
{{ humanize 1000.0 }}
```

```
1k
```

**humanisieren (1024)**

Das `humanize1024` funktioniert ähnlich wie, verwendet `humanize` aber 1024 statt 1000 als Basis.

```
{{ humanize1024 1024.0 }}
```

```
1ki
```

**HumanizeDuration**

Die `humanizeDuration` Funktion humanisiert eine Dauer in Sekunden.

```
{{ humanizeDuration 60.0 }}
```

```
1m 0s
```

**Prozentsatz humanisieren**

Die `humanizePercentage` Funktion humanisiert einen Verhältniswert zu einem Prozentsatz.

```
{{ humanizePercentage 0.2 }}
```

```
20%
```

**HumanizeTimestamp**

Die `humanizeTimestamp` Funktion humanisiert einen Unix-Zeitstempel.

```
{{ humanizeTimestamp 1577836800.0 }}
```

```
2020-01-01 00:00:00 +0000 UTC
```

**Spiel**

Die `match` Funktion gleicht den Text mit einem regulären Ausdrucksmuster ab.

```
{{ match "a.*" "abc" }}
```

```
true
```

**Pfad/Präfix**

Die `pathPrefix` Funktion gibt den Pfad des Grafana-Servers zurück.

```
{{ pathPrefix }}
```

```
/grafana
```

**TableLink**

Die `tableLink` Funktion gibt den Pfad zur Tabellenansicht [Erkunden Sie in Grafana-Version 10](v10-explore.md) für den angegebenen Ausdruck und die angegebene Datenquelle zurück.

```
{{ 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ß.

```
{{ title "hello, world!" }}
```

```
Hello, World!
```

**toLower**

Die `toLower` Funktion gibt den gesamten Text in Kleinbuchstaben zurück.

```
{{ toLower "Hello, world!" }}
```

```
hello, world!
```

**toUpper**

Die `toUpper` Funktion gibt den gesamten Text in Großbuchstaben zurück.

```
{{ toUpper "Hello, world!" }}
```

```
HELLO, WORLD!
```

**reReplaceAll**

Die `reReplaceAll` Funktion ersetzt Text, der dem regulären Ausdruck entspricht.

```
{{ reReplaceAll "localhost:(.*)" "example.com:$1" "localhost:8080" }}
```

```
example.com:8080
```

# Über Warnungsregeln
<a name="v10-alerting-explore-rules"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Eine 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 der Dauer, über die die Bedingung erfüllt sein muss, damit sie ausgelöst wird.

Während Abfragen und Ausdrücke den auszuwertenden Datensatz auswählen, legt eine *Bedingung* den Schwellenwert fest, den die Daten erfüllen oder überschreiten müssen, 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](v10-alerting-explore-rules-types.md)
+ [Regeln für die Aufzeichnung](v10-alerting-explore-rule-recording.md)
+ [Anfragen und Bedingungen](v10-alerting-explore-rules-queries.md)
+ [Warnungsinstanzen](v10-alerting-rules-instances.md)
+ [Namespaces, Ordner und Gruppen](v10-alerting-rules-grouping.md)
+ [Evaluierung von Warnmeldungsregeln](v10-alerting-rules-evaluation.md)
+ [Stand und Zustand der Warnregeln](v10-alerting-explore-state.md)
+ [Vorlagen für Benachrichtigungen](v10-alerting-rules-notification-templates.md)

# Arten von Warnungsregeln
<a name="v10-alerting-explore-rules-types"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Grafana unterstützt mehrere Warnungsregeltypen. Erfahren Sie mehr über die einzelnen Warnungsregeltypen und deren Funktionsweise und entscheiden Sie, welcher für Ihren Anwendungsfall am besten geeignet ist.

## Von Grafana verwaltete Regeln
<a name="v10-alerting-explore-rule-types-grafana"></a>

Von Grafana verwaltete Regeln sind der flexibelste Warnregeltyp. Sie ermöglichen es Ihnen, Benachrichtigungen zu erstellen, die auf Daten aus jeder Ihrer vorhandenen Datenquellen reagieren können.

Sie unterstützen nicht nur mehrere Datenquellen, sondern können auch [Ausdrücke](v10-panels-query-xform-expressions.md) hinzufügen, um Ihre Daten zu transformieren und Warnbedingungen auszudrücken.

In Grafana verwaltete Benachrichtigungen:
+ Warnungsregeln werden in Grafana auf der Grundlage einer oder mehrerer Datenquellen erstellt.
+ Warnungsregeln werden von der Engine zur Bewertung von Alert-Regeln in Grafana ausgewertet.
+ Alerts werden mit dem internen Grafana-Alertmanager zugestellt.

**Anmerkung**  
Sie können Benachrichtigungen auch so konfigurieren, dass sie mit einem externen Alertmanager zugestellt werden, oder Sie können sowohl interne als auch externe Alertmanager verwenden. Weitere Informationen finden Sie unter Einen externen Alertmanager [hinzufügen](v10-alerting-setup-alertmanager.md).

## Regeln für verwaltete Datenquellen
<a name="v10-alerting-explore-rule-types-datasource"></a>

Um mit Datenquellen verwaltete Warnregeln 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.

Bei datenquellenverwalteten Warnmeldungen:
+ Warnungsregeln werden in der Datenquelle selbst erstellt und gespeichert.
+ Warnungsregeln können nur auf der Grundlage von Prometheus-Daten erstellt werden.
+ Die Auswertung und Bereitstellung von Warnregeln erfolgt aus Gründen der Hochverfügbarkeit und Fehlertoleranz auf mehrere Knoten verteilt.

## Wählen Sie einen Warnungsregeltyp
<a name="v10-alerting-explore-rule-types-choose"></a>

Beachten Sie bei der Auswahl des zu verwendenden Warnungsregeltyps den folgenden Vergleich zwischen von Grafana verwalteten Warnungsregeln und datenquellenverwalteten Warnungsregeln.


| Feature | Von Grafana verwaltete Warnungsregel | Von Loki/Mimir verwaltete Warnungsregel | 
| --- | --- | --- | 
| Erstellen Sie Warnregeln auf der Grundlage von Daten aus einer unserer unterstützten Datenquellen | Ja | Nein: Sie können nur Warnungsregeln erstellen, die auf Prometheus-Daten basieren. Für die Datenquelle muss die Ruler-API aktiviert sein.  | 
| Datenquellen mischen und abgleichen | Ja | Nein | 
| Beinhaltet Unterstützung für Aufzeichnungsregeln | Nein | Ja | 
| Fügen Sie Ausdrücke hinzu, um Ihre Daten zu transformieren und Warnbedingungen festzulegen | Ja | Nein | 
| Verwenden Sie Bilder in Warnmeldungen | Ja | Nein | 
| Skalierung | Sie sind ressourcenintensiver, hängen von der Datenbank ab und können mit vorübergehenden Fehlern behaftet sein. Sie lassen sich nur vertikal skalieren. | Speichern Sie Warnregeln in der Datenquelle selbst und ermöglichen Sie eine „unendliche“ Skalierung. Generieren und versenden Sie Warnmeldungen vom Speicherort Ihrer Daten aus. | 
| Bewertung und Bereitstellung von Warnmeldungsregeln | Die Auswertung und Bereitstellung von Warnregeln erfolgt innerhalb von Grafana mit einem externen Alertmanager oder beidem. | Die Auswertung und Zustellung von Warnmeldungsregeln erfolgt verteilt, sodass es keine einzige Fehlerquelle gibt. | 

# Regeln für die Aufzeichnung
<a name="v10-alerting-explore-rule-recording"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

*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 Abfrage dieser neuen Zeitreihe ist schneller, insbesondere bei Dashboards, da bei jeder Aktualisierung der Dashboards derselbe Ausdruck abgefragt wird.

Lesen Sie mehr über die [Aufnahmeregeln](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/) in Prometheus.

# Anfragen und Bedingungen
<a name="v10-alerting-explore-rules-queries"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

In Grafana spielen Abfragen eine wichtige Rolle beim Abrufen und Transformieren von Daten aus unterstützten Datenquellen, zu denen Datenbanken wie MySQL und PostgreSQL, Zeitreihendatenbanken wie Prometheus, InfluxDB und Graphite sowie Dienste wie Amazon OpenSearch CloudWatch, Azure Monitor und Google Cloud Monitoring gehören.

Weitere Informationen zu unterstützten Datenquellen finden Sie unter. [Datenquellen und Grafana-Alerting](v10-alerting-overview-datasources.md)

Beim Ausführen einer Abfrage müssen Sie die Datenquelle definieren, die gewünschten Daten angeben, die abgerufen werden sollen, und die entsprechenden Filter oder Transformationen anwenden. Für die Erstellung dieser Abfragen werden Abfragesprachen oder Syntaxen verwendet, die für die gewählte Datenquelle spezifisch sind.

In Alerting definieren Sie eine Abfrage, um die Daten abzurufen, die Sie messen möchten, und eine Bedingung, die erfüllt sein muss, bevor eine Warnungsregel ausgelöst wird.

Eine Warnungsregel besteht aus einer oder mehreren Abfragen und Ausdrücken, die die Daten auswählen, die Sie messen möchten.

Weitere Informationen zu Abfragen und Ausdrücken finden Sie unter[Daten abfragen und transformieren](v10-panels-query-xform.md).

## Datenquellenabfragen
<a name="v10-alerting-explore-rules-queries-data-source-queries"></a>

Abfragen in Grafana können je nach verwendeter Datenquelle und Abfragesprache auf verschiedene Arten angewendet werden. 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.

Zu den gängigen Typen von Abfragekomponenten gehören: 

**Metriken oder Datenfelder** — Geben Sie die spezifischen Metriken oder Datenfelder an, die Sie abrufen möchten, z. B. CPU-Auslastung, Netzwerkverkehr oder Sensorwerte.

**Zeitraum** — Definieren Sie den Zeitraum, für den Sie Daten abrufen möchten, z. B. die letzte Stunde, einen bestimmten Tag oder einen benutzerdefinierten Zeitraum.

**Filter** — Wenden Sie Filter an, um die Daten anhand bestimmter Kriterien einzugrenzen, z. B. das Filtern von Daten nach einem bestimmten Tag, Host oder einer bestimmten Anwendung.

**Aggregationen** — Führen Sie Aggregationen der Daten durch, um Kennzahlen wie Durchschnittswerte, Summen oder Zahlen über einen bestimmten Zeitraum zu berechnen.

**Gruppierung — Gruppieren** Sie die Daten nach bestimmten Dimensionen oder Tags, um aggregierte Ansichten oder Aufschlüsselungen zu erstellen.

**Anmerkung**  
Grafana unterstützt keine Warnabfragen mit Vorlagenvariablen. Weitere Informationen finden [Sie hier](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514) in den Grafana Labs-Foren.

## Ausdrucksabfragen
<a name="v10-alerting-explore-rules-queries-expression-queries"></a>

In Grafana wird ein Ausdruck verwendet, um Berechnungen, Transformationen oder Aggregationen an den abgefragten Daten der Datenquelle durchzuführen. Es ermöglicht Ihnen, benutzerdefinierte Metriken zu erstellen oder bestehende Metriken auf der Grundlage mathematischer Operationen, Funktionen oder logischer Ausdrücke zu ändern.

Mithilfe von Ausdrucksabfragen können Benutzer Aufgaben wie die Berechnung der prozentualen Änderung zwischen zwei Werten, die Anwendung von Funktionen wie logarithmischen oder trigonometrischen Funktionen, die Aggregation von Daten über bestimmte Zeitbereiche oder Dimensionen und die Implementierung bedingter Logik zur Behandlung verschiedener Szenarien ausführen.

In Alerting können Sie nur Ausdrücke für von Grafana verwaltete Warnungsregeln verwenden. Für jeden Ausdruck können Sie aus den Mathe-, Reduce- und Resampling-Ausdrücken wählen. Diese Regeln werden als multidimensionale Regeln bezeichnet, da sie für jede Serie eine separate Warnung generieren.

Sie können auch eine klassische Bedingung verwenden, bei der eine Warnungsregel erstellt wird, die eine einzelne Warnung auslöst, wenn ihre Bedingung erfüllt ist. Infolgedessen sendet Grafana nur eine einzige Warnung, selbst wenn die Alarmbedingungen für mehrere Serien erfüllt sind.

**Anmerkung**  
Klassische Bedingungen existieren hauptsächlich aus Kompatibilitätsgründen und sollten nach Möglichkeit vermieden werden.

**Reduzieren**

Aggregiert Zeitreihenwerte im ausgewählten Zeitbereich zu einem einzigen Wert.

**Math (Mathematik)**

Führt Berechnungen functions/operations in freier Form mit Zeitreihen- und Zahlendaten durch. Kann zur Vorverarbeitung von Zeitreihendaten oder zur Definition einer Warnbedingung für Zahlendaten verwendet werden.

**Resampling**

Ordnet einen Zeitbereich einem neuen Satz von Zeitstempeln neu zu. Dies ist nützlich, wenn Zeitreihendaten aus verschiedenen Datenquellen verglichen werden, bei denen die Zeitstempel sonst nicht übereinstimmen würden.

**Threshold**

Überprüft, ob Zeitreihendaten der Schwellenwertbedingung entsprechen.

Mit dem Schwellenwertausdruck können Sie zwei Einzelwerte vergleichen. Er kehrt zurück`0`, wenn die Bedingung falsch ist und `1` wenn die Bedingung wahr ist. Die folgenden Schwellenwertfunktionen sind verfügbar:
+ Liegt über (x > y)
+ Liegt darunter (x < y)
+ Liegt darunter (x y1 UND x < y2)
+ < y1 AND x >Liegt außerhalb des Bereichs (x y2)

**Klassischer Zustand**

Überprüft, ob Zeitreihendaten der Warnbedingung entsprechen.

**Anmerkung**  
Klassische Abfragen mit Bedingungsausdrücken erzeugen immer nur eine Warnungsinstanz, unabhängig davon, wie viele Zeitreihen die Bedingung erfüllen. Klassische Bedingungen existieren hauptsächlich aus Kompatibilitätsgründen und sollten nach Möglichkeit vermieden werden.

## Aggregationen
<a name="v10-alerting-explore-rules-queries-aggregations"></a>

Grafana Alerting bietet die folgenden Aggregationsfunktionen, mit denen Sie Ihre Abfrage weiter verfeinern können.

Diese Funktionen sind nur für **Bedingungsausdrücke vom **Typ Reduce** und Classic** verfügbar.


| Funktion | Expression | Was macht es | 
| --- | --- | --- | 
| avg | Reduzieren//Klassisch | Zeigt den Durchschnitt der Werte an | 
| min | Reduzieren//Klassisch | Zeigt den niedrigsten Wert an | 
| max | Reduzieren//Klassisch | Zeigt den höchsten Wert an | 
| sum | Reduzieren//Klassisch | Zeigt die Summe aller Werte an | 
| count | Reduzieren//Klassisch | Zählt die Anzahl der Werte im Ergebnis | 
| last | Reduzieren//Klassisch | Zeigt den letzten Wert an | 
| median | Reduzieren//Klassisch | Zeigt den Medianwert an | 
| diff | Classic | Zeigt den Unterschied zwischen dem neuesten und dem ältesten Wert an | 
| diff\$1abs | Classic | Zeigt den absoluten Wert von diff an | 
| percent\$1diff | Classic | Zeigt den prozentualen Wert der Differenz zwischen dem neuesten und dem ältesten Wert an | 
| percent\$1diff\$1abs | Classic | Zeigt den absoluten Wert von percent\$1diff an | 
| count\$1non\$1null | Classic | Zeigt die Anzahl der Werte in der Ergebnismenge an, die dies nicht sind null | 

## Warnungsbedingung
<a name="v10-alerting-explore-rules-queries-alert-condition"></a>

Eine Warnbedingung ist die Abfrage oder der Ausdruck, der bestimmt, ob die Warnung ausgelöst wird oder nicht, je nachdem, welchen Wert sie liefert. Es kann nur eine Bedingung geben, die bestimmt, ob die Warnung ausgelöst wird.

Nachdem Sie Ihre and/or Abfrageausdrücke definiert haben, wählen Sie einen davon als Bedingung für die Warnungsregel aus.

Wenn die abgefragten Daten die definierte Bedingung erfüllen, löst Grafana die zugehörige Warnung aus, die so konfiguriert werden kann, dass Benachrichtigungen über verschiedene Kanäle wie E-Mail, Slack oder gesendet werden. PagerDuty Die Benachrichtigungen informieren Sie darüber, dass die Bedingung erfüllt ist, sodass Sie geeignete Maßnahmen ergreifen oder das zugrunde liegende Problem untersuchen können.

Standardmäßig wird der zuletzt hinzugefügte Ausdruck als Warnbedingung verwendet.

## Schwellenwert für die Wiederherstellung
<a name="v10-alerting-explore-rules-queries-recovery-threshold"></a>

Um das Geräusch flackernder Warnmeldungen zu reduzieren, können Sie einen Schwellenwert für die Wiederherstellung festlegen, der sich vom Schwellenwert für Warnmeldungen unterscheidet.

Flatternde Alerts treten auf, wenn eine Metrik über dem Schwellenwert liegt. Dies kann zu häufigen Statusänderungen führen, sodass zu viele Benachrichtigungen generiert werden.

Von Grafana verwaltete Warnregeln werden für ein bestimmtes Zeitintervall ausgewertet. Bei jeder Auswertung wird das Ergebnis der Abfrage mit dem in der Warnungsregel festgelegten Schwellenwert verglichen. Wenn der Wert einer Metrik über dem Schwellenwert liegt, wird eine Warnungsregel ausgelöst und eine Benachrichtigung gesendet. Wenn der Wert unter den Schwellenwert fällt und eine aktive Warnung für diese Metrik vorliegt, wird die Warnung behoben und eine weitere Benachrichtigung gesendet.

Es kann schwierig sein, eine Warnungsregel für eine verrauschte Metrik zu erstellen. Das heißt, wenn der Wert einer Metrik kontinuierlich einen Schwellenwert über- und unterschreitet. Dies wird als Flattern bezeichnet und führt zu einer Reihe von Benachrichtigungen über das Auslösen von Auslösen und zu einer fehlerhaften Statushistorie der Warnmeldungen.

Wenn Sie beispielsweise eine Latenzwarnung mit einem Schwellenwert von 1000 ms haben und die Zahl um 1000 schwankt (sagen wir 980 ->1010 -> 990 -> 1020 usw.), löst jede dieser Alarme eine Benachrichtigung aus.

Um dieses Problem zu lösen, können Sie einen (benutzerdefinierten) Wiederherstellungsschwellenwert festlegen, was im Grunde bedeutet, dass Sie zwei Schwellenwerte anstelle von einem haben. Eine Warnung wird ausgelöst, wenn der erste Schwellenwert überschritten wird, und sie wird erst behoben, wenn der zweite Schwellenwert überschritten wird.

Sie könnten beispielsweise einen Schwellenwert von 1000 ms und einen Wiederherstellungsschwellenwert von 900 ms festlegen. Auf diese Weise hört eine Warnregel erst auf, wenn sie unter 900 ms fällt, und das Flattern wird reduziert.

# Warnungsinstanzen
<a name="v10-alerting-rules-instances"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

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 wir nach der ersten Auswertung beobachten, sodass eine einzige Regel den Status jeder CPU melden kann.

# Namespaces, Ordner und Gruppen
<a name="v10-alerting-rules-grouping"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

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 und Ordner**

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.

Ein Namespace enthält eine oder mehrere Gruppen. Die Regeln innerhalb einer Gruppe werden sequentiell in regelmäßigen Abständen ausgeführt. Das Standardintervall ist eine Minute. Sie können die Namespaces und Gruppen für Grafana Mimi- oder Loki-Regeln umbenennen und die Bewertungsintervalle für Gruppen bearbeiten.

**Gruppen**

Die Regeln innerhalb einer Gruppe werden nacheinander in regelmäßigen Intervallen ausgeführt, was bedeutet, dass keine Regeln gleichzeitig und in der Reihenfolge ihres Auftretens ausgewertet werden. Das Standardintervall ist eine Minute. Sie können Grafana Mimir- oder Loki-Regelnamespaces oder Loki-Regelnamespaces und -gruppen umbenennen und die Gruppenauswertungsintervalle bearbeiten.

**Tipp**  
Wenn Sie möchten, dass Regeln gleichzeitig und mit unterschiedlichen Intervallen ausgewertet werden, sollten Sie erwägen, sie in verschiedenen Gruppen zu speichern.

**Anmerkung**  
Von Grafana verwaltete Warnungsregeln werden gleichzeitig und nicht sequentiell ausgewertet.

# Evaluierung von Warnmeldungsregeln
<a name="v10-alerting-rules-evaluation"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Verwenden Sie die Auswertung von Warnungsregeln, um zu bestimmen, wie oft eine Warnungsregel ausgewertet werden sollte und wie schnell sie ihren Status ändern sollte.

Dazu müssen Sie sicherstellen, dass sich Ihre Warnungsregel in der richtigen Bewertungsgruppe befindet, und einen Wartezeitraum festlegen, der für Ihren Anwendungsfall am besten geeignet ist.

## Bewertungsgruppe
<a name="v10-alerting-rules-evaluation-group"></a>

Jede Warnungsregel ist Teil einer Bewertungsgruppe. Jede Bewertungsgruppe enthält ein Bewertungsintervall, das bestimmt, wie oft die Warnungsregel überprüft wird.

**Von Datenquellen verwaltete** Warnungsregeln innerhalb derselben Gruppe werden nacheinander ausgewertet, während Warnungsregeln in verschiedenen Gruppen gleichzeitig ausgewertet werden können. Diese Funktion ist besonders nützlich, wenn Sie sicherstellen möchten, dass Aufzeichnungsregeln vor allen Warnungsregeln ausgewertet werden.

**Von Grafana verwaltete** Warnungsregeln werden unabhängig von der Warnungsregelgruppe gleichzeitig ausgewertet. Das Standardauswertungsintervall ist auf 10 Sekunden festgelegt, was bedeutet, dass von Grafana verwaltete Warnungsregeln alle 10 Sekunden bis zum nächsten 10-Sekunden-Fenster auf der Uhr ausgewertet werden, zum Beispiel 10:00:00, 10:00:10, 10:00:20 usw. Bei Bedarf können Sie auch Ihr eigenes Bewertungsintervall konfigurieren.

**Anmerkung**  
Bewertungsgruppen und die Gruppierung von Warnmeldungen in Benachrichtigungsrichtlinien sind zwei verschiedene Dinge. Durch die Gruppierung nach Benachrichtigungsrichtlinien können mehrere Warnmeldungen mit denselben Labels in derselben Zeitnachricht gesendet werden.

## Ausstehender Zeitraum
<a name="v10-alerting-rules-evaluation-pending-period"></a>

Indem Sie einen Wartezeitraum festlegen, können Sie unnötige Benachrichtigungen bei vorübergehenden Problemen vermeiden.

In der Wartezeit wählen Sie den Zeitraum aus, in dem eine Warnungsregel gegen die Bedingung verstoßen kann, bis sie ausgelöst wird.

**Beispiel**

Stellen Sie sich vor, Sie haben ein Bewertungsintervall für die Warnungsregel auf alle 30 Sekunden und die Wartezeit auf 90 Sekunden festgelegt.

Die Auswertung erfolgt wie folgt:

[00:30] Erste Bewertung — Bedingung nicht erfüllt.

[01:00] Zweite Bewertung — Bedingung verletzt. Der Zähler für ausstehende Zahlungen wird gestartet. **Die Warnung beginnt ausstehend.**

[01:30] Dritte Bewertung — Bedingung verletzt. Ausstehender Zähler = 30 Sekunden. **Status „Ausstehend“.**

[02:00] Vierte Bewertung — Bedingung verletzt. **Zähler „Ausstehend“ = Status „60 Sekunden ausstehend“.**

[02:30] Fünfte Bewertung — Bedingung verletzt. Ausstehender Zähler = 90 Jahre. **Der Alarm wird ausgelöst**

Wenn die Warnungsregel eine Bedingung hat, die für einen bestimmten Zeitraum verletzt werden muss, bevor sie aktiv wird, ändert sich ihr Status wie folgt:
+ Wenn die Bedingung zum ersten Mal verletzt wird, wechselt die Regel in den Status „Ausstehend“.
+ Die Regel verbleibt im Status „ausstehend“, bis die Bedingung für den erforderlichen Zeitraum nicht eingehalten wurde (Wartezeit).
+ Sobald die erforderliche Zeit verstrichen ist, wechselt die Regel in den Status „Auslösung“.
+ Wenn die Bedingung während der Wartezeit nicht mehr verletzt wird, kehrt die Regel in ihren normalen Zustand zurück.

**Anmerkung**  
Wenn Sie den Status „Ausstehend“ überspringen möchten, können Sie den Wartezeitraum einfach auf 0 setzen. Dadurch wird die Wartezeit praktisch übersprungen und Ihre Warnungsregel wird ausgelöst, sobald die Bedingung verletzt wird.

Wenn eine Warnungsregel ausgelöst wird, werden Warnungsinstanzen erzeugt, die dann an den Alertmanager gesendet werden.

# Stand und Zustand der Warnregeln
<a name="v10-alerting-explore-state"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Der Status und der Zustand der 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. | 

**Letzten Status beibehalten**

Eine Warnungsregel kann so konfiguriert werden, dass der letzte Status beibehalten wird, wenn `NoData` der letzte `Error` Status erreicht wird. Dadurch wird sowohl verhindert, dass Warnmeldungen ausgelöst werden, als auch, dass sie behoben und erneut ausgelöst werden. Genau wie bei der normalen Evaluierung wird die Warnungsregel von `Pending` zu `Firing` nach Ablauf der Wartezeit umgestellt.

**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.

# Vorlagen für Benachrichtigungen
<a name="v10-alerting-rules-notification-templates"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

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](v10-alerting-manage-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.

# Alert-Manager
<a name="v10-alerting-explore-alertmanager"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

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 Alerts generiert werden.

**Grafana Alarmmanager**

Grafana Alertmanager ist ein interner Alertmanager, der vorkonfiguriert ist und standardmäßig zur Auswahl steht.

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.

# Kontaktstellen
<a name="v10-alerting-explore-contacts"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

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. Ein Kontaktpunkt könnte beispielsweise eine Pagerduty-Integration, eine Amazon SNS- und Slack-Integration oder eine Pagerduty-Integration, eine Slack-Integration und zwei Amazon SNS-Integrationen enthalten. Sie können auch eine Kontaktstelle 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.

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 [Kontaktpunkte konfigurieren](v10-alerting-configure-contactpoints.md) und[Benachrichtigungen anpassen](v10-alerting-manage-notifications.md).

# Benachrichtigungen
<a name="v10-alerting-explore-notifications"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

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](v10-alerting-explore-contacts.md), die festlegen, wohin Ihre Warnmeldungen gesendet werden sollen. Eine Kontaktstelle besteht aus einer oder mehreren Integrationen, die zur Übermittlung von Benachrichtigungen verwendet werden. Fügen Sie Benachrichtigungsvorlagen zu Kontaktpunkten hinzu, um sie wiederzuverwenden und die Nachrichtenübermittlung in Ihren Benachrichtigungen einheitlich zu gestalten.

Als Nächstes erstellen Sie eine Benachrichtigungsrichtlinie, bei der es sich um eine Reihe von Regeln handelt, die festlegen, 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.

## Alert-Manager
<a name="v10-alerting-explore-notifications-alertmanager"></a>

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="v10-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 Standardrichtlinie bezeichnet wird. Es kann nur eine Standardrichtlinie geben, und die Standardrichtlinie 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 verschachtelte Richtlinie kann über eigene verschachtelte Richtlinien verfügen, die eine zusätzliche Zuordnung von Warnmeldungen ermöglichen. Ein Beispiel für eine verschachtelte Richtlinie könnte das Senden von Infrastrukturwarnungen an das Ops-Team sein, während eine untergeordnete Richtlinie Warnmeldungen 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 Standardrichtlinie. Wenn die Standardrichtlinie jedoch eine Warnung erhält, überprüft sie jede verschachtelte Richtlinie und sendet die Warnung an die erste verschachtelte Richtlinie, die der Warnung entspricht. Wenn die verschachtelte Richtlinie weitere verschachtelte Richtlinien enthält, kann sie versuchen, die Warnung mit einer ihrer verschachtelten Richtlinien abzugleichen. Wenn keine verschachtelten Richtlinien mit der Warnung übereinstimmen, ist die Richtlinie selbst die entsprechende Richtlinie. Wenn keine verschachtelten Richtlinien vorhanden sind oder keine verschachtelten Richtlinien mit der Warnung übereinstimmen, ist die Standardrichtlinie die entsprechende Richtlinie.

Ausführlichere Informationen zu Benachrichtigungsrichtlinien finden Sie unter. [Richtlinien für Benachrichtigungen](v10-alerting-explore-notifications-policies-details.md)

## Vorlagen für Benachrichtigungen
<a name="v10-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“.

Ausführlichere Informationen zum Anpassen von Benachrichtigungen finden Sie unter. [Benachrichtigungen anpassen](v10-alerting-manage-notifications.md)

## Stille
<a name="v10-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.

Ausführlichere Informationen zur Verwendung von Stille finden Sie unter[Warnmeldungen stummschalten](v10-alerting-silences.md).

# Richtlinien für Benachrichtigungen
<a name="v10-alerting-explore-notifications-policies-details"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Benachrichtigungsrichtlinien bieten Ihnen eine flexible Möglichkeit, Benachrichtigungen an verschiedene Empfänger weiterzuleiten. Mithilfe von Label-Matchern können Sie die Zustellung von Warnmeldungen ändern, ohne jede einzelne Warnungsregel aktualisieren zu müssen.

In diesem Abschnitt erfahren Sie mehr darüber, wie Benachrichtigungsrichtlinien funktionieren und strukturiert sind, sodass Sie das Beste aus der Einrichtung Ihrer Benachrichtigungsrichtlinien herausholen können.

## Richtlinienbaum
<a name="v10-alerting-explore-notifications-policy-tree"></a>

Bei Benachrichtigungsrichtlinien handelt es sich *nicht* um eine Liste, sondern um eine Baumstruktur. Das bedeutet, dass jede Richtlinie untergeordnete Richtlinien haben kann usw. Das Stammverzeichnis der Benachrichtigungsrichtlinienstruktur wird als **Standardbenachrichtigungsrichtlinie** bezeichnet.

Jede Richtlinie besteht aus einer Reihe von Label-Matchern (0 oder mehr), die angeben, mit welchen Labels sie umgehen möchten oder nicht.

Weitere Informationen zum Label-Abgleich finden Sie unter[So funktioniert der Labelabgleich](v10-alerting-overview-labels-matching.md).

**Anmerkung**  
Wenn Sie keine Label-Matcher für Ihre Benachrichtigungsrichtlinie konfiguriert haben, entspricht Ihre Benachrichtigungsrichtlinie *allen* Warnungsinstanzen. Dadurch können Richtlinien für Kinder möglicherweise nicht bewertet werden, es sei denn, Sie haben in der Benachrichtigungsrichtlinie die Option **Gleichgeschlechtsabgleich fortsetzen** aktiviert.

## Routing
<a name="v10-alerting-explore-notifications-routing"></a>

Um zu bestimmen, welche Benachrichtigungsrichtlinie für welche Warnungsinstanzen zuständig ist, müssen Sie sich zunächst die vorhandenen Benachrichtigungsrichtlinien ansehen, beginnend mit der Standardbenachrichtigungsrichtlinie.

Wenn keine anderen Richtlinien als die Standardrichtlinie konfiguriert sind, verwaltet die Standardrichtlinie die Warnungsinstanz.

Wenn andere Richtlinien als die Standardrichtlinie definiert sind, werden diese Benachrichtigungsrichtlinien in der Reihenfolge bewertet, in der sie angezeigt werden.

Wenn eine Benachrichtigungsrichtlinie Label-Matcher hat, die mit den Bezeichnungen der Warnungsinstanz übereinstimmen, wird sie zu ihren untergeordneten Richtlinien übergehen und, falls vorhanden, weiterhin nach untergeordneten Richtlinien suchen, die möglicherweise Label-Matcher haben, die die Gruppe der Bezeichnungen weiter einschränken, usw., bis keine untergeordneten Richtlinien mehr gefunden wurden.

Wenn in einer Benachrichtigungsrichtlinie keine untergeordneten Richtlinien definiert sind oder wenn keine der untergeordneten Richtlinien Label-Matcher hat, die den Labels der Warnungsinstanz entsprechen, wird die übergeordnete Benachrichtigungsrichtlinie verwendet.

Sobald eine passende Richtlinie gefunden wurde, sucht das System nicht weiter nach anderen passenden Richtlinien. Wenn Sie weiterhin nach anderen Richtlinien suchen möchten, die möglicherweise übereinstimmen, aktivieren **Sie Weiter nach gleichgeordneten Richtlinien für** diese bestimmte Richtlinie abgleichen.

Wenn keine der Benachrichtigungsrichtlinien ausgewählt ist, wird schließlich die Standardbenachrichtigungsrichtlinie verwendet.

### Beispiel für Routing
<a name="v10-alerting-explore-notifications-routing-example"></a>

Hier ist ein Beispiel für einen relativ einfachen Benachrichtigungsrichtlinienbaum und einige Warnungsinstanzen.

![\[Ein Bild zeigt eine Reihe von Benachrichtigungsrichtlinien in einer Baumstruktur und eine Reihe von Warnungsinstanzen mit unterschiedlichen Bezeichnungen, die den Richtlinien entsprechen.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/notification-routing.png)


Im Folgenden finden Sie eine Aufschlüsselung, wie diese Richtlinien ausgewählt werden:

**Pod stuck in CrashLoop** hat kein `severity` Label, sodass keine der untergeordneten Richtlinien übereinstimmt. Es hat ein `team=operations` Label, sodass die erste Richtlinie zugeordnet ist.

Die `team=security` Richtlinie wird nicht evaluiert, da wir bereits eine Übereinstimmung gefunden haben und **„Mit gleichgestellten Personen fortfahren**“ für diese Richtlinie nicht konfiguriert wurde.

**Festplattennutzung — 80%** haben sowohl ein als auch ein `severity` Label `team` und entsprechen einer untergeordneten Richtlinie des Betriebsteams.

**Unautorisierte Protokolleinträge** haben eine `team` Bezeichnung, stimmen aber nicht mit der ersten Richtlinie (`team=operations`) überein, da die Werte nicht identisch sind. Daher wird die Suche fortgesetzt und der `team=security` Richtlinie entspricht. Da es keine untergeordneten Richtlinien gibt, wird das zusätzliche `severity=high` Label ignoriert.

## Vererbung
<a name="v10-alerting-explore-notifications-inheritance"></a>

Untergeordnete Richtlinien sind nicht nur ein nützliches Konzept für die Weiterleitung von Warnungsinstanzen, sondern übernehmen auch Eigenschaften von ihrer übergeordneten Richtlinie. Dies gilt auch für alle Richtlinien, bei denen es sich um untergeordnete Richtlinien der Standardbenachrichtigungsrichtlinie handelt.

Die folgenden Eigenschaften werden an untergeordnete Richtlinien vererbt:
+ Kontaktstelle
+ Gruppierungsoptionen
+ Zeitliche Optionen
+ Timings stummschalten

Jede dieser Eigenschaften kann durch eine individuelle Richtlinie überschrieben werden, falls Sie die geerbten Eigenschaften überschreiben möchten.

Wenn Sie eine Kontaktstelle aus der übergeordneten Richtlinie übernehmen möchten, lassen Sie das Feld leer. Um die vererbten Gruppierungsoptionen zu überschreiben, aktivieren Sie Gruppierung **überschreiben**. Um die geerbten Zeitoptionen zu überschreiben, aktivieren Sie die Option **Allgemeine Zeitangaben überschreiben**.

### Beispiel für Vererbung
<a name="v10-alerting-explore-notifications-inheritance-example"></a>

Das folgende Beispiel zeigt, wie der Benachrichtigungsrichtlinienbaum aus unserem vorherigen Beispiel es den untergeordneten Richtlinien von ermöglicht, ihren Kontaktpunkt `team=operations` zu erben.

Auf diese Weise können wir vermeiden, dass dieselbe Kontaktstelle für jede Kinderrichtlinie mehrmals angegeben werden muss.

![\[Ein Bild, das eine Reihe von Benachrichtigungsrichtlinien in einer Baumstruktur zeigt, wobei einigen Richtlinien Kontaktstellen zugewiesen sind, einige Richtlinien für Kinder jedoch die Kontaktstellen ihrer Eltern erben, anstatt ihre eigenen zu definieren.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/notification-inheritance.png)


## Zusätzliche Konfigurationsoptionen
<a name="v10-alerting-explore-notifications-additional-configuration-options"></a>

### Gruppierung
<a name="v10-alerting-explore-notifications-grouping"></a>

Die Gruppierung ist eine wichtige Funktion von Grafana Alerting, da Sie damit relevante Benachrichtigungen zu einer kleineren Anzahl von Benachrichtigungen zusammenfassen können. Dies ist besonders wichtig, wenn Benachrichtigungen an Ersthelfer gesendet werden, z. B. an Techniker auf Abruf, bei denen der Erhalt vieler Benachrichtigungen in kurzer Zeit überwältigend sein kann und sich in einigen Fällen negativ auf die Fähigkeit eines Ersthelfers auswirken kann, auf einen Vorfall zu reagieren. Stellen Sie sich zum Beispiel einen großen Ausfall vor, bei dem viele Ihrer Systeme ausgefallen sind. In diesem Fall kann die Gruppierung den Unterschied zwischen dem Empfang eines Telefonanrufs und 100 Telefonanrufen ausmachen.

Mithilfe der Option Gruppieren nach in einer Benachrichtigungsrichtlinie legen Sie fest, wie Benachrichtigungen gruppiert werden. Standardmäßig gruppieren Benachrichtigungsrichtlinien in Grafana-Benachrichtigungen nach Warnungsregeln mithilfe der `grafana_folder` Bezeichnungen `alertname` und (da Warnungsnamen in mehreren Ordnern nicht eindeutig sind). Wenn Sie Benachrichtigungen nach etwas anderem als der Warnungsregel gruppieren möchten, ändern Sie die Gruppierung in eine andere Kombination von Bezeichnungen.

#### Deaktivieren Sie die Gruppierung
<a name="v10-alerting-explore-notifications-disable-grouping"></a>

Wenn Sie jede Warnung als separate Benachrichtigung erhalten möchten, können Sie dies tun, indem Sie sie nach einem speziellen Label namens gruppieren. `...` Dies ist nützlich, wenn Ihre Benachrichtigungen an ein automatisiertes System und nicht an einen Ersthelfer gesendet werden.

#### Eine einzige Gruppe für alle Benachrichtigungen
<a name="v10-alerting-explore-notifications-a-single-group-for-all-alerts"></a>

Wenn Sie alle Benachrichtigungen zusammen in einer einzigen Benachrichtigung erhalten möchten, können Sie dies tun, indem Sie Group by leer lassen.

### Zeitliche Optionen
<a name="v10-alerting-explore-notifications-timing-options"></a>

Die Zeitoptionen bestimmen, wie oft Benachrichtigungen für jede Gruppe von Benachrichtigungen gesendet werden. Es gibt drei Timer, über die Sie Bescheid wissen müssen: Gruppenwartezeit, Gruppenintervall und Wiederholungsintervall.

#### Wartezeit für Gruppen
<a name="v10-alerting-explore-notifications-group-wait"></a>

Gruppenwartezeit ist die Zeit, die Grafana wartet, bevor die erste Benachrichtigung für eine neue Gruppe von Benachrichtigungen gesendet wird. Je länger die Gruppe wartet, desto mehr Zeit haben Sie, bis andere Benachrichtigungen eintreffen. Je kürzer die Wartezeit für Gruppen ist, desto früher wird die erste Benachrichtigung gesendet, es besteht jedoch die Gefahr, dass unvollständige Benachrichtigungen gesendet werden. Sie sollten immer eine Wartezeit für Gruppen wählen, die für Ihren Anwendungsfall am sinnvollsten ist.

**Die Standardeinstellung** beträgt 30 Sekunden

#### Gruppenintervall
<a name="v10-alerting-explore-notifications-group-interval"></a>

Sobald die erste Benachrichtigung für eine neue Gruppe von Benachrichtigungen gesendet wurde, startet Grafana den Gruppenintervall-Timer. Dies ist die Zeit, die Grafana wartet, bevor sie Benachrichtigungen über Änderungen an die Gruppe sendet. Beispielsweise wurde der Gruppe möglicherweise gerade ein weiterer Auslösealarm hinzugefügt, während ein vorhandener Alarm möglicherweise behoben wurde. Wenn eine Warnung aufgrund einer Wartezeit in der Gruppe zu spät war, um in die erste Benachrichtigung aufgenommen zu werden, wird sie nach Ablauf des Gruppenintervalls in nachfolgende Benachrichtigungen aufgenommen. Nach Ablauf des Gruppenintervalls setzt Grafana den Gruppenintervall-Timer zurück. Dies wiederholt sich, bis keine Benachrichtigungen mehr in der Gruppe vorhanden sind. Danach wird die Gruppe gelöscht.

**Standard** 5 Minuten

#### Intervall wiederholen
<a name="v10-alerting-explore-notifications-repeat-interval"></a>

Das Wiederholungsintervall bestimmt, wie oft Benachrichtigungen wiederholt werden, wenn sich die Gruppe seit der letzten Benachrichtigung nicht geändert hat. Sie können sich diese als Erinnerung daran vorstellen, dass einige Benachrichtigungen immer noch ausgelöst werden. Das Wiederholungsintervall steht in engem Zusammenhang mit dem Gruppenintervall. Das bedeutet, dass Ihr Wiederholungsintervall nicht nur größer oder gleich dem Gruppenintervall sein muss, sondern auch ein Vielfaches des Gruppenintervalls sein muss. Wenn das Wiederholungsintervall kein Vielfaches des Gruppenintervalls ist, wird es zu Eins gezwungen. Wenn Ihr Gruppenintervall beispielsweise 5 Minuten und Ihr Wiederholungsintervall 9 Minuten beträgt, wird das Wiederholungsintervall auf das nächste Vielfache von 5 aufgerundet, das 10 Minuten ist.

**Die Standardeinstellung** ist 4 Stunden

# Warnung bei hoher Verfügbarkeit
<a name="v10-alerting-explore-high-availability"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Amazon Managed Grafana ist für Hochverfügbarkeit konfiguriert, einschließlich der Ausführung mehrerer Instances in mehreren Availability Zones für jeden Workspace, den Sie erstellen.

Grafana Alerting verwendet das Prometheus-Modell, bei dem die Bewertung von Warnregeln von der Zustellung von Benachrichtigungen getrennt wird. In diesem Modell erfolgt die Auswertung der Warnungsregeln im Alert-Generator und die Zustellung von Benachrichtigungen im Alert-Empfänger. In Grafana Alerting ist der Alert-Generator der Scheduler und der Empfänger der Alertmanager.

Bei Hochverfügbarkeitskonfigurationen werden alle Alert-Regeln auf allen Instanzen ausgewertet. Sie können sich die Auswertung von Warnungsregeln als Duplikat vorstellen. Auf diese Weise stellt Grafana Alerting sicher, dass, solange mindestens eine Grafana-Instanz funktioniert, die Warnungsregeln weiterhin ausgewertet und Benachrichtigungen für Alerts weiterhin gesendet werden. Sie werden diese Duplikation in der Statushistorie sehen. Dies ist eine gute Methode, um festzustellen, ob Sie Hochverfügbarkeit verwenden.

# Alerting einrichten
<a name="v10-alerting-setup"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Konfigurieren Sie die Funktionen und Integrationen, die Sie zum Erstellen und Verwalten Ihrer Benachrichtigungen benötigen.

**Voraussetzungen**

Bevor Sie Benachrichtigungen einrichten, müssen Sie die folgenden Schritte ausführen.
+ Konfigurieren Sie Ihre [Datenquellen](AMG-data-sources.md).
+ Stellen Sie sicher, dass die von Ihnen gewählte Datenquelle mit [Grafana-Benachrichtigungen](v10-alerting-overview-datasources.md) kompatibel ist und von diesen unterstützt wird.

**Um Benachrichtigungen einzurichten**

1. Konfigurieren Sie [Warnungsregeln](v10-alerting-configure.md).
   + Erstellen Sie von Grafana verwaltete oder von Datenquellen verwaltete Warn- und Aufzeichnungsregeln.

1. [Kontaktpunkte konfigurieren.](v10-alerting-configure-contactpoints.md)
   + Überprüfen Sie die Standardkontaktstelle und aktualisieren Sie den Kontakt für Ihr System.
   + Fügen Sie optional neue Kontaktstellen und Integrationen hinzu.

1. Konfigurieren Sie [Benachrichtigungsrichtlinien](v10-alerting-explore-notifications-policies-details.md)
   + Überprüfen Sie die Standard-Benachrichtigungsrichtlinie und aktualisieren Sie sie für Ihr System.
   + Fügen Sie optional weitere verschachtelte Richtlinien hinzu.
   + Fügen Sie optional Labels und Label-Matcher hinzu, um die Weiterleitung von Warnmeldungen zu steuern.

In den folgenden Themen finden Sie weitere Informationen zu zusätzlichen Konfigurationsoptionen, einschließlich der Konfiguration externer Warnungsmanager und der Weiterleitung von von Grafana verwalteten Warnungen außerhalb von Grafana.

**Topics**
+ [Migration klassischer Dashboard-Benachrichtigungen zu Grafana-Benachrichtigungen](v10-alerting-use-grafana-alerts.md)
+ [Einen externen Alertmanager hinzufügen](v10-alerting-setup-alertmanager.md)
+ [Bereitstellung von Grafana-Alerting-Ressourcen](v10-alerting-setup-provision.md)

# Migration klassischer Dashboard-Benachrichtigungen zu Grafana-Benachrichtigungen
<a name="v10-alerting-use-grafana-alerts"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Arbeitsbereiche, die Grafana-Benachrichtigungen nicht verwenden möchten, verwenden die. [Klassische Dashboard-Benachrichtigungen](old-alerts-overview.md) Um zur neuen Grafana-Benachrichtigung zu wechseln, müssen Sie sich für die Funktion anmelden. Einzelheiten zu den Unterschieden zwischen klassischen Dashboard-Benachrichtigungen und Grafana-Benachrichtigungen finden Sie unter. [Grafana-Benachrichtigungen im Vergleich zu älteren Dashboard-Benachrichtigungen](#v10-alerting-diff-old-new) GrafanaLabs hat angekündigt, dass klassische Dashboard-Benachrichtigungen in Version 11 entfernt werden.

Wenn Sie klassische Dashboard-Benachrichtigungen verwenden, zeigt Ihnen Amazon Managed Grafana eine Vorschau von Grafana-Benachrichtigungen, in der Sie Ihre aktualisierten Benachrichtigungen überprüfen und ändern können, bevor Sie das Upgrade abschließen.

## Vorschau von Grafana-Benachrichtigungen
<a name="v10-alerting-preview-grafana-alerts"></a>

Sie können vor der Migration eine Vorschau Ihrer Benachrichtigungen in Grafana-Benachrichtigungen anzeigen. In der Vorschau können Sie Änderungen an den Benachrichtigungen vornehmen, die sich auf die Migration auswirken.

**Um eine Vorschau Ihrer Grafana-Alerting-Migration anzuzeigen**

1. Melden Sie sich in Ihrem Grafana-Workspace an.

1. Wählen Sie im linken Menü **Alerting (Legacy)**, um Ihre aktuellen Benachrichtigungen anzuzeigen.

1. Wählen Sie im linken Menü **Alerting Upgrade**, um Ihre Benachrichtigungen in Grafana-Benachrichtigungen anzuzeigen.

   In dieser Ansicht können Sie sehen, wie Ihre Benachrichtigungen nach der Migration aussehen werden.

**Anmerkung**  
In dieser Ansicht können Sie auch Änderungen vornehmen, die sich auf Ihre Migration auswirken. Um alle von Ihnen vorgenommenen Änderungen rückgängig zu machen, wählen Sie oben rechts auf der **Upgrade-Seite die Option Upgrade zurücksetzen**.

Wenn Sie bereit sind, Ihre Benachrichtigungen zu aktualisieren, lesen Sie den nächsten Abschnitt.

## Migration zum Grafana-Warnsystem
<a name="v10-alerting-use-grafana-alerts-opt-in"></a>

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)

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="v10-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.

## Grafana-Benachrichtigungen im Vergleich zu älteren Dashboard-Benachrichtigungen
<a name="v10-alerting-diff-old-new"></a>

Grafana-Benachrichtigungen wurden in Grafana 8 eingeführt und bieten mehrere Verbesserungen gegenüber älteren Dashboard-Benachrichtigungen.

### Mehrdimensionale Warnmeldungen
<a name="v10-alerts-diff-multi-dimensional"></a>

Sie können jetzt mit einer einzigen Warnregel Warnmeldungen erstellen, die Ihnen systemweite Transparenz bieten. Generieren Sie mehrere Warnungsinstanzen anhand einer einzigen Warnungsregel. Sie können beispielsweise eine Regel erstellen, um die Festplattennutzung mehrerer Mountpoints auf einem einzelnen Host zu überwachen. Die Evaluierungs-Engine gibt mehrere Zeitreihen aus einer einzigen Abfrage zurück, wobei jede Zeitreihe durch ihren Labelsatz identifiziert wird.

### Erstellen Sie Benachrichtigungen außerhalb von Dashboards
<a name="v10-alerts-diff-alerts-outside-of-dashboards"></a>

Im Gegensatz zu älteren Dashboard-Benachrichtigungen können Sie mit Grafana-Benachrichtigungen Abfragen und Ausdrücke erstellen, die Daten aus mehreren Quellen auf einzigartige Weise kombinieren. Sie können Dashboards und Panels weiterhin anhand ihrer ID mit Warnregeln verknüpfen und so schnell Fehler im beobachteten System beheben.

Da einheitliche Benachrichtigungen nicht mehr direkt mit Panel-Abfragen verknüpft sind, enthalten sie keine Bilder oder Abfragewerte in der Benachrichtigungs-E-Mail. Sie können benutzerdefinierte Benachrichtigungsvorlagen verwenden, um Abfragewerte anzuzeigen.

### Erstellen Sie Alarmregeln für Loki und Grafana Mimir
<a name="v10-alerts-diff-loki-mimir-alerting-rules"></a>

In Grafana Alerting können Sie die Alarmregeln von Loki und Grafana Mimir mithilfe derselben Benutzeroberfläche und API wie Ihre von Grafana verwalteten Benachrichtigungen verwalten.

### Benachrichtigungen aus Prometheus-kompatiblen Datenquellen anzeigen und danach suchen
<a name="v10-alerts-diff-view-alerts-from-prometheus"></a>

Benachrichtigungen für Prometheus-kompatible Datenquellen sind jetzt im Abschnitt Grafana-Benachrichtigungen aufgeführt. Sie können in mehreren Datenquellen nach Labels suchen, um schnell relevante Benachrichtigungen zu finden.

### Spezielle Benachrichtigungen für Alarmstatus NoData und Fehler
<a name="v10-alerts-diff-special-alerts"></a>

Grafana Alerting führte ein neues Konzept der Alarmzustände ein. Wenn die Auswertung einer Warnregel den Status NoData oder Fehler ergibt, generiert Grafana Alerting spezielle Warnungen mit den folgenden Bezeichnungen:
+ `alertname`mit Wert DatasourceNoData oder DatasourceError abhängig vom Status.
+ `rulename`Name der Warnungsregel, zu der die spezielle Warnung gehört.
+ `datasource_uid`wird die UID der Datenquelle haben, die den Status verursacht hat.
+ Alle Bezeichnungen und Anmerkungen der ursprünglichen Warnungsregel

Sie können diese Benachrichtigungen genauso behandeln wie normale Benachrichtigungen, indem Sie eine Stille, eine Route zu einem Kontaktpunkt usw. hinzufügen.

**Anmerkung**  
Wenn die Regel viele Datenquellen verwendet und eine oder mehrere keine Daten zurückgeben, wird die spezielle Warnung für jede Datenquelle erstellt, die den Warnstatus verursacht hat.

# Einen externen Alertmanager hinzufügen
<a name="v10-alerting-setup-alertmanager"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

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.

**Anmerkung**  
Sie können Amazon Managed Service for Prometheus nicht als externen Alertmanager verwenden.

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.

Externe Alertmanager werden mithilfe der Grafana-Konfiguration im Grafana-Hauptnavigationsmenü als Datenquellen konfiguriert. 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.

**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.

**Um einen externen Alertmanager hinzuzufügen**

1. Wählen Sie im linken Hauptmenü **Verbindungen** aus.

1. Suchen Sie nach `Alertmanager`.

1. Wählen Sie die Schaltfläche **Neue Datenquelle erstellen**.

1. 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. **Wählen Sie** Speichern und testen.

# Bereitstellung von Grafana-Alerting-Ressourcen
<a name="v10-alerting-setup-provision"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

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](v10-alerting-setup-provision-terraform.md)
+ [Bereitgestellte Alert-Ressourcen in Grafana anzeigen](v10-alerting-setup-provision-view.md)

# Erstellen und verwalten Sie Warnressourcen mit Terraform
<a name="v10-alerting-setup-provision-terraform"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Verwenden Sie 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 das Programm aus`terraform apply`, um Ihre Alarm-Ressourcen bereitzustellen.

## Voraussetzungen
<a name="v10-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="v10-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 für die 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="v10-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="v10-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 ihn *<slack-webhook-url>* durch deine Slack-Webhook-URL (oder andere Kontaktpunktdetails).

   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 den 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="v10-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 Alert-Stack 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="v10-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 Alert-Stack 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="v10-alerting-setup-provision-tf-rules"></a>

[Mit Warnungsregeln](v10-alerting-configure.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, in dem Sie Ihre Regeln speichern möchten.

   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="v10-alerting-setup-provision-view"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Sie können ü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.

# Warnmeldungen konfigurieren
<a name="v10-alerting-configure"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Konfigurieren Sie die Funktionen und Integrationen, die Sie zum Erstellen und Verwalten Ihrer Benachrichtigungen benötigen.

**Topics**
+ [Konfigurieren Sie die verwalteten Warnungsregeln von Grafana](v10-alerting-configure-grafanamanaged.md)
+ [Konfigurieren von mit Datenquellen verwalteten Warnungsregeln](v10-alerting-configure-datasourcemanaged.md)
+ [Aufzeichnungsregeln konfigurieren](v10-alerting-configure-recordingrules.md)
+ [Kontaktpunkte konfigurieren](v10-alerting-configure-contactpoints.md)
+ [Benachrichtigungsrichtlinien konfigurieren](v10-alerting-configure-notification-policies.md)

# Konfigurieren Sie die verwalteten Warnungsregeln von Grafana
<a name="v10-alerting-configure-grafanamanaged"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

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. Die Verwendung von Bildern in Warnmeldungen wird ebenfalls unterstützt. Dies ist der einzige Regeltyp, der Warnmeldungen aus mehreren Datenquellen in einer einzigen Regeldefinition ermöglicht.

Als Ergebnis einer Warnungsregel (auch bekannt als multidimensionale Warnung) können mehrere Warnungsinstanzen erstellt werden.

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.

Wenn Sie eine in der Benutzeroberfläche erstellte Warnressource löschen, können Sie sie nicht mehr abrufen. Um eine Sicherungskopie Ihrer Konfiguration zu erstellen und gelöschte Alert-Ressourcen wiederherstellen zu können, erstellen Sie Ihre Alert-Ressourcen mit Terraform oder der Alerting API.

In den folgenden Verfahren gehen wir den Prozess der Erstellung Ihrer von Grafana verwalteten Warnregeln durch.

Um eine von Grafana verwaltete Warnungsregel zu erstellen, verwenden Sie den Ablauf zur Erstellung von Benachrichtigungen im Arbeitsbereich und folgen Sie diesen Schritten, um Ihnen zu helfen.

**Geben Sie den Namen der Warnungsregel**

1. Wählen Sie **Warnung** -> **Warnungsregeln** -> **\$1 Neue Warnungsregel**.

1. Geben Sie einen Namen ein, um Ihre Warnungsregel zu identifizieren.

   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.

Definieren Sie als Nächstes eine Abfrage, um die Daten abzurufen, die Sie messen möchten, sowie eine Bedingung, die erfüllt sein muss, bevor eine Warnungsregel ausgelöst wird.

**Um die Abfrage und die Bedingung zu definieren**

1. Wählen Sie eine Datenquelle aus.

1. Geben Sie in der Dropdownliste **Optionen** einen [Zeitraum an](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range).
**Anmerkung**  
Grafana Alerting unterstützt beispielsweise nur feste relative Zeitbereiche. `now-24hr: now`  
Absolute Zeitbereiche: `2021-12-02 00:00:00 to 2021-12-05 23:59:592` oder halbrelative Zeitbereiche: werden nicht unterstützt. `now/d to: now`

1. Fügen Sie eine Abfrage hinzu.

   Um mehrere [Abfragen](v10-panels-query-xform.md#v10-panels-query-xform-add) hinzuzufügen, wählen Sie **Abfrage hinzufügen**.

   Alle Alarmregeln werden standardmäßig von Grafana verwaltet. Wenn Sie zu einer von einer Datenquelle verwalteten Warnungsregel wechseln möchten, klicken Sie auf Zu einer von einer **Datenquelle verwalteten Warnungsregel wechseln**.

1. [Fügen Sie einen oder mehrere Ausdrücke hinzu.](v10-panels-query-xform-expressions.md)

   1. **Wählen Sie für jeden Ausdruck entweder **klassische Bedingung** aus, um eine einzelne Warnungsregel zu erstellen, oder wählen Sie aus den Optionen **Math**, **Reduce und Resample**, um für jede Serie eine separate Warnung zu generieren.**
**Anmerkung**  
Wenn Sie Prometheus verwenden, können Sie einen Instant-Vektor und integrierte Funktionen verwenden, sodass Sie keine zusätzlichen Ausdrücke hinzufügen müssen.

   1. Wählen Sie **Vorschau**, um zu überprüfen, ob der Ausdruck erfolgreich ist.

1. [Optional] Um einen Wiederherstellungsschwellenwert hinzuzufügen, aktivieren Sie die Option **Benutzerdefinierter Wiederherstellungsschwellenwert** und geben Sie einen Wert ein, ab dem Ihre Warnungsregel nicht mehr ausgelöst werden soll.

   Sie können einer Abfrage nur einen Wiederherstellungsschwellenwert hinzufügen, und dieser muss die Warnbedingung sein.

1. Wählen Sie **In der Abfrage oder dem Ausdruck, den Sie als Warnbedingung** festlegen möchten, die Option Als Warnbedingung festlegen aus.

Verwenden Sie die Auswertung von Warnungsregeln, um zu bestimmen, wie oft eine Warnungsregel ausgewertet werden sollte und wie schnell sie ihren Status ändern sollte.

Dazu müssen Sie sicherstellen, dass sich Ihre Warnungsregel in der richtigen Bewertungsgruppe befindet, und einen Wartezeitraum festlegen, der für Ihren Anwendungsfall am besten geeignet ist.

**So legen Sie das Verhalten bei der Auswertung von Warnungen fest**

1. Wählen Sie einen Ordner aus oder wählen Sie **\$1 Neuer Ordner**.

1. Wählen Sie eine Bewertungsgruppe aus oder klicken Sie auf **\$1 Neue Bewertungsgruppe**.

   Wenn Sie eine neue Bewertungsgruppe erstellen, geben Sie das Intervall für die Gruppe an.

   Alle Regeln innerhalb derselben Gruppe werden gleichzeitig über dasselbe Zeitintervall ausgewertet.

1. Geben Sie einen ausstehenden Zeitraum ein.

   Der Wartezeitraum ist der Zeitraum, in dem eine Warnungsregel die Bedingung verletzen kann, bis sie ausgelöst wird.

   Sobald eine Bedingung erfüllt ist, geht die Warnung in den Status **Ausstehend** über. Wenn die Bedingung für die angegebene Dauer aktiv bleibt, wechselt die Warnung in den Status **Auslösung**, andernfalls kehrt sie in den Status **Normal** zurück.

1. Aktivieren Sie bei Bedarf die Benachrichtigungen mit Pausenwarnungen.
**Anmerkung**  
Unterbrechen Sie die Auswertung der Warnungsregeln, um bei der Optimierung Ihrer Benachrichtigungen zu laute Warnmeldungen zu vermeiden. Durch das Anhalten wird die Auswertung der Warnungsregeln beendet und es werden keine Warnungsinstanzen erstellt. Dies unterscheidet sich von den Zeiten der Stummschaltung, die zwar verhindern, dass Benachrichtigungen zugestellt werden, aber dennoch die Auswertung von Warnungsregeln und die Erstellung von Warnungsinstanzen ermöglichen.  
Sie können die Auswertung von Warnungsregeln pausieren, um zu verhindern, dass bei der Optimierung Ihrer Warnmeldungen laute Warnmeldungen ausgegeben werden. Durch das Anhalten wird die Auswertung der Warnungsregeln beendet und es werden keine Warnungsinstanzen erstellt. Dies unterscheidet sich von den Zeiten der Stummschaltung, die zwar verhindern, dass Benachrichtigungen zugestellt werden, aber dennoch die Auswertung von Warnungsregeln und die Erstellung von Warnungsinstanzen ermöglichen.

1. **Konfigurieren Sie unter Keine Daten konfigurieren und Fehlerbehandlung** das Warnverhalten bei fehlenden Daten.

   Beachten Sie die Richtlinien weiter unten in diesem Abschnitt.

Fügen Sie Ihren Warnungsregeln Labels hinzu, um festzulegen, welche Benachrichtigungsrichtlinie Ihre Auslösewarnungen behandeln soll.

Alle Warnungsregeln und -instanzen, unabhängig von ihren Bezeichnungen, entsprechen der Standardbenachrichtigungsrichtlinie. Wenn es keine verschachtelten Richtlinien gibt oder keine verschachtelten Richtlinien den Bezeichnungen in der Warnungsregel oder Warnungsinstanz entsprechen, ist die Standardbenachrichtigungsrichtlinie die entsprechende Richtlinie.

**So konfigurieren Sie Benachrichtigungen**

1. Fügen Sie Labels hinzu, wenn Sie die Art und Weise ändern möchten, wie Ihre Benachrichtigungen weitergeleitet werden.

   Fügen Sie benutzerdefinierte Labels hinzu, indem Sie vorhandene Schlüssel-Wert-Paare aus der Drop-down-Liste auswählen, oder fügen Sie neue Labels hinzu, indem Sie den neuen Schlüssel oder Wert eingeben.

1. Zeigen Sie eine Vorschau Ihrer Einrichtung für das Routing Ihrer Alert-Instanz an.

   Basierend auf den hinzugefügten Labels werden Warnungsinstanzen an die angezeigten Benachrichtigungsrichtlinien weitergeleitet.

   Erweitern Sie jede Benachrichtigungsrichtlinie, um weitere Details anzuzeigen.

1. Wählen Sie **Details anzeigen, um Details** zur Weiterleitung von Benachrichtigungen und eine Vorschau anzuzeigen.

Fügen Sie [Anmerkungen](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations) hinzu, um mehr Kontext zu der Warnung in Ihrer Warnmeldung bereitzustellen.

Anmerkungen fügen Metadaten hinzu, um weitere Informationen zur Warnung in Ihrer Warnmeldung bereitzustellen. Fügen Sie beispielsweise eine Anmerkung mit einer **Zusammenfassung** hinzu, um zu erfahren, durch welchen Wert die Warnung ausgelöst wurde oder auf welchem Server sie aufgetreten ist.

**Um Anmerkungen hinzuzufügen**

1. [Optional] Fügen Sie eine Zusammenfassung hinzu.

   Kurze Zusammenfassung dessen, was passiert ist und warum.

1. [Optional] Fügen Sie eine Beschreibung hinzu.

   Beschreibung der Funktion der Warnungsregel.

1. [Optional] Fügen Sie eine Runbook-URL hinzu.

   Webseite, auf der Sie Ihr Runbook für die Warnung aufbewahren

1. [Optional] Fügen Sie eine benutzerdefinierte Anmerkung hinzu

1. [Optional] Fügen Sie ein Dashboard und einen Panel-Link hinzu.

   Verknüpft Benachrichtigungen mit Bedienfeldern in einem Dashboard.

1. Wählen Sie **Save rule** (Regel speichern).

**Ein- und mehrdimensionale Regel**

Für von Grafana verwaltete Benachrichtigungen können Sie eine Regel mit einer klassischen Bedingung oder eine mehrdimensionale Regel erstellen.
+ **Regel mit klassischer Bedingung**

  Verwenden Sie den 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.
+ **Mehrdimensionale Regel**

  Um für jede Serie eine separate Warnung zu generieren, erstellen Sie eine mehrdimensionale Regel. Verwenden Sie `Resample` Ausdrücke `Math``Reduce`, oder, um eine mehrdimensionale Regel zu erstellen. Beispiel:
  + 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](v10-alerting-overview-numeric.md)).
  + Fügen Sie einen `Math` Ausdruck mit der Bedingung für die Regel hinzu. Nicht erforderlich, falls eine Abfrage oder ein Reduce-Ausdruck bereits zurückgibt, `0` ob die Regel nicht ausgelöst werden soll, oder eine positive Zahl, wenn sie ausgelöst werden soll. Einige Beispiele: `$B > 70` ob es ausgelöst werden soll, falls der Wert von B größer als 70 query/expression ist. `$B < $C * 100`falls es ausgelöst werden sollte, 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 unter [https://comtemplate-variables-are-notmunity.grafana.com/t/](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514) - - /2514. supported-in-alert-queries while-setting-up-alert

**Konfigurieren Sie keine Daten und Fehlerbehandlung**

Konfigurieren Sie das Warnverhalten, wenn Ihre Warnungsregelauswertung keine Daten oder einen Fehler zurückgibt.

**Anmerkung**  
Warnungsregeln, die so konfiguriert sind, dass sie ausgelöst werden, wenn eine Auswertung keine Daten oder einen Fehler zurückgibt, werden nur ausgelöst, wenn der gesamte Evaluierungszeitraum abgelaufen ist. Das bedeutet, dass die Warnungsregel nicht sofort ausgelöst wird, wenn die Bedingung der Warnungsregel verletzt wird, sondern wartet, bis die für das Feld **Für** festgelegte Zeit abgelaufen ist, und wird dann ausgelöst, wodurch Warngeräusche reduziert werden und vorübergehende Probleme mit der Datenverfügbarkeit möglich sind.

Wenn bei der Auswertung der Warnungsregel keine Daten zurückgegeben werden, können Sie den Status Ihrer Warnungsregel so einstellen, dass er wie folgt aussieht:


| Keine Daten | Description | 
| --- | --- | 
| Keine Daten | Erstellt eine neue Warnung DatasourceNoData mit dem Namen und der UID der Warnungsregel sowie der UID der Datenquelle, die keine Daten zurückgegeben hat, als Beschriftungen. | 
| Warnfunktion | Setzt den Status der Warnungsregel auf. Alerting Die Warnungsregel wartet, bis die im Feld Für festgelegte Zeit abgelaufen ist, bevor sie ausgelöst wird. | 
| OK | Setzt den Status der Warnungsregel aufNormal. | 

Wenn Ihre Auswertung einen Fehler ergibt, können Sie den Status Ihrer Warnungsregel so einstellen, dass er wie folgt aussieht:


| Fehler | Description | 
| --- | --- | 
| Fehler | Erstellt eine Warnungsinstanz DatasourceError mit dem Namen und der UID der Warnungsregel sowie der UID der Datenquelle, die keine Daten zurückgegeben hat, als Beschriftungen. | 
| Warnfunktion | Setzt den Status der Warnungsregel auf. Alerting Die Warnungsregel wartet, bis die im Feld Für festgelegte Zeit abgelaufen ist, bevor sie ausgelöst wird. | 
| OK | Setzt den Status der Warnungsregel aufNormal. | 

**Löst veraltete Warnungsinstanzen auf**

Eine Warnungsinstanz gilt als veraltet, wenn ihre Dimension oder Serie für zwei Bewertungsintervalle vollständig aus den Abfrageergebnissen verschwunden ist.

Veraltete Warnungsinstanzen im Status`Alerting`/`NoData`/`Error`werden automatisch als markiert, `Resolved` und die `grafana_state_reason` Anmerkung wird der Warnungsinstanz mit dem Grund hinzugefügt. `MissingSeries`

**Erstellen Sie Warnmeldungen aus Panels**

Erstellen Sie Benachrichtigungen aus einem beliebigen Panel-Typ. Das bedeutet, dass Sie die Abfragen im Panel wiederverwenden und darauf basierende Benachrichtigungen erstellen können.

1. Navigieren Sie im Bereich **Dashboards** zu einem Dashboard.

1. Wählen Sie in der oberen rechten Ecke des Panels die drei Punkte (Ellipsen) aus.

1. Wählen Sie im Dropdownmenü die Option **Mehr...** und wählen Sie dann **Neue Warnungsregel** aus.

Dadurch wird das Formular für Warnungsregeln geöffnet, in dem Sie Ihre Warnung auf der Grundlage der Abfrage des aktuellen Panels konfigurieren und erstellen können.

# Konfigurieren von mit Datenquellen verwalteten Warnungsregeln
<a name="v10-alerting-configure-datasourcemanaged"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Erstellen Sie Warnregeln für eine externe Instanz von Grafana Mimir oder Loki, für die die Lineal-API aktiviert ist. Diese werden als datenquellenverwaltete Warnregeln bezeichnet.

**Anmerkung**  
Warnungsregeln für eine externe Grafana Mimir- oder Loki-Instanz können von Benutzern mit Editor- oder Admin-Rollen bearbeitet oder gelöscht werden.  
Wenn Sie eine in der Benutzeroberfläche erstellte Warnressource löschen, können Sie sie nicht mehr abrufen. Um eine Sicherungskopie Ihrer Konfiguration zu erstellen und gelöschte Alert-Ressourcen wiederherstellen zu können, erstellen Sie Ihre Alert-Ressourcen mit Terraform oder der Alerting API.

**Voraussetzungen**
+ Stellen Sie sicher, dass Sie Schreibberechtigungen für die Prometheus- oder Loki-Datenquelle haben. Andernfalls können Sie keine verwalteten Alarmregeln von Grafana Mimir 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 Regelspeichertypen.
  + **Grafana Mimir** - benutze das `/prometheus` Präfix. 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](https://grafana.com/docs/mimir/latest/operators-guide/reference-http-api/#querier--query-frontend) URL befinden[.](https://grafana.com/docs/mimir/latest/operators-guide/reference-http-api/#ruler) 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-Benutzeroberfläche verwalten**.

In den folgenden Verfahren führen wir Sie durch den Prozess der Erstellung Ihrer durch eine Datenquelle verwalteten Warnregeln.

Um eine von einer Datenquelle verwaltete Warnungsregel zu erstellen, verwenden Sie den Ablauf zur Erstellung von Warnungen im Workspace und befolgen Sie die folgenden Schritte, um Ihnen zu helfen.

**So legen Sie den Namen der Warnungsregel fest**

1. Wählen Sie **Warnung** -> **Warnungsregeln** -> **\$1 Neue Warnungsregel**.

1. Geben Sie einen Namen ein, um Ihre Warnungsregel zu identifizieren.

   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.

Definieren Sie eine Abfrage, um die Daten abzurufen, die Sie messen möchten, sowie eine Bedingung, die erfüllt sein muss, bevor eine Warnungsregel ausgelöst wird.

**Um eine Abfrage und eine Bedingung zu definieren**

1. Alle Alarmregeln werden standardmäßig von Grafana verwaltet. Um zu einer von einer Datenquelle verwalteten Warnregel zu **wechseln, wählen Sie Zu einer von einer Datenquelle verwalteten Warnungsregel** wechseln.

1. Wählen Sie eine Datenquelle aus der Dropdownliste aus.

   Sie können auch „**Erweiterte Datenquellenauswahl öffnen**“ wählen, um weitere Optionen zu sehen, darunter das Hinzufügen einer Datenquelle (nur für Administratoren).

1. Geben Sie eine PromQL- oder LogQL-Abfrage ein.

1. **Wählen Sie Warnmeldungen in der Vorschau aus.**

Verwenden Sie die Auswertung von Warnungsregeln, um zu bestimmen, wie oft eine Warnungsregel ausgewertet werden soll und wie schnell sie ihren Status ändern sollte.

**So legen Sie das Verhalten bei der Auswertung von Warnungen fest**

1. Wählen Sie einen Namespace aus oder wählen Sie **\$1 Neuer Namespace**.

1. Wählen Sie eine Bewertungsgruppe aus oder wählen Sie **\$1 Neue Bewertungsgruppe**.

   Wenn Sie eine neue Bewertungsgruppe erstellen, geben Sie das Intervall für die Gruppe an.

   Alle Regeln innerhalb derselben Gruppe werden nacheinander über dasselbe Zeitintervall ausgewertet.

1. Geben Sie einen ausstehenden Zeitraum ein.

   Der Wartezeitraum ist der Zeitraum, in dem eine Warnungsregel gegen die Bedingung verstoßen kann, bis sie ausgelöst wird.

   Sobald 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, andernfalls kehrt sie in den `Normal` Status zurück.

Fügen Sie Ihren Warnungsregeln Labels hinzu, um festzulegen, welche Benachrichtigungsrichtlinie Ihre Auslösewarnungen behandeln soll.

Alle Warnungsregeln und -instanzen, unabhängig von ihren Bezeichnungen, entsprechen der Standardbenachrichtigungsrichtlinie. Wenn es keine verschachtelten Richtlinien gibt oder keine verschachtelten Richtlinien den Bezeichnungen in der Warnungsregel oder Warnungsinstanz entsprechen, ist die Standardbenachrichtigungsrichtlinie die entsprechende Richtlinie.

**Konfigurieren von -Benachrichtigungen**
+ Fügen Sie Labels hinzu, wenn Sie die Art und Weise ändern möchten, wie Ihre Benachrichtigungen weitergeleitet werden.

  Fügen Sie benutzerdefinierte Labels hinzu, indem Sie vorhandene Schlüssel-Wert-Paare aus der Drop-down-Liste auswählen, oder fügen Sie neue Labels hinzu, indem Sie den neuen Schlüssel oder Wert eingeben.

Fügen Sie [Anmerkungen](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations) hinzu, um in Ihren Warnmeldungen mehr Kontext zur Warnung bereitzustellen.

Anmerkungen fügen Metadaten hinzu, um mehr Informationen zur Warnung in Ihren Warnmeldungen bereitzustellen. Fügen Sie beispielsweise eine `Summary` Anmerkung hinzu, die Ihnen mitteilt, durch welchen Wert die Warnung ausgelöst wurde oder auf welchem Server sie ausgelöst wurde.

**Um Anmerkungen hinzuzufügen**

1. [Optional] Fügen Sie eine Zusammenfassung hinzu.

   Kurze Zusammenfassung dessen, was passiert ist und warum.

1. [Optional] Fügen Sie eine Beschreibung hinzu.

   Beschreibung der Funktion der Warnungsregel.

1. [Optional] Fügen Sie eine Runbook-URL hinzu.

   Webseite, auf der Sie Ihr Runbook für die Warnung aufbewahren

1. [Optional] Fügen Sie eine benutzerdefinierte Anmerkung hinzu

1. [Optional] Fügen Sie ein Dashboard und einen Panel-Link hinzu.

   Verknüpft Benachrichtigungen mit Bedienfeldern in einem Dashboard.

1. Wählen Sie **Save rule** (Regel speichern).

# Aufzeichnungsregeln konfigurieren
<a name="v10-alerting-configure-recordingrules"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Sie können 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.

**Anmerkung**  
Aufzeichnungsregeln werden als Instanzregeln ausgeführt und alle 10 Sekunden ausgeführt.

**Voraussetzungen**
+ Stellen Sie sicher, dass Sie Schreibberechtigungen für die Prometheus- oder Loki-Datenquelle haben. Sie werden Warnregeln in Ihrer Datenquelle 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 `/prometheus` Präfix. 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**.

**Um Aufzeichnungsregeln zu erstellen**

1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü **Alerting, Alert-Regeln aus**.**

1. Wählen Sie **Neue Aufzeichnungsregel**.

1. Legen Sie den Namen der Regel fest.

   Der Name der Aufzeichnungsregel muss ein Prometheus-Metrikname sein und darf keine Leerzeichen enthalten.

1. Abfrage definieren
   + Wählen Sie Ihre Loki- oder Prometheus-Datenquelle aus.
   + Geben Sie eine Abfrage ein.

1. Fügen Sie Namespace und Gruppe hinzu.
   + Wählen Sie in der Dropdownliste **Namespace** einen vorhandenen Regel-Namespace aus oder fügen Sie einen neuen hinzu. Namespaces können eine oder mehrere Regelgruppen enthalten und haben nur einen organisatorischen Zweck.
   + Wählen Sie in der Dropdownliste **Gruppe** eine bestehende Gruppe im ausgewählten Namespace aus oder fügen Sie eine neue hinzu. Neu erstellte Regeln werden an das Ende der Gruppe angehängt. Regeln innerhalb einer Gruppe werden nacheinander in regelmäßigen Intervallen mit derselben Evaluierungszeit ausgeführt.

1. Fügen Sie Beschriftungen hinzu.
   + Fügen Sie benutzerdefinierte Labels hinzu, indem Sie vorhandene Schlüssel-Wert-Paare aus der Drop-down-Liste auswählen, oder fügen Sie neue Labels hinzu, indem Sie den neuen Schlüssel oder Wert eingeben.

1. Wählen Sie **Regel speichern**, um die Regel zu speichern, oder **Regel speichern und beenden**, um die Regel zu speichern und zur Warnseite zurückzukehren.

# Kontaktpunkte konfigurieren
<a name="v10-alerting-configure-contactpoints"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Definieren Sie anhand von Kontaktpunkten, wie Ihre Kontakte benachrichtigt werden, wenn eine Warnregel ausgelöst wird.

**Anmerkung**  
Sie können Kontaktpunkte für von Grafana verwaltete Benachrichtigungen erstellen und bearbeiten. Kontaktstellen für von Datenquellen verwaltete Benachrichtigungen sind schreibgeschützt.

## Mit Kontaktpunkten arbeiten
<a name="v10-alerting-configure-contactpoints-working"></a>

Die folgenden Verfahren zeigen, wie Sie eine Kontaktstelle hinzufügen, bearbeiten, löschen und testen.

**So fügen Sie einen Kontaktpunkt hinzu**

1. Wählen Sie im Menü auf der linken Seite **Alerting aus**.

1. Wählen Sie **Kontaktstellen**.

1. **Wählen Sie im Drop-down-Menü „Alertmanager** auswählen“ einen Alertmanager aus. Der Grafana Alertmanager ist standardmäßig ausgewählt.

1. Wählen Sie auf der Registerkarte **Kontaktstellen** die Option **\$1 Kontaktstelle hinzufügen**.

1. Geben Sie einen **Namen** für die Kontaktstelle ein.

1. Wählen Sie unter **Integration** einen Typ aus und füllen Sie die Pflichtfelder auf der Grundlage dieses Typs 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. Um eine weitere Kontaktpunktintegration hinzuzufügen, wählen Sie **Kontaktpunktintegration hinzufügen** aus und wiederholen Sie die Schritte für jeden benötigten Kontaktpunkttyp.

1. Speichern Sie Ihre Änderungen.

**Um eine Kontaktstelle zu bearbeiten**

1. Wählen Sie im Menü auf der linken Seite **Alerting aus**.

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 **Bearbeiten**.

1. Aktualisieren Sie die Kontaktstelle und speichern Sie dann Ihre Änderungen.

Sie können Kontaktpunkte löschen, die aufgrund einer Benachrichtigungsrichtlinie nicht verwendet werden.

**Um eine Kontaktstelle zu löschen**

1. Wählen Sie im Menü auf der linken Seite **Alerting**.

1. Wählen Sie **Kontaktstellen, um die Liste der vorhandenen Kontaktstellen** zu öffnen.

1. Wählen Sie unter **Kontaktstellen die Kontaktstelle** aus, die Sie löschen möchten, und wählen Sie dann **Mehr**, **Löschen** aus.

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.

Nachdem Ihre Kontaktstelle erstellt wurde, können Sie eine Testbenachrichtigung senden, um zu überprüfen, ob sie richtig konfiguriert ist.

**Um eine Testbenachrichtigung zu senden**

1. Wählen Sie im Menü auf der linken Seite **Alerting aus**.

1. Wählen Sie **Kontaktstellen, um die Liste der vorhandenen Kontaktstellen** zu öffnen.

1. Wählen Sie unter **Kontaktstellen die Kontaktstelle** aus, die Sie testen möchten, und klicken Sie dann auf **Bearbeiten**. Bei Bedarf können Sie auch eine neue Kontaktstelle erstellen.

1. Wählen Sie **Test**, um den Dialog zum Testen der Kontaktstelle zu öffnen.

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.

## Konfigurieren Sie Kontaktpunkt-Integrationen
<a name="v10-alerting-configure-contactpoints-integration"></a>

Konfigurieren Sie Kontaktpunktintegrationen in Grafana, um Ihren bevorzugten Kommunikationskanal für den Empfang von Benachrichtigungen auszuwählen, wenn Ihre Alarmregeln ausgelöst werden. Jede Integration hat ihre eigenen Konfigurationsoptionen und ihren eigenen Einrichtungsprozess. In den meisten Fällen beinhaltet dies die Bereitstellung eines API-Schlüssels oder einer Webhook-URL.

Nach der Konfiguration können Sie Integrationen als Teil Ihrer Kontaktstellen verwenden, um Benachrichtigungen zu erhalten, wenn sich der Status Ihrer Warnung ändert. In diesem Abschnitt behandeln wir anhand PagerDuty eines Beispiels die grundlegenden Schritte zur Konfiguration einer Integration, sodass Sie sofort Benachrichtigungen in Echtzeit erhalten und den Überblick über Ihre Überwachungsdaten behalten können.

**Liste der unterstützten Integrationen**

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` | 

**Konfiguration PagerDuty für Warnmeldungen**

Für die Einrichtung PagerDuty müssen Sie einen Integrationsschlüssel angeben. Geben Sie die folgenden Details an.


| Einstellung | Description | 
| --- | --- | 
| Integrationsschlüssel | Integrationsschlüssel für PagerDuty | 
| Schweregrad | Stufe für dynamische Benachrichtigungen. Der Standardwert ist critical. | 
| Benutzerdefinierte Details | Zusätzliche Informationen zur Veranstaltung | 

Das `CustomDetails` Feld ist ein Objekt, das beliebige Schlüssel-Wert-Paare enthält. Die benutzerdefinierten Details werden mit den standardmäßig verwendeten zusammengeführt.

Die Standardwerte für `CustomDetails` sind:

```
{
	"firing":       `{{ template "__text_alert_list" .Alerts.Firing }}`,
	"resolved":     `{{ template "__text_alert_list" .Alerts.Resolved }}`,
	"num_firing":   `{{ .Alerts.Firing | len }}`,
	"num_resolved": `{{ .Alerts.Resolved | len }}`,
}
```

Im Fall von doppelten Schlüsseln überschreiben die benutzerdefinierten Details die Standarddaten.

# Benachrichtigungsrichtlinien konfigurieren
<a name="v10-alerting-configure-notification-policies"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Benachrichtigungsrichtlinien bestimmen, wie Benachrichtigungen an Kontaktstellen weitergeleitet werden.

Richtlinien haben eine Baumstruktur, wobei jede Richtlinie eine oder mehrere verschachtelte Richtlinien haben kann. Jede Richtlinie, mit Ausnahme der Standardrichtlinie, kann auch bestimmten Warnbezeichnungen entsprechen.

Jede Warnung wird anhand der Standardrichtlinie und anschließend anhand der einzelnen verschachtelten Richtlinien bewertet.

Wenn Sie die `Continue matching subsequent sibling nodes` Option für eine verschachtelte 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 Standardrichtlinie regelt jede Warnung, die keiner verschachtelten Richtlinie entspricht.

Weitere Informationen zu Benachrichtigungsrichtlinien finden Sie unter. [Benachrichtigungen](v10-alerting-explore-notifications.md)

Die folgenden Verfahren zeigen Ihnen, wie Sie Benachrichtigungsrichtlinien erstellen und verwalten.

**Um die Standard-Benachrichtigungsrichtlinie zu bearbeiten**

1. Wählen Sie im Menü auf der linken Seite **Alerting aus**.

1. Wählen Sie **Benachrichtigungsrichtlinien** aus.

1. **Wählen Sie im Drop-down-Menü „Alertmanager** auswählen“ den Alertmanager aus, den Sie bearbeiten möchten.

1. **Wählen Sie im Abschnitt **Standardrichtlinie...**** , **Bearbeiten**.

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 aus, nach denen Benachrichtigungen gruppiert werden sollen. Wenn mehrere Warnungen für diese Richtlinie übereinstimmen, werden sie nach diesen Labels gruppiert. Pro Gruppe wird eine Benachrichtigung gesendet. Wenn das Feld leer ist (Standardeinstellung), werden alle Benachrichtigungen in einer einzigen Gruppe gesendet. Verwenden Sie ein spezielles Label, `...` um Benachrichtigungen nach allen Labels zu gruppieren (wodurch die Gruppierung effektiv deaktiviert wird).

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 Benachrichtigungsrichtlinie zu erstellen, müssen Sie ihrer Baumstruktur folgen. Neue Richtlinien, die am Stamm des Baums erstellt werden (die Standardrichtlinie), sind die Baumzweige. Jeder Zweig kann seine eigenen verschachtelten Richtlinien haben. Aus diesem Grund fügen Sie immer eine neue **verschachtelte** Richtlinie hinzu, entweder unter der Standardrichtlinie oder unter einer bereits verschachtelten Richtlinie.

**Um eine neue verschachtelte Richtlinie hinzuzufügen**

1. **Wählen Sie im Menü auf der linken Seite Alerting aus.**

1. Wählen Sie **Benachrichtigungsrichtlinien** aus.

1. **Wählen Sie im Drop-down-Menü „Alertmanager** auswählen“ den Alertmanager aus, den Sie bearbeiten möchten.

1. **Um eine spezifische Richtlinie der obersten Ebene hinzuzufügen, wechseln Sie zum Abschnitt Spezifisches Routing (entweder zur Standardrichtlinie oder zu einer anderen vorhandenen Richtlinie, zu der Sie eine neue verschachtelte Richtlinie hinzufügen möchten) und wählen Sie \$1 Neue verschachtelte Richtlinie aus.**

1. Fügen Sie im Abschnitt „Übereinstimmende Labels“ eine oder mehrere Regeln für übereinstimmende Warnungsbezeichnungen hinzu.

1. Wählen Sie in der Dropdownliste **Kontaktstelle** die Kontaktstelle aus, an die Benachrichtigungen gesendet werden sollen, wenn eine Warnung nur dieser bestimmten Richtlinie entspricht und keiner der verschachtelten Richtlinien.

1. Aktivieren Sie optional die Option Mit dem **Abgleich aufeinanderfolgender gleichgeordneter Knoten** fortfahren, um den Abgleich von gleichgeordneten Richtlinien auch dann fortzusetzen, wenn die Warnung mit der aktuellen Richtlinie übereinstimmt. Wenn diese Option aktiviert ist, können Sie mehr als eine Benachrichtigung für eine Warnung erhalten.

1. Aktivieren Sie optional **Gruppierung überschreiben**, um dieselbe Gruppierung wie in der Standardrichtlinie anzugeben. Wenn die Option nicht aktiviert ist, wird die Standardrichtliniengruppierung verwendet.

1. Aktivieren Sie optional die Option **Allgemeine Zeitangaben überschreiben, um** die in der Gruppenbenachrichtigungsrichtlinie konfigurierten Zeitoptionen außer Kraft zu setzen.

1. Wählen Sie **Richtlinie speichern** aus, um Ihre Änderungen zu speichern.

**Um eine verschachtelte Richtlinie zu bearbeiten**

1. **Wählen Sie im Menü auf der linken Seite Alerting aus.**

1. Wählen Sie **Benachrichtigungsrichtlinien** aus.

1. Wählen Sie die Richtlinie aus, die Sie bearbeiten möchten, und wählen Sie dann**...** , **Bearbeiten**.

1. Nehmen Sie alle Änderungen vor (wie beim Hinzufügen einer verschachtelten Richtlinie).

1. Speichern Sie Ihre Änderungen.

**Nach Richtlinien suchen**

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. Die Richtlinien, die diese Kontaktstelle verwenden, werden auf der Benutzeroberfläche hervorgehoben.
+ Um nach Label zu suchen, geben Sie einen gültigen Label-Matcher in das Eingabefeld **Search by Matchers** 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.

# Verwalte deine Benachrichtigungen
<a name="v10-alerting-manage"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Sobald Sie Ihre Alarmregeln, Kontaktstellen und Benachrichtigungsrichtlinien eingerichtet haben, können Sie Grafana-Benachrichtigungen verwenden, um Ihre Benachrichtigungen in der Praxis zu verwalten.

**Topics**
+ [Benachrichtigungen anpassen](v10-alerting-manage-notifications.md)
+ [Kontaktstellen verwalten](v10-alerting-manage-contactpoints.md)
+ [Warnmeldungen stummschalten](v10-alerting-silences.md)
+ [Warnungsregeln anzeigen und filtern](v10-alerting-manage-rules-viewfilter.md)
+ [Timings stummschalten](v10-alerting-manage-muting.md)
+ [Status und Zustand der Warnungsregeln anzeigen](v10-alerting-manage-rulestate.md)
+ [Warnungsgruppen anzeigen und nach Warnungsgruppen filtern](v10-alerting-manage-viewfiltergroups.md)
+ [Benachrichtigungsfehler anzeigen](v10-alerting-manage-viewnotificationerrors.md)

# Benachrichtigungen anpassen
<a name="v10-alerting-manage-notifications"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

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 Amazon SNS 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](v10-alerting-notifications-go-templating.md)
+ [Vorlagen für Benachrichtigungen erstellen](v10-alerting-create-templates.md)
+ [Verwenden von Benachrichtigungsvorlagen](#v10-alerting-use-notification-templates)
+ [Vorlage – Referenz](v10-alerting-template-reference.md)

# Verwendung der Template-Sprache von Go
<a name="v10-alerting-notifications-go-templating"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

[Sie 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="v10-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](v10-alerting-create-templates.md) und alle Daten und Funktionen in der[Vorlage – Referenz](v10-alerting-template-reference.md).

## Tags öffnen und schließen
<a name="v10-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="v10-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](#v10-go-variables) drucken. Um beispielsweise das `Alerts` Feld zu drucken, auf das sich der Punkt bezieht, würden `ExtendedData` Sie Folgendes schreiben:

```
{{ .Alerts }}
```

## Wiederholt die Warnmeldungen
<a name="v10-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="v10-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 sich auf die aktuelle Bezeichnung bezieht. `.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 }}
```

## Die Index-Funktionen
<a name="v10-go-index"></a>

Verwenden Sie die `index` Funktion, um eine bestimmte Anmerkung oder ein bestimmtes Etikett zu drucken.

```
{{ range .Alerts }}
The name of the alert is {{ index .Labels "alertname" }}
{{ end }}
```

## Wenn Aussagen
<a name="v10-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="v10-go-with"></a>

With ähnelt if-Anweisungen, `with` aktualisiert jedoch im Gegensatz zu if-Anweisungen den Punkt, sodass er auf den Wert von with verweist:

```
{{ with .Alerts }}
There are {{ len . }} alert(s)
{{ else }}
There are no alerts
{{ end }}
```

## Variablen
<a name="v10-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 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="v10-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="v10-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, kann Grafana beide Vorlagen verwenden. Grafana verhindert nicht und zeigt auch keine Fehlermeldung an, wenn es zwei oder mehr Vorlagen mit demselben Namen gibt.

```
{{ define "print_labels" }}
{{ end }}
```

## Vorlagen ausführen
<a name="v10-go-execute"></a>

Sie können eine definierte Vorlage innerhalb Ihrer Vorlage ausführen`template`, indem Sie den Namen der Vorlage in doppelten Anführungszeichen und den Cursor verwenden, der an die Vorlage übergeben werden soll:

```
{{ template "print_labels" . }}
```

## Übergeben Sie Daten an Vorlagen
<a name="v10-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="v10-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="v10-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="v10-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="v10-alerting-create-templates"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

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="v10-alerting-creating-templates"></a>

**Um eine Benachrichtigungsvorlage zu erstellen**

1. Wählen Sie „**Benachrichtigungen“,** „**Kontaktstellen**“.

1. Wählen Sie den Tab **Benachrichtigungsvorlagen** und dann **\$1 Benachrichtigungsvorlage 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. Speichern Sie Ihre Änderungen.

   `{{ 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. Wählen Sie „**Benachrichtigungen“,** „**Kontaktstellen**“.

1. Wählen Sie den Tab **Benachrichtigungsvorlagen** und dann **\$1 Benachrichtigungsvorlage 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 späteren Abschnitten finden Sie detaillierte Beispiele für Vorlagen, die Sie möglicherweise erstellen.

1. Klicken Sie auf Speichern.

## Eine Vorschau der Benachrichtigungsvorlagen anzeigen
<a name="v10-alerting-preview-templates"></a>

Sehen Sie sich eine Vorschau Ihrer Benachrichtigungsvorlagen an, bevor Sie sie in Ihren Kontaktstellen verwenden. Dies hilft Ihnen, das Ergebnis der von Ihnen erstellten Vorlage zu verstehen, und gibt Ihnen die Möglichkeit, etwaige Fehler zu beheben, bevor Sie die Vorlage speichern.

**Anmerkung**  
Benachrichtigungsvorschauen sind nur für Grafana Alertmanager verfügbar.

**Um eine Vorschau Ihrer Benachrichtigungsvorlagen anzuzeigen**

1. Wählen Sie „**Benachrichtigungen“,** „**Kontaktstellen**“.

1. Wählen Sie den Tab **Benachrichtigungsvorlagen** und dann **\$1 Benachrichtigungsvorlage hinzufügen** oder bearbeiten Sie eine vorhandene Vorlage.

1. Fügen Sie den Inhalt Ihrer Vorlage hinzu oder aktualisieren Sie sie.

   Standarddaten werden bereitgestellt, und Sie können Warndaten sowie Warnungsinstanzen hinzufügen oder bearbeiten. Sie können Warndaten direkt im Payload-Datenfenster selbst hinzufügen oder auf **Warnungsinstanzen auswählen** oder **Benutzerdefinierte Benachrichtigungen hinzufügen** klicken.

1. [Optional] So fügen Sie Warnungsdaten aus vorhandenen Warnungsinstanzen hinzu:

   1. **Wählen Sie „Warnungsinstanzen** auswählen“.

   1. Bewegen Sie den Mauszeiger über die Warnungsinstanzen, um weitere Informationen zu jeder Warnungsinstanz anzuzeigen/

   1. Wählen Sie **Bestätigen**, um die Warnungsinstanz zur Payload hinzuzufügen.

1. [Optional] Um Warnungsdaten mit dem Alert-Dateneditor hinzuzufügen, wählen Sie **Benutzerdefinierte Daten hinzufügen** aus:

   1. Fügen Sie Anmerkungen und benutzerdefinierte Beschriftungen hinzu oder richten Sie ein Dashboard oder einen Bereich ein.

   1. Aktiviere „Ausgelöst“ oder „Gelöst“, je nachdem, ob du deiner Benachrichtigung ausgelöste oder gelöste Warnmeldungen hinzufügen möchtest.

   1. Wähle „**Warnungsdaten hinzufügen**“.

   1. Wählen Sie **Vorschau aktualisieren**, um zu sehen, wie der Inhalt Ihrer Vorlage aussehen wird und welche Payload-Daten dazu gehören.

   Wenn Ihre Vorlage Fehler enthält, werden diese in der Vorschau angezeigt und Sie können sie vor dem Speichern korrigieren.

1. Speichern Sie Ihre Änderungen.

## Erstellen Sie eine Vorlage für den Betreff der Nachricht
<a name="v10-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="v10-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="v10-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. Führen Sie die Vorlage über das Titelfeld in Ihrer Kontaktpunktintegration aus.

   ```
   {{ template "slack.title" . }}
   ```

## Eine Vorlage für den Inhalt einer Slack-Nachricht erstellen
<a name="v10-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.

**Anmerkung**  
Diese Vorlage ist nur für von Grafana verwaltete Benachrichtigungen vorgesehen. Um die Vorlage für von Datenquellen verwaltete Benachrichtigungen zu verwenden, löschen Sie die Verweise auf dashboardURL und silenceUrl. Weitere Informationen zur Konfiguration von Prometheus-Benachrichtigungen finden Sie in der [Prometheus-Dokumentation](https://prometheus.io/docs/alerting/latest/notifications/) zu Benachrichtigungen.

```
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. Führen Sie die Vorlage über das Textfeld in Ihrer Kontaktpunktintegration aus:

   ```
   {{ template "slack.message" . }}
   ```

## Template sowohl für E-Mail als auch für Slack mit gemeinsam genutzten Vorlagen
<a name="v10-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="v10-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 Registerkarte „**Kontaktstellen**“, um eine Liste der vorhandenen Kontaktstellen anzuzeigen.

1. Wählen Sie **New (Neu)**. Alternativ können Sie eine bestehende Kontaktstelle bearbeiten, indem Sie auf das Symbol **Bearbeiten** klicken.

1. Geben Sie die Vorlagen, die Sie verwenden möchten, in ein Feld 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. Wählen Sie **Kontaktstelle speichern**.

# Vorlage – Referenz
<a name="v10-alerting-template-reference"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Dieser Abschnitt enthält Referenzinformationen für die Erstellung Ihrer Vorlagen.

**Warnung (Typ)**

Der Warnungstyp enthält die folgenden Daten.


| Name | Art | Description | Beispiel | 
| --- | --- | --- | --- | 
|  Status  |  Zeichenfolge  |  `firing` oder `resolved`.  | \$1\$1 .Status \$1\$1 | 
|  Labels  |  KeyValue  |  Eine Reihe von Bezeichnungen, die an die Warnung angehängt sind.  | \$1\$1 .Labels \$1\$1 | 
|  Anmerkungen  |  KeyValue  |  Eine Reihe von Anmerkungen, die der Warnung beigefügt sind.  | \$1\$1 .Annotations \$1\$1 | 
| Werte | KeyValue | Die Werte aller Ausdrücke, einschließlich der klassischen Bedingungen | \$1\$1 .Values \$1\$1 | 
|  StartsAt  |  Zeit.Zeit  |  Uhrzeit, zu der der Alarm ausgelöst wurde.  | \$1\$1 .StartsAt \$1\$1 | 
|  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.  | \$1\$1 .EndsAt \$1\$1 | 
|  Generator-URL  |  Zeichenfolge  |  Ein Backlink zu Grafana oder einem externen Alertmanager.  | \$1\$1 .GeneratorURL \$1\$1 | 
|  Silence-URL  |  Zeichenfolge  |  Ein Link zum Stummschalten der Warnung (mit vorgefüllten Bezeichnungen für diese Warnung). Nur für von Grafana verwaltete Benachrichtigungen.  | \$1\$1 .SilenceURL\$1\$1 | 
|  Dashboard-URL  |  Zeichenfolge  |  Link zum Grafana-Dashboard, falls die Warnungsregel zu einer gehört. Nur für von Grafana verwaltete Benachrichtigungen.  | \$1\$1 .DashboardURL \$1\$1 | 
|  Panel-URL  |  Zeichenfolge  |  Link zum Grafana-Dashboard-Panel, falls die Warnungsregel zu einer gehört. Nur für von Grafana verwaltete Benachrichtigungen.  | \$1\$1 .PanelURL \$1\$1 | 
|  Fingerabdruck  |  Zeichenfolge  |  Fingerabdruck, der zur Identifizierung der Warnung verwendet werden kann.  | \$1\$1 .Fingerprint \$1\$1 | 
|  ValueString  |  Zeichenfolge  |  Eine Zeichenfolge, die die Bezeichnungen und den Wert jedes reduzierten Ausdrucks in der Warnung enthält.  | \$1\$1 .ValueString \$1\$1 | 

 **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 gibt an`firing`, ob mindestens ein Alarm ausgelöst wird, andernfalls`resolved`.  |  `{{ .Status }}`  | 
|  Benachrichtigungen  |  `[]Alert`  |  Liste aller ausgelösten und gelösten Alarme in dieser Benachrichtigung.  |  `There are {{ len .Alerts }} alerts`  | 
|  Auslösewarnungen  |  `[]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 Namen  | `{{ .Names }}` | 
|  Werte  |    |  [] Zeichenfolge  |  Liste von Werten  | `{{ .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).

# Kontaktstellen verwalten
<a name="v10-alerting-manage-contactpoints"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

In der Listenansicht der **Kontaktpunkte** werden alle vorhandenen Kontaktstellen und Benachrichtigungsvorlagen aufgeführt.

Auf der Registerkarte **Kontaktstellen** können Sie:
+ Suchen Sie nach Namen und Typen von Kontaktstellen und Integrationen.
+ Sehen Sie sich alle vorhandenen Kontaktstellen und Integrationen an.
+ Sehen Sie sich an, für wie viele Benachrichtigungsrichtlinien jeder Kontaktpunkt verwendet wird, und navigieren Sie direkt zu den verknüpften Benachrichtigungsrichtlinien.
+ Sehen Sie sich den Status der Zustellungen von Benachrichtigungen an.
+ Exportieren Sie einzelne Kontaktpunkte oder alle Kontaktpunkte im JSON-, YAML- oder Terraform-Format.
+ Löschen Sie Kontaktpunkte, die nicht von einer Benachrichtigungsrichtlinie verwendet werden.

Auf der Registerkarte **Benachrichtigungsvorlagen** können Sie:
+ Bestehende Benachrichtigungsvorlagen anzeigen, bearbeiten, kopieren oder löschen.

# Warnmeldungen stummschalten
<a name="v10-alerting-silences"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

*Sie können Warnmeldungen unterdrücken, indem Sie sie stumm schalten.* 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.

**Anmerkung**  
Um Warnmeldungen in regelmäßigen Zeitabständen zu unterdrücken, z. B. während regulärer Wartungsperioden, sollten Sie [Timings stummschalten](v10-alerting-manage-muting.md) eher die Option „Stummschalten“ verwenden.

**Um eine Stille hinzuzufügen**

1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü Alerting.**

1. **Wählen Sie Stille.**

1. **Wählen Sie einen Alertmanager aus dem Alertmanager-Drop-down-Menü aus.**

1. Wählen Sie **„**Stille erstellen“.

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.

1. Als Alternative zur Festlegung einer Endzeit können Sie im Feld **Dauer** angeben, wie lange die Stille durchgesetzt werden soll. Dadurch wird die Endzeit im Feld **Start und Ende der Stille** automatisch aktualisiert.

1. Geben Sie in den Feldern **Bezeichnung** und **Wert** ein oder mehrere *passende Labels* ein. Matcher bestimmen, für welche Regeln das Schweigen gilt. Alle passenden Warnmeldungen (im Status „Auslösen“) werden im Feld **Betroffene Warnmeldungen angezeigt**.

1. Fügen Sie optional einen **Kommentar** hinzu, der die Stille beschreibt.

1. Wählen Sie **Absenden** aus.

**Um eine Stille zu bearbeiten**

1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü Alerting.**

1. Wählen Sie **Stille**, um die Liste der vorhandenen Stille anzuzeigen.

1. Suchen Sie nach der Stille, die Sie bearbeiten möchten, und wählen Sie dann **Bearbeiten** (Stiftsymbol).

1. Nehmen Sie die gewünschten Änderungen vor und wählen Sie dann **Absenden**, um Ihre Änderungen zu speichern.

Sie können eine bestehende Stille bearbeiten, indem Sie das **Bearbeiten-Symbol** (Stift) wählen.

**Um einen URL-Link zu einem Stilleformular zu erstellen**

Wenn Sie auf ein Silence-Formular verlinken, geben Sie die standardmäßigen passenden Labels sowie die Parameter für die Kommentarfunktion `matcher` und die `comment` Abfrageparameter an. Der `matcher` Parameter sollte das folgende Format haben, `[label][operator][value]` wobei der `operator` Parameter eines der folgenden sein kann: `=` (equals, not regex), (not equals, not regex), `!=` (equals, regex), `=~` (not equals, regex). `!~` Die URL kann viele `matcher` Abfrageparameter mit dem Schlüssel enthalten. Um beispielsweise einen Link zu einem Silence-Formular mit den passenden Bezeichnungen `severity=critical` `cluster!~europe-.*` und Kommentar zu erstellen`Silence critical EU alerts`, erstellen Sie eine URL`https://mygrafana/alerting/silence/new?matcher=severity%3Dcritical&matcher=cluster!~europe-*&comment=Silence%20critical%20EU%20alert`.

Um einen Link zu einer neuen Silence-Seite für einen externen Alertmanager zu erstellen, fügen Sie einen `alertmanager` Abfrageparameter hinzu

**Um eine Stille zu entfernen**

1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü Alerting.**

1. Wählen Sie **Stille**, um die Liste der vorhandenen Stille 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.

# Warnungsregeln anzeigen und filtern
<a name="v10-alerting-manage-rules-viewfilter"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Auf der Seite „**Benachrichtigungen“ werden Warnregeln aufgeführt.** Standardmäßig sind Regeln nach Datenquellentypen gruppiert. Der Abschnitt **Grafana** listet Regeln auf, die von Grafana verwaltet werden. Warnregeln für Prometheus-kompatible Datenquellen sind ebenfalls hier aufgeführt. 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.

## Warnungsregeln anzeigen
<a name="v10-alerting-manage-rules-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ü **Alerting, Alert-Regeln aus**.** Standardmäßig wird die Listenansicht angezeigt.

1. In **Ansicht als** können Sie zwischen den Ansichten Gruppiert, Listen und Status wechseln, indem Sie die gewünschte Option auswählen.

1. Erweitern Sie die Regelzeile, um die Regelbezeichnungen, Anmerkungen, Datenquellen, die Regelabfragen und eine Liste der Warnungsinstanzen anzuzeigen, die sich aus der Regel ergeben.

Auf dieser Seite können Sie auch Kopien einer Warnungsregel erstellen, um bestehende Regeln wiederzuverwenden.

## Warnungsregeln exportieren
<a name="v10-alerting-manage-rules-export"></a>

Sie können Regeln im Grafana-Arbeitsbereich nach YAML oder JSON exportieren.
+ Wählen Sie das Symbol **Regelgruppe exportieren** neben jeder Warnungsregelgruppe, um sie nach YAML, JSON oder Terraform zu exportieren.
+ Wählen Sie **Regeln exportieren**, um alle von Grafana verwalteten Warnungsregeln nach YAML, JSON oder Terraform zu exportieren.
+ Wählen Sie neben jeder einzelnen Warnungsregel innerhalb einer Gruppe die Option **Mehr**, **Export ändern** aus, um bereitgestellte Warnungsregeln zu bearbeiten und eine geänderte Version zu exportieren.

## Abfragedefinitionen für bereitgestellte Benachrichtigungen anzeigen
<a name="v10-alerting-manage-rules-querydef"></a>

Zeigt schreibgeschützte Abfragedefinitionen für bereitgestellte Benachrichtigungen an. Prüfen Sie schnell, ob Ihre Warnungsregelabfragen korrekt sind, ohne in Ihrem As-Code-Repository nach Regeldefinitionen suchen zu müssen.

**Gruppierte Ansicht**

Die gruppierte Ansicht zeigt Grafana-Warnungsregeln 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 Warnmeldungen filtern
<a name="v10-alerting-manage-rules-filter"></a>

Sie können die Warnregeln, die auf der Seite „**Benachrichtigungen**“ angezeigt werden, auf verschiedene Arten filtern.

**Um Warnungsregeln zu filtern**

1. **Wählen Sie unter Datenquellen** auswählen eine Datenquelle aus. Sie können Warnungsregeln sehen, die die ausgewählte Datenquelle abfragen.

1. Geben Sie im Feld **Nach Label suchen mithilfe von** Label-Selektoren Suchkriterien ein. Beispiel, `environment=production;region=~US|EU,severity!=warning`.

1. Wählen Sie **unter Benachrichtigungen nach Status filtern** den Warnstatus aus, den Sie sehen möchten. Sie können sich Warnregeln anzeigen lassen, die diesem Status entsprechen. Regeln, die anderen Bundesstaaten entsprechen, sind ausgeblendet.

# Timings stummschalten
<a name="v10-alerting-manage-muting"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Eine 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.

## Stummschalten im Vergleich zu Stille
<a name="v10-alerting-manage-muting-compare"></a>

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. | 

## Timing für Stummschaltung hinzufügen
<a name="v10-alerting-manage-muting-add"></a>

Sie können in Ihrem Grafana-Arbeitsbereich Stummschaltungen erstellen.

**Um ein Timing für die Stummschaltung hinzuzufügen**

1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü Alerting.**

1. Wählen Sie **Benachrichtigungsrichtlinien** und dann die Registerkarte Timings **stummschalten**.

1. Wählen Sie in der Dropdownliste **Alertmanager** den Alertmanager aus, den Sie bearbeiten möchten.

1. Wählen Sie die Taste **\$1** Timing für Stummschaltung hinzufügen.

1. Füllen Sie das Formular aus, um ein [Zeitintervall](#v10-alerting-manage-muting-interval) zu erstellen, das mit Ihrem Timing für die Stummschaltung übereinstimmt.

1. Speichern Sie Ihre Stummschaltung.

## Hinzufügen eines Timings für die Stummschaltung zu einer Benachrichtigungsrichtlinie
<a name="v10-alerting-manage-muting-add-notif"></a>

Sobald Sie einen Zeitpunkt für die Stummschaltung festgelegt haben, verwenden Sie ihn, indem Sie ihn der Benachrichtigungsrichtlinie hinzufügen, die Sie in regelmäßigen Abständen stummschalten möchten.

**Um einer Benachrichtigungsrichtlinie einen Zeitpunkt für die Stummschaltung hinzuzufügen**

1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü Alerting.**

1. Wählen Sie **Benachrichtigungsrichtlinien** und dann die Registerkarte **Benachrichtigungsrichtlinien** aus.

1. Wählen Sie die Benachrichtigungsrichtlinie aus, der Sie die Stummschaltung hinzufügen möchten, und wählen Sie**...** , **Bearbeiten**.

1. Wählen Sie in der Dropdownliste **für die Stummschaltung** die Zeiten für die Stummschaltung aus, die Sie der Richtlinie hinzufügen möchten.

1. Speichern Sie Ihre Änderungen.

## Zeitintervalle
<a name="v10-alerting-manage-muting-interval"></a>

Ein Zeitintervall ist eine bestimmte Dauer, in der Warnmeldungen unterdrückt werden. Die Dauer besteht in der Regel aus einem bestimmten Zeitraum und den Tagen der Woche, des Monats oder des Jahres. 

Die Optionen für das Supportzeitintervall sind:
+ **Zeitbereich** — Die Zeit inklusive Start- und Endzeit (in UTC, wenn kein Standort ausgewählt wurde, andernfalls Ortszeit).
+ **Standort** — Legt den Ort für das Timing fest. Der Zeitraum wird in Ortszeit für den Standort angezeigt.
+ **Wochentage** — Der Tag oder Bereich von Wochentagen. Beispiel, `monday:thursday`.
+ **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.
+ **Monate** — Die Monate des Jahres in numerischer oder vollständiger Kalendermonatsbezeichnung. Beispiel, `1, may:august`.
+ **Jahre** — Das Jahr oder die Jahre für das Intervall. Beispiel, `2023:2024`.

Jedes dieser Elemente kann eine Liste sein, und mindestens ein Element im Element muss erfüllt sein, um eine Übereinstimmung zu erhalten. Felder unterstützen auch Bereiche mithilfe von`:`. Beispiel, `monday:thursday`.

Wenn ein Feld leer gelassen wird, entspricht jeder Zeitpunkt dem Feld. Damit ein Moment von einem kompletten Zeitintervall entspricht, müssen alle Felder übereinstimmen. Ein Timing für die Stummschaltung kann mehrere Zeitintervalle enthalten.

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`

# Status und Zustand der Warnungsregeln anzeigen
<a name="v10-alerting-manage-rulestate"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Anhand des Status und der Integrität von Warnungsregeln erhalten Sie mehrere wichtige Statusindikatoren für Ihre Benachrichtigungen.

Es gibt drei Komponenten:
+ [Status der Warnungsregel](#v10-alerting-manage-rulestate-state)
+ [Status der Warnungsinstanz](#v10-alerting-manage-rulestate-instance)
+ [Zustand der Warnmeldungsregel](#v10-alerting-manage-rulestate-health)

Obwohl sie miteinander verwandt sind, vermittelt jede Komponente subtil unterschiedliche Informationen.

**Um den Status und den Zustand Ihrer Warnungsregeln einzusehen**

1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü Alerting.**

1. Wählen Sie **Warnungsregeln**, um die Liste der vorhandenen Benachrichtigungen anzuzeigen.

1. Wählen Sie eine Warnungsregel aus, um deren Status und Zustand einzusehen.

## Status der Warnungsregel
<a name="v10-alerting-manage-rulestate-state"></a>

Eine Warnungsregel kann sich in einem der folgenden Status befinden:


| Status | Description | 
| --- | --- | 
| Normal | Keine der von der Evaluierungs-Engine zurückgegebenen Zeitreihen hat den firing Status „pendingOder“. | 
| Ausstehend | Mindestens eine von der Evaluierungs-Engine zurückgegebene Zeitreihe istpending. | 
| Wird gefeuert | Mindestens eine von der Evaluierungs-Engine zurückgegebene Zeitreihe istfiring. | 

**Anmerkung**  
Warnmeldungen werden zuerst auf `pending` und dann `firing` übertragen. Daher dauert es mindestens zwei Bewertungszyklen, bis eine Warnung ausgelöst wird.

## Status der Warnungsinstanz
<a name="v10-alerting-manage-rulestate-instance"></a>

Eine Warnungsinstanz kann sich in einem der folgenden Zustände befinden:


| Status | Description | 
| --- | --- | 
| Normal | Der Status einer Warnung, die pending weder noch istfiring. Alles funktioniert wie erwartet. | 
| 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. | 
| Keine Daten | Für das konfigurierte Zeitfenster wurden keine Daten empfangen. | 
| Warnfunktion | Beim Versuch, eine Warnregel auszuwerten, ist ein Fehler aufgetreten. | 

## Letzten Status beibehalten
<a name="v10-alerting-manage-rulestate-keepstate"></a>

Eine Warnungsregel kann so konfiguriert werden, dass der letzte Status beibehalten wird, wenn ein `NoData` oder `Error` -Zustand auftritt. Dadurch wird sowohl verhindert, dass Warnmeldungen ausgelöst werden, als auch, dass sie behoben und erneut ausgelöst werden. Genau wie bei der normalen Evaluierung wird die Warnungsregel von `pending` zu `firing` nach Ablauf der Wartezeit umgestellt.

## Zustand der Warnmeldungsregel
<a name="v10-alerting-manage-rulestate-health"></a>

Eine Warnungsregel kann einen der folgenden Integritätsstatus haben.


| Status | Description | 
| --- | --- | 
| Ok | Keine Fehler bei der Auswertung der Warnungsregel. | 
| Fehler | Bei der Auswertung der Warnungsregel ist ein Fehler aufgetreten. | 
| NoData | Das Fehlen von Daten in mindestens einer Zeitreihe, die während einer Regelauswertung zurückgegeben wurde. | 
| \$1Status\$1, KeepLast | Die Regel hätte einen anderen Status erhalten, wurde aber so konfiguriert, dass sie den letzten Status der Warnungsregel beibehält. | 

## Besondere Warnmeldungen für NoData und Fehler
<a name="v10-alerting-manage-rulestate-special"></a>

Wenn die Auswertung einer Warnungsregel den Status `NoData` oder ergibt`Error`, generiert Grafana-Alerting Warninstanzen mit den folgenden zusätzlichen Bezeichnungen.


| Label (Bezeichnung) | Description | 
| --- | --- | 
| Name der Warnung | Entweder DatasourceNoData oderDatasourceError, je nach Bundesland. | 
| datasource\$1uid | Die UID der Datenquelle, die den Status verursacht hat. | 

**Anmerkung**  
Um die zusätzlichen Beschriftungen zu generieren, müssen Sie, wie im [Konfigurieren Sie die verwalteten Warnungsregeln von Grafana](v10-alerting-configure-grafanamanaged.md) Thema beschrieben, `Error` in der Regel „Keine Daten“ `NoData` oder „Fehler behandeln“ auf oder in der Warnungsregel festlegen.

Sie können diese Benachrichtigungen auf die gleiche Weise behandeln wie normale Benachrichtigungen, einschließlich Hinzufügen von Stille, Weiterleitung an eine Kontaktstelle usw.

# Warnungsgruppen anzeigen und nach Warnungsgruppen filtern
<a name="v10-alerting-manage-viewfiltergroups"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

Warnungsgruppen zeigen gruppierte Alerts aus einer Alertmanager-Instanz an. Standardmäßig werden Warnungsregeln in Benachrichtigungsrichtlinien nach den Labelschlüsseln für die Standardrichtlinie 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. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü Alerting.**

1. Wählen Sie **Gruppen, um bestehende Gruppen** anzuzeigen.

1. Wählen Sie in der **Alertmanager-Dropdownliste** einen externen Alertmanager als Datenquelle aus.

1. Wählen Sie aus der Dropdownliste **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`

Sie können Warnungen nach Bezeichnung oder Status der Benachrichtigungen filtern.

**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="v10-alerting-manage-viewnotificationerrors"></a>

****  
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)  
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)

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. Wählen Sie im Menü auf der linken Seite **Benachrichtigungen und** dann **Kontaktstellen** aus.

   Wenn eine Kontaktstelle ausfällt, werden Sie in einer Meldung in der rechten Ecke des Arbeitsbereichs darüber informiert, dass und wie viele Fehler vorliegen.

1. Wählen Sie eine Kontaktstelle aus, um die Details der Fehler für diese Kontaktstelle einzusehen.

   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.