

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.

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