CONFIGURATION PARAMETER运行时统计数据 / 累积查询和索引统计
track_wal_io_timing
收集 WAL I/O 等待计时。
Collects timing statistics for WAL I/O activity.
布尔 会话（超级用户） 引入 14 现存至 20 devel 0 次默认值变更
- 类型
- 布尔bool
- 上下文
- 会话（超级用户）超级用户可在会话内用 SET 修改
- 默认值
off- 引入版本
- 14
- 状态
- 现存
版本轨迹
相对 PostgreSQL 17 无变化。
默认值变迁
默认值自 PostgreSQL 14 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
启用WAL I/O调用的定时。此参数默认关闭，因为它将重复查询操作系统的当前时间， 这可能会在某些平台上造成显著的开销。 您可以使用pg_test_timing工具来 测量系统上定时的开销。 I/O定时信息显示在 pg_stat_wal中。 只有超级用户和具有适当SET权限的用户才能更改此设置。
机制详解
track_wal_io_timing 测量 WAL I/O 等待，并在 pg_stat_io 与 pg_stat_get_backend_io() 的 wal 对象下暴露；它与普通数据库 I/O 计时相互独立。
收集会反复读取操作系统时钟，可能产生依平台而异的开销。pg_test_timing 可测时钟读取成本，负载测试则反映总影响。
它不会改变 wal_sync_method、持久性或 WAL 吞吐。与 track_io_timing 配合可把 WAL 等待与关系/临时文件 I/O 分开。其 superuser 上下文允许获授权会话修改，无需重启服务器。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
分析提交延迟、需要把 WAL write/sync 等待与关系 I/O 分开时启用。测量平台时钟开销，并把计数与 synchronous_commit、wal_sync_method 和存储行为关联。
-
OLAP分析与批处理
读密集分析可能很少受益，而批量导入与刷新任务的写阶段可能很有价值。应按真正使用证据的写阶段启用，而不是仅因负载标签是 OLAP。
-
小规格低配实例与开发机
除非正在诊断 WAL 延迟且时钟读取便宜，否则保持 off。只有需要同时区分 WAL 与非 WAL 等待时，才与 track_io_timing 配合。
常见问题
- 期待 WAL 计时包含 track_io_timing 测量的关系与临时文件 I/O。
- 把 WAL 等待经过时间当成纯设备服务时间。
- 认为该开关会改变持久性、wal_sync_method 或 WAL 吞吐。
- 没有在生产平台测量时钟读取开销就启用。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
-
PostgreSQL 15 ← 14 仅描述更新
分类
Statistics / Query and Index Statistics CollectorStatistics / Cumulative Query and Index Statistics -
PostgreSQL 14 ← 13 新增此参数
PostgreSQL 14 起可用
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| 累积查询和索引统计 8 | |||||
stats_fetch_consistency |
枚举 | 会话 | cache |
— | |
| 设置读取累计统计信息时的一致性方式。 | 现存 | ||||
track_activities |
布尔 | 会话（超级用户） | on |
— | |
| 收集会话当前执行命令的信息。 | 现存 | ||||
track_activity_query_size |
整数 | 重启生效 | 1 KiB |
132 次 | |
| 设置 pg_stat_activity.query 预留的字节数。 | 现存 | ||||
track_cost_delay_timing |
布尔 | 会话（超级用户） | off |
— | |
| 收集基于成本的 vacuum 延迟计时。 | 现存 | ||||
track_counts |
布尔 | 会话（超级用户） | on |
— | |
| 收集数据库活动累计统计。 | 现存 | ||||
track_functions |
枚举 | 会话（超级用户） | none |
— | |
| 收集函数调用次数与耗时统计。 | 现存 | ||||
track_io_timing |
布尔 | 会话（超级用户） | off |
— | |
| 收集数据库 I/O 等待计时。 | 现存 | ||||
track_wal_io_timing |
布尔 | 会话（超级用户） | off |
— | |
| 收集 WAL I/O 等待计时。 | 现存 | ||||