首页/云/可观测性速查/Dashboard links:看板间导航
Grafana 与看板53 条

Dashboard links:看板间导航

在看板顶部放置导航链接:可链接到其他看板并携带变量与时间范围,形成总览到详情的逐层结构。

可观测性速查云更新于 2026-10-13

Dashboard links 是什么

Dashboard links 在看板顶部放置导航链接:可以链接到其他看板并携带当前变量与时间范围,形成从总览到详情的逐层结构。它是排障路径的固化方式——把「先看总览、再看服务、最后看实例」这条路线写进链接,新人不必靠口口相传就知道从哪里下钻。链接支持分组,可按业务线或层次组织,避免顶部被塞满。

基本信息

配置位置看板设置 → Links,支持普通链接与看板链接
URL 形式/d/<uid>/<name>?var-instance=${instance}&var-job=${job}
关键选项Include time range、Include variables
适用平台Grafana 8+
权限要求看板 Editor 及以上

典型使用场景

  • 逐层下钻:从业务总览跳到服务看板,再跳到实例看板
  • 变量传递:把当前选中的实例与服务带到目标看板,打开即对齐上下文
  • 时间对齐:勾选时间范围传递后,目标看板自动继承当前窗口
  • 多业务线导航:按团队分组链接,减少搜索成本
  • 处置入口:链接到处置文档或值班手册,缩短从发现到处置的路径

使用要点

  • 目标看板必须存在同名变量,否则参数会被静默忽略
  • 分享给他人时用带 uid 的固定链接,看板改名不会失效
  • 链接数量要控制,用分组收敛或只保留高频路径
  • 与 URL 参数结合使用时,注意两边参数名写法一致
  • 把导航路径写进看板说明,方便新人按路径排查

链接配置

链接配置
# 看板设置 -> Links
# URL 示例(携带变量)
/d/app-detail?var-instance=${instance}&var-job=${job}

# 选项:Include time range / Include variables
# 勾选后目标看板自动继承当前时间范围与变量取值
# 分组:同层次链接放在一个分组,避免顶部被塞满

链接类型对照

类型指向典型用途
看板链接其他看板逐层下钻
普通链接任意地址处置文档与手册
带变量链接携带当前取值上下文对齐
带时间范围继承当前窗口复盘取证
分组链接多个链接归组多业务线导航
两级或三级的导航结构(总览、服务、实例)最实用,层级再深会让下钻变成迷路,反而不如直接搜看板名。

易错点

  • 目标看板没有同名变量时参数会被静默忽略,先核对两边变量命名
  • 链接数量失控会占满顶部空间,用分组收敛或只保留高频路径
  • 用看板名称做链接地址,看板改名后链接集体失效,应使用带 uid 的形式
  • 忽略时间范围传递选项,下钻后目标看板打开的是默认窗口,与来源时段不一致

数据来源与参考

  • Grafana 官方文档 · Dashboard links
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