菜单
Grafana Cloud Enterprise Open source

管理仪表盘链接

您可以使用链接在常用仪表盘之间导航,或将其他人连接到您的可视化。链接允许您创建指向其他仪表盘、面板甚至外部网站的快捷方式。

Grafana 支持仪表盘链接、面板链接和数据链接。仪表盘链接显示在仪表盘顶部。面板链接可通过点击面板标题旁边的图标访问。

首先弄清楚您目前是如何在仪表盘之间导航的。如果您经常在一组仪表盘之间跳转,并且难以在每个仪表盘中找到相同的上下文,链接可以帮助优化您的工作流程。

下一步是确定哪种链接类型适合您的工作流程。尽管 Grafana 中的所有链接类型都用于创建指向其他仪表盘或外部网站的快捷方式,但它们在不同的上下文中使用。

  • 如果链接与仪表盘中大部分(如果不是全部)面板相关,请使用仪表盘链接
  • 如果您想钻取到特定面板,请使用面板链接
  • 如果您想链接到外部网站,可以使用仪表盘链接或面板链接。
  • 如果您想钻取到特定序列,甚至单个测量值,请使用数据链接

使用 URL 控制时间范围

要控制面板或仪表盘的时间范围,您可以在仪表盘 URL 中提供查询参数

  • from - 定义时间范围的下限,以毫秒 epoch 指定
  • to - 定义时间范围的上限,以毫秒 epoch 指定
  • timetime.window - 定义从 time-time.window/2time+time.window/2 的时间范围。两个参数都应以毫秒为单位指定。例如,?time=1500000000000&time.window=10000 将导致从 1499999995000 到 1500000005000 的 10 秒时间范围

创建仪表盘链接时,您可以包含时间范围和当前模板变量,以便直接跳转到另一个仪表盘中的相同上下文。这样,您就不必担心您发送链接的人是否正在查看正确的数据。对于其他类型的链接,请参阅数据链接变量

仪表盘链接也可以用作外部系统的快捷方式,例如提交带有当前仪表盘名称的 GitHub Issue

要查看仪表盘链接的实际示例,请参阅

添加仪表盘链接后,它会显示在仪表盘的右上角。

在当前仪表盘顶部添加指向其他仪表盘的链接。

  1. 在您要链接的仪表盘中,点击 编辑

  2. 点击 设置

  3. 转到链接选项卡,然后点击添加仪表盘链接

    默认链接类型是仪表盘

  4. 使用标签下拉列表中,输入标签以将链接的仪表盘限制为您输入的标签所对应的仪表盘。

    如果您不添加任何标签,Grafana 将包含所有其他仪表盘的链接。

  5. 设置链接选项

    • 显示为下拉列表 – 如果您要链接到许多仪表盘,则可能需要选择此选项并为下拉列表添加一个可选标题。否则,Grafana 会在仪表盘顶部并排显示仪表盘链接。
    • 包含当前时间范围 – 选择此选项以在链接中包含仪表盘时间范围。当用户点击链接时,链接的仪表盘将打开并已设置指示的时间范围。示例:https://play.grafana.org/d/000000010/annotations?orgId=1&from=now-3h&to=now
    • 包含当前模板变量值 – 选择此选项以在链接中包含当前用作查询参数的模板变量。当用户点击链接时,链接仪表盘中的任何匹配模板都将设置为链接中的值。有关更多信息,请参阅仪表盘 URL 变量
    • 在新标签页中打开链接 – 如果您希望仪表盘链接在新标签页或窗口中打开,请选择此选项。
  6. 点击右上角的保存仪表盘

  7. 点击返回仪表盘,然后点击退出编辑

