Transformationen - Amazon Managed Grafana

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.

Transformationen

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

Transformationen verarbeiten die Ergebnismenge, bevor sie an die Visualisierung übergeben wird. Sie greifen auf Transformationen auf der Registerkarte „Transformieren“ des Amazon Managed Grafana-Panel-Editors zu.

Sie können Transformationen verwenden, um Felder umzubenennen, separate Zeitreihen zusammenzufügen, abfrageübergreifende Berechnungen durchzuführen und vieles mehr. Wenn Sie große Dashboards oder umfangreiche Abfragen haben, kann die Möglichkeit, das Abfrageergebnis von einem Bereich in einem anderen Bereich wiederzuverwenden, eine enorme Leistungssteigerung bedeuten.

Anmerkung

Transformationen führen manchmal zu Daten, die nicht grafisch dargestellt werden können. In diesem Fall zeigt Amazon Managed Grafana einen Vorschlag in der Visualisierung an. Wählen Sie den Vorschlag, um zur Tabellenvisualisierung zu wechseln. Dies hilft Ihnen oft dabei, besser zu verstehen, was die Transformation mit Ihren Daten macht.

Amazon Managed Grafana wendet Transformationen in der Reihenfolge an, in der sie auf dem Bildschirm aufgeführt sind. Jede Transformation erstellt eine neue Ergebnismenge, die an die nächste Transformation in der Pipeline übergeben wird.

Die Reihenfolge kann einen großen Unterschied darin machen, wie Ihre Ergebnisse aussehen. Wenn Sie beispielsweise die Transformation zum Reduzieren verwenden, um alle Ergebnisse einer Spalte auf einen einzigen Wert zu komprimieren, können Sie Transformationen nur auf diesen einzelnen Wert anwenden.

Voraussetzungen

Bevor Sie Transformationen anwenden, müssen alle der folgenden Bedingungen erfüllt sein:

  • Sie haben eine Abfrage eingegeben und Daten aus einer Datenquelle zurückgegeben. Weitere Informationen zu Abfragen finden Sie unter Abfragen.

  • Sie haben eine Visualisierung angewendet, die Abfragen unterstützt, z. B. eine der folgenden Visualisierungen:

    • Balkenmaß

    • Messinstrument

    • Diagramm

    • Heatmap

    • Logs (Protokolle)

    • Stat

    • Tabelle

Eine Transformation anwenden

Transformationen sind auf der Registerkarte Transformieren im unteren Bereich des Bedienfeldeditors neben der Registerkarte Abfragen verfügbar.

Um eine Transformation anzuwenden
  1. Wählen Sie in dem Bereich, dem Sie Transformationen hinzufügen möchten, den Titel des Bedienfelds und anschließend „Bearbeiten“.

  2. Wählen Sie die Registerkarte Transform (Transformation) aus.

  3. Wählen Sie eine Transformation aus.

    In der angezeigten Transformationszeile können Sie die Transformationsoptionen konfigurieren.

  4. Um eine weitere Transformation anzuwenden, wählen Sie Transformation hinzufügen. Beachten Sie, dass sich die nächste Transformation auf die Ergebnismenge auswirkt, die von der vorherigen Transformation zurückgegeben wurde.

Wenn Sie Probleme haben, wählen Sie das Bug-Symbol, um Ihre Transformationen zu debuggen.

Um eine Transformation zu entfernen, wählen Sie das Papierkorbsymbol.

Arten und Optionen von Transformationen

Grafana-Arbeitsbereiche umfassen die folgenden Transformationen.

Reduzieren

Wenden Sie eine Transformation zum Reduzieren an, wenn Sie Ihre Ergebnisse auf einen Wert reduzieren möchten. Reduce entfernt im Grunde die Zeitkomponente. Wenn es als Tabelle visualisiert wird, reduziert es eine Spalte auf eine Zeile (Wert).

