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 transformieren

Transformationen sind eine leistungsstarke Methode, um Daten zu bearbeiten, die von einer Abfrage zurückgegeben werden, bevor das System eine Visualisierung anwendet. Mithilfe von Transformationen können Sie:

Für Benutzer, die auf mehrere Ansichten desselben Datensatzes angewiesen sind, bieten Transformationen eine effiziente Methode zur Erstellung und Verwaltung zahlreicher Dashboards.

Sie können die Ausgabe einer Transformation auch als Eingabe für eine andere Transformation verwenden, was zu einer Leistungssteigerung führt.

Typen von Transformationen

Grafana bietet eine Reihe von Möglichkeiten, wie Sie Daten transformieren können. Im Folgenden finden Sie eine vollständige Liste der Transformationsfunktionen.

Reihenfolge der Transformationen

Wenn es mehrere Transformationen gibt, wendet Grafana sie in der Reihenfolge an, in der sie aufgelistet sind. Jede Transformation erstellt eine Ergebnismenge, die dann an die nächste Transformation in der Verarbeitungspipeline weitergegeben wird.

Die Reihenfolge, in der Grafana Transformationen anwendet, wirkt sich direkt auf die Ergebnisse aus. Wenn Sie beispielsweise eine Reduce-Transformation verwenden, um alle Ergebnisse einer Spalte zu einem einzigen Wert zu verdichten, können Sie Transformationen nur auf diesen einzelnen Wert anwenden.

Fügen Sie Daten eine Transformationsfunktion hinzu

Die folgenden Schritte führen Sie durch das Hinzufügen einer Transformation zu Daten.

Debuggen Sie eine Transformation

Um die Eingabe- und Ausgaberesultsets der Transformation zu sehen, wählen Sie das Bugsymbol auf der rechten Seite der Transformationszeile.

Die Eingabe- und Ausgabeergebnissätze können Ihnen beim Debuggen einer Transformation helfen.

Löschen Sie eine Transformation

Wir empfehlen, Transformationen zu entfernen, die Sie nicht benötigen. Wenn Sie eine Transformation löschen, entfernen Sie die Daten aus der Visualisierung.

Voraussetzungen:

Identifizieren Sie alle Dashboards, die auf der Transformation basieren, und informieren Sie die betroffenen Dashboard-Benutzer.

Transformationsfunktionen

Sie können die folgenden Transformationen an Ihren Daten durchführen.

Feld aus Berechnung hinzufügen

Verwenden Sie diese Transformation, um ein neues Feld hinzuzufügen, das aus zwei anderen Feldern berechnet wurde. Mit jeder Transformation können Sie ein neues Feld hinzufügen.

Verketten Sie Felder

Diese Transformation kombiniert alle Felder aus allen Frames zu einem Ergebnis. Betrachten Sie diese beiden Abfragen.

Abfrage A:

Anfrage B:

Nachdem Sie die Felder verkettet haben, würde der Datenrahmen wie folgt aussehen:

Config aus Abfrageergebnissen

Mit dieser Transformation können Sie eine Abfrage auswählen und daraus Standardoptionen wie Min., Max., Einheit und Schwellenwerte extrahieren und auf andere Abfrageergebnisse anwenden. Dies ermöglicht eine dynamische, abfragegesteuerte Visualisierungskonfiguration.

Wenn Sie für jede Zeile im Ergebnis der Konfigurationsabfrage eine eindeutige Konfiguration extrahieren möchten, versuchen Sie es mit der Transformation von Zeilen in Felder.

Optionen

Feldtyp konvertieren

Diese Transformation ändert den Feldtyp des angegebenen Felds.

Beispielsweise könnte die folgende Abfrage geändert werden, indem das Zeitfeld als Uhrzeit und das Datumsformat als YYYY ausgewählt wird.

Das Ergebnis:

Daten nach Namen filtern

Verwenden Sie diese Transformation, um Teile der Abfrageergebnisse zu entfernen.

Grafana zeigt das Feld Identifier an, gefolgt von den Feldern, die von Ihrer Abfrage zurückgegeben wurden.

