首页/云/可观测性速查/分享、嵌入与 Kiosk 模式
Grafana 与看板53 条

分享、嵌入与 Kiosk 模式

链接分享自带时间范围与变量;iframe 嵌入需开启 allow_embedding;kiosk 模式隐藏导航边框,是大屏与工单系统集成的常规手段。

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

分享、嵌入与 Kiosk 模式是什么

Grafana 的分享链接会带上当前时间范围与变量取值,打开后看到的是同一视图;iframe 嵌入需要开启 allow_embedding;kiosk 模式隐藏导航与侧边栏,只留面板区域,是值班大屏、电视轮播与工单系统集成的常规手段。

基本信息

嵌入开关[security] allow_embedding
分享参数from / to / var-* 变量
kiosk 模式?kiosk 或 ?kiosk=tv
自动刷新?refresh=1m
快照生成静态快照绕过登录
权限前提嵌入页仍需登录或有匿名访问

典型使用场景

  • 把值班大屏以 kiosk=tv 方式投到电视上轮播
  • 在工单或内部系统里嵌入相关看板,便于定位问题
  • 分享带时间范围与变量的链接,让同事看到完全相同的视图
  • 生成快照发给外部同事,避免共享账号
  • 固定绝对时间范围用于故障复盘,保证页面不再随时间变化
  • 为业务方提供只读的嵌入视图,控制访问范围

配置与用法

配置与用法
[security]
allow_embedding = true     # 允许 iframe 嵌入

链接示例

链接示例
# 分享当前时间窗口(相对时间会随打开时刻变化)
...?from=now-6h&to=now&var-job=node

# 全屏电视模式:隐藏菜单与侧边栏
...?kiosk=tv&refresh=1m

# 固定时间范围内嵌(复盘常用绝对时间)
...?from=1755000000000&to=1755003600000&kiosk

参数对照

参数作用说明
from / to时间范围支持相对与绝对毫秒时间戳
var-<name>变量取值按变量名传值
kiosk隐藏导航kiosk=tv 更适合电视
refresh自动刷新如 refresh=1m
allow_embedding服务端开关不开则 iframe 无法加载
kiosk 模式只留面板区域,适合值班室大屏与电视轮播;配合 refresh 参数即可实现自动刷新。
iframe 嵌入默认仍需登录,对外展示应配合匿名访问或分享快照;反过来,开启匿名访问时务必把角色限制为只读。
相对时间链接(now-6h)随打开时刻变化,固定复盘要换绝对时间戳,否则不同人打开看到的区间不同。
分享链接会携带变量取值:把生产环境的变量交给外部人员,等于暴露了部分环境信息,分享前先检查参数。

易错点

  • iframe 嵌入默认仍需登录,对外展示应配合匿名访问或分享快照
  • 相对时间链接(now-6h)随打开时刻变化,固定复盘要换绝对时间戳
  • 开启匿名访问时给了编辑角色,等于把修改权限开放给所有人
  • 忘记开启 allow_embedding 时 iframe 会加载失败,且错误信息不明显
  • 分享链接里的变量取值可能暴露内部环境信息,外发前先核对参数

数据来源与参考

  • Grafana 官方文档 · Sharing
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