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
# 勾选后目标看板自动继承当前时间范围与变量取值
# 分组:同层次链接放在一个分组,避免顶部被塞满链接类型对照
| 类型 | 指向 | 典型用途 |
|---|---|---|
| 看板链接 | 其他看板 | 逐层下钻 |
| 普通链接 | 任意地址 | 处置文档与手册 |
| 带变量链接 | 携带当前取值 | 上下文对齐 |
| 带时间范围 | 继承当前窗口 | 复盘取证 |
| 分组链接 | 多个链接归组 | 多业务线导航 |
两级或三级的导航结构(总览、服务、实例)最实用,层级再深会让下钻变成迷路,反而不如直接搜看板名。