跳转到主要内容

trace_recovery_messages

trace_recovery_messages:控制恢复相关调试消息的日志级别。实测在档范围为 PG9.0–16;最后在档的 PG16 启动默认值为 log,context 为 sighup。它在 PG17 被移除。
说明

Fact — 官方简述译文:控制恢复相关调试消息的日志级别。

身份

类型 , enum
上游 pg_settings 类型
Context , sighup
配置 reload 后生效
单位 ,
原始单位
范围 ,
最后在档版本的原始上下限
枚举值 , debug5, debug4, debug3, debug2, debug1, log, notice, warning, error
非枚举类型记为 —
分类 , Developer Options
上游分类
最后 boot 值 , log
log

生命周期

Fact
首次观测 PG9.0(研究下界)
在档版本 PG9.0–16
移除版本 PG17
引入提交 不作断言:早于 PG9.0 研究边界
提交日期
Discussion

默认值变迁

PG9.0–19 Beta 3 实测 boot 默认值
版本 原始 boot_val 单位 人类可读值
PG9.0–16 log log

机制详解

PG16 及以前,trace_recovery_messages 会把达到所选严重级别的恢复 DEBUG 消息重新映射为 LOG,使通常隐藏的恢复内部信息在测试时可见。

它只改变消息可见性,不改变恢复决策、WAL 重放顺序或持久性;详细恢复日志可能极大并影响时序。

PostgreSQL 17 移除该参数。升级配置必须删除;当前恢复诊断应使用受支持日志、进度与 WAL 检查工具。其 SIGHUP 上下文允许通过重载配置生效,无需重启服务器。

调优建议

提示

Advice。 以下建议是工作负载起点,必须用真实测量验证。

场景 建议
OLTP 当前 PostgreSQL 不应配置 trace_recovery_messages。升级时删除;即使存在后继参数,也只能用于同类受控开发测试,不能成为生产默认。
OLAP 分析负载不能成为保留已移除 trace_recovery_messages 的理由;当前版本应使用受支持 EXPLAIN、日志或文档化替代项诊断。
小规格 现代配置中删除 trace_recovery_messages。未知参数导致的启动失败与诊断开销远大于历史用途。

Pigsty 取值

以下值来自固定 8 核、32 GiB、100 GiB SSD 夹具,并按 PG16 渲染当前 Pigsty 模板;这不表示 Pigsty 当前支持该历史或测试版本。

模板 有效值 与上游 boot 比较 源表达式
OLTP 未修改
OLAP 未修改
CRIT 未修改
TINY 未修改
注意

Advice — 待人工复核。 当前 Pigsty 模板投影事实:OLTP: PG9.0–16 未修改;OLAP: PG9.0–16 未修改;CRIT: PG9.0–16 未修改;TINY: PG9.0–16 未修改。 未发现覆盖值,因此不推断 Pigsty 专属理由。

常见坑

  • 限时诊断或恢复任务结束后仍让 trace_recovery_messages 保持启用。
  • 在生产数据的唯一副本上进行实验。
  • 低估日志、core、临时文件、WAL、CPU 或连接名额放大。
  • 把服务器能启动或查询能完成误当作数据与行为正确的证明。

log_min_messages · restore_command · recovery_min_apply_delay · wal_consistency_checking

参考资料