先想清楚:传「数据」还是传「视图」
| 需求 | 用什么 |
|---|---|
| 请人帮忙排查,看故障当时的现场 | Snapshot(快照) |
| 归档报告、邮件附件 | PDF / PNG 导出 |
| 给对方做二次分析 | CSV 导出 |
| 嵌进门户、Wiki、大屏 | iframe 公开嵌入 |
| 环境间迁移、复用模板 | JSON 导入导出、模板库 |
快照(Snapshot)
右上角 Share → Snapshot 可以发布快照。快照只保留渲染后的数据与图表外观,不含数据源连接信息与查询细节,非常适合把「当时那一帧」交给外部协作者。内部快照与公开快照的选项名称随版本略有差异,以实际界面为准。
注意: 快照页面包含图表可见的全部数据,敏感指标务必先脱敏;长期存档建议改用导出的静态文件。
导出:CSV、PNG、PDF
- CSV:面板 Inspect → Data → Download,导出该面板当前的数据帧,适合丢进表格软件继续算。
- PNG / PDF:Share 菜单中的图片与 PDF 入口,由图像渲染服务生成。自管实例默认没有渲染能力,需要另行部署
grafana-image-renderer并在grafana.ini中配置[rendering]。
iframe 嵌入与 allow_embedding
Share → Embed 生成 iframe 代码,可附带时间范围与 kiosk 参数。未登录访客能否看到嵌入内容,取决于服务器配置:
[security]
allow_embedding = true
[auth.anonymous]
enabled = true
org_role = Viewer
从 Grafana 8 起 allow_embedding 默认关闭,不开则 iframe 直接空白——这是安全策略不是 bug;匿名访问等于向公网暴露数据,开启前先读生产环境安全加固。
JSON 与模板库
- 导出:Dashboard settings → JSON 复制完整模型;Share → Export 得到便于跨实例导入的 JSON。
- 导入:Dashboards → Import 粘贴 JSON 或填社区模板 ID,随后映射本机数据源。
- 模板库:grafana.com 仪表盘目录收录大量开箱模板(如 Node Exporter 全栈监控),导入时注意模板要求的最小 Grafana 版本。
导入导出的本质都是同一份 JSON 模型,批量自动化见HTTP API 与自动化。
常见坑
- 导入后提示缺面板:模板用到了未安装的可视化插件,先在 Connections → Plugins 补齐。
- 嵌入页面要求登录:匿名访问未开启,或浏览器 SameSite 策略拦截了 iframe 内的会话。
- PDF 导出排版错乱:渲染服务按 24 列网格重排,复杂浮动布局建议先在窄屏预览调整。