看板文本是什么
看板以文本形式保存定义:标识与标题、时间范围、模板变量与面板数组构成骨架,面板内再包含栅格位置、查询与字段配置。界面上的每次调整最终都落成这份文本,因此它既是导入导出的载体,也是版本管理与批量修改的入口。
栅格模型与手工编辑
理解栅格模型能让布局可控:看板宽度固定为若干列,面板通过位置与尺寸描述自己在网格中的位置。手工修改文本时最容易出问题的是语法细节与引用关系,改完应先在副本上导入验证,再替换正式看板。
基本信息
| 栅格模型 | 面板用坐标与宽高描述在网格中的位置 |
|---|---|
| 模板变量 | 集中存放在变量列表中 |
| 模型版本 | 随产品版本升级,导入旧版本会自动迁移 |
| 导入导出 | 界面可整体导出为文本,也支持接口操作 |
典型使用场景
- 看板迁移:导出后在另一套环境导入,快速复制整套视图
- 版本管理:把看板文本纳入代码库,改动可评审可回滚
- 批量修改:脚本化调整单位、阈值或查询模板
- 模板复用:以现有看板为基础生成多套同构看板
- 自动化部署:随环境初始化一起下发看板定义
精简结构示例
精简结构示例
{
"uid": "app-overview",
"title": "应用总览",
"tags": ["app"],
"refresh": "30s",
"time": {"from": "now-6h", "to": "now"},
"panels": [
{"id": 1, "type": "timeseries", "title": "QPS",
"gridPos": {"h": 8, "w": 12, "x": 0, "y": 0},
"targets": [{"refId": "A", "expr": "sum(rate(http_requests_total[5m]))"}]}
]
}结构要点
| 部分 | 作用 | 注意 |
|---|---|---|
| 标识与标题 | 唯一标识与展示名 | 标识重复时导入会提示已存在 |
| 时间范围与刷新 | 默认展示区间 | 同一主题的看板保持一致 |
| 模板变量 | 下拉选项定义 | 默认值要有代表性 |
| 面板数组 | 图表集合 | 每个面板含位置、查询与配置 |
| 栅格位置 | 在网格中的坐标与尺寸 | 改动前先算好总宽度 |
常见问题
| 问题 | 原因 | 处理方式 |
|---|---|---|
| 导入提示已存在 | 标识重复 | 选择覆盖导入 |
| 导入解析失败 | 文本语法错误 | 先用校验工具检查一遍 |
| 面板重叠错位 | 坐标计算错误 | 按总宽度重新排布 |
同一份看板导入不同环境时,数据源引用可能失效:提前约定数据源命名,或在导入后统一替换引用。
手工编辑文本时留下多余的标点或注释会导致解析失败:先导入副本验证,再覆盖正式看板。