Geben Sie im Feld Berechnungen einen oder mehrere Berechnungstypen ein. Wählen Sie, um eine Liste mit Berechnungsoptionen anzuzeigen. Informationen zu verfügbaren Berechnungen finden Sie unterListe der Berechnungen.

Nachdem Sie mindestens eine Berechnung ausgewählt haben, zeigt Amazon Managed Grafana anhand der von Ihnen ausgewählten Berechnung einen Wert an. Wenn Sie mehr als eine Berechnung auswählen, wird mehr als ein Wert angezeigt.

Merge

Verwenden Sie diese Transformation, um die Ergebnisse 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 geben zwei Abfragen Tabellendaten zurück. Die Daten werden vor der Anwendung der Transformation als zwei separate Tabellen visualisiert.

Abfrage A

Zeit Aufgabe Betriebszeit
2020-07-07 11:34:20 node 25260122
2020-07-07 11:24:20 Postfach 123001233

Abfrage B

Zeit Aufgabe Fehler
2020-07-07 11:34:20 node 15
07.07.2020 11:24:20 Postfach 5

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

Zeit Aufgabe Fehler Betriebszeit
2020-07-07 11:34:20 node 15 25260122
2020-07-07 11:24:20 Postfach 5 123001233

Filtern nach Name

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

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

Sie können Filter auf zwei Arten anwenden:

  • Geben Sie einen Regex-Ausdruck ein.

  • Wählen Sie ein Feld aus, um die Filterung für dieses Feld umzuschalten. Gefilterte Felder werden mit dunkelgrauem Text angezeigt, ungefilterte Felder haben weißen Text.

Daten nach Abfragen filtern

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

Amazon Managed Grafana zeigt die Abfrage-Identifikationsbuchstaben in dunkelgrauem Text an. Um die Filterung umzuschalten, wählen Sie eine Abfrage-ID aus. Wenn der Abfragebuchstabe weiß ist, werden die Ergebnisse angezeigt. Wenn der Abfragebuchstabe dunkel ist, sind die Ergebnisse ausgeblendet.

Organisieren Sie Felder

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

Anmerkung

Diese Transformation funktioniert nur in Bedienfeldern, die über eine einzige Abfrage verfügen. Wenn Ihr Panel über mehrere Abfragen verfügt, müssen Sie entweder eine Transformation für die Verknüpfung nach Feld (äußere Verknüpfung) anwenden oder die zusätzlichen Abfragen entfernen.

Amazon Managed Grafana zeigt eine Liste der Felder an, die von der Abfrage zurückgegeben wurden. Sie können jede der folgenden Änderungen vornehmen:

  • Ändern Sie die Reihenfolge der Felder, indem Sie den Mauszeiger über einem Feld halten. Der Cursor wird zu einer Hand, und dann können Sie das Feld an die neue Position ziehen.

  • Ein Feld ein- oder ausblenden, indem Sie auf das Augensymbol neben dem Feldnamen klicken.

  • Benennen Sie Felder um, indem Sie einen neuen Namen in das Feld Umbenennen eingeben.

Feldweise verknüpfen (äußere Verknüpfung)

Verwenden Sie diese Transformation, um mehrere Zeitreihen aus einer Ergebnismenge feldweise zu verknüpfen.

Diese Transformation ist nützlich, wenn Sie Abfragen kombinieren möchten, um Ergebnisse aus den Feldern zu berechnen.

