Pigsty监控系统对PostgreSQL检查点统计视图的适配

PostgreSQL 17版本引入了一个重要的监控视图变更——将检查点相关统计信息从pg_stat_bgwriter视图拆分到新的pg_stat_checkpointer视图。这一变更对监控系统提出了适配要求，Pigsty项目及时跟进并完成了这一功能适配。

背景与变更内容

在PostgreSQL 17之前，检查点相关的统计信息都存储在pg_stat_bgwriter系统视图中。随着PostgreSQL的发展，检查点作为一个独立且关键的操作过程，其统计信息被单独提取出来，形成了新的pg_stat_checkpointer视图。

原pg_stat_bgwriter视图现在仅保留以下字段：

• buffers_clean：后台写入器写入的缓冲区数量
• maxwritten_clean：后台写入器因写入过多缓冲区而停止清理扫描的次数
• buffers_alloc：分配的缓冲区数量
• stats_reset：统计信息最后重置的时间

新的pg_stat_checkpointer视图则包含了丰富的检查点相关指标：

• num_timed：已执行的计划检查点数量
• num_requested：已执行的请求检查点数量
• 重启点相关统计（restartpoints_timed、restartpoints_req、restartpoints_done）
• 时间消耗指标（write_time、sync_time）
• buffers_written：检查点和重启点期间写入的缓冲区数量
• stats_reset：统计信息最后重置的时间

技术意义

这一变更反映了PostgreSQL对监控功能的精细化设计。检查点作为数据库关键操作，其性能直接影响整个系统的稳定性和性能。独立的统计视图使得：

1. 监控更加清晰：检查点相关指标不再与其他后台写入器指标混杂
2. 指标更加丰富：新增了时间消耗等关键性能指标
3. 分析更加便捷：重启点等高级功能的统计更加直观

Pigsty的适配实现

Pigsty监控系统通过其核心组件pg_exporter及时跟进这一变更。适配工作主要包括：

1. 识别PostgreSQL版本差异，自动选择正确的查询方式
2. 更新指标采集逻辑，确保新旧版本都能正确采集相关指标
3. 保持指标命名一致性，避免因视图变更导致监控告警规则失效
4. 完善文档说明，帮助用户理解这一变更的影响

对用户的影响

对于使用Pigsty监控PostgreSQL的用户：

1. 升级到PostgreSQL 17后，检查点相关指标将自动从新的视图中采集
2. 原有告警规则和仪表盘将继续工作，无需手动调整
3. 可以获得更详细的检查点性能数据，便于性能分析和调优

这一适配确保了Pigsty用户在升级PostgreSQL时监控系统的平稳过渡，同时能够利用新版本提供的更丰富监控指标。