本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 配置数据链接
<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)。

通过数据链接，可为链接提供更精细的上下文。您可以创建包含序列名称甚至光标下值的链接。例如，如果您的可视化显示四台服务器，则可以向其中一两台服务器添加数据链接。您也可以使用数据链接来链接面板。

根据可视化效果，可通过不同的方式访问链接本身。例如，对于时间序列可视化，您可以选择数据点或数据线。对于统计、仪表或条形仪表之类的大面积可视化，您可以选择可视化中的任意位置来打开上下文菜单。

如果可视化中只有一个数据链接，则选择可视化中的任意位置都会打开链接，而不是上下文菜单。

**支持的可视化**
+ 条形图
+ 条形仪表
+ K 线图
+ Canvas
+ 计量表
+ Geomap
+ 热图
+ 直方图
+ 饼图
+ Stat
+ 状态时间轴
+ 状态历史记录
+ 表
+ 时间序列
+ 趋势

## 数据链接变量
<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-specific 变量在`__field`命名空间下可用：
+ `__field.name`：字段的名称
+ `__field.labels.<LABEL>`：URL 的标签值。如果您的标签包含点，请使用 `__field.labels["<LABEL>"]` 语法。

### 值变量
<a name="v10-panels-value-variables"></a>

Value-specific 变量在`__value`命名空间下可用：
+ `__value.time`：URL 的值的时间戳（Unix 毫秒纪元）（即 `?time=1560268814105`）
+ `__value.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 的结果 | 
| --- | --- | 
| 选择一个值 | 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. 保存对控制面板的更改。