库面板是什么
Library panels 把单个面板保存为组织级资产：多个看板引用同一份定义，任何一处更新后所有引用同步生效。它适合黄金指标行、依赖组件概览、SLO 燃烧率这类「口径必须一致、又会出现在很多看板里」的复用单元，避免同一个查询在十几个看板里各写一遍、改一次漏几处。
基本信息
| 适用平台 | Grafana 8.5+，Library panels 功能 |
|---|---|
| 保存入口 | 面板菜单 → More → Save as library panel |
| 引用方式 | Add panel → Library panels，或看板 JSON 中的 libraryPanel 引用 |
| 前提条件 | 引用方看板需存在同名模板变量 |
| 联动效果 | 更新一次库面板，全部引用同步 |
典型使用场景
- 黄金指标行：所有业务看板统一引用同一份「延迟、流量、错误、饱和度」四图行
- 依赖概览：数据库、缓存、消息队列的关键面板在多处复用
- SLO 面板：燃烧率与错误预算口径集中维护，避免各团队算法不一致
- 容量行：节点 CPU、内存、磁盘的标准视图被基础与业务看板共用
- 统一升级：样式与单位调整一次生效，不用逐个看板改
保存与引用
保存与引用
# 面板菜单 -> More -> Save as library panel
# 引用：Add panel -> Library panels -> 选择目标库面板
# 更新：在任意引用处编辑并保存，所有引用同步生效
# 前提：目标看板需存在库面板所用同名变量（如 $instance、$job）
# 想脱离统一维护：断开引用另建独立面板，避免误改全体使用边界
| 场景 | 合适做法 | 原因 |
|---|---|---|
| 口径必须统一 | 用库面板引用 | 一处修改，全体同步 |
| 需要各自演化 | 复制为独立面板 | 避免误改所有引用看板 |
| 临时试验 | 先建独立面板 | 验证稳定后再升为库面板 |
| 变量差异大 | 先统一变量命名 | 库面板依赖同名变量 |
库面板把「查询、阈值、图形样式」打包复用，是团队统一指标口径最省力的抓手，但前提是各看板的变量命名先对齐，否则复用处处报错。