Abfragen - Amazon Managed Grafana
Abfrage-EditorenAbfragesyntaxBenutzeroberfläche der Registerkarte „Abfrage“Teilen von Abfrageergebnissen zwischen Bedienfeldern

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.

Abfragen

Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die Grafana-Version 8.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 9.x unterstützen, finden Sie unter. Arbeitet in Grafana-Version 9

Grafana-Workspace-Panels verwenden Abfragen, um mit Datenquellen zu kommunizieren und Daten für die Visualisierung abzurufen. Eine Abfrage ist eine Frage, die in der Abfragesprache geschrieben ist, die von der Datenquelle verwendet wird. Wenn die Abfrage richtig formatiert ist, antwortet die Datenquelle. Im Bereich Datenquellenoptionen können Sie einstellen, wie oft die Abfrage an die Datenquelle gesendet wird und wie viele Datenpunkte gesammelt werden.

Grafana-Arbeitsbereiche unterstützen bis zu 26 Abfragen pro Panel.

Abfrage-Editoren

Abfrage-Editoren sind Formulare, die Ihnen beim Schreiben von Abfragen helfen. Abhängig von Ihrer Datenquelle bietet der Abfrage-Editor möglicherweise automatische Vervollständigung, Metriknamen oder Variablenvorschläge.

Aufgrund von Unterschieden zwischen den Abfragesprachen verfügen Datenquellen möglicherweise über Abfrageeditoren, die unterschiedlich aussehen.

Abfragesyntax

Datenquellen haben unterschiedliche Abfragesprachen und Syntaxen, um nach den Daten zu fragen. Hier sind zwei Abfragebeispiele.

PostgreSQL 


SELECT hostname FROM host WHERE region IN($region)

PromQL 


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

Weitere Informationen zum Schreiben einer Abfrage für Ihre Datenquelle finden Sie in der Dokumentation zu dieser Datenquelle. Datenquellen sind unter aufgeführtVerbinden zu Datenquellen.

Benutzeroberfläche der Registerkarte „Abfrage“

Die Registerkarte „Abfrage“ besteht aus den folgenden Elementen:

  • Datenquellenauswahl

  • Abfrageoptionen

  • Schaltfläche „Inspektor abfragen“

  • Liste des Abfrage-Editors

Datenquellenauswahl

Die Datenquellenauswahl ist eine Dropdownliste. Wählen Sie ihn aus, um eine Datenquelle auszuwählen, die Sie hinzugefügt haben. Wenn Sie ein Panel erstellen, wählt Amazon Managed Grafana automatisch Ihre Standarddatenquelle aus. Weitere Informationen zu Datenquellen finden Sie unterVerbinden zu Datenquellen.

Zusätzlich zu den Datenquellen, die Sie in Ihrem Grafana-Workspace konfiguriert haben, stehen drei spezielle Datenquellen zur Verfügung.

  • TestDataDB — Eine integrierte Datenquelle, die Random-Walk-Daten generiert. Die Grafana-Datenquelle ist nützlich, um Visualisierungen zu testen und Experimente durchzuführen.

  • Gemischt — Eine Datenquelle zum Abfragen mehrerer Datenquellen im selben Panel. Wenn diese Datenquelle ausgewählt ist, können Sie für jede neue Abfrage, die Sie hinzufügen, eine Datenquelle auswählen.

    • Die erste Abfrage verwendet die Datenquelle, die ausgewählt wurde, bevor Sie Gemischt ausgewählt haben.

    • Sie können eine vorhandene Abfrage nicht so ändern, dass sie die gemischte Datenquelle verwendet.

  • Dashboard — Eine Datenquelle für die Verwendung einer Ergebnismenge aus einem anderen Bereich im selben Dashboard.

Abfrageoptionen

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

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