Feld aus Formel 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.

  • Modus — Wählen Sie einen Modus aus:

    • Zeile reduzieren — Wendet die ausgewählte Formel unabhängig auf jede Zeile der ausgewählten Felder an.

    • Binäre Option — Wendet eine grundlegende mathematische Operation (summultiply, usw.) auf Werte in einer einzelnen Zeile aus zwei ausgewählten Feldern an.

  • Feldname — Wählen Sie die Namen der Felder aus, die Sie in der Berechnung für das neue Feld verwenden möchten.

  • Berechnung — Wählen Sie eine Berechnung aus, die verwendet werden soll, wenn Amazon Managed Grafana das neue Feld erstellt. Wählen Sie das Feld aus, um eine Liste mit Berechnungsmöglichkeiten zu sehen. Informationen zu verfügbaren Berechnungen finden Sie unterListe der Berechnungen.

  • Alias — (Optional) Geben Sie den Namen Ihres neuen Felds ein. Wenn Sie dieses Feld leer lassen, wird das Feld so benannt, dass es der Formel entspricht.

  • Alle Felder ersetzen — (Optional) Verwenden Sie diese Option, wenn Sie alle anderen Felder ausblenden und nur Ihr berechnetes Feld in der Visualisierung anzeigen möchten.

Beschriftungen für Felder

Anmerkung

Um diese Transformation anzuwenden, muss Ihre Abfrage beschriftete Felder zurückgeben.

Wenn Sie diese Transformation auswählen, wandelt Amazon Managed Grafana automatisch alle beschrifteten Daten in Felder um.

Stellen Sie sich zum Beispiel ein Abfrageergebnis aus zwei Zeitreihen vor.

1: Beschriftungen Server=Server A, DataCenter=EU 2: Labels Server=Server B, DataCenter=EU

Diese Transformation würde zu der folgenden Tabelle führen.

Zeit Server Rechenzentrum Wert
2020-07-07 11:34:20 Server A EU 1
2020-07-07 11:34:20 Server B EU 2

Wertfeldname; Wenn Sie Server als Wertfeldnamen wählen würden, würden Sie für jeden Wert des Server Labels ein Feld erhalten.

Zeit Rechenzentrum Server A Server B
2020-07-07 11:34:20 EU 1 2

Gruppieren nach

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

Gruppieren nach

Diese Transformation gruppiert die Daten nach einem bestimmten Feldwert (Spaltenwert) und verarbeitet Berechnungen für jede Gruppe. Die verfügbaren Berechnungen sind dieselben wie für die Reduce-Transformation.

Hier ist ein Beispiel für Originaldaten.

Zeit Server ID CPU-Temperatur Serverstatus
2020-07-07 11:34:20 Server 1 80 Herunterfahren
2020-07-07 11:34:20 Server 3 62 OK
2020-07-07 10:32:20 Server 2 90 Überlastung
2020-07-07 10:31:22 Server 3 55 OK
2020-07-07 09:30:57 Server 3 62 Rebooting
2020-07-07 09:30:05 Server 2 88 OK
2020-07-07 09:28:06 Server 1 80 OK
2020-07-07 09:25:05 Server 2 88 OK
2020-07-07 09:23:07 Server 1 86 OK

Diese Transformation erfolgt in zwei Schritten. Zunächst 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 Sie beispielsweise nach dem Server ID Feld Gruppieren, werden die Daten wie folgt gruppiert:

Zeit Server ID CPU-Temperatur Serverstatus
2020-07-07 11:34:20 Server 1 80 Herunterfahren
2020-07-07 09:28:06 Server 1 80 OK
2020-07-07 09:23:07 Server 1 86 OK
2020-07-07 10:32:20 | server 2 | 90 | Overload 2020-07-07 09:30:05 | server 2 | 88 | OK 2020-07-07 09:25:05 | server 2 | 88 | OK 2020-07-07 11:34:20 | server 3 | 62 | OK 2020-07-07 10:31:22 | server 3 | 55 | OK 2020-07-07 09:30:57 | server 3 | 62 | Rebooting

Alle Zeilen mit demselben Wert von 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. Die Berechnung wird dann auf jede Zeilengruppe angewendet. Beispielsweise möchten Sie möglicherweise den Durchschnitt CPU temperature für jeden dieser Server berechnen. Sie können die auf das CPU Temperature Feld angewendete Mittelwertberechnung hinzufügen, um Folgendes zu erhalten.

Server ID CPU-Temperatur (Mittelwert)
Server 1 82
Server 2 88,6
Server 3 59,6

