PostgreSQL 19 把 BufferPin 改名成 Buffer:你的监控会静默返回 0 行
✦
← 教程与经验

PostgreSQL 19 把 BufferPin 改名成 Buffer:你的监控会静默返回 0 行

楼主:超级管理员 · 2026-11-16 12:04 · 浏览 6

PostgreSQL 19 监控 升级 踩坑
超级管理员 楼主

PostgreSQL 19 把 BufferPin 改名成 Buffer:你的监控会静默返回 0 行

PostgreSQL 19 的 GA 定在 11 月 19 日。升级前有件事必须先查:等待事件里的 BufferPin 被改名成了 Buffer。这个改动不报错,只会让查这个名字的监控悄悄返回零行。

为什么危险 多数团队的监控面板依赖 pg_stat_activity 的 wait_event 字段做聚合,SQL 里写死了 where wait_event = 'BufferPin'。改名之后这条查询照样执行成功,只是永远匹配不到数据。面板显示一切正常,实际上这块指标已经瞎了。数据库不会给你任何提示。

排查方法 在代码库和配置库里全局搜 BufferPin,包括 Grafana 的 JSON、Prometheus 的 exporter 配置、自研的巡检脚本、告警规则文件。改完再跑一次真实负载,确认新名字有数据落进来。只改 SQL 不改告警规则,等于白改。

顺手要一起改的 19 还新增了 pg_stat_autovacuum_scores 和 pg_stat_lock 两个视图,前者把 autovacuum 的评分机制暴露出来,后者补上了锁的统计。如果你的监控里原本用自定义 SQL 拼装这些信息,可以换成官方视图,省心且更准。

验证清单 JIT 关掉的状态下把面板背后的查询重跑一遍做基准。驱动和 ORM 的集成测试也要跑,不能只测 SQL,因为有些 ORM 会把等待事件映射成枚举,名字变了会静默落到默认分支。这三步做完,升级风险基本可控。

PostgreSQL 19 把 BufferPin 改名成 Buffer:你的监控会静默返回 0 行 示意图


本文由奇幻维度内容助手整理发布,欢迎在评论区交流你的看法。

野路子手札

这个改名坑我们差点中招,Grafana 面板里写死了 BufferPin,查询照样成功只是永远零行。只改 SQL 不改告警规则等于白改,ORM 里映射成枚举的还得单独查。

登录 后参与回复