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.
Konfiguration der Korrelation
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
Jede Korrelation ist mit den folgenden Optionen konfiguriert:
- Label (Bezeichnung)
-
Linkbezeichnung, die in der Visualisierung angezeigt wird.
- Beschreibung
-
Optionale Beschreibung.
- Quelldatenquelle
-
Die Quelle der Ergebnisse, für die Links angezeigt wurden.
- Feld „Ergebnisse“
-
Definiert, wo der Link in einer Visualisierung angezeigt wird.
- Zielabfrage
-
Die Zielabfrage wird ausgeführt, wenn auf einen Link geklickt wird.
- Transformationen
-
Optionale Manipulationen an den enthaltenen Quelldaten, die an die Zielabfrage übergeben wurden.
Einzelheiten zum Erstellen einer Korrelation finden Sie unter Korrelation erstellen.
Quelldatenquelle und Ergebnisfeld
In Explore-Visualisierungen werden Links für die Ergebnisse aus der Quelldatenquelle der Korrelation angezeigt. Einem der Felder aus dem in der Korrelationskonfiguration bereitgestellten Ergebnis (dem Ergebnisfeld) wird ein Link zugewiesen. Jede Visualisierung zeigt Felder mit Links auf unterschiedliche Weise an.
Zielabfrage
Die Zielabfrage wird ausgeführt, wenn in der Visualisierung auf einen Link geklickt wird. Sie können den Abfrage-Editor der ausgewählten Zieldatenquelle verwenden, um die Zielabfrage anzugeben. Auf die Ergebnisse der Quelldaten kann innerhalb der Zielabfrage mit Variablen zugegriffen werden.
Korrelationsvariablen
Sie können Variablen innerhalb der Zielabfrage verwenden, um auf die Quelldaten zuzugreifen, die sich auf die Abfrage beziehen. Korrelationen verwenden die Grafana-Variablensyntax. Variablen werden mit Werten aus den Quellergebnissen gefüllt, wenn der Link ausgewählt wird. Es gibt zwei Arten von Variablen, die Sie verwenden können:
-
Feldvariablen (um auf Feldwerte und Beschriftungen zuzugreifen).
-
Korrelationsvariablen (für den Zugriff auf Feldwerte und Transformationen).
Beispiel: Wenn die Quellergebnisse ein Feld mit dem Namen enthaltenemployee, kann auf den Wert des Felds zugegriffen werden mit:
-
Eine Feldvariable
${__data.fields.employee}. -
Eine Korrelationsvariable, die den obigen Feldwert zuordnet
${employee}.
Neben der Zuordnung von Feldwerten zu kürzeren Variablennamen können mehr Korrelationsvariablen erstellt werden, indem Transformationen auf bestehende Felder angewendet werden.
Durch Korrelation wird nur dann eine Datenverknüpfung erstellt, wenn alle Variablen Werte in der ausgewählten Datenzeile haben. Globale Variablen bilden die Ausnahme von dieser Regel und müssen nicht aus den zurückgegebenen Daten ausgefüllt werden. Diese Variablen werden automatisch von Datenquellen interpoliert.
Korrelationstransformationen
Transformationen bieten eine Möglichkeit, mehr Variablen aus Feldwerten zu extrahieren. Die Ausgabe von Transformationen besteht aus einer Reihe neuer Variablen, auf die wie auf jede andere Variable zugegriffen werden kann.
Es gibt zwei Arten von Transformationen: logfmt und reguläre Ausdrücke.
Jede Transformation verwendet einen ausgewählten Feldwert als Eingabe. Die Ausgabe einer Transformation besteht aus einer Reihe neuer Variablen, die auf dem Typ und den Optionen der Transformation basieren.
Logfmt-Transformation
Die Logfmt-Transformation dekonstruiert einen Feldwert, der Text enthält, der mit logfmt-Schlüssel/Wert-Paaren formatiert ist.
Die Logfmt-Transformation erfordert nur die Angabe des Eingabefeldnamens, wenn Sie möchten, dass die Transformation auf ein anderes Feld als das Ergebnisfeld angewendet wird. Beispielausgabevariablen für: field = "host=srv001 endpoint=/test
app=foo"
| Name | Wert |
|---|---|
| Host | srv001 |
| Endpunkt | /testen |
| App | Essen |
Transformation regulärer Ausdrücke
Die Transformation für reguläre Ausdrücke dekonstruiert einen Feldwert auf der Grundlage des angegebenen regulären Ausdrucks.
Optionen für die Transformation regulärer Ausdrücke:
- field
Name des Eingabefeldes
- Ausdruck
-
Regulärer Ausdruck. Benannte Capture-Gruppen werden Variablen zugeordnet, die dem Gruppennamen entsprechen. Wenn nicht benannte übereinstimmende Gruppen verwendet werden, wird aus dem ersten Treffer eine Variable erstellt. Der Wert überschreibt die Variable, die dem Eingabefeld entspricht, oder es wird eine neue Variable erstellt, wenn MapValue angegeben wird (siehe Beispiele in der folgenden Tabelle).
- MapValue
-
Wird mit einfachen Regex-Gruppen ohne benannte passende Gruppen verwendet. Standardmäßig überschreibt die erste Übereinstimmung die Variable mit dem Namen des Felds, das als Eingabe verwendet wird. Um dieses Standardverhalten zu ändern, können Sie die MapValue-Eigenschaft angeben. Der angegebene Name wird verwendet, um eine neue Variable zu erstellen. Dies kann nützlich sein, wenn Ihre Zielabfrage sowohl den exakten Wert als auch einen Teil des mit der Transformation extrahierten Werts benötigt.
Beispiel: Angenommen, der ausgewählte Feldname ist employee und der Feldwert istJohn Doe.
Verschiedene Ausgabevariablen, die auf den Optionen Expression und MapValue basieren:
| Ausdruck | MapValue | Ausgabevariablen | Kommentar |
|---|---|---|---|
/\w+ (\w+)/ |
- | employee=Doe |
Kein MapValue angegeben. Die erste Übereinstimmung wird der vorhandenen Feldnamenvariablen () employee zugeordnet. |
/(\w+) (\w+)/ |
Name | name=John |
Die erste Übereinstimmung wird einer neuen Variablen namens zugeordnet. name |
/(?\w+) (?\w+)/ |
- | firstName=John, lastName=Doe |
Wenn benannte Gruppen verwendet werden, sind dies die Namen der Ausgabevariablen und MapValue wird ignoriert. |
/(?\w+) (?\w+)/ |
Name | firstName=John, lastName=Doe |
Wie oben |
