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.
Aufgezeichnete Anfragen
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
Sie können Trends im Zeitverlauf erkennen, indem Sie anhand aufgezeichneter Abfragen in einem festgelegten Intervall eine Momentaufnahme eines Datenpunkts erstellen. Dies kann Ihnen einen Einblick in historische Trends geben.
Für Plugins, die keine Zeitreihen zurückgeben, kann es nützlich sein, historische Daten grafisch darzustellen. Möglicherweise möchten Sie eine Abfrage durchführen, um einen Verlauf der Antwortzeiten von Anfragen ServiceNowzu sehen, aber es können nur aktuelle point-in-time Messwerte zurückgegeben werden.
So funktionieren aufgezeichnete Abfragen
Aufgezeichnete Abfragen funktionieren nur mit Backend-Datenquellen-Plugins. Weitere Informationen finden Sie unter Backend-Datenquellen-Plugin
-
einzelne Zeile und Spalte — Eine Abfrage, die eine einzelne Zeile und Spalte zurückgibt.
-
Zeilenanzahl — Eine Abfrage, die aussagekräftige Zeilen zurückgibt, die gezählt werden sollen.
-
Ausdruck — Beliebiger Ausdruck. Weitere Informationen zum Erstellen und Verwenden von Ausdrücken finden Sie unter Ausdrücke
.
Nachdem eine aufgezeichnete Abfrage erstellt oder aktiviert wurde, erstellt sie sofort einen Snapshot und erstellt weiterhin Schnappschüsse im festgelegten Intervall. Die aufgezeichnete Abfrage macht keine Schnappschüsse mehr, wenn sie deaktiviert oder gelöscht ist oder Grafana nicht läuft. Datenpunkte werden im Backend gesammelt, indem die aufgezeichnete Abfrage ausgeführt und jedes Ergebnis an eine Prometheus-Instanz mit Remote-Schreibzugriff weitergeleitet wird.
Anmerkung
Sie müssen eine Prometheus-Datenquelle konfigurieren und sie einem Remote-Schreibziel zuordnen, bevor aufgezeichnete Abfragen verwendet werden können.
Erstellen Sie eine aufgezeichnete Abfrage
Gehen Sie wie folgt vor, um eine aufgezeichnete Abfrage zu erstellen:
-
Suchen oder erstellen Sie eine Abfrage, die Sie aufzeichnen möchten, in einem Dashboard in einem Bearbeitungsbereich. Die Abfrage darf nur eine Zeile und eine Spalte zurückgeben. Wenn mehr Ergebnisse zurückgegeben werden, können Sie trotzdem die Anzahl der zurückgegebenen Ergebnisse mit der Option count aufzeichnen. Die Datenquelle der Abfrage muss eine Backend-Datenquelle sein. Ausdrücke können verwendet werden, um Daten aus einer Zeitreihenabfrage zu aggregieren. Weitere Informationen zum Erstellen und Verwenden von Ausdrücken finden Sie unter Ausdrücke
. -
Wählen Sie das Menü „Datensatzabfrage“ im Abfrage-Editor.
-
Geben Sie aufgezeichnete Abfrageinformationen ein. Alle Felder sind Pflichtfelder, sofern nicht anders angegeben.
-
Name — Name der aufgezeichneten Abfrage.
-
Beschreibung — (optional) Beschreiben Sie die aufgezeichnete Abfrage so, wie sie in der Liste der aufgezeichneten Abfragen angezeigt werden soll.
-
Intervall — Das Intervall, in dem der Snapshot erstellt wird. Das Intervall beginnt, wenn Sie die aufgezeichnete Abfrage erstellen, und endet, wenn Sie die aufgezeichnete Abfrage anhalten oder löschen. Weitere Informationen zum Anhalten und Löschen aufgezeichneter Abfragen finden Sie unter Aufgezeichnete Abfragen verwalten
. -
Bereich — Der relative Zeitraum der Abfrage. Wenn Sie einen Bereich von 30 m und ein Intervall von 1 Stunde auswählen, erstellt die Abfrage jede Stunde der letzten 30 Minuten einen Snapshot.
-
Abfrageergebnisse zählen — Wenn Sie die von Ihrer Abfrage zurückgegebenen Zeilen zählen möchten, schalten Sie diese Option ein. Wenn diese Option deaktiviert ist, muss Ihre Abfrage eine Zeile mit einem Wert zurückgeben.
-
-
Testen Sie Ihre aufgezeichnete Abfrage, indem Sie auf die Schaltfläche „Aufgezeichnete Abfrage testen“ klicken.
-
Wählen Sie „Abfrage aufzeichnen starten“.
Eine aufgezeichnete Abfrage hinzufügen
Sie können bestehende aufgezeichnete Abfragen zu Panels in einem Dashboard hinzufügen. Für jede aufgezeichnete Abfrage, die Sie hinzufügen, wird eine Prometheus-Abfrage erstellt:. generated_recorded_query_name{id="generated_id", name="recorded query
name"} Die von Prometheus erstellte Abfrage gibt alle gesammelten Schnappschüsse der aufgezeichneten Abfrage zurück.
-
Navigieren Sie zu einem Bereich in einem Dashboard, in dem Sie eine aufgezeichnete Abfrage hinzufügen möchten.
-
Wählen Sie das Menü + Aufgezeichnete Abfragen.
-
Wenn Sie aufgezeichnete Abfragen nach Datenquelle filtern möchten, wählen Sie eine Datenquelle aus dem Dropdownmenü Nach Datenquelle filtern aus.
-
Wählen Sie in Ihrer aufgezeichneten Abfrage das Menü Hinzufügen aus, um es dem Bereich hinzuzufügen.
Nachdem Sie Ihre aufgezeichnete Abfrage zum Panel hinzugefügt haben, wird die Panel-Datenquelle-- Mixed --. Ihre aufgezeichnete Abfrage wird durch eine Prometheus Abfrage mit einer Namensbezeichnung dargestellt, die dem Namen Ihrer aufgezeichneten Abfrage entspricht. Weitere Informationen zur Prometheus-Datenquelle
Wenn nach dem Hinzufügen einer aufgezeichneten Abfrage eine Abfrage mit einer -- Mixed -- Datenquelle statt einer Prometheus-Datenquelle angezeigt wird, kann dies bedeuten, dass kein Prometheus
Remote-Schreibziel für aufgezeichnete Abfragen eingerichtet wurde. Informationen zum Einrichten eines Remote-Schreibpunkts finden Sie unter Remote-Schreibziel
Verwenden einer aufgezeichneten Abfrage
Um eine aufgezeichnete Abfrage zu verwenden, erstellen Sie eine und fügen Sie sie einem Dashboard hinzu. Danach kann sie in den Einstellungen auf der Registerkarte Aufgezeichnete Abfragen verwaltet werden.
Verwaltung aufgezeichneter Abfragen
Aufgezeichnete Abfragen können auf der Registerkarte Aufgezeichnete Abfragen in den Einstellungen pausiert oder aktiviert und gelöscht werden. Durch das Löschen einer aufgezeichneten Anfrage wird sie aus Grafana entfernt, aber die in Prometheus gesammelten Informationen sind weiterhin vorhanden. Wenn Sie eine aufgezeichnete Abfrage pausieren, werden keine neuen Datenpunkte mehr erfasst, bis sie wieder aufgenommen wird.
Ziel für Remote-Schreibvorgänge
Das Remote-Schreibziel ist die Prometheus-Datenquelle, in die aufgezeichnete Abfragedatenpunkte geschrieben werden. Sie benötigen einen Prometheus mit aktiviertem Remote Write und Sie müssen eine Datenquelle für diesen Prometheus erstellen.
Um das Remote-Schreibziel zu bearbeiten, wählen Sie im Konsolenmenü auf der Registerkarte Aufgezeichnete Abfragen in den Einstellungen die Option Remote-Schreibziel bearbeiten. Wählen Sie die Prometheus-Datenquelle aus, für die Remote Write aktiviert ist, und geben Sie den Remote-Schreibpfad ein.
