翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
相関関係の設定
このドキュメントのトピックは、Grafana バージョン 10.x をサポートする Grafana ワークスペース向けです。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「Grafana バージョン 9 での作業」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「Grafana バージョン 8 での作業」を参照してください。
各相関関係は、次のオプションを使用して設定できます。
- ラベル
-
視覚化に表示されるリンクラベル。
- 説明
-
オプションの説明。
- ソースデータソース
-
リンクが表示される結果のソース。
- 結果フィールド
-
視覚化でリンクが表示される場所を定義します。
- ターゲットクエリ
-
ターゲットクエリは、リンクがクリックされたときに実行されます。
- [変換]
-
ターゲットクエリに渡される、含まれるソースデータへのオプションの操作。
相関関係の作成の詳細については、「相関関係の作成」を参照してください。
ソースデータソースと結果フィールド
リンクは、相関関係のソースデータソースからの結果に関して、Explore の視覚化に表示されます。リンクは、相関設定で提供された結果 (結果フィールド) のフィールドの 1 つに割り当てられます。各視覚化では、異なる方法でリンクを含むフィールドが表示されます。
ターゲットクエリ
ターゲットクエリは、視覚化でリンクがクリックされたときに実行されます。選択したターゲットデータソースのクエリエディタを使用して、ターゲットクエリを指定できます。ソースデータの結果は、変数を使用してターゲットクエリ内でアクセスできます。
相関変数
ターゲットクエリ内の変数を使用して、クエリに関連するソースデータにアクセスできます。相関関係は Grafana 変数構文を使用します。リンクが選択されると、変数にソース結果の値が入力されます。使用できる変数には 2 種類あります。
-
フィールド変数 (フィールド値とラベルへのアクセスのため）。
-
相関変数 (フィールド値と変換へのアクセスのため）。
例: ソース結果に employee というフィールドが含まれている場合、フィールドの値には以下を使用してアクセスできます。
-
フィールド変数
${__data.fields.employee}。 -
上記のフィールド値を
${employee}にマッピングする相関変数。
フィールド値を短い変数名にマッピングするだけでなく、既存のフィールドに変換を適用することで、より多くの相関変数を作成できます。
相関関係は、すべての変数が選択したデータ行に値を持つ場合にのみデータリンクを作成します。[グローバル変数]はこのルールの例外であり、返されたデータから入力する必要はありません。これらの変数は、データソースによって自動的に補間されます。
相関関係の変換
変換を使用すると、フィールド値からより多くの変数を抽出できます。変換の出力は、他の変数としてアクセスできる一連の新しい変数です。
変換には logfmt と正規表現の 2 種類があります。
各変換では、選択したフィールド値が入力として使用されます。変換の出力は、変換のタイプとオプションに基づく一連の新しい変数です。
Logfmt 変換
logfmt 変換は、[logfmt キーと値のペア]
logfmt 変換では、結果フィールドとは異なるフィールドに変換を適用する場合にのみ、入力フィールド名を指定する必要があります。field = "host=srv001 endpoint=/test
app=foo" の出力変数の例:
| 名前 | 値 |
|---|---|
| ホスト | srv001 |
| エンドポイント | /test |
| アプリケーション | foo |
正規表現変換
正規表現変換は、指定された正規表現に基づいてフィールド値を分解します。
正規表現変換オプション：
- field
入力フィールド名
- expression
-
正規表現 名前付きのキャプチャグループは、グループ名に一致する変数にマッピングされます。名前のない一致グループが使用されている場合、最初の一致から変数が作成されます。この値は、入力フィールドに一致する変数を上書きするか、mapValue が指定されている場合は新しい変数が作成されます (次の表の例を参照）。
- mapValue
-
一致する名前付きのグループのない単純な正規表現グループで使用されます。デフォルトでは、最初の一致は、入力として使用されるフィールドの名前で変数をオーバーライドします。デフォルトの動作を変更するには、mapValue プロパティを指定します。指定された名前は、新しい変数の作成に使用されます。これは、対象のクエリで、正確な値と変換で抽出された値の一部の両方が必要な場合に役立ちます。
例: 選択したフィールド名が employeeで、フィールド値が John Doe であると仮定します。
式および mapValue オプションに基づくさまざまな出力変数：
| expression | mapValue | 出力変数 | コメント |
|---|---|---|---|
/\w+ (\w+)/ |
- | employee=Doe |
mapValue が指定されていません。最初の一致は、既存のフィールド名変数 (employee) にマッピングされます。 |
/(\w+) (\w+)/ |
名前 | name=John |
最初のマッチングは、name という新しい変数にマッピングされます。 |
/(?\w+) (?\w+)/ |
- | firstName=John, lastName=Doe |
名前付きグループを使用すると、出力変数の名前になり、mapValue は無視されます。 |
/(?\w+) (?\w+)/ |
名前 | firstName=John, lastName=Doe |
上記と同じ |
