三种链接一览
| 机制 | 位置 | 典型用途 |
|---|---|---|
| Dashboard link | 仪表盘顶部导航条 | 相关仪表盘之间横向跳转 |
| Data link | 挂在字段配置里,作用于数据点 / 单元格 | 点一下跳到数据源原生 UI 或工单系统 |
| Panel link | 面板标题超链接 | 从服务概览跳进该服务详情页 |
仪表盘链接
入口在 Dashboard settings → Links → Add link:
- Type 选
Dashboard(站内跳转,按 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-xxx与from/to,其余状态让目标仪表盘用默认值,URL 最短也最稳。
常见坑
- 绝对 URL 突然失效:域名、协议(HTTP / HTTPS)或 SSO 回调域变更后链接集体阵亡,能用相对路径就用。
- 变量没跟过去:目标仪表盘不存在同名变量时,
var-xxx会被静默忽略。 - 点击无反应:部分可视化只在特定交互点(表格单元格、散点)支持 data link,先换时间序列面板验证配置本身有效。
下一步
- 链接里
${var}的源头,见模板变量。 - Data link 属于字段配置的一部分,见字段配置与覆盖项。
- 整盘分享而非跳转,见分享、导出与公开访问。