Und Sie können mehr als eine dieser Berechnungen hinzufügen. Sie können beispielsweise die folgenden Berechnungen verwenden.

  • Für das Feld Time können Sie den letzten Wert berechnen, um zu erfahren, wann der letzte Datenpunkt für jeden Server empfangen wurde.

  • Für das Feld Server Status können Sie den letzten Wert berechnen, um den letzten Statuswert für jeden Server zu ermitteln.

  • Für das Feld Temperature können Sie auch den letzten Wert berechnen, um die zuletzt überwachte Temperatur für jeden Server zu ermitteln.

Die Transformation „Gruppieren nach“ führt zu den folgenden Ergebnissen.

Server ID CPU-Temperatur (Mittelwert) CPU-Temperatur (letzte) Zeit (letzte) Serverstatus (zuletzt)
Server 1 82 80 2020-07-07 11:34:20 Herunterfahren
Server 2 88,6 90 2020-07-07 10:32:20 Überlastung
Server 3 59,6 62 07.07.2020 11:34:20 OK

Mit dieser Transformation können Sie einige wichtige Informationen aus Ihrer Zeitreihe extrahieren und sie auf bequeme Weise anzeigen.

Reihe zu Zeilen

Verwenden Sie diese Transformation, um die Ergebnisse 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: TimeMetric, undValue. Die Metric Spalte wird hinzugefügt, sodass Sie sehen können, aus welcher Abfrage die Metrik stammt. Passen Sie diesen Wert an, indem Sie ihn Label in der Quellabfrage definieren.

Im folgenden Beispiel geben zwei Abfragen Zeitreihendaten zurück. Sie wird als zwei separate Tabellen visualisiert, bevor die Transformation angewendet wird.

Abfrage A

Zeit Temperatur
2020-07-07 11:34:20 25
07.07.2020 10:31:22 22
2020-07-07 09:30:05 19

Abfrage B

Zeit Feuchte
2020-07-07 11:34:20 24
07.07.2020 10:32:20 29
07.07.2020 09:30:57 33

Die Anwendung der Transformation führt zu den folgenden Ergebnissen. Series to rows

Zeit Metrik Wert
2020-07-07 11:34:20 Temperatur 25
07.07.2020 11:34:20 Feuchtigkeit 22
2020-07-07 10:32:20 Feuchtigkeit 29
2020-07-07 10:31:22 Temperatur 22
2020-07-07 09:30:57 Feuchtigkeit 33
2020-07-07 09:30:05 Temperatur 19

Daten nach Wert filtern

Diese Transformation ermöglicht es Ihnen, Ihre Daten direkt im Grafana-Workspace 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 lauten wie folgt:

  • Regex — Entspricht einem Regex-Ausdruck.

  • Ist Null — Entspricht, wenn der Wert Null ist.

  • Ist nicht Null — Stimmt überein, wenn der Wert nicht Null ist.

  • Gleich — Entspricht, wenn der Wert dem angegebenen Wert entspricht.

  • Anders — Entspricht, wenn der Wert vom angegebenen Wert abweicht.

Die verfügbaren Bedingungen für Zahlenfelder lauten wie folgt:

  • Größer — Entspricht, wenn der Wert größer als der angegebene Wert ist.

  • Niedriger — Entspricht, wenn der Wert niedriger als der angegebene Wert ist.

  • Größer oder gleich — Entspricht, wenn der Wert größer oder gleich dem angegebenen Wert ist.

  • Niedriger oder gleich — Entspricht, wenn der Wert niedriger oder gleich dem angegebenen Wert ist.

  • Bereich — Entspricht einem Bereich zwischen einem angegebenen Minimum und Maximum. Das Minimum und das Maximum sind im Bereich enthalten.

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

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

Transformationen debuggen

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

Amazon Managed Grafana zeigt die Transformations-Debug-Ansicht unter der Transformationszeile an.