本篇目录7 节

06仪表盘与可视化Dashboards

仪表盘与面板链接

三种链接机制各司其职:仪表盘链接做顶部导航,数据链接从数据点深链到外部系统,面板链接让标题变成跳转按钮。含变量传参与绝对、相对 URL 写法示例。

约 2 分钟/658 字/GRAFANA 12.X

三种链接一览

机制 位置 典型用途
Dashboard link 仪表盘顶部导航条 相关仪表盘之间横向跳转
Data link 挂在字段配置里,作用于数据点 / 单元格 点一下跳到数据源原生 UI 或工单系统
Panel link 面板标题超链接 从服务概览跳进该服务详情页

仪表盘链接

入口在 Dashboard settings → Links → Add link

  • TypeDashboard(站内跳转,按 UID 选目标)或 Link(任意 URL)。
  • Open in new tab 控制是否新标签页打开。
  • Include time range or variable:把当前时间窗口与变量选中值一起带走,这是仪表盘链接最有价值的开关。
  • As dropdown:多条链接折叠成一个下拉,节省导航条空间。

站内相对路径示例:

/d/latency-overview/api-latency?orgId=1&var-service=${service}

/d/<dashboard-uid>/<slug> 是 Grafana 仪表盘的标准路径;slug 部分只为可读,真正定位靠 UID,因此搬家、改名都不影响链接。

数据链接

Data link 配置在字段标准的 Data links 区(也可作为 override 只作用于某条序列),点击数据点时会弹出跳转菜单。内部跳转可用 __value.time__series.name 等占位符(确切集合随面板类型与版本变化,以实际界面为准);跳外部系统则手写完整 URL,例如查看某序列在 Prometheus 里的原始表达式:

https://prometheus.example.com/graph?g0.expr=rate%28http_requests_total%7Bservice%3D%22checkout%22%7D%5B5m%5D%29&g0.tab=0

注意: URL 中的 {}"() 等字符必须百分号转义(%7B%7D%22……);最省事的办法是在浏览器里先把目标页调好,复制地址栏再改造。

面板链接

面板编辑页 Panel options → Panel link 添加;填好标题与 URL 后,面板标题变为超链接。URL 支持变量插值:

/d/abc123/service-detail?var-service=${query:pipe:name}

${...} 内可加格式化管道(如 pipe:name 取展示名),具体语法随版本演进,复杂场景先用仪表盘设置里的预览验证。

变量传参速查

参数 含义
var-<name>=<value> 设置目标仪表盘变量,重复出现即多选
from / to 时间范围,now-6h 相对式或 epoch 毫秒绝对式
orgId 目标组织 ID
kiosk 隐藏外壳的展示模式,常配 tv 值用于投屏

提示: 跨仪表盘跳转的首选姿势:链接里只带 var-xxxfrom/to,其余状态让目标仪表盘用默认值,URL 最短也最稳。

常见坑

  • 绝对 URL 突然失效:域名、协议(HTTP / HTTPS)或 SSO 回调域变更后链接集体阵亡,能用相对路径就用。
  • 变量没跟过去:目标仪表盘不存在同名变量时,var-xxx 会被静默忽略。
  • 点击无反应:部分可视化只在特定交互点(表格单元格、散点)支持 data link,先换时间序列面板验证配置本身有效。

下一步

本页为学习整理的中文改写,依据Grafana 官方文档最新版本编写(以 Grafana 12.x 为基准),操作路径请以实际产品界面为准。

Dashboards