Sie können die folgenden Optionen für die Abfrage von Panel-Datenquellen verwenden:

  • Max. Datenpunkte — Legt die maximale Anzahl von Datenpunkten für jede zurückgegebene Datenreihe fest, sofern die Datenquelle dies unterstützt. Wenn die Abfrage mehr Datenpunkte zurückgibt als die Einstellung für maximale Datenpunkte, konsolidiert die Datenquelle sie (reduziert die Anzahl der zurückgegebenen Punkte, indem sie sie nach Durchschnitt oder Maximum oder einer anderen Funktion zusammenfasst).

    Es gibt zwei Hauptgründe für die Begrenzung der Punktezahl: Leistung und Glättung der Linie. Der Standardwert ist die Breite (oder Anzahl der Pixel) des Diagramms, wodurch vermieden wird, dass mehr Datenpunkte vorhanden sind, als das Grafikfenster anzeigen kann.

    Bei Streaming-Daten wird der Wert für die maximale Anzahl an Datenpunkten für den Rolling-Puffer verwendet. (Streaming ist ein kontinuierlicher Datenfluss, und durch Puffern kann der Stream in Blöcke aufgeteilt werden).

  • Minimales Intervall — Legt einen Mindestgrenzwert für das automatisch berechnete Intervall fest, in der Regel das minimale Scrape-Intervall. Wenn alle 15 Sekunden ein Datenpunkt gespeichert wird, ist kein geringeres Intervall erforderlich. Ein weiterer Anwendungsfall besteht darin, es auf ein höheres Minimum als das Scrape-Intervall festzulegen, um grobkörnigere, gut funktionierende Abfragen zu erhalten.

  • Intervall — Eine Zeitspanne, die Sie verwenden können, wenn Sie Datenpunkte nach Zeit aggregieren oder gruppieren.

    Amazon Managed Grafana berechnet automatisch ein geeignetes Intervall, das als Variable in Abfragen mit Vorlagen verwendet werden kann. Die Variable wird entweder in Sekunden:$__interval; oder in Millisekunden: angegeben. $__interval_ms Sie wird normalerweise in Aggregationsfunktionen wie oder verwendet. sum average 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 stark herauszoomt, wird das Intervall größer, was zu einer grobkörnigeren Aggregation führt. Wenn der Benutzer die Ansicht vergrößert, verringert sich das Intervall, was zu einer feinkörnigeren Aggregation führt.

    Weitere Informationen finden Sie unter Globale Variablen.

  • Relative Zeit — Überschreiben Sie den relativen Zeitraum für einzelne Bereiche, sodass sie sich von dem unterscheiden, was in der Dashboard-Zeitauswahl in der oberen rechten Ecke des Dashboards ausgewählt wurde. Auf diese Weise können Sie Metriken aus verschiedenen Zeiträumen oder Tagen auf demselben Dashboard anzeigen.

  • Time Shift — Bietet eine weitere Möglichkeit, den Zeitbereich für einzelne Panels zu überschreiben. Diese Funktion funktioniert nur mit relativen Zeitbereichen, und Sie können den Zeitbereich anpassen.

    Sie können beispielsweise den Zeitraum für das Panel so einstellen, dass er 2 Stunden vor dem Zeitwähler im Dashboard liegt. Weitere Informationen finden Sie unter Steuerungen für den Zeitbereich.

  • Cache-Timeout — (Dieses Feld ist nur sichtbar, wenn es in Ihrer Datenquelle verfügbar ist.) Überschreibt das Standard-Cache-Timeout, wenn Ihr Zeitreihenspeicher über einen Abfrage-Cache verfügt. Er wird als numerischer Wert in Sekunden angegeben.

Schaltfläche im Abfrageinspektor

Sie können „Abfrageinspektor“ wählen, um die Registerkarte „Abfrage“ des Bedienfeldinspektors zu öffnen. Auf der Registerkarte „Abfrage“ können Sie die vom Panel gesendete Abfrageanforderung und die Antwort sehen.

Wählen Sie Aktualisieren, um den vollständigen Text der Anfrage zu sehen, die von diesem Panel an den Server gesendet wurde.

Anmerkung

Sie müssen mindestens eine Abfrage hinzufügen, bevor der Abfrageinspektor Ergebnisse zurückgeben kann.

Weitere Informationen zum Bedienfeldinspektor finden Sie unterInspizieren Sie ein Panel.

Liste des Abfrage-Editors

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

Teilen von Abfrageergebnissen zwischen Bedienfeldern

Mit Amazon Managed 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, was die Leistung Ihres Dashboards verbessern 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 Amazon Managed 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 Datenquellenabfragen mit einem anderen Panel gemeinsam zu nutzen

  1. Erstellen Sie ein Dashboard. Weitere Informationen finden Sie unter Erstellen eines Dashboards.

  2. Fügen Sie ein Panel hinzu. Weitere Informationen finden Sie unter Ein Panel hinzufügen.

  3. Ändern Sie den Titel inSource panel. Sie verwenden dieses Panel als Quelle für die anderen Panels. Definieren Sie die Abfrage oder Abfragen, die gemeinsam genutzt werden sollen. Wenn Sie derzeit keine Datenquelle zur Verfügung haben, können Sie die Grafana-Datenquelle verwenden, die eine zufällige Zeitreihe zurückgibt, die Sie zum Testen verwenden können.

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

  5. Wählen Sie unter Ergebnisse aus der Bedienfeldliste verwenden den ersten Bereich aus, den Sie erstellt haben.

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

Um zu einem Bereich zu gelangen, in dem eine Abfrage definiert ist, wählen Sie diese Abfrage aus.