Daten transformieren

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

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:

• Felder umbenennen

• Zeitreihendaten verbinden

• Führen Sie mathematische Operationen abfrageübergreifend durch

• Verwenden Sie die Ausgabe einer Transformation als Eingabe für eine andere Transformation

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.

Anmerkung

Manchmal kann das System transformierte Daten nicht grafisch darstellen. Wenn das passiert, klicken Sie auf den Schalter Tabellenansicht über der Visualisierung, um zu einer Tabellenansicht der Daten zu wechseln. Dies kann Ihnen helfen, das Endergebnis Ihrer Transformationen zu verstehen.

Typen von Transformationen

Grafana bietet eine Reihe von Möglichkeiten, wie Sie Daten transformieren können. Nachfolgend 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. Diese Dokumentation enthält keine Schritte für jeden Transformationstyp.

Um eine Transformation zu einem Panel hinzuzufügen

1. Navigieren Sie zu dem Bereich, in dem Sie eine oder mehrere Transformationen hinzufügen möchten.

2. Bewegen Sie den Mauszeiger über einen beliebigen Teil des Bedienfelds, um das Aktionsmenü in der oberen rechten Ecke anzuzeigen.

3. Wählen Sie im Aktionsmenü Bearbeiten aus.

4. Wählen Sie die Registerkarte Transformieren aus.

5. Wählen Sie eine Transformation aus. Eine Transformationszeile wird angezeigt, in der Sie die Transformationsoptionen konfigurieren.

6. Um eine weitere Transformation anzuwenden, wählen Sie Transformation hinzufügen. Diese Transformation wirkt sich auf die Ergebnismenge aus, die von der vorherigen Transformation zurückgegeben wurde.

Debuggen Sie eine Transformation

Um die Eingabe- und Ausgaberesultsets der Transformation zu sehen, wählen Sie das Debug-Symbol (Bug) auf der rechten Seite der Transformationszeile. Dadurch werden die Eingabedaten und das Ergebnis der Transformation als Ausgabe angezeigt.

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

Deaktivieren Sie eine Transformation

Sie können eine Transformation deaktivieren oder ausblenden, indem Sie oben rechts in der Transformationszeile auf das Symbol zum Einblenden (Augen) klicken. Dadurch werden die für diese spezifische Transformation angewendeten Aktionen deaktiviert. Dies kann dazu beitragen, Probleme zu identifizieren, wenn Sie mehrere Transformationen nacheinander ändern.

Filtern Sie eine Transformation

Wenn Ihre Transformation mehr als eine Abfrage verwendet, können Sie diese filtern und die ausgewählte Transformation nur auf eine der Abfragen anwenden. Wählen Sie dazu das Filtersymbol oben rechts in der Transformationszeile. Dadurch wird ein Drop-down-Menü mit einer Liste der im Panel verwendeten Abfragen geöffnet. Von hier aus können Sie die Abfrage auswählen, die Sie transformieren möchten.

Sie können auch nach Anmerkungen (einschließlich Exemplaren) filtern, um Transformationen auf sie anzuwenden. Wenn Sie dies tun, ändert sich die Liste der Felder entsprechend den Feldern in der Anmerkung oder im Beispiel-Tooltip.

Das Filtersymbol wird immer angezeigt, wenn Ihr Panel mehr als eine Abfrage oder Datenquelle enthält (d. h. Fenster- oder Annotationsdaten). Es funktioniert jedoch möglicherweise nicht, wenn vorherige Transformationen zum Zusammenführen der Ausgaben der Abfragen angewendet werden. Das liegt daran, dass eine Transformation die Ausgabe der vorherigen verwendet.

Löscht 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.

Um eine Transformation zu löschen

1. Öffnen Sie ein Panel zur Bearbeitung.

2. Wählen Sie die Registerkarte Transformieren.

3. Wählen Sie das Papierkorbsymbol neben der Transformation, die Sie löschen möchten.