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

# データリンクの設定
<a name="v10-panels-configure-data-links"></a>

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

データリンクを使用すると、リンクへのより詳細なコンテキストを提供できます。カーソルの下に系列名または値を含むリンクを作成できます。例えば、視覚化で 4 つのサーバーが表示されている場合は、そのうちの 1 つまたは 2 つにデータリンクを追加できます。データリンクを使用してパネルをリンクすることもできます。

リンク自体には、視覚化に応じてさまざまな方法でアクセスできます。例えば、時系列の視覚化では、データポイントまたは行を選択します。統計、ゲージ、棒ゲージなどの広域視覚化では、視覚化の任意の場所を選択してコンテキストメニューを開くことができます。

視覚化にデータリンクが 1 つしかない場合、視覚化の任意の場所を選択すると、コンテキストメニューではなくリンクが開きます。

**サポートされている視覚化**
+ 棒グラフ
+ 棒ゲージ
+ ローソク足チャート
+ キャンバス
+ ゲージ
+ ジオマップ
+ ヒートマップ
+ ヒストグラム
+ 円グラフ
+ 統計
+ 状態タイムライン
+ ステータス履歴
+ [テーブル]
+ 時系列
+ トレンド

## データリンク変数
<a name="v10-panels-data-link-variables"></a>

データリンクの変数を使用すると、データフィルターが保持された詳細なダッシュボードにユーザーを送信できます。例えば、 変数を使用して、ラベル、時間範囲、系列、または変数の選択を指定できます。

使用可能な変数のリストを表示するには、データリンク **URL** フィールドに `$` を入力します。

データリンク URL のテンプレート変数も使用できます。「[変数](v10-dash-variables.md)」を参照してください。

### 時間範囲パネル変数
<a name="v10-panels-time-range-panel-variables"></a>

これらの変数を使用すると、データリンク URL に現在の時間範囲を含めることができます。
+ `__url_time_range` – 現在のダッシュボードの時間範囲 (`?from=now-6h&to=now` など)
+ `$__from` – 詳細については、「[グローバル変数](v10-dash-variable-add.md#v10-dash-variable-add-global)」を参照してください。
+ `$__to` – 詳細については、「[グローバル変数](v10-dash-variable-add.md#v10-dash-variable-add-global)」を参照してください。

### 系列変数
<a name="v10-panels-series-variables"></a>

系列固有の変数は、`__series` 名前空間で使用できます。
+ `__series.name` – URL への系統名

### フィールド変数
<a name="v10-panels-field-variables"></a>

フィールド固有の変数は、`__field` 名前空間で使用できます。
+ `__field.name` – フィールドの名前
+ `__field.labels.<LABEL>` – URL に対するラベルの値。ラベルにドットが含まれている場合は、`__field.labels["<LABEL>"]` 構文を使用します。

### 値変数
<a name="v10-panels-value-variables"></a>

値固有の変数は、`__value` 名前空間で使用できます。
+ `__value.time` – URL への値のタイムスタンプ (Unix ms エポック) (`?time=1560268814105` など)
+ `__value.raw` – raw 値
+ `__value.numeric` – 値の数値表現
+ `__value.text` – 値のテキスト表現
+ `__value.calc` – 値が計算の結果である場合の計算名

データリンクで値固有の変数を使用すると、[ツールチップ] モードの設定オプションに応じて異なる結果が表示されることがあります。

### データ変数
<a name="v10-panels-data-variables"></a>

他のフィールドの値にアクセスするには、以下を使用します。
+ `__data.fields[i]` – (同じ行にある) フィールド `i` の値。
+ `__data.fields["NameOfField"]` – インデックスの代わりに名前を使用するフィールドの値。
+ `__data.fields[i].labels.cluster` – 別のフィールドのラベルにアクセス。

### テンプレート変数
<a name="v10-panels-template-variables"></a>

テンプレート変数を使用する別のダッシュボードにリンクするときは、リンクをクリックした人の変数値を選択します。

`${var-myvar:queryparam}` - ここで、`var-myvar` は、使用する現在のダッシュボードにあるテンプレート変数と一致するテンプレート変数の名前です。


| 可変状態 | 作成された URL の結果 | 
| --- | --- | 
| 1 つの値を選択済み | var-myvar=value1 | 
| 複数の値を選択済み | var-myvar=value1&var-myvar=value2 | 
| All を選択済み | var-myvar=All | 

現在のダッシュボードのすべての変数を URL に追加する場合は、`${__all_variables}` を使用します。

## データリンクの追加
<a name="v10-panels-add-a-datalink"></a>

パネルにデータリンクを追加できます。

1. データリンクを追加するパネルに移動します。

1. パネルにカーソルを合わせると、右上隅にメニューアイコンが表示されます。

1. メニューから、**[編集]** を選択してパネルエディタを開きます。

1. **[パネル編集]** ペインで、**[データリンク]** セクションまでスクロールダウンして展開します。

1. **[リンクの追加]** を選択します。

1. 開いたダイアログボックスに、**[タイトル]**を入力します。これは、判読可能なリンクラベルで、リンクは UI に表示されます。

1. リンク先の **[URL]** または変数を入力します。

   データリンク変数を追加するには、**URL** フィールドを選択し、`$` を入力するか、Ctrl\+Space または Cmd\+Space を押すと、使用可能な変数のリストが表示されます。

1. リンクを新しいタブで開く場合は、**[新しいタブで開く]** を選択します。

1. **[保存]** を選択して変更を保存し、ダイアログボックスを閉じます。

1. ダッシュボードに変更を保存します。