Activity: RecoveryWalStream
流式恢复期间,在 startup 进程的主循环中等待 WAL 到达。
PostgreSQL 等待事件档案
类别Activity
事件
RecoveryWalStream
版本PG 13-18
证据2 个源码位置
官方描述译文
流式恢复期间,在 startup 进程的主循环中等待 WAL 到达。
| PG 13 | PG 14 | PG 15 | PG 16 | PG 17 | PG 18 |
|---|---|---|---|---|---|
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
触发机制
WAIT_EVENT_RECOVERY_WAL_STREAM 位于 src/backend/access/transam/xlogrecovery.c:4038,是经 grep 核验的报告路径。公共身份/资源映射位于 src/backend/utils/activity/wait_event_names.txt:64。探针覆盖的操作是:流式恢复期间,在 startup 进程的主循环中等待 WAL 到达。RecoveryWalStream 后台路径在主循环暂时无事可做、进入 latch wait 前报告此事件;信号、计时器或新工作会唤醒进程并进入下一轮循环。
正常还是麻烦?
- 正常: 对匹配的后台进程而言,这通常是预期空闲。
- 需要调查: 只有工作队列、关闭或故障切换时限没有推进但进程一直停在这里,或事件出现在不匹配的后端类型上时,才需要调查。
诊断 SQL
正在等待 Activity/RecoveryWalStream 的会话
当前 Activity 等待分布
这些会话的锁与关系上下文
处置建议
- 先与 backend_type 对照。
- 检查该进程专属的积压与最后进展时间。
- 修复缺失的工作信号或停滞的上游阶段,不要终止正常空闲的 worker。
源码证据
- PostgreSQL 18.6 · src/backend/access/transam/xlogrecovery.c:4038 —
WAIT_EVENT_RECOVERY_WAL_STREAM - PostgreSQL 18.6 · src/backend/utils/activity/wait_event_names.txt:64 —
RECOVERY_WAL_STREAM
关联控制项与信号
- GUC: [guc:wal_buffers] · [guc:synchronous_commit]
- 指标: [metric:waiting_sessions] · [metric:wait_event_share] · [metric:wal_bytes] · [metric:wal_write_time]