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