Grafana 仪表板快照导出器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/grafana-dashboard-snapshot-exporter。
技能介绍
它解决什么问题
Grafana 看板默认是“活”的:面板背后是实时查询,同一个面板在不同时间打开可能显示完全不同的数据。这就带来几个麻烦场景——出故障时想给值班同事复现某个时间点的指标形状,邮件里贴截图对方既不能交互查看也难核对数值;想做一份“事故当时”的数据归档,手动截图费时且丢失下钻能力;跨团队分享某个看板状态,对方要么没有权限,要么看到的是另一时刻的数据。
快照是 Grafana 给出的方案:把某个时间点的看板数据固化为静态页面,生成可通过链接分享的视图。缺的是把它变成可脚本化、可重复的操作,而不是每次点鼠标。
它如何工作
这个技能封装了 Grafana HTTP API 的 /api/snapshots 端点,核心流程是:
- 点对点抓取:调用端点时把当前看板与面板数据固定下来,快照反映调用那一刻的实际数据状态,而不是查询模板本身
- 过期可控:创建快照时可配置
expires过期策略,让链接在设定时间后失效,避免快照长期残留 - 基于密钥分享:创建成功后返回快照密钥(snapshot key),分享链接由 Grafana 实例托管,接收方打开即可看到当时的面板数据视图
适用边界与注意点
- 目标 Grafana 实例需开启 snapshot 分享能力,且调用方持有有效的 API token
- 快照链接一旦泄露,拿到链接的人即可访问当时的看板数据;敏感环境要结合实例的鉴权与分享开关配置来评估风险
- 上游项目没有自动抽取到可用的安装与调用说明,建议先通读来源仓库代码,再决定是否接入生产流程
- 快照是静态数据,不会跟随源数据更新;它适合“留证”与“回放”,不适合替代实时看板
使用场景
- 事故复盘时要把故障时刻的看板面板数据固化成链接,发给值班同事核对
- 跨团队分享某次发版验证的指标基线,对方没有 Grafana 访问权限,需要链接形式
- 需要定期把重要看板当前数据留档备查,并设置链接过期时间避免长期残留
- 在自动化流程里用脚本批量生成看板快照,替代逐个面板手动截图
适合人员
- SRE 工程师:故障复盘时需要向团队重现故障时间点的看板数据状态
- 监控平台开发者:想在 CI 流水线中自动归档看板状态并生成分享链接
- 技术值班人员:需要把当次事故的指标数据以链接形式发给跨团队协作方