本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
管理控制面板链接
本文档主题专为支持 Grafana 9.x 版本的 Grafana 工作空间而设计。
有关支持 Grafana 版本 10.x 的 Grafana 工作空间,请参阅。在 Grafana 版本 10 中工作
有关支持 Grafana 8.x 版本的 Grafana 工作空间,请参阅。在 Grafana 版本 8 中工作
您可以使用链接在常用仪表板之间导航,或者将其他人连接到您的可视化效果。通过链接,您可以创建指向其他仪表板、面板甚至外部网站的快捷方式。
Grafana 支持仪表板链接、面板链接和数据链接。仪表板链接显示在仪表板的顶部。单击面板左上角的图标即可访问面板链接。
选择要使用的链接
首先弄清楚你目前在仪表板之间导航的方式。如果你经常在一组仪表板之间跳来跳去,难以在每个仪表板中找到相同的上下文,那么链接可以帮助优化你的工作流程。
下一步是找出哪种链接类型适合您的工作流程。尽管 Grafana 中的所有链接类型都用于创建指向其他仪表板或外部网站的快捷方式,但它们在不同的上下文中起作用。
-
如果链接与仪表板中的大多数(如果不是全部)面板相关,请使用仪表板链接。
-
如果要深入了解特定的面板,请使用面板链接。
-
如果要链接到外部站点,则可以使用仪表板链接或面板链接。
-
如果您想深入研究特定的系列,甚至是单个测量,请使用数据链接。
使用 URL 控制时间范围
要控制面板或仪表板的时间范围,可以在控制面板 URL 中提供查询参数:
-
from
定义时间范围的下限,以 ms epoch 为单位指定。 -
to
定义时间范围的上限,以 ms epoch 为单位指定。 -
time
并time.window
定义了从time-time.window/2
到的时间范围time+time.window/2
。两个参数都应以 ms 为单位指定。例如,?time=1500000000000&time.window=10000
将得出 10 秒的时间范围从 1499999995000 到 1500000005000。
仪表板链接
创建仪表板链接时,可以包括时间范围和当前模板变量,以便直接跳转到另一个仪表板中的相同上下文。这样,您就不必担心发送链接的人是否在查看正确的数据。有关其他类型的链接,请参阅数据链接变量。
仪表板链接也可以用作外部系统的快捷方式,例如使用当前仪表板名称提交 GitHub 问题
添加仪表板链接后,它将显示在仪表板的右上角。
向仪表板添加链接
在当前仪表板的顶部添加指向其他仪表板的链接。
-
在查看要关联的仪表板时,点击屏幕顶部的齿轮打开仪表板设置。
-
单击 “链接”,然后单击 “添加仪表板链接” 或 “新建”。
-
在类型中,选择仪表板。
-
从以下选项中选择链接选项。
-
使用标签:输入标签,将链接的仪表板限制为仅包含带有您输入标签的仪表板。否则,Grafana 会包含指向所有其他仪表板的链接。
-
作为下拉列表:如果您要链接到很多仪表板,则可能需要选择此选项并在下拉列表中添加可选标题。否则,Grafana 会在控制面板顶部并排显示控制面板链接。
-
时间范围:选择此选项可在链接中包含仪表板的时间范围。当用户点击链接时,链接的仪表板将打开,并且指定的时间范围已经设置。
-
变量值:选择此选项可在链接中包含当前用作查询参数的模板变量。当用户单击链接时,链接的仪表板中的所有匹配模板都将设置为链接中的值。有关更多信息,请参阅控制面板 URL 变量。
-
在新标签页中打开:如果您想在新选项卡或窗口中打开仪表板链接,请选择此选项。
-
-
单击 Add (添加)。
向控制面板添加 URL 链接
在当前控制面板的顶部添加指向网址的链接。您可以链接到任何可用的 URL,包括仪表板、面板或外部站点。您甚至可以控制时间范围,确保用户在 Grafana 中放大正确的数据。
-
在查看要关联的仪表板时,点击屏幕顶部的齿轮打开仪表板设置。
-
单击 “链接”,然后单击 “添加仪表板链接” 或 “新建”。
-
在 “类型” 中,选择 “链接”。
-
从以下选项中选择链接选项。
-
网址:输入您要链接到的网址。根据目标的不同,您可能需要包括字段值。有关更多信息,请参阅此 Github 示例
。 -
标题:输入您希望链接显示的标题。
-
工具提示:输入您希望链接显示的工具提示。
-
图标:选择要与链接一起显示的图标。
-
时间范围:选择此选项可在链接中包含仪表板的时间范围。当用户单击链接时,链接的仪表板将打开,并设置了指定的时间范围。
-
from
定义时间范围的下限,以 ms epoch 为单位指定。 -
to
定义时间范围的上限,以 ms epoch 为单位指定。 -
time
并time.window
定义了从time-time.window/2
到的时间范围time+time.window/2
。两个参数都应以 ms 为单位指定。例如,?time=1500000000000&time.window=10000
将得出 10 秒的时间范围从 1499999995000 到 1500000005000。
-
-
变量值:选择此选项可在链接中包含当前用作查询参数的模板变量。当用户单击链接时,链接的仪表板中的所有匹配模板都将设置为链接中的值。
变量格式如下:
https://${you-domain}/path/to/your/dashboard?var-${template-varable1}=value1&var-{template-variable2}=value2
-
在新标签页中打开:如果您想在新标签页或窗口中打开仪表板链接,请选择此选项
-
-
单击 Add (添加)。
更新控制面板链接
要更改或更新现有的仪表板链接,请按照以下步骤操作。
-
在 “控制面板设置” 的 “链接” 选项卡上,单击要编辑的现有链接。
-
更改设置,然后单击 “更新”。
复制仪表板链接
要复制现有的仪表板链接,请单击要复制的现有链接旁边的复制图标。
删除仪表板链接
要删除现有的仪表板链接,请单击要删除的重复图标旁边的垃圾桶图标。
面板链接
每个面板可以有自己的一组链接,这些链接显示在面板的左上角。您可以链接到任何可用的 URL,包括仪表板、面板或外部站点。您甚至可以控制时间范围,确保用户在 Grafana 中放大正确的数据。
要查看可用的面板链接,请单击面板左上角的图标。
-
添加面板链接:每个面板可以有自己的一组链接,这些链接显示在面板的左上角。您可以链接到任何可用的 URL,包括仪表板、面板或外部站点。您甚至可以控制时间范围,确保用户在 Grafana 中放大正确的数据。单击面板左上角的图标可查看可用的面板链接。
-
将光标悬停在要添加链接的面板上,然后按
e
。或者单击面板标题旁边的下拉箭头,然后单击 “编辑”。 -
在 “面板” 选项卡上,向下滚动到 “链接” 部分。
-
展开 “链接”,然后单击 “添加链接”。
-
输入标题。标题是用户可读的链接标签,将显示在用户界面中。
-
输入您要链接到的 URL。您甚至可以添加仪表板中定义的模板变量之一。按
Ctrl+Space
或Cmd+Space
并单击 URL 字段以查看可用的变量。通过向面板链接添加模板变量,该链接会将用户引导到正确的上下文,相关变量已设置完毕。您也可以使用时间变量。
-
from
定义时间范围的下限,以 ms epoch 为单位指定。 -
to
定义时间范围的上限,以 ms epoch 为单位指定。 -
time
并time.window
定义了从time-time.window/2
到的时间范围time+time.window/2
。两个参数都应以 ms 为单位指定。例如,?time=1500000000000&time.window=10000
结果是 10 秒的时间范围从 1499999995000 到 1500000005000。
-
-
-
更新面板链接
-
在 “面板” 选项卡上,找到要对其进行更改的链接。
-
单击 “编辑”(铅笔)图标打开 “编辑” 链接窗口。
-
进行任何必需的更改。
-
单击 “保存” 保存更改并关闭窗口。
-
点击右上角的 “保存”,将您所做的更改保存到控制面板。
-
-
删除面板链接
-
在 “面板” 选项卡上,找到要对其进行更改的链接。
-
单击要删除的链接旁边的 X 图标。
-
点击右上角的 “保存”,将您所做的更改保存到控制面板。
-