Sie können Filter auf zwei Arten anwenden:

Daten nach Abfragen filtern

Verwenden Sie diese Transformation in Bedienfeldern mit mehreren Abfragen, wenn Sie eine oder mehrere Abfragen ausblenden möchten.

Grafana zeigt die Abfrage-Identifikationsbuchstaben in dunkelgrauem Text an. Klicken Sie auf eine Abfrage-ID, um die Filterung umzuschalten. Wenn der Abfragebuchstabe weiß ist, werden die Ergebnisse angezeigt. Wenn der Abfragebuchstabe dunkel ist, sind die Ergebnisse ausgeblendet.

Daten nach Wert filtern

Diese Transformation ermöglicht es Ihnen, Ihre Daten direkt in Grafana zu filtern und einige Datenpunkte aus Ihrem Abfrageergebnis zu entfernen. Sie haben die Möglichkeit, Daten ein- oder auszuschließen, die einer oder mehreren von Ihnen definierten Bedingungen entsprechen. Die Bedingungen werden auf ein ausgewähltes Feld angewendet.

Diese Transformation ist nützlich, wenn Ihre Datenquelle nicht nativ nach Werten filtert. Sie können dies auch verwenden, um die anzuzeigenden Werte einzugrenzen, wenn Sie eine gemeinsam genutzte Abfrage verwenden.

Die verfügbaren Bedingungen für alle Felder sind:

Die verfügbaren Bedingungen für Zahlenfelder sind:

Betrachten Sie den folgenden Datensatz:

Wenn Sie die Datenpunkte mit einer Temperatur unter 30 °C einbeziehen, sieht die Konfiguration wie folgt aus:

Und Sie erhalten das folgende Ergebnis, bei dem nur die Temperaturen unter 30 °C berücksichtigt werden:

Sie können dem Filter mehr als eine Bedingung hinzufügen. Möglicherweise möchten Sie die Daten nur einbeziehen, wenn die Höhe größer als 100 ist. Fügen Sie dazu diese Bedingung der folgenden Konfiguration hinzu:

Wenn Sie mehr als eine Bedingung haben, können Sie wählen, ob die Aktion (Einschließen/Ausschließen) auf Zeilen angewendet werden soll, die allen Bedingungen entsprechen oder einer der von Ihnen hinzugefügten Bedingungen entsprechen.

Im obigen Beispiel haben wir Match All ausgewählt, weil wir die Zeilen mit einer Temperatur unter 30 UND einer Höhe über 100 einbeziehen wollten. Wenn wir stattdessen die Zeilen mit einer Temperatur unter 30 ODER einer Höhe von über 100 einbeziehen wollten, würden wir Match any auswählen. Dies würde die erste Zeile in den Originaldaten einschließen, die eine Temperatur von 32 °C hat (entspricht nicht der ersten Bedingung), aber eine Höhe von 101 (was der zweiten Bedingung entspricht), also ist sie enthalten.

Bedingungen, die ungültig oder unvollständig konfiguriert sind, werden ignoriert.

Group by (Gruppierung nach)

Diese Transformation gruppiert die Daten nach einem bestimmten Feldwert (Spaltenwert) und verarbeitet Berechnungen für jede Gruppe. Klicken Sie hier, um eine Liste mit Berechnungsoptionen anzuzeigen.

Hier ist ein Beispiel für Originaldaten.

Diese Transformation erfolgt in zwei Schritten. Zuerst geben Sie ein oder mehrere Felder an, nach denen die Daten gruppiert werden sollen. Dadurch werden dieselben Werte dieser Felder gruppiert, als ob Sie sie sortiert hätten. Wenn wir beispielsweise nach dem Server-ID-Feld gruppieren, würden die Daten wie folgt gruppiert:

Alle Zeilen mit demselben Wert für die Server-ID werden zusammen gruppiert.

