Korrelationseditor in Explore - Amazon Managed Grafana
Eine Korrelation erstellenTransformationenBeispiele für Korrelationen

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.

Korrelationseditor in Explore

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

Korrelationen ermöglichen es Benutzern, eine Verbindung zwischen zwei beliebigen Datenquellen herzustellen. Weitere Informationen, einschließlich einer Übersicht über Korrelationen, finden Sie unter. Korrelationen in Grafana-Version 10

Eine Korrelation erstellen

Sie können Korrelationen auf der Explore-Seite erstellen.

Um eine Korrelation zu erstellen

  1. Navigieren Sie in Ihrem Amazon Managed Grafana-Arbeitsbereich zur Explore-Seite.

  2. Wählen Sie eine Datenquelle aus, die Sie als Quelle für eine neue Korrelation verwenden möchten.

  3. Führen Sie eine Abfrage aus, die Daten in einer unterstützten Visualisierung generiert.

    Anmerkung

    Unterstützte Visualisierungen sind Logs und Table.

  4. Wählen Sie in der oberen Werkzeugleiste + Hinzufügen und dann Korrelation hinzufügen (Sie können auch den Korrelationseditor aus der Befehlspalette auswählen).

    Explore befindet sich jetzt im Korrelationseditor-Modus, was durch einen blauen Rand und eine obere Leiste gekennzeichnet ist. Sie können den Correlations Editor beenden, indem Sie in der oberen Leiste Beenden wählen.

  5. Sie können jetzt die folgenden neuen Korrelationen für die Visualisierung mit Links erstellen, die an die Daten angehängt sind und die Sie verwenden können, um eine neue Abfrage zu erstellen:

    • Protokolle — Links werden neben den Feldwerten in den Protokolldetails für jede Protokollzeile angezeigt.

    • Tabelle — jede Tabellenzelle ist ein Link.

  6. Wählen Sie einen Link, um eine neue Korrelation hinzuzufügen. Links sind mit einem Feld verknüpft, das als Ergebnisfeld einer Korrelation verwendet wird. Weitere Details finden Sie unter Konfiguration der Korrelation.

  7. Verwenden Sie in der sich öffnenden geteilten Ansicht den rechten Bereich, um die Zielabfragequelle der Korrelation einzurichten. Weitere Details finden Sie unter Zielabfrage.

  8. Erstellen Sie eine Zielabfrage mithilfe der Variablensyntax mit Variablen aus der Liste oben im Bereich. Die Liste enthält Beispielwerte aus der ausgewählten Datenzeile.

  9. Geben Sie eine Bezeichnung und eine Beschreibung an (optional). Ein Label wird als Name des Links in der Visualisierung verwendet und kann Variablen enthalten.

  10. Stellen Sie Transformationen bereit (optional; Einzelheiten siehe unten).

  11. Wählen Sie in der oberen Werkzeugleiste Speichern, um die Korrelation zu speichern und den Modus Korrelationseditor zu verlassen. Der Link, mit dem die Korrelation erstellt wurde, wird in jeder Zeile durch einen Datenlink ersetzt. Wenn der Link ausgewählt ist, wird die von Ihnen definierte Abfrage in einem anderen Bereich ausgeführt, wobei die Variablen dynamisch durch die Werte aus der ausgewählten Zeile ersetzt werden.

Transformationen

Transformationen ermöglichen es Ihnen, Werte zu extrahieren, die in einem Feld mit anderen Daten vorhanden sind. Mithilfe einer Transformation können Sie beispielsweise einen Teil einer Protokollzeile extrahieren, um ihn in einer Korrelation zu verwenden. Weitere Informationen zu Transformationen in Korrelationen finden Sie unter. Korrelationstransformationen

Nachdem Sie im Editor-Modus einen der generierten Links ausgewählt haben, können Sie Transformationen hinzufügen, indem Sie im Drop-down-Menü Transformationen die Option Transformation hinzufügen auswählen.

