翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Grafana バージョン 10 の相関関係
<a name="v10-correlations"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

相関を設定することで、Explore ビジュアライゼーションのインタラクティブリンクを作成して、提示されたデータに関連するクエリを実行できます。

相関は、あるデータソース内のデータを使用して別のデータソース内のデータをクエリする方法を定義します。例:
+ ログデータソースで返されるアプリケーション名を使用して、メトリクスデータソース内のそのアプリケーションに関連するメトリクスをクエリできます。
+ SQL データソースから返されるユーザー名を使用して、ログデータソース内の特定のユーザーに関連するログをクエリできます。

Explore では、ユーザー定義の相関関係を使用して、視覚化内のリンクを表示します。リンクをクリックすると、関連するクエリが実行され、Explore Split View で結果を確認できます。

相関関係に基づくリンクの表示を現在サポートしている視覚化について説明します。
+ [ログ](v10-panels-logs.md)
+ [[テーブル]](v10-panels-table.md)

相関関係は、Grafana で **[管理] > [プラグインとデータ] > [相関]** ページを使用するか、[[Explore]](v10-explore-correlations.md) で直接設定できます。

**Topics**
+ [相関関係の設定](v10-correlations-config.md)
+ [新しい相関関係を作成する](v10-correlations-create.md)

# 相関関係の設定
<a name="v10-correlations-config"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

 各相関関係は、次のオプションを使用して設定できます。

**ラベル**  
視覚化に表示されるリンクラベル。

**説明**  
オプションの説明。

**ソースデータソース**  
リンクが表示される結果のソース。

**結果フィールド**  
視覚化でリンクが表示される場所を定義します。

**ターゲットクエリ**  
ターゲットクエリは、リンクがクリックされたときに実行されます。

**[変換]**  
ターゲットクエリに渡される、含まれるソースデータへのオプションの操作。

相関関係の作成の詳細については、「[相関関係の作成](v10-correlations-create.md)」を参照してください。

## ソースデータソースと結果フィールド
<a name="v10-correlations-config-source-and-result"></a>

リンクは、相関関係のソースデータソースからの結果に関して、Explore の視覚化に表示されます。リンクは、相関設定で提供された結果 (結果フィールド) のフィールドの 1 つに割り当てられます。各視覚化では、異なる方法でリンクを含むフィールドが表示されます。

## ターゲットクエリ
<a name="v10-correlations-config-target-query"></a>

ターゲットクエリは、視覚化でリンクがクリックされたときに実行されます。選択したターゲットデータソースのクエリエディタを使用して、ターゲットクエリを指定できます。ソースデータの結果は、変数を使用してターゲットクエリ内でアクセスできます。

### 相関変数
<a name="v10-correlations-config-variables"></a>

