首页/云/可观测性速查/面板与行重复(Repeat)
Grafana 与看板53 条

面板与行重复(Repeat)

按变量为每个取值生成一份面板或整行:多实例、多环境同构展示不再手工复制;重复块内自动带入对应变量值。

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

Repeat 是什么

Repeat(重复)让一个面板或一整行按模板变量展开:变量有几个取值就渲染几份,多实例、多环境的同构视图不必手工复制。行重复常用于「一个环境一行」,面板重复常用于「一台机器一张图」;重复块内部自动带上对应的变量值,标题里写上变量名就能分辨每一块。

基本信息

适用平台Grafana 8+
入口位置行:Row 设置 → Repeat for;面板:Panel → Repeat options
重复方向Horizontal 横向铺开、Vertical 纵向堆叠
依赖条件必须存在被引用的模板变量
性能注意变量取值过多会导致渲染块数量爆炸

典型使用场景

  • 多实例巡检:按 instance 重复,每台主机一张 CPU 与内存图,横排铺开
  • 多环境对照:按 env 重复整行,生产与预发并排比较同一指标
  • 多集群:按数据源或集群变量重复,同一套图看多个集群
  • 多业务线:按 team 或 service 重复,各团队视图互不干扰
  • 新增对象即入库:新增实例自动出现在看板上,不需要改动看板结构

配置方式

配置方式
# 行重复:Row 设置 -> Repeat for -> 选择变量(如 instance)
# 面板重复:Panel -> Repeat options -> Repeat by variable
# 方向:Horizontal(横向)/ Vertical(纵向)
# 标题里写 $instance,让每一块都能被分辨

# 变量取值收窄示例:只取常用实例,避免重复块数量过多
label_values(up{job="node"}, instance)

重复方式对照

方式粒度适用场景
行重复整行包含多个面板一个环境或一台机器一行
面板重复单个面板同一张图在多对象间对比
Horizontal左右铺开对象较少、便于并列比较
Vertical上下堆叠对象较多、便于逐行阅读
重复块数量等于变量取值个数:把选择器默认值收敛到常用集合,或改用少量多选,才能保证看板打开速度。

配置步骤

  • 先建好被引用的模板变量,并确认它在面板查询里能正常生效
  • 按粒度选择方式:一行里放多个面板就做行重复,单图对比就做面板重复
  • 在重复项里选变量与方向,横向适合对象较少、纵向适合对象较多
  • 标题里写入变量值,让每一块在截图与群里都能被指认
  • 把变量的默认取值收敛到常用集合,避免打开看板时一次性渲染过多块

易错点

  • 变量取值太多会让重复面板数量爆炸,加载缓慢甚至超时,先把默认取值收窄
  • 选择 All 生成大量重复块时页面基本无法使用,必要时改为单选或少量多选
  • 标题里不写变量值,重复块看起来完全一样,排查时无法判断对应哪个对象
  • 重复面板依赖的变量被删除或改名后整行消失,调整看板结构时要留意引用关系

数据来源与参考

  • Grafana 官方文档 · Repeat rows and panels
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