IPC: WalSummaryReady
等待生成新的 WAL summary。
PostgreSQL 等待事件档案
类别IPC
事件
WalSummaryReady
版本PG 17-18
证据2 个源码位置
官方描述译文
等待生成新的 WAL summary。
| PG 13 | PG 14 | PG 15 | PG 16 | PG 17 | PG 18 |
|---|---|---|---|---|---|
| — | — | — | — | ✓ | ✓ |
触发机制
WAIT_EVENT_WAL_SUMMARY_READY 位于 src/backend/postmaster/walsummarizer.c:821,是经 grep 核验的报告路径。公共身份/资源映射位于 src/backend/utils/activity/wait_event_names.txt:161。探针覆盖的操作是:等待生成新的 WAL summary。WalSummaryReady 路径已经到达进程协调点,会休眠到对端、worker、屏障、队列或复制阶段发出进展信号。
正常还是麻烦?
- 正常: 只要所有参与者都在继续推进,短暂汇合就属正常。
- 需要调查: 同一阶段连续三次采样仍存在、预期对端缺失或被阻塞,或队列及其依赖者停止推进时,应当调查。
诊断 SQL
正在等待 IPC/WalSummaryReady 的会话
当前 IPC 等待分布
这些会话的锁与关系上下文
处置建议
- 确认事件所指的对端或阶段。
- 检查该参与者的等待、错误与进展状态。
- 修复停滞的参与者或上游依赖,不要把等待者当作根因。
源码证据
- PostgreSQL 18.6 · src/backend/postmaster/walsummarizer.c:821 —
WAIT_EVENT_WAL_SUMMARY_READY - PostgreSQL 18.6 · src/backend/utils/activity/wait_event_names.txt:161 —
WAL_SUMMARY_READY
关联控制项与信号
- GUC: [guc:wal_buffers] · [guc:synchronous_commit]
- 指标: [metric:waiting_sessions] · [metric:wait_event_share] · [metric:wal_bytes] · [metric:wal_write_time]