URL 参数是什么
Grafana 看板的 URL 参数可以完全控制打开时的初始状态：时间范围、刷新率、组织、模板变量取值与全屏模式都能写进链接。它是把看板嵌进其他系统的关键手段——告警通知、处置文档、自动化巡检脚本都靠拼链接直达现场，点开就是准备好的视图，不必再手动选变量、调时间窗口。
基本信息
| 常用参数 | orgId、from、to、refresh、var-变量名、kiosk、theme |
|---|---|
| 变量传值 | 单值写 var-job=node，多值重复同名参数 |
| 时间写法 | now-12h、绝对时间戳或带时区的 ISO 时间 |
| 适用版本 | Grafana 8+ |
| 权限要求 | 只读即可，链接本身不改变权限 |
典型使用场景
- 告警直达：把带变量的链接放进告警说明，点开就是对应该实例的视图
- 处置文档：把看板链接与命令一起写进手册，减少现场查找时间
- 大屏展示：用 kiosk 模式隐藏导航，配合固定时间范围做常驻大屏
- 自动化巡检：脚本访问带绝对时间的链接做定时截图或巡检记录
- 上下文交接：交接时把链接发出去，对方打开即看到同一段数据
使用要点
- 变量名大小写敏感，拼错会被静默忽略
- 相对时间每次打开都重新计算，复盘取证要用绝对时间窗
- 多值变量要重复写同名参数，或用带花括号的写法表达列表
- 分享链接时使用带 uid 的形式，避免看板改名后失效
- 参数较多时把链接固化到文档或模板里，避免手工拼错
常用参数速查
常用参数速查
?orgId=1 # 组织
&from=now-12h&to=now # 时间范围
&refresh=1m # 刷新率
&var-job=node # 模板变量（单值）
&var-instance=web01&var-instance=web02 # 多值变量重复同名参数
&kiosk # 全屏模式，隐藏导航
&theme=light # 主题（部分版本可用）参数读法
| 参数 | 作用 | 注意 |
|---|---|---|
| from / to | 时间范围 | 相对或绝对，复盘用绝对 |
| refresh | 自动刷新间隔 | 过快会持续压后端 |
| var-名称 | 模板变量取值 | 变量名大小写敏感 |
| kiosk | 全屏展示 | 大屏场景常用 |
| orgId | 组织 | 多组织环境必须写对 |
把带参数的链接固化进告警说明与交接文档，打开即对齐上下文，是成本最低的一类可用性改进。