Visualisierungen kommentieren - Amazon Managed Grafana

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

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

Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. Arbeitet in Grafana-Version 8

Anmerkungen bieten eine Möglichkeit, Punkte in einer Visualisierung mit umfangreichen Ereignissen zu markieren. Sie werden in allen Grafikfeldern als vertikale Linien und Symbole dargestellt. 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 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 unter.

Anmerkungen werden für die folgenden Visualisierungstypen unterstützt:

  • Zeitreihen

  • Zeitleiste des Bundesstaates

  • Kerzen

Erstellen Sie Anmerkungen in Bedienfeldern

Grafana bietet die Möglichkeit, mithilfe der integrierten Annotationsabfrage, die in allen Dashboards vorhanden ist, Annotationsereignisse 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.

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

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

  4. Wählen Sie Speichern.

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

Anmerkungen zur Region

Sie können auch Anmerkungen erstellen, die eine Region oder einen Zeitraum in einer Visualisierung abdecken.

Um eine Regionsanmerkung hinzuzufügen
  1. Drücken Sie im Armaturenbrett die Taste Ctrl (oderCmd), während Sie einen Bereich des Bedienfelds auswählen.

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

  3. Klicken Sie auf Speichern.

Um eine Anmerkung zu bearbeiten
  1. Zeigen Sie im Dashboard mit der Maus auf einen Kommentarindikator in einem Bereich.

  2. Wählen Sie im Kommentar-Tooltip das Symbol Bearbeiten (Stift) aus.

  3. Ändern Sie die Beschreibung und/oder die Tags.

  4. Wählen Sie Speichern.

Um eine Anmerkung zu löschen
  1. Zeigen Sie im Dashboard mit der Maus auf einen Kommentarindikator in einem Bereich.

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

Rufen Sie Anmerkungen über die Dashboard-Einstellungen ab

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.

  2. Wählen Sie Anmerkungen aus.

  3. Klicken Sie auf Annotationsabfrage hinzufügen.

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

  5. 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).

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

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

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

  9. Wählen Sie in der Dropdownliste 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.

  10. Konfigurieren Sie die Abfrage.

    Die Abfrageoptionen für Anmerkungen sind für jede Datenquelle unterschiedlich. Informationen zu Anmerkungen in einer bestimmten Datenquelle finden Sie unterVerbinden zu Datenquellen.

Integrierte Abfrage

Nachdem Sie eine Anmerkung hinzugefügt haben, sind sie weiterhin sichtbar. Dies liegt an der integrierten Annotationsabfrage, die in allen Dashboards vorhanden ist. Diese Annotationsabfrage ruft alle Annotationsereignisse ab, die aus dem aktuellen Dashboard stammen und 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.

  2. Wählen Sie Anmerkungen aus.

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

  2. Wählen Sie Anmerkungen aus.

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

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