ターゲットクエリ内の変数を使用して、クエリに関連するソースデータにアクセスできます。相関関係は [Grafana 変数構文](v10-dash-variable-syntax.md)を使用します。リンクが選択されると、変数にソース結果の値が入力されます。使用できる変数には 2 種類あります。
+ [フィールド変数](v10-panels-configure-data-links.md#v10-panels-data-link-variables) (フィールド値とラベルへのアクセスのため）。
+ 相関変数 (フィールド値と変換へのアクセスのため）。

例: ソース結果に `employee` というフィールドが含まれている場合、フィールドの値には以下を使用してアクセスできます。
+ フィールド変数 `${__data.fields.employee}`。
+ 上記のフィールド値を `${employee}` にマッピングする相関変数。

フィールド値を短い変数名にマッピングするだけでなく、既存のフィールドに変換を適用することで、より多くの相関変数を作成できます。

相関関係は、すべての変数が選択したデータ行に値を持つ場合にのみデータリンクを作成します。[[グローバル変数]](v10-dash-variable-add.md#v10-dash-variable-add-global)はこのルールの例外であり、返されたデータから入力する必要はありません。これらの変数は、データソースによって自動的に補間されます。

### 相関関係の変換
<a name="v10-correlations-config-transformations"></a>

変換を使用すると、フィールド値からより多くの変数を抽出できます。変換の出力は、他の変数としてアクセスできる一連の新しい変数です。

変換には logfmt と正規表現の 2 種類があります。

各変換では、選択したフィールド値が入力として使用されます。変換の出力は、変換のタイプとオプションに基づく一連の新しい変数です。

### Logfmt 変換
<a name="v10-correlations-config-logfmt-transformation"></a>

logfmt 変換は、[[logfmt キーと値のペア]](https://brandur.org/logfmt) でフォーマットされたテキストを含むフィールド値を分解します。各ペアは変数になり、キーは変数の名前になります。

logfmt 変換では、結果フィールドとは異なるフィールドに変換を適用する場合にのみ、入力フィールド名を指定する必要があります。`field = "host=srv001 endpoint=/test app=foo"` の出力変数の例:


| 名前 | 値 | 
| --- | --- | 
| ホスト | srv001 | 
| エンドポイント | /test | 
| アプリケーション | foo | 

### 正規表現変換
<a name="v10-correlations-config-regular-expression-transformation"></a>

正規表現変換は、指定された正規表現に基づいてフィールド値を分解します。

正規表現変換オプション：

**field**  
入力フィールド名

**expression**  
正規表現 名前付きのキャプチャグループは、グループ名に一致する変数にマッピングされます。名前のない一致グループが使用されている場合、最初の一致から変数が作成されます。この値は、入力フィールドに一致する変数を上書きするか、mapValue が指定されている場合は新しい変数が作成されます (次の表の例を参照）。

**mapValue**  
一致する名前付きのグループのない単純な正規表現グループで使用されます。デフォルトでは、最初の一致は、入力として使用されるフィールドの名前で変数をオーバーライドします。デフォルトの動作を変更するには、mapValue プロパティを指定します。指定された名前は、新しい変数の作成に使用されます。これは、対象のクエリで、正確な値と変換で抽出された値の一部の両方が必要な場合に役立ちます。

例: 選択したフィールド名が `employee`で、フィールド値が `John Doe` であると仮定します。

式および mapValue オプションに基づくさまざまな出力変数：


| expression | mapValue | 出力変数 | コメント | 
| --- | --- | --- | --- | 
| /\$1w\$1 (\$1w\$1)/ | - | employee=Doe | mapValue が指定されていません。最初の一致は、既存のフィールド名変数 (employee) にマッピングされます。 | 
| /(\$1w\$1) (\$1w\$1)/ | 名前 | name=John | 最初のマッチングは、name という新しい変数にマッピングされます。 | 
| /(?\$1w\$1) (?\$1w\$1)/ | - | firstName=John, lastName=Doe | 名前付きグループを使用すると、出力変数の名前になり、mapValue は無視されます。 | 
| /(?\$1w\$1) (?\$1w\$1)/ | 名前 | firstName=John, lastName=Doe | 上記と同じ | 

# 新しい相関関係を作成する
<a name="v10-correlations-create"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

相関関係は、Explore の相関関係エディタで作成することも、Amazon Managed Grafana ワークスペースの Grafana **[管理]**ページを使用して作成することもできます。

**前提条件**

新しい相関関係を追加するアクセス許可が必要です。データソースへの書き込み権限を持つユーザーのみが、新しい相関関係を定義できます。

## Explore の相関関係エディタでの相関関係の作成
<a name="v10-correlations-create-explore"></a>

相関関係は、Explore 相関関係エディタで作成できます。詳細については、[相関関係の作成](v10-explore-correlations.md#v10-explore-corr-create-a-correlation)を参照してください。

## 管理ページでの相関関係の作成
<a name="v10-correlations-create-administration"></a>

Grafana コンソールの**[管理]**ページを使用して相関関係を作成できます。

**管理ページで相関関係を作成するには**

1. Grafana の**[管理]**セクションに移動します。

1. **[プラグインとデータ]** で、**[相関関係]** を開きます。

1. 右上隅の **[追加]** ボタンを選択します。

1. 相関の**ラベル**を指定します。

1. (オプション) **[説明]**を入力します。

1. 次のページに移動します。

1. **ターゲットデータソース**を指定します。

1. 変数を使用して**ターゲットクエリ**を指定します。

1. 次のページに移動します。

1. **ソースデータソース**を指定します。

1. **結果フィールド**を指定します。

1. ソースデータソースのフィールドではない変数が必要な場合は、変換を追加します。

1. **[追加]** を選択して新しい変換を追加します。

1. 変換のタイプを選択します。

1. 選択したタイプに応じて変換を設定します。

1. 相関関係を保存します。

相関関係は同じ方法で編集できますが、編集時に選択したデータソースを変更することはできません。