Nachdem Sie ausgewählt haben, nach welchem Feld Sie Ihre Daten gruppieren möchten, können Sie verschiedene Berechnungen für die anderen Felder hinzufügen und die Berechnung auf jede Zeilengruppe anwenden. Wir könnten zum Beispiel die durchschnittliche CPU-Temperatur für jeden dieser Server berechnen wollen. Wir können also die Mittelwertberechnung hinzufügen, die auf das Feld CPU-Temperatur angewendet wird, um Folgendes zu erhalten:

Und wir können mehr als eine Berechnung hinzufügen. Zum Beispiel:

Wir würden dann erhalten:

Diese Transformation ermöglicht es Ihnen, wichtige Informationen aus Ihrer Zeitreihe zu extrahieren und sie auf bequeme Weise anzuzeigen.

Nach Feld verbinden

Verwenden Sie diese Transformation, um mehrere Ergebnisse zu einer einzigen Tabelle zusammenzuführen. Dies ist besonders nützlich, wenn Sie mehrere Zeitreihenergebnisse in eine einzige große Tabelle mit einem gemeinsamen Zeitfeld konvertieren möchten.

Innere Verbindung

Bei einer inneren Verknüpfung werden Daten aus mehreren Tabellen zusammengeführt, wobei alle Tabellen denselben Wert aus dem ausgewählten Feld haben. Diese Art der Verknüpfung schließt Daten aus, bei denen die Werte nicht in jedem Ergebnis übereinstimmen.

Verwenden Sie diese Transformation, um die Ergebnisse mehrerer Abfragen (Kombination aus einem übergebenen Join-Feld oder der ersten Zeitspalte) zu einem Ergebnis zu kombinieren und Zeilen zu löschen, in denen eine erfolgreiche Verknüpfung nicht möglich ist.

Im folgenden Beispiel geben zwei Abfragen Tabellendaten zurück. Es wird als zwei separate Tabellen visualisiert, bevor die innere Join-Transformation angewendet wird.

Abfrage A:

Anfrage B:

Das Ergebnis nach der Anwendung der inneren Join-Transformation sieht wie folgt aus:

Äußere Verbindung

Ein äußerer Join umfasst alle Daten aus einem inneren Join und Zeilen, in denen die Werte nicht in jeder Eingabe übereinstimmen. Während die innere Verknüpfung Abfrage A und Abfrage B im Zeitfeld verknüpft, umfasst die äußere Verknüpfung alle Zeilen, die im Zeitfeld nicht übereinstimmen.

Im folgenden Beispiel geben zwei Abfragen Tabellendaten zurück. Es wird als zwei Tabellen visualisiert, bevor die Outer-Join-Transformation angewendet wird.

Abfrage A:

Anfrage B:

Das Ergebnis nach der Anwendung der Outer-Join-Transformation sieht wie folgt aus:

Beschriftungen für Felder

Durch diese Transformation werden Zeitreihenergebnisse, die Beschriftungen oder Tags enthalten, in eine Tabelle umgewandelt, in der alle Labelschlüssel und -werte im Tabellenergebnis enthalten sind. Die Beschriftungen können entweder als Spalten- oder als Zeilenwerte angezeigt werden.

Bei einem Abfrageergebnis aus zwei Zeitreihen:

Im Spaltenmodus sieht das Ergebnis wie folgt aus:

Im Modus „Zeilen“ enthält das Ergebnis eine Tabelle für jede Reihe und zeigt jeden Labelwert wie folgt an:

Name des Wertefeldes

Wenn Sie Server als Namen für das Wertfeld ausgewählt haben, erhalten Sie für jeden Wert der Serverbezeichnung ein Feld.

Verhalten beim Zusammenführen

Der Transformator „Labels to Fields“ besteht intern aus zwei getrennten Transformationen. Die erste Methode bezieht sich auf einzelne Datenreihen und extrahiert Beschriftungen in Felder. Die zweite ist die Zusammenführungstransformation, die alle Ergebnisse in einer einzigen Tabelle zusammenfasst. Die Zusammenführungstransformation versucht, alle übereinstimmenden Felder zu verknüpfen. Dieser Zusammenführungsschritt ist erforderlich und kann nicht deaktiviert werden.