Um eine Transformation in einer Korrelation zu verwenden

  1. Wählen Sie ein Feld aus, auf das die Transformation angewendet werden soll. Wählen Sie den Teil des Felds aus, den Sie für die Transformation verwenden möchten. Zum Beispiel eine Protokollzeile. Nach der Auswahl wird der Wert dieses Felds verwendet, um Sie bei der Erstellung der Transformation zu unterstützen.

  2. Wählen Sie den Typ der Transformation aus. Die Optionen und relevanten Einstellungen finden Korrelationstransformationen Sie unter.

  3. Je nach Ihrer Auswahl werden möglicherweise eine oder mehrere Variablen aufgefüllt, oder Sie müssen möglicherweise weitere Spezifikationen in den angezeigten Optionen angeben.

  4. Wählen Sie Transformation zur Korrelation hinzufügen aus, um die angegebenen Variablen zur Liste der verfügbaren Variablen hinzuzufügen.

Anmerkung

Für reguläre Ausdrücke in diesem Dialogfeld werden die in anderen Dokumentationen mapValue genannten Variable Name hier aufgerufen. Grafana markiert jeden Text, der dem Ausdruck im Feldwert entspricht. Verwenden Sie Gruppen zur Erfassung regulärer Ausdrücke, um auszuwählen, welcher Teil des Treffers extrahiert werden soll. Wenn ein gültiger regulärer Ausdruck angegeben wird, werden die Variable und der Wert dieser Variablen unter dem Variable Name Feld angezeigt.

Beispiele für Korrelationen

Die folgenden Beispiele zeigen, wie Korrelationen mithilfe des Korrelationseditors in Explore erstellt werden. Wenn Sie diesen Beispielen folgen möchten, stellen Sie sicher, dass Sie eine Testdatenquelle einrichten.

Einen Text zur grafischen Darstellung der Korrelation erstellen

Dieses Beispiel zeigt, wie Sie mit dem Korrelationseditor in Explore eine Korrelation erstellen.

Korrelationen ermöglichen es Ihnen, die Ergebnisse einer Abfrage zu verwenden, um eine neue Abfrage in einer beliebigen Datenquelle auszuführen. In diesem Beispiel führen Sie eine Abfrage aus, die Tabellendaten rendert. Die Daten werden verwendet, um eine andere Abfrage auszuführen, die ein Diagrammergebnis liefert.

Um diesem Beispiel zu folgen, stellen Sie sicher, dass Sie eine Testdatenquelle eingerichtet haben.

Um eine Korrelation zwischen Text und Diagramm zu erstellen

  1. Navigieren Sie in Grafana zu Explore.

  2. Wählen Sie die Testdatenquelle aus dem Drop-down-Menü oben links auf der Seite aus.

  3. Wählen Sie + Hinzufügen im Drop-down-Menü auf der rechten Seite und wählen Sie Korrelation hinzufügen aus.

  4. Explore befindet sich jetzt im Correlations Editor-Modus, was durch einen blauen Rand gekennzeichnet ist.

  5. Wählen Sie das folgende Szenario aus dem Szenario-Dropdownmenü aus: CSV-Datei.

  6. Wählen Sie die Datei population_by_state.csv aus. Jede Zelle ist ein Link, auf den Sie klicken können, um mit der Erstellung einer neuen Korrelation zu beginnen.

  7. Klicken Sie auf eine beliebige Zelle in der State Spalte, um eine neue Korrelation zu erstellen, die diesem Eintrag einen Datenlink zuordnet. Wählen Sie California beispielsweise.

  8. Wählen Sie in der geteilten Ansicht dieselbe Datenquelle aus, die Sie im linken Bereich ausgewählt haben. Der Helper über dem Abfrage-Editor enthält alle verfügbaren Variablen, die Sie für die Zielabfrage verwenden können. Variablen enthalten alle Datenfelder (Tabellenspalten) aus der ausgewählten Zeile.

  9. Wählen Sie im Menü Szenario die Option CSV-Metrikwerte aus. Das String Input Feld im Abfrage-Editor enthält Variablen mit Populationswerten für jedes Jahr:${1980},${2000},${2020}. Dadurch wird ein Diagramm mit Variablenwerten generiert.

  10. Geben Sie im Feld Alias des Abfrage-Editors Folgendes ein${State}.

    Führen Sie eine Abfrage aus, um festzustellen, ob anhand von Beispielwerten aus den Variablen ein Diagramm erstellt wird.

  11. Wählen Sie Speichern, um die Korrelation zu speichern und den Korrelationseditor zu beenden.

    Nachdem die Korrelation gespeichert wurde, führt Explore die Abfrage im linken Bereich erneut aus. Wenn Sie auf einen Statusnamen klicken, wird die Abfrage auf der rechten Seite erneut ausgeführt, wobei Werte aus der Zeile in die CSV-Datei eingefügt werden, wodurch das Diagramm geändert wird. Die Abfrage wird jedes Mal, wenn Sie auf einen Bundesstaatsnamen klicken, mit aktualisierten Werten erneut ausgeführt.

