LWLock: ControlFile
等待读取或更新 pg_control 文件,或创建新的 WAL 文件。
PostgreSQL 等待事件档案
类别LWLock
事件
ControlFile
版本PG 13-18
证据3 个源码位置
官方描述译文
等待读取或更新 pg_control 文件,或创建新的 WAL 文件。
| PG 13 | PG 14 | PG 15 | PG 16 | PG 17 | PG 18 |
|---|---|---|---|---|---|
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
触发机制
pgstat_report_wait_start 位于 src/backend/storage/lmgr/lwlock.c:739,是经 grep 核验的报告路径。公共身份/资源映射位于 src/backend/access/transam/xlog.c:2723。探针覆盖的操作是:等待读取或更新 pg_control 文件,或创建新的 WAL 文件。LWLockAcquire 无法立即取得显示为 ControlFile 的轻量级锁 tranche;后端在内部共享内存资源上休眠时,通用 LWLock 报告器发布该 tranche 名称。
正常还是麻烦?
- 正常: 短暂内部临界区周围的零星样本属于正常。
- 需要调查: 若同一 tranche 在连续三次一秒采样中影响至少 10% 的活动前台会话,应当调查;达到 25% 或持续超过五秒按紧急处理。
诊断 SQL
正在等待 LWLock/ControlFile 的会话
当前 LWLock 等待分布
这些会话的锁与关系上下文
处置建议
- 重复采样并锁定一个热点 tranche。
- 把它与受保护资源及当前负载阶段关联。
- 降低具体竞争源;增加并发可能让共享内存热点更糟。
源码证据
- PostgreSQL 18.6 · src/backend/access/transam/xlog.c:2723 —
ControlFile - PostgreSQL 18.6 · src/backend/storage/lmgr/lwlock.c:739 —
pgstat_report_wait_start - PostgreSQL 18.6 · src/backend/utils/activity/wait_event_names.txt:321 —
ControlFile
关联控制项与信号
- GUC: 无直接关联项。
- 指标: [metric:waiting_sessions] · [metric:wait_event_share]