Um dies zu veranschaulichen, finden Sie hier ein Beispiel mit zwei Abfragen, die Zeitreihen ohne überlappende Beschriftungen zurückgeben.

Dies wird zunächst zu diesen beiden Tabellen führen:

Nach der Zusammenführung:

Mischen von

Verwenden Sie diese Transformation, um das Ergebnis mehrerer Abfragen zu einem einzigen Ergebnis zu kombinieren. Dies ist hilfreich, wenn Sie die Tabellenfenster-Visualisierung verwenden. Werte, die zusammengeführt werden können, werden in derselben Zeile zusammengefasst. Werte können zusammengeführt werden, wenn die gemeinsam genutzten Felder dieselben Daten enthalten.

Im folgenden Beispiel haben wir zwei Abfragen, die Tabellendaten zurückgeben. Es wird als zwei separate Tabellen visualisiert, bevor die Transformation angewendet wird.

Abfrage A:

Anfrage B:

Hier ist das Ergebnis nach der Anwendung der Merge-Transformation:

Felder organisieren

Verwenden Sie diese Transformation, um die von der Abfrage zurückgegebenen Felder umzubenennen, neu anzuordnen oder auszublenden.

Grafana zeigt eine Liste der Felder an, die von der Abfrage zurückgegeben wurden. Sie haben folgende Möglichkeiten:

Partitionierung nach Werten

Diese Transformation kann dazu beitragen, dass bei der grafischen Darstellung mehrerer Reihen nicht mehrere Abfragen an dieselbe Datenquelle mit unterschiedlichen WHERE Klauseln erforderlich sind. Stellen Sie sich eine SQL-Tabelle mit Metriken mit den folgenden Daten vor:

Wenn Sie vor Version 9.3 im selben TimeSeries Panel eine rote Trendlinie für die USA und eine blaue Trendlinie für die EU zeichnen wollten, mussten Sie dies wahrscheinlich in zwei Abfragen aufteilen:

SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='US'
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='EU'

Dazu müssen Sie auch im Voraus wissen, welche Regionen tatsächlich in der Metriktabelle enthalten sind.

Mit dem Transformator „Nach Werten partitionieren“ können Sie jetzt eine einzelne Abfrage ausführen und die Ergebnisse nach eindeutigen Werten in einer oder mehreren Spalten (fields) Ihrer Wahl aufteilen. Im folgenden Beispiel wird verwende Region.

SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'

Reduzieren

Die Transformation zum Reduzieren wendet eine Berechnung auf jedes Feld im Frame an und gibt einen einzelnen Wert zurück. Zeitfelder werden entfernt, wenn diese Transformation angewendet wird.

Betrachten Sie die Eingabe:

Abfrage A:

Anfrage B:

Der Reduktionstransformator hat zwei Modi:

Wenn Sie beispielsweise die erste und letzte Berechnung mit einer Transformation von Datenreihen in Zeilen verwenden würden, wäre das Ergebnis:

Die Formel Felder mit der letzten Option reduzieren ergibt zwei Frames mit jeweils einer Zeile:

Abfrage A:

Anfrage B:

Mit Regex umbenennen

Verwenden Sie diese Transformation, um Teile der Abfrageergebnisse mithilfe eines regulären Ausdrucks und eines Ersatzmusters umzubenennen.

Sie können einen regulären Ausdruck angeben, der nur auf Treffer angewendet wird, sowie ein Ersatzmuster, das Rückverweise unterstützt. Stellen wir uns zum Beispiel vor, Sie visualisieren die CPU-Auslastung pro Host und möchten den Domainnamen entfernen. Sie könnten die Regex auf setzen ([^\.]+)\..+ und das Ersatzmuster auf$1, web-01.example.com würde werden. web-01

Zeilen zu Feldern

Die Transformation von Zeilen in Felder konvertiert Zeilen in separate Felder. Dies kann nützlich sein, da Felder individuell gestaltet und konfiguriert werden können. Es kann auch zusätzliche Felder als Quellen für die dynamische Feldkonfiguration verwenden oder sie Feldbeschriftungen zuordnen. Die zusätzlichen Beschriftungen können dann verwendet werden, um bessere Anzeigenamen für die resultierenden Felder zu definieren.