Sie können dieselben Schritte auf jede Datenquelle anwenden. Korrelationen ermöglichen es Ihnen, Links in Visualisierungen zu erstellen, um dynamische Abfragen auf der Grundlage ausgewählter Daten auszuführen. In diesem Beispiel haben wir Daten verwendet, die von einer Abfrage zurückgegeben wurden, um eine neue Abfrage zu erstellen, die eine andere Visualisierung mit derselben Datenquelle generiert. Sie können jedoch Korrelationen zwischen beliebigen Datenquellen herstellen, um benutzerdefinierte Erkundungsabläufe zu erstellen.

Korrelation zwischen Protokollen und Tabellen erstellen

In diesem Beispiel erstellen Sie eine Korrelation, um zu demonstrieren, wie Sie mithilfe von Transformationen Werte aus der Protokollzeile und einem anderen Feld extrahieren können.

Um diesem Beispiel zu folgen, stellen Sie sicher, dass Sie eine Testdatenquelle eingerichtet haben.

Um eine Korrelation zwischen Protokollen und Tabellen zu erstellen

  1. Navigieren Sie in Grafana zu Explore.

  2. Wählen Sie die Testdatenquelle aus dem Drop-down-Menü oben links auf der Seite aus.

  3. Wählen Sie + Hinzufügen im Drop-down-Menü auf der rechten Seite und wählen Sie Korrelation hinzufügen aus.

  4. Explore befindet sich jetzt im Correlations Editor-Modus, was durch einen blauen Rand gekennzeichnet ist.

  5. Wählen Sie im Menü Szenario die Option Protokolle aus.

  6. Erweitern Sie eine Protokollzeile, um die Korrelationslinks zu sehen. Wählen Sie Correlate with hostname.

  7. Explore wird in einer geteilten Ansicht geöffnet. Wählen Sie dieselbe Datenquelle aus, die Sie im linken Bereich ausgewählt haben. Der Helper über dem Abfrage-Editor enthält alle verfügbaren Variablen, die Sie für die Zielabfrage verwenden können.

  8. Erweitern Sie den Abschnitt Transformationen und klicken Sie auf Transformation hinzufügen.

  9. Wählen Sie im Dropdownmenü Feld die Option Nachricht aus. Die Protokollzeile wird als Beispieldaten angezeigt.

  10. Wählen Sie unter Typ die Option Logfmt aus. Dadurch wird die Liste der Variablen aufgefüllt.

  11. Wählen Sie Transformation zur Korrelation hinzufügen aus.

  12. Wählen Sie erneut Transformation hinzufügen und wählen Sie unter Feld den Hostnamen aus.

  13. Wählen Sie unter Typ die Option Regulärer Ausdruck aus.

  14. Geben Sie unter Ausdruck Folgendes ein:-([0-9]\*). Dadurch werden alle Zahlen rechts vom Bindestrich ausgewählt.

  15. Geben Sie unter Variablenname Folgendes ein:hostNumber. Dadurch wird die Liste der Variablen aufgefüllt.

  16. Wählen Sie Transformation zur Korrelation hinzufügen aus, um sie zu den anderen Variablen hinzuzufügen.

  17. Öffnen Sie im Datenquellen-Editor das Dropdownmenü Szenario und wählen Sie CSV-Inhalt aus.

  18. Geben Sie im Textfeld unten Folgendes ein und speichern Sie die Korrelation:

    time,msg,hostNumber,status
${time},${msg},${hostNumber},${status}

    Dadurch wird die geteilte Ansicht geschlossen und die linke Abfrage erneut ausgeführt. Erweitern Sie eine beliebige Protokollzeile, um die Korrelationsschaltfläche zu sehen. Wenn Sie die Korrelationsschaltfläche wählen, öffnet sich die geteilte Ansicht mit time (einem Feld), msg (extrahiert mit logfmt aus der Protokollzeile), host number (extrahiert mit Regex aus derhostname) und status (extrahiert mit logfmt aus der Protokollzeile).