在当前仪表盘顶部添加一个指向 URL 的链接。您可以链接到任何可用的 URL,包括仪表盘、面板或外部网站。您甚至可以控制时间范围,以确保用户在 Grafana 中聚焦于正确的数据。

  1. 在您要链接的仪表盘中,点击 编辑

  2. 点击 设置

  3. 转到链接选项卡,然后点击添加仪表盘链接

  4. 类型下拉列表中,选择链接

  5. URL字段中,输入您要链接的 URL。

    根据目标,您可能希望包含字段值。示例:https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests

  6. 工具提示字段中,输入当用户将鼠标悬停在链接上时希望显示的工具提示。

  7. 图标下拉列表中,选择您希望与链接一起显示的图标。

  8. 设置链接选项;默认情况下,这些选项对于 URL 链接是启用的

    • 包含当前时间范围 – 选择此选项以在链接中包含仪表盘时间范围。当用户点击链接时,链接的仪表盘将打开并已设置指示的时间范围。示例:https://play.grafana.org/d/000000010/annotations?orgId=1&from=now-3h&to=now
    • 包含当前模板变量值 – 选择此选项以在链接中包含当前用作查询参数的模板变量。当用户点击链接时,链接仪表盘中的任何匹配模板都将设置为链接中的值。
    • 在新标签页中打开链接 – 如果您希望仪表盘链接在新标签页或窗口中打开,请选择此选项。
  9. 点击右上角的保存仪表盘

  10. 点击返回仪表盘,然后点击退出编辑

要编辑、复制或删除仪表盘链接,请按照以下步骤操作

  1. 在您要链接的仪表盘中,点击 编辑

  2. 点击 设置

  3. 转到链接选项卡。

  4. 执行以下操作之一

    • 编辑 - 点击链接名称并更新链接设置。
    • 复制 - 点击要复制的链接旁边的复制链接图标。
    • 删除 - 点击要删除的链接旁边的红色 X,然后点击删除
  5. 点击保存仪表盘

  6. 点击返回仪表盘,然后点击退出编辑

每个面板都可以有自己的一组链接,这些链接显示在面板标题后的面板左上方。您可以链接到任何可用的 URL,包括仪表盘、面板或外部网站。您甚至可以控制时间范围,以确保用户在 Grafana 中聚焦于正确的数据。

点击面板标题旁边的图标以查看可用的面板链接。

List of panel links displayed
  1. 将鼠标悬停在您要添加链接的面板的任何部分,以显示右上角的动作菜单。

  2. 点击菜单并选择编辑

    要使用键盘快捷键打开面板,将鼠标悬停在面板上并按下 e

  3. 展开面板选项部分,向下滚动到面板链接

  4. 点击添加链接

  5. 输入一个标题标题是链接的人类可读标签,将显示在 UI 中。

  6. 输入您要链接的URL。您甚至可以添加仪表盘中定义的模板变量之一。按下 Ctrl+Space 或 Cmd+Space 并在URL字段中点击以查看可用变量。通过将模板变量添加到面板链接,链接会将用户发送到正确的上下文,并已设置相关变量。您还可以使用时间变量

    • from - 定义时间范围的下限,以毫秒 epoch 指定。
    • to - 定义时间范围的上限,以毫秒 epoch 指定。
    • timetime.window - 定义从 time-time.window/2time+time.window/2 的时间范围。两个参数都应以毫秒为单位指定。例如,?time=1500000000000&time.window=10000 将导致从 1499999995000 到 1500000005000 的 10 秒时间范围。
  7. 如果您希望链接在新标签页中打开,请选择在新标签页中打开

  8. 点击保存以保存更改并关闭对话框。

  9. 点击右上角的保存仪表盘

  10. 点击返回仪表盘,然后点击退出编辑

  1. 将鼠标悬停在面板的任何部分,以显示右上角的动作菜单。

  2. 点击菜单并选择编辑

    要使用键盘快捷键打开面板,将鼠标悬停在面板上并按下 e

  3. 展开面板选项部分,向下滚动到面板链接。

  4. 找到您要进行更改的链接。

  5. 点击编辑(铅笔)图标以打开编辑链接窗口。

  6. 进行任何必要的更改。

  7. 点击保存以保存更改并关闭对话框。

  8. 点击右上角的保存仪表盘

  9. 点击返回仪表盘,然后点击退出编辑

  1. 将鼠标悬停在面板的任何部分,以显示右上角的动作菜单。

  2. 点击菜单并选择编辑

    要使用键盘快捷键打开面板,将鼠标悬停在面板上并按下 e

  3. 展开面板选项部分,向下滚动到面板链接。

  4. 找到您要删除的链接。

  5. 点击您要删除的链接旁边的 X 图标。

  6. 点击右上角的保存仪表盘

  7. 点击返回仪表盘,然后点击退出编辑