月度报告

代理商收费监控基础设施，而每个月客户都想知道”你们这个月做了什么”。 回答这个问题所需的全部数据其实早已采集完毕 —— 这项功能就是把它变成 一份客户可以直接阅读的页面。

生成月度报告

选择项目 → 报告 → 选择月份（YYYY-MM）→ 预览。

预览即为最终文档。如果满意，点击保存并选择 .html 文件的保存位置。

页面内容

每个 VM 一行摘要：

列	含义
有数据的天数	当月实际有采样数据的天数
采样次数	成功轮询的总次数
平均/峰值 CPU	按每天的采样数加权平均
平均/峰值内存	以百分比表示
最高磁盘使用率	使用率最高的挂载点的百分比
磁盘变化	当月内使用率最高的挂载点的百分比增幅（或降幅）
事件	critical、warning 和连接中断事件的数量统计

值得关注的事件，按时间倒序排列 —— 这一部分通常是客户读得最仔细的地方。

平均值是按每天采样数加权计算的：只有四次轮询的一天， 不会被当作与完整一天同等对待。

为什么读取的是聚合数据

原始采样数据只保留 14 天。如果直接读取原始数据，“月度报告”实际上 可能悄悄地只包含半个月的数据，却仍自称为月度报告。

因此读取的是每日聚合表，该表持续记录并长期保留。事件则是直接读取的， 因为事件不会被清理。

需要了解的一个后果：任何未启用监控的月份，都不会有数据。 无法还原过去。

文件格式

输出是一个自包含的 HTML 文件：

• 不含脚本，
• 不含外部字体，
• 不含外链图片，
• 打开时不发起任何网络请求。

也就是说，您可以直接通过邮件发送、归档保存，三年后再次打开时依旧 呈现相同的样式。需要 PDF？在浏览器中打开并打印为 PDF 即可 —— 布局本身已经为适配纸张做好了设计。

建议的工作流程

1. 设定一个固定周期，例如每月 1 号。
2. 为每个项目导出上一个完整月份的内容。
3. 发送前先浏览一遍值得关注的事件部分 —— 这正是您体现价值的地方： 一句”14 号的事件是服务商维护，已处理”的说明，比一整页数字更有分量。
4. 通过邮件发送，或在客户需要签字版本时打印为 PDF。

当前局限

• 内容是按项目生成的，暂不支持跨多个项目的合并视图。
• 尚不支持自定义 Logo 或品牌配色。
• 没有自动导出计划，目前仍需手动点击按钮。

这些都已列入下一步的开发计划。