本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
配置数据链接
本文档主题专为支持 Grafana 9.x 版本的 Grafana 工作空间而设计。
有关支持 Grafana 版本 10.x 的 Grafana 工作空间,请参阅。在 Grafana 版本 10 中工作
有关支持 Grafana 8.x 版本的 Grafana 工作空间,请参阅。在 Grafana 版本 8 中工作
您可以使用数据链接变量或数据链接在面板之间创建链接。
数据链接变量
您可以使用数据链接中的变量来引用系列字段、标签和值。有关数据链接的更多信息,请参阅数据链接。
要查看可用变量列表,请在数据链接 URL 字段中键入 $ 以查看可以使用的变量列表。
注意
这些变量在 6.4 中发生了变化,因此,如果您使用的是旧版本的 Grafana,请使用版本选择器为旧版本的 Grafana 选择文档。
您也可以在数据链接 URL 中使用模板变量,请参阅添加和管理仪表板变量。
时间范围面板变量
这些变量允许您在数据链接 URL 中包含当前时间范围。
-
__url_time_range-当前仪表板的时间范围(即? from=now-6h&to=now)
-
$__from 和 $__to-有关更多信息,请参阅。全局变量
系列变量
系列特定的变量在 __series 命名空间下可用:
-
__series.name-网址的系列名称
字段变量
字段特定的变量在 __ field 命名空间下可用:
-
__field.name-字段的名称
-
__field.labels。 <LABEL>-标签对网址的值。如果您的标签包含点,请使用 __field.labels [” “<LABEL>] 语法。
值变量
值特定的变量在 __value 命名空间下可用:
-
__value. time-值的时间戳(Unix ms epoch)到网址(即? time=1560268814105)
-
__value.raw-原始值
-
__value.numeric-值的数字表示形式
-
__value.text-值的文本表示形式
-
__value.calc-如果该值是计算结果,则为计算名称
模板变量
当链接到另一个使用模板变量的仪表板时,请为任何点击该链接的人选择变量值。
$ {var-myvar: queryparam}-其中 var-myvar 是模板变量的名称,该变量与当前仪表板中你要使用的变量相匹配。
变量状态 | 生成创建的网址 |
---|---|
选择了一个值 | var-myvar=value1 |
选择了多个值 | var-myvar=value1&var-myvar=value2 |
已选择全部 | var-myvar=all |
如果你想将当前仪表板的所有变量添加到网址中,请使用 $ {__all_ variables}。
数据链接
数据链接允许您为链接提供更精细的上下文。您可以创建包含系列名称甚至光标下方的值的链接。例如,如果您的可视化显示四台服务器,则可以向其中一两台服务器添加数据链接。
根据可视化效果,可以通过不同的方式访问链接本身。对于图形,您需要单击数据点或线;对于像统计、仪表盘或条形仪表这样的面板,您可以单击可视化中的任意位置以打开快捷菜单。
您可以使用数据链接中的变量将人们带到带有保留数据筛选器的详细仪表板。例如,您可以使用变量来指定时间范围、序列和变量选择。有关更多信息,请参阅 数据链接变量。
提前打字建议
创建或更新数据链接时,按键盘上的 Cmd+Space 或 Ctrl+Space 打开预输入建议,以便更轻松地向网址添加变量。
添加数据链接
-
将光标悬停在要添加链接的面板上,然后按 e。或者单击面板标题旁边的下拉箭头,然后单击 “编辑”。
-
在 “字段” 选项卡上,向下滚动到 “数据链接” 部分。
-
展开 “数据链接”,然后单击 “添加链接”。
-
输入标题。标题是用户可读的链接标签,将显示在用户界面中。
-
输入您要链接到的 URL。
您甚至可以添加仪表板中定义的模板变量之一。在 URL 字段中单击,然后键入 $ 或按 Ctrl+Space 或 Cmd+Space 查看可用变量列表。通过向面板链接添加模板变量,该链接会将用户引导到正确的上下文,相关变量已设置完毕。有关更多信息,请参阅 数据链接变量。
-
如果您想在新选项卡中打开链接,请选择在新选项卡中打开。
-
单击 “保存” 保存更改并关闭窗口。
-
点击右上角的 “保存”,将您所做的更改保存到控制面板。
更新数据链接
-
在 “字段” 选项卡上,找到要对其进行更改的链接。
-
单击 “编辑”(铅笔)图标打开 “编辑” 链接窗口。
-
进行任何必需的更改。
-
单击 “保存” 保存更改并关闭窗口。
-
点击右上角的 “保存”,将您所做的更改保存到控制面板。
删除数据链接
-
在 “字段” 选项卡上,找到要删除的链接。
-
单击要删除的链接旁边的 X 图标。
-
点击右上角的 “保存”,将您所做的更改保存到控制面板。