本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
配置数据链接
本文档主题专为支持 Grafana 版本 10.x 的 Grafana 工作空间而设计。
有关支持 Grafana 9.x 版本的 Grafana 工作空间,请参阅。在 Grafana 版本 9 中工作
有关支持 Grafana 8.x 版本的 Grafana 工作空间,请参阅。在 Grafana 版本 8 中工作
数据链接允许您为链接提供更精细的上下文。您可以创建包含系列名称甚至光标下方的值的链接。例如,如果您的可视化显示四台服务器,则可以向其中一两台服务器添加数据链接。您也可以使用数据链接来链接面板。
根据可视化效果,可以通过不同的方式访问链接本身。例如,对于时间序列可视化,您可以选择数据点或线。对于大面积可视化,例如统计数据、仪表盘或条形仪表,您可以选择可视化中的任意位置来打开快捷菜单。
如果可视化中只有一个数据链接,则选择可视化中的任意位置将打开链接,而不是快捷菜单。
支持的可视化效果
条形图
条形仪表
K 线图
画布
计量表
地理地图
热图
直方图
饼图
Stat
州时间表
状态历史记录
表
时间序列
趋势
数据链接变量
数据链接中的变量允许您将人员发送到带有保留数据筛选器的详细仪表板。例如,您可以使用变量来指定标签、时间范围、序列或变量选择。
要查看可用变量的列表,请在数据链接 URL 字段$
中键入。
您也可以在数据链接 URL 中使用模板变量,请参阅Variables。
时间范围面板变量
这些变量允许您在数据链接 URL 中包含当前时间范围。
系列变量
系列特定的变量可在__series
命名空间下找到:
-
__series.name
— 网址的系列名称
字段变量
特定于字段的变量在命名空间下__field
可用:
-
__field.name
— 字段的名称 -
__field.labels.<LABEL>
— 标签对网址的值。如果您的标签包含圆点,则使用__field.labels["<LABEL>"]
语法。
值变量
特定于值的变量在__value
命名空间下可用:
-
__value.time
— 值的时间戳(Unix ms epoch)到 URL(即)?time=1560268814105
-
__value.raw
— 原始价值 -
__value.numeric
— 值的数字表示 -
__value.text
— 值的文本表示形式 -
__value.calc
-如果值是计算结果,则计算名称
根据工具提示模式的设置选项,在数据链接中使用特定于值的变量可能会显示不同的结果。
数据变量
要访问其他字段中的值,请使用:
-
__data.fields[i]
— 字段的值i
(在同一行上)。 -
__data.fields["NameOfField"]
— 使用名称而不是索引的字段值。 -
__data.fields[i].labels.cluster
— 访问另一个字段的标签。
模板变量
当链接到另一个使用模板变量的仪表板时,请为任何点击该链接的人选择变量值。
${var-myvar:queryparam}
— 其中var-myvar
是与当前仪表板中要使用的模板变量相匹配的模板变量的名称。
变量状态 | 生成创建的网址 |
---|---|
选择了一个值 | var-myvar=value1 |
选择了多个值 | var-myvar=value1&var-myvar=value2 |
已选择 All |
var-myvar=All |
如果要将当前仪表板的所有变量添加到 URL 中,请使用${__all_variables}
。
添加数据链接
您可以向面板添加数据链接。
-
导航到要向其添加数据链接的面板。
-
将鼠标悬停在面板上方可在右上角显示菜单图标。
-
从菜单中选择 “编辑” 以打开面板编辑器。
-
在面板编辑窗格中,向下滚动到数据链接部分并将其展开。
-
选择 “添加链接”。
-
在打开的对话框中,输入标题。这是链接的可读标签,将显示在用户界面中。
-
输入要链接到的 URL 或变量。
要添加数据链接变量,请选择 URL 字段,然后输入
$
或按 Ctrl+Space 或 Cmd+Space 以查看可用变量列表。 -
如果您想在新选项卡中打开链接,请选择在新选项卡中打开。
-
选择 “保存” 以保存更改并关闭对话框。
-
将您所做的更改保存到控制面板。