Diese Transformation umfasst eine Feldtabelle, die alle Felder in den von der Konfigurationsabfrage zurückgegebenen Daten auflistet. Diese Tabelle gibt Ihnen die Kontrolle darüber, welches Feld jeder Konfigurationseigenschaft zugeordnet werden soll (die Option *Verwenden als**). Sie können auch wählen, welcher Wert ausgewählt werden soll, wenn die zurückgegebenen Daten mehrere Zeilen enthalten.

Diese Transformation erfordert:

Nützlich bei der Visualisierung von Daten in:

Ordnen Sie zusätzliche Felder Beschriftungen zu

Wenn ein Feld nicht der Konfigurationseigenschaft zugeordnet ist, verwendet Grafana es automatisch als Quelle für ein Label im Ausgabefeld-

Beispiel:

Ausgabe:

Die zusätzlichen Beschriftungen können jetzt im Feld Anzeigename verwendet werden, um vollständigere Feldnamen bereitzustellen.

Wenn Sie die Konfiguration aus einer Abfrage extrahieren und auf eine andere anwenden möchten, sollten Sie die Konfiguration aus der Transformation der Abfrageergebnisse verwenden.

Beispiel

Eingabe:

Ausgabe:

Wie Sie sehen können, wird jede Zeile in den Quelldaten zu einem separaten Feld. Für jedes Feld ist jetzt auch eine maximale Konfigurationsoption festgelegt. Optionen wie Min., Max., Einheit und Schwellenwerte sind alle Teil der Feldkonfiguration. Wenn sie so eingestellt sind, werden sie von der Visualisierung anstelle von Optionen verwendet, die manuell im Optionsbereich des Panel-Editors konfiguriert wurden.

Bereiten Sie Zeitreihen vor

Die Zeitreihentransformation vorbereiten ist nützlich, wenn eine Datenquelle Zeitreihendaten in einem Format zurückgibt, das von dem Panel, das Sie verwenden möchten, nicht unterstützt wird.

Diese Transformation hilft Ihnen, dieses Problem zu lösen, indem Sie die Zeitreihendaten entweder vom Breitformat in das Langformat oder umgekehrt konvertieren.

Wählen Sie die Option „Zeitreihen mit mehreren Frames“, um den Zeitreihendatenrahmen vom Breitformat in das Langformat umzuwandeln.

Wählen Sie die Option Breite Zeitreihe, um den Zeitreihen-Datenrahmen vom Langformat in das Breitformat umzuwandeln.

Reihe in Zeilen

Verwenden Sie diese Transformation, um das Ergebnis mehrerer Zeitreihen-Datenabfragen zu einem einzigen Ergebnis zu kombinieren. Dies ist hilfreich, wenn Sie die Tabellenfenster-Visualisierung verwenden.

Das Ergebnis dieser Transformation wird drei Spalten enthalten: Zeit, Metrik und Wert. Die Spalte Metrik wurde hinzugefügt, sodass Sie leicht erkennen können, aus welcher Abfrage die Metrik stammt. Passen Sie diesen Wert an, indem Sie Label in der Quellabfrage definieren.

Im folgenden Beispiel haben wir zwei Abfragen, die Zeitreihendaten zurückgeben. Es wird als zwei separate Tabellen visualisiert, bevor die Transformation angewendet wird.

Abfrage A:

Anfrage B:

Hier ist das Ergebnis nach der Anwendung der Transformation „Serie auf Zeilen“.

Sortiere nach

Diese Transformation sortiert jeden Frame nach dem konfigurierten Feld. Wenn diese Option aktiviert reverse ist, werden die Werte in umgekehrter Reihenfolge zurückgegeben.

Limit

Verwenden Sie diese Transformation, um die Anzahl der angezeigten Zeilen zu begrenzen.

Im folgenden Beispiel haben wir die folgende Antwort von der Datenquelle:

Hier ist das Ergebnis nach dem Hinzufügen einer Limit-Transformation mit dem Wert '3':