创建与管理仪表盘

新建第一个仪表盘

最常用的入口：

1. 点击左侧栏 Dashboards，选择 New dashboard（部分版本为 + 图标）。
2. 在新建向导里选一个数据源并创建第一条查询，或直接点 Add a new panel 跳过向导。
3. 编辑完成后点右上角 Save，选择要存放的文件夹并填写名称与描述。

提示： 仪表盘不保存就不生效；离开未保存的仪表盘时界面会弹出确认提示，别习惯性忽略。

网格与面板操作

仪表盘是 24 列宽度的网格布局，面板在其中自由排布：

• 添加面板：空白画布或已有面板边缘的 Add panel 入口。
• 移动与缩放：拖动面板主体改变位置；进入编辑模式后拖拽边缘蓝色边框调整大小。
• 复制与删除：面板右上角 ⋮ 菜单里的 Duplicate、Delete 等项。
• 行（Row）：用 Row 给面板分组，支持折叠，适合按「概览 / 明细 / 排障」划分长页面。

时间范围与刷新

右上角的时间选择器与刷新控件是全仪表盘共享的：

时间参数如何随 URL 传递、如何做环比对比，见分屏对比与时间范围。

用文件夹组织

文件夹（Folder）是仪表盘的目录，也是权限分配的单位。在 Dashboards 列表页新建文件夹，再通过拖拽或 Move 归档仪表盘。文件夹级权限随版本与授权模式略有差异，以实际界面为准，矩阵见角色与权限。

JSON 模型：仪表盘的本来面目

每个仪表盘都是一份 JSON 文档。在 Dashboard settings 中找到 JSON（不同版本入口名称略有差异），可以看到完整模型：

{
  "uid": "abc123",
  "title": "API 服务监控",
  "panels": [
    {
      "id": 1,
      "type": "timeseries",
      "title": "QPS",
      "gridPos": { "h": 8, "w": 12, "x": 0, "y": 0 }
    }
  ],
  "time": { "from": "now-6h", "to": "now" },
  "refresh": "1m"
}

批量修改、审查 diff、配置即代码都建立在这个模型之上，相关自动化见HTTP API 与自动化。

版本历史

仪表盘每次保存都会自动留存版本快照：

1. 打开 Dashboard settings → Versions。
2. 选择两个版本并排对比 JSON 差异。
3. 在目标版本上点 Restore 即可回滚。

注意： 版本保留数量受服务器设置限制，可能被清理；重大改动前建议先手动导出一份 JSON 存底。

常见坑

• 面板总是弹回原位：网格布局在某些缩放宽度下取整冲突，微调宽度后再拖。
• 改了却没生效：检查是否保存到正确的文件夹与组织，多标签页同时编辑会互相覆盖。
• 仪表盘打开很慢：先数面板数量与查询时间跨度，大跨度聚合查询对任何数据源都是重负载。

下一步

• 面板选什么可视化类型，见面板与可视化类型。
• 让仪表盘可复用，读模板变量。
• 把仪表盘送出去，看分享、导出与公开访问。