Daten abfragen und transformieren - Amazon Managed Grafana
Informationen zu AbfragenNavigieren Sie zur Registerkarte „Abfrage“Fügen Sie eine Abfrage hinzuAbfragen verwaltenAbfrageoptionen

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.

Daten abfragen und transformieren

Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die Grafana-Version 9.x unterstützen.

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

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

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

Informationen zu Abfragen

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.

Abfrage-Editoren

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

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

Einzelheiten zu den einzigartigen Funktionen des Abfrage-Editors einer bestimmten Datenquelle finden Sie in der zugehörigen Dokumentation:

Abfragesyntax

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

PostgreSQL-Beispiel:

SELECT hostname FROM host WHERE region IN($region)

PromQL-Beispiel:

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

Spezielle Datenquellen

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

Navigieren Sie zur Registerkarte „Abfrage“

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.

Fügen Sie eine Abfrage hinzu

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.

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

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

  4. Wählen Sie Abfrageoptionen, um die maximale Anzahl von Datenpunkten zu konfigurieren, die Sie benötigen. Weitere Informationen zu Abfrageoptionen finden Sie unterAbfrageoptionen.

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

  6. Wählen Sie Apply (Anwenden) aus.

Grafana fragt die Datenquelle ab und visualisiert die Daten.

Abfragen verwalten

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

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

Abfrageoptionen

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

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

Zu den Optionen für die Abfrage von Panel-Datenquellen gehören:

  • Max. Datenpunkte — Wenn die Datenquelle dies unterstützt, wird damit die maximale Anzahl von Datenpunkten für jede zurückgegebene Serie festgelegt. Wenn die Abfrage mehr Datenpunkte zurückgibt als die Einstellung für maximale Datenpunkte, reduziert die Datenquelle die Anzahl der zurückgegebenen Punkte, indem sie sie nach Durchschnitt, Maximum oder einer anderen Funktion zusammenfasst.

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

    Bei Streaming-Daten verwendet Grafana den Wert für maximale Datenpunkte für den Rolling-Puffer. Streaming ist ein kontinuierlicher Datenfluss, und die Pufferung unterteilt den Stream in Blöcke. Loki streamt beispielsweise Daten in seinem Live-Tailing-Modus.

  • Minimales Intervall — Legt einen Mindestgrenzwert für das automatisch berechnete Intervall fest, bei dem es sich in der Regel um das minimale Scrape-Intervall handelt. Wenn alle 15 Sekunden ein Datenpunkt gespeichert wird, profitieren Sie nicht von einem niedrigeren Intervall. Sie können dies auch auf ein höheres Minimum als das Scrape-Intervall festlegen, um Abfragen abzurufen, die grobkörniger sind und gut funktionieren.

  • Intervall — Legt eine Zeitspanne fest, die Sie beim Aggregieren oder Gruppieren von Datenpunkten nach Zeit verwenden können.

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

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

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

    Weitere Informationen finden Sie unter Globale Variablen.

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

    Beispiel Relatives Zeitfeld

    Letzte 5 Minuten

    now-5m

    Der Tag bis jetzt

    now/d

    Die letzten 5 Tage

    now-5d/d

    Bisher in dieser Woche

    now/w

    Die letzten 2 Jahre

    now-2y/y

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

    Beispiel Feld „Time Shift“

    Letzte ganze Woche

    1w/w

    Vor zwei ganzen Wochen

    2w/w

    Letzter ganzer Monat

    1M/M

    Das ganze Jahr

    1d/y

    Letztes ganzes Jahr

    1y/y

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