用途:以 JSON 为唯一载体编写 Grafana 仪表盘,并通过 HTTP API 推送、更新和共享(按 uid 访问)。适用于 Grafana OSS、Enterprise 或 Cloud。
主要能力:支持多种面板类型(timeseries、stat、gauge、table、heatmap、logs、traces、node-graph);支持模板变量(如 $job)与转换(如 calculateField 计算 Error %);可通过 API 创建文件夹、搜索仪表盘、按 uid 读取与覆盖更新。
使用方式:需可访问的 Grafana 实例、具备 dashboards:write 权限的 API Token(Authorization: Bearer <token>)、jq 工具,以及 references/json-schema.md 中的 JSON schema 速查。典型流程为:构造包含 dashboard、folderUid、overwrite、message 的 JSON 负载;先用 jq empty 校验 JSON;再 POST 到 $GRAFANA/api/dashboards/db;随后 GET /api/dashboards/uid/<uid> 回读验证;最后在浏览器确认面板渲染。更新已有仪表盘时先 GET 取回,修改 templating.list 或面板 expr 后以 overwrite: true 回传。
限制:资料未提供具体版本兼容范围、权限之外的配额或价格信息;嵌入应用插件中的仪表盘需改用 @grafana/scenes(skill grafana-o11y:grafana-scenes)。