报告与日志

• 1: application_name
• 2: cluster_name
• 3: debug_pretty_print
• 4: debug_print_parse
• 5: debug_print_plan
• 6: debug_print_raw_parse
• 7: debug_print_rewritten
• 8: event_source
• 9: log_autoanalyze_min_duration
• 10: log_autovacuum_min_duration
• 11: log_checkpoints
• 12: log_connections
• 13: log_destination
• 14: log_directory
• 15: log_disconnections
• 16: log_duration
• 17: log_error_verbosity
• 18: log_file_mode
• 19: log_filename
• 20: log_hostname
• 21: log_line_prefix
• 22: log_lock_failures
• 23: log_lock_waits
• 24: log_min_duration_sample
• 25: log_min_duration_statement
• 26: log_min_error_statement
• 27: log_min_messages
• 28: log_parameter_max_length
• 29: log_parameter_max_length_on_error
• 30: log_recovery_conflict_waits
• 31: log_replication_commands
• 32: log_rotation_age
• 33: log_rotation_size
• 34: log_startup_progress_interval
• 35: log_statement
• 36: log_statement_sample_rate
• 37: log_temp_files
• 38: log_timezone
• 39: log_transaction_sample_rate
• 40: log_truncate_on_rotation
• 41: logging_collector
• 42: silent_mode
• 43: syslog_facility
• 44: syslog_ident
• 45: syslog_sequence_numbers
• 46: syslog_split_messages
• 47: update_process_title

1 - application_name

身份

生命周期

默认值变迁

机制详解

application_name 是客户端提供的会话元数据，通常在启动包中设置，也可稍后用 SET 修改。它出现在 pg_stat_activity 与 CSV 日志中，并可通过 log_line_prefix 的 %a 写入文本日志。

该值短于 NAMEDATALEN 字节（标准构建为 64 个字符）。PostgreSQL 接受可打印 ASCII，其他字符显示为 C 风格十六进制转义。由于截断与转义，日志消费者不能假定显示值与应用原始字符串完全一致。

它属于 USER 上下文标签，不是经过认证的身份：任何获授权客户端都可声明误导值，池化会话也可能保留或覆盖它。应与已认证用户、数据库、会话 ID、远端点，以及受控连接池签出/重置行为关联。

调优建议

Pigsty 取值

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

常见坑

• 把 application_name 当作已认证身份，或单独用于授权、计费与审计归属。
• 超过 NAMEDATALEN，因截断悄然丢失具有区分度的后缀。
• 误以为任意 Unicode 会原样保留，而不是转义为可打印的 C 风格十六进制序列。
• 在日志与 pg_stat_activity 中泄漏秘密或制造无界基数，或在连接池中未重置该值。

关联参数

cluster_name · update_process_title · log_line_prefix · log_timezone · log_hostname

参考资料

• PostgreSQL 19 Beta 3 — application_name
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

2 - cluster_name

身份

生命周期

默认值变迁

机制详解

cluster_name：设置显示在进程标题中的集群名称。它是写入进程标题的运维标签，可区分同一主机上的多个集群，但不是数据库标识符。

cluster_name 属于 POSTMASTER 上下文：PostgreSQL 在服务器启动时读取它，重新加载配置或会话 SET 都不能使新值生效。

进程标题与 application_name、cluster_name、pg_stat_activity、log_line_prefix 相互补充，使操作系统观察能够关联数据库活动。

调优建议

Pigsty 取值

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

常见坑

• 期待重新加载或 SET 激活 cluster_name，而它实际需要受控重启服务器。
• 把秘密或无界高基数数据放入运维可见的进程标签。
• 集群、应用与进程标签不一致，无法在监控系统之间关联。
• 没有回滚计划及客户端或运维兼容测试，就全局修改 cluster_name。

关联参数

application_name · update_process_title · log_line_prefix · log_timezone · log_hostname

参考资料

• PostgreSQL 19 Beta 3 — cluster_name
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

3 - debug_pretty_print

身份

生命周期

默认值变迁

机制详解

debug_pretty_print：对解析树和计划树的显示进行缩进美化。它只改变 debug_print_* 开关所输出内部解析树与计划树的缩进格式。

debug_pretty_print 属于 USER 上下文。获授权角色可在会话内修改，ALTER ROLE 或 ALTER DATABASE 可为未来会话建立默认值。

debug_print_* 开关沿普通服务器日志路径输出，因此 log_min_messages、log_destination 与收集器容量共同决定内容能否安全保留。

调优建议

Pigsty 取值

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

常见坑

• 只在一个会话中修改 debug_pretty_print，却认为角色默认值、数据库默认值或其他池化会话也已随之改变。
• 全局长期打开内部树转储，压垮日志 I/O、存储或摄取。
• 把调试输出当作稳定公共格式，或用它替代定向 EXPLAIN 诊断。
• 没有回滚计划及客户端或运维兼容测试，就全局修改 debug_pretty_print。

关联参数

debug_print_parse · debug_print_plan · debug_print_rewritten · log_min_messages · client_min_messages

参考资料

• PostgreSQL 19 Beta 3 — debug_pretty_print
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

4 - debug_print_parse

身份

生命周期

默认值变迁

机制详解

debug_print_parse：记录每个查询的解析树。输出是每条查询的 PostgreSQL 内部解析树表示，而不是规范化后的 SQL 文本。

debug_print_parse 属于 USER 上下文。获授权角色可在会话内修改，ALTER ROLE 或 ALTER DATABASE 可为未来会话建立默认值。

debug_print_* 开关沿普通服务器日志路径输出，因此 log_min_messages、log_destination 与收集器容量共同决定内容能否安全保留。

调优建议

Pigsty 取值

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

常见坑

• 只在一个会话中修改 debug_print_parse，却认为角色默认值、数据库默认值或其他池化会话也已随之改变。
• 全局长期打开内部树转储，压垮日志 I/O、存储或摄取。
• 把调试输出当作稳定公共格式，或用它替代定向 EXPLAIN 诊断。
• 没有回滚计划及客户端或运维兼容测试，就全局修改 debug_print_parse。

关联参数

debug_pretty_print · debug_print_plan · debug_print_rewritten · log_min_messages · client_min_messages

参考资料

• PostgreSQL 19 Beta 3 — debug_print_parse
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

5 - debug_print_plan

身份

生命周期

默认值变迁

机制详解

debug_print_plan：记录每个查询的执行计划树。输出是每条查询的内部计划树，比定向执行 EXPLAIN 冗长得多，主要用于服务器调试。

debug_print_plan 属于 USER 上下文。获授权角色可在会话内修改，ALTER ROLE 或 ALTER DATABASE 可为未来会话建立默认值。

debug_print_* 开关沿普通服务器日志路径输出，因此 log_min_messages、log_destination 与收集器容量共同决定内容能否安全保留。

调优建议

Pigsty 取值

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

常见坑

• 只在一个会话中修改 debug_print_plan，却认为角色默认值、数据库默认值或其他池化会话也已随之改变。
• 全局长期打开内部树转储，压垮日志 I/O、存储或摄取。
• 把调试输出当作稳定公共格式，或用它替代定向 EXPLAIN 诊断。
• 没有回滚计划及客户端或运维兼容测试，就全局修改 debug_print_plan。

关联参数

debug_pretty_print · debug_print_parse · debug_print_rewritten · log_min_messages · client_min_messages

参考资料

• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

6 - debug_print_raw_parse

身份

生命周期

默认值变迁

机制详解

debug_print_raw_parse：把每条查询的原始解析树写入日志。它可以按会话修改，便于在不影响全部负载的前提下比较计划或行为。 本站在 PG19 Beta 3 实测到它；boot_val 是编译或初始化基线，并不能证明某个运行集群的当前有效值。

原始解析树在语义分析、重写、规划与执行之前输出。消息级别为 LOG；debug_pretty_print 控制格式，而 client_min_messages 与 log_min_messages 决定输出位置。内容可能非常庞大，也可能暴露查询结构。

应与 debug_print_parse、debug_print_rewritten、debug_print_plan、debug_pretty_print 一起理解。请在目标服务器检查 SHOW 与 pg_settings，确认 source 和 pending_restart，并在修改前后对比真实负载、日志和资源指标。

调优建议

Pigsty 取值

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

常见坑

• 把 debug_print_raw_parse 的实测 boot_val 当成初始化后或托管集群当前有效值的证明。
• 忽略 pg_settings 报告的 user context，误以为修改会立即生效。
• 孤立修改该参数，没有检查关联上限、可观测性和回滚路径。
• 在生产中依赖测试版行为，却没有在 PostgreSQL 19 正式版发布后重新验证。

关联参数

debug_print_parse · debug_print_rewritten · debug_print_plan · debug_pretty_print · log_min_messages

参考资料

• PostgreSQL 19 Beta 3 — debug_print_raw_parse
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

7 - debug_print_rewritten

身份

生命周期

默认值变迁

机制详解

debug_print_rewritten：记录每个查询重写后的解析树。它显示规则重写后的查询树，可诊断视图与规则问题，但可能产生非常庞大的日志。

debug_print_rewritten 属于 USER 上下文。获授权角色可在会话内修改，ALTER ROLE 或 ALTER DATABASE 可为未来会话建立默认值。

debug_print_* 开关沿普通服务器日志路径输出，因此 log_min_messages、log_destination 与收集器容量共同决定内容能否安全保留。

调优建议

Pigsty 取值

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

常见坑

• 只在一个会话中修改 debug_print_rewritten，却认为角色默认值、数据库默认值或其他池化会话也已随之改变。
• 全局长期打开内部树转储，压垮日志 I/O、存储或摄取。
• 把调试输出当作稳定公共格式，或用它替代定向 EXPLAIN 诊断。
• 没有回滚计划及客户端或运维兼容测试，就全局修改 debug_print_rewritten。

关联参数

debug_pretty_print · debug_print_parse · debug_print_plan · log_min_messages · client_min_messages

参考资料

• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

8 - event_source

身份

生命周期

默认值变迁

机制详解

event_source：设置在 Windows 事件日志中标识 PostgreSQL 消息的应用名称。这是 Windows 事件日志标识符，只有 eventlog 是活动日志目标时才会生效。

event_source 属于 POSTMASTER 上下文：PostgreSQL 在服务器启动时读取它，重新加载配置或会话 SET 都不能使新值生效。

只有 Windows 上的 log_destination 选择 eventlog 时才读取 event_source；其余管线由 Windows 事件日志注册、权限、路由与保留策略提供。

调优建议

Pigsty 取值

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

常见坑

• 期待重新加载或 SET 激活 event_source，而它实际需要受控重启服务器。
• 更改来源名称，却未注册或更新 Windows 事件日志路由与访问策略。
• 在 eventlog 未启用或平台不是 Windows 时期待 event_source 生效。
• 没有回滚计划及客户端或运维兼容测试，就全局修改 event_source。

关联参数

logging_collector · log_destination · log_directory · log_filename · log_rotation_age · log_rotation_size

参考资料

• PostgreSQL 19 Beta 3 — event_source
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

9 - log_autoanalyze_min_duration

身份

生命周期

默认值变迁

机制详解

log_autoanalyze_min_duration：设置记录 autovacuum ANALYZE 动作的最短执行时间。重新加载配置即可让服务器采用新值，无需完整重启。 本站在 PG19 Beta 3 实测到它；boot_val 是编译或初始化基线，并不能证明某个运行集群的当前有效值。

0 会记录每次自动 ANALYZE，-1 禁用这类耗时消息，正值则记录达到阈值的动作，以及因锁冲突或关系被删除而跳过的相关事件。表级存储参数可以覆盖它，并且它与记录 VACUUM 的 log_autovacuum_min_duration 相互独立。

应与 log_autovacuum_min_duration、autovacuum、autovacuum_analyze_threshold、autovacuum_analyze_scale_factor 一起理解。请在目标服务器检查 SHOW 与 pg_settings，确认 source 和 pending_restart，并在修改前后对比真实负载、日志和资源指标。

调优建议

Pigsty 取值

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

常见坑

• 把 log_autoanalyze_min_duration 的实测 boot_val 当成初始化后或托管集群当前有效值的证明。
• 忽略 pg_settings 报告的 sighup context，误以为修改会立即生效。
• 孤立修改该参数，没有检查关联上限、可观测性和回滚路径。
• 在生产中依赖测试版行为，却没有在 PostgreSQL 19 正式版发布后重新验证。

关联参数

log_autovacuum_min_duration · autovacuum · autovacuum_analyze_threshold · autovacuum_analyze_scale_factor · log_min_messages

参考资料

• PostgreSQL 19 Beta 3 — log_autoanalyze_min_duration
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

10 - log_autovacuum_min_duration

身份

生命周期

默认值变迁

机制详解

log_autovacuum_min_duration：设置记录 autovacuum 操作所需达到的最短执行时间。每个达到阈值的自动 VACUUM 或 ANALYZE 会输出时长与工作详情；-1 关闭完成记录，零记录所有动作。

log_autovacuum_min_duration 属于 SIGHUP 上下文：重新加载配置即可在不重启的情况下激活服务器新值，后续读取它的操作使用刷新值。

它改变输出的诊断数据而非查询语义，但日志量、敏感内容、log_line_prefix、目标、收集器吞吐与保留策略共同决定运维成本和价值。

调优建议

Pigsty 取值

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

常见坑

• 编辑 log_autovacuum_min_duration 后没有重新加载配置，也没有核对有效值与后续行为。
• 增加日志内容却未预算收集器吞吐、存储、保留与下游查询成本。
• 记录 SQL 文本、绑定值、身份或主机数据，却没有脱敏与访问控制策略。
• 没有回滚计划及客户端或运维兼容测试，就全局修改 log_autovacuum_min_duration。

关联参数

log_checkpoints · log_lock_waits · log_lock_failures · log_temp_files · log_replication_commands

参考资料

• PostgreSQL 19 Beta 3 — log_autovacuum_min_duration
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

11 - log_checkpoints

身份

生命周期

默认值变迁

机制详解

log_checkpoints：记录每次检查点。检查点记录包含各阶段耗时及缓冲区或 WAL 工作量，暴露检查点节奏与写压力，而不只是一个标记。

log_checkpoints 属于 SIGHUP 上下文：重新加载配置即可在不重启的情况下激活服务器新值，后续读取它的操作使用刷新值。

它改变输出的诊断数据而非查询语义，但日志量、敏感内容、log_line_prefix、目标、收集器吞吐与保留策略共同决定运维成本和价值。

调优建议

Pigsty 取值

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

常见坑

• 编辑 log_checkpoints 后没有重新加载配置，也没有核对有效值与后续行为。
• 增加日志内容却未预算收集器吞吐、存储、保留与下游查询成本。
• 记录 SQL 文本、绑定值、身份或主机数据，却没有脱敏与访问控制策略。
• 没有回滚计划及客户端或运维兼容测试，就全局修改 log_checkpoints。

关联参数

log_autovacuum_min_duration · log_lock_waits · log_lock_failures · log_temp_files · log_replication_commands

参考资料

• PostgreSQL 19 Beta 3 — log_checkpoints
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

12 - log_connections

身份

生命周期

默认值变迁

机制详解

PostgreSQL 10–17 中，log_connections 是布尔参数，启用后记录成功连接。PostgreSQL 18 将其改为字符串列表，精确选项为 receipt、authentication、authorization、setup_durations 与 all；空字符串关闭连接日志。为兼容旧配置，on、true、yes、1 等价于 receipt,authentication,authorization，off、false、no、0 等价于空列表。认证失败无论本参数为何值都会记录。

log_connections 属于 SUPERUSER_BACKEND 上下文：超级用户或获授相应 SET 权限的角色可在会话启动时选择它，但后端会话启动后不能再修改。因此配置变化只影响新会话。

receipt 记录连接到达，authentication 记录认证方法提交的原始身份，authorization 记录带用户、数据库和应用上下文的成功授权，setup_durations 记录总初始化、后端 fork 与认证耗时。会话结束由 log_disconnections 单独控制；连接身份与拓扑仍属于敏感日志数据。

调优建议

Pigsty 取值

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

常见坑

• 使用不存在的 setup，而不是 PostgreSQL 18 的有效选项 setup_durations。
• 误以为兼容值 on 等于 all；它不含 setup_durations，只映射到 receipt、authentication、authorization。
• 期待既有会话继承新值，而该参数在后端启动时已经固定。
• 未考虑 psql 等客户端可能探测两次就把重复 receipt 当作攻击，或在没有访问控制策略时长期保留原始身份。

关联参数

log_statement · log_duration · log_disconnections · log_parameter_max_length · log_parameter_max_length_on_error

参考资料

• PostgreSQL 19 Beta 3 — log_connections
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

13 - log_destination

身份

生命周期

默认值变迁

机制详解

log_destination：设置服务器日志输出的目标。可同时启用多个目标；csvlog 与 jsonlog 需要 logging_collector，而 stderr、syslog 和 Windows eventlog 采用不同传输路径。

log_destination 属于 SIGHUP 上下文：重新加载配置即可在不重启的情况下激活服务器新值，后续读取它的操作使用刷新值。

实际路径由 log_destination、logging_collector 或 syslog/eventlog、文件命名与权限、轮转触发条件，以及外部转运或保留共同构成。

调优建议

Pigsty 取值

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

常见坑

• 编辑 log_destination 后没有重新加载配置，也没有核对有效值与后续行为。
• 组合互不兼容的目标、收集器、文件名与轮转假设，最终丢失或覆盖日志。
• 未监控写满或不可写的日志目标；不同路径下它可能阻塞日志甚至数据库活动。
• 没有回滚计划及客户端或运维兼容测试，就全局修改 log_destination。

关联参数

logging_collector · log_directory · log_filename · log_rotation_age · log_rotation_size

参考资料

• PostgreSQL 19 Beta 3 — log_destination
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

14 - log_directory

身份

生命周期

默认值变迁

机制详解

log_directory：设置日志文件的目标目录。相对路径在数据目录下解析，绝对路径则可把收集器管理的文件放到独立文件系统。

log_directory 属于 SIGHUP 上下文：重新加载配置即可在不重启的情况下激活服务器新值，后续读取它的操作使用刷新值。

实际路径由 log_destination、logging_collector 或 syslog/eventlog、文件命名与权限、轮转触发条件，以及外部转运或保留共同构成。

调优建议

Pigsty 取值

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

常见坑

• 编辑 log_directory 后没有重新加载配置，也没有核对有效值与后续行为。
• 组合互不兼容的目标、收集器、文件名与轮转假设，最终丢失或覆盖日志。
• 未监控写满或不可写的日志目标；不同路径下它可能阻塞日志甚至数据库活动。
• 没有回滚计划及客户端或运维兼容测试，就全局修改 log_directory。

关联参数

logging_collector · log_destination · log_filename · log_rotation_age · log_rotation_size

参考资料

• PostgreSQL 19 Beta 3 — log_directory
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

15 - log_disconnections

身份

生命周期

默认值变迁

机制详解

log_disconnections：记录会话结束及其持续时间。记录在会话结束时输出并包含会话时长，可与连接开始身份配对，但不能证明每次突发故障都到达日志器。

log_disconnections 属于 SUPERUSER_BACKEND 上下文：配置变化在新后端会话启动时生效，并需要超级用户级权限；既有会话保留启动值。

它改变输出的诊断数据而非查询语义，但日志量、敏感内容、log_line_prefix、目标、收集器吞吐与保留策略共同决定运维成本和价值。

调优建议

Pigsty 取值

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

常见坑

• 期待既有会话继承新的 log_disconnections 值，而它在每个后端启动时已经固定。
• 增加日志内容却未预算收集器吞吐、存储、保留与下游查询成本。
• 记录 SQL 文本、绑定值、身份或主机数据，却没有脱敏与访问控制策略。
• 没有回滚计划及客户端或运维兼容测试，就全局修改 log_disconnections。

关联参数

log_statement · log_duration · log_connections · log_parameter_max_length · log_parameter_max_length_on_error

参考资料

• PostgreSQL 19 Beta 3 — log_disconnections
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

16 - log_duration

身份

生命周期

默认值变迁

机制详解

log_duration：记录每条已完成 SQL 语句的执行时长。它为每条完成语句输出时长，但自身不输出语句文本；需要文本时由 log_statement 或时长阈值提供。

log_duration 属于 SUPERUSER 上下文。超级用户或获授相应 SET 权限的角色可在会话内修改，ALTER ROLE 或 ALTER DATABASE 可为未来会话建立默认值。

它改变输出的诊断数据而非查询语义，但日志量、敏感内容、log_line_prefix、目标、收集器吞吐与保留策略共同决定运维成本和价值。

调优建议

Pigsty 取值

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

常见坑

• 只在一个会话中修改 log_duration，却认为角色默认值、数据库默认值或其他池化会话也已随之改变。
• 增加日志内容却未预算收集器吞吐、存储、保留与下游查询成本。
• 记录 SQL 文本、绑定值、身份或主机数据，却没有脱敏与访问控制策略。
• 期待时长日志包含 SQL 文本，而实际上没有任何语句日志参数输出文本。

关联参数

log_statement · log_connections · log_disconnections · log_parameter_max_length · log_parameter_max_length_on_error

参考资料

• PostgreSQL 19 Beta 3 — log_duration
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

17 - log_error_verbosity

身份

生命周期

默认值变迁

机制详解

log_error_verbosity：设置日志消息的详细程度。TERSE 抑制详情与提示，DEFAULT 保留常规诊断，VERBOSE 追加 SQLSTATE 以及源文件、函数与行号。

log_error_verbosity 属于 SUPERUSER 上下文。超级用户或获授相应 SET 权限的角色可在会话内修改，ALTER ROLE 或 ALTER DATABASE 可为未来会话建立默认值。

它改变输出的诊断数据而非查询语义，但日志量、敏感内容、log_line_prefix、目标、收集器吞吐与保留策略共同决定运维成本和价值。

调优建议

Pigsty 取值

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

常见坑

• 只在一个会话中修改 log_error_verbosity，却认为角色默认值、数据库默认值或其他池化会话也已随之改变。
• 增加日志内容却未预算收集器吞吐、存储、保留与下游查询成本。
• 记录 SQL 文本、绑定值、身份或主机数据，却没有脱敏与访问控制策略。
• 没有回滚计划及客户端或运维兼容测试，就全局修改 log_error_verbosity。

关联参数

log_statement · log_duration · log_connections · log_disconnections · log_parameter_max_length · log_parameter_max_length_on_error

参考资料

• PostgreSQL 19 Beta 3 — log_error_verbosity
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

18 - log_file_mode

身份

生命周期

默认值变迁

机制详解

log_file_mode 是 logging_collector 新建文件所用的 chmod 风格数字模式。常规八进制写法必须带前导零：0640 与十进制 640 不是同一个数值。它不作用于 syslog/eventlog 输出，也不会修改既有文件。

它属于 SIGHUP 上下文。重载后，logging_collector 下次创建文件时使用新模式；重载不会对当前打开文件或历史文件执行 chmod。

有效访问边界还包括 PostgreSQL 服务账号、文件组、log_directory 的所有权与遍历权限、转运代理组成员，以及外部保留副本。只有该组受到严格控制时，组可读模式才安全。

调优建议

Pigsty 取值

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

常见坑

• 编辑 log_file_mode 后没有重新加载配置，也没有核对有效值与后续行为。
• 组合互不兼容的目标、收集器、文件名与轮转假设，最终丢失或覆盖日志。
• 未监控写满或不可写的日志目标；不同路径下它可能阻塞日志甚至数据库活动。
• 写成 640 而非八进制 0640，得到不同的数字权限模式。

关联参数

logging_collector · log_destination · log_directory · log_filename · log_rotation_age · log_rotation_size

参考资料

• PostgreSQL 19 Beta 3 — log_file_mode
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

19 - log_filename

身份

生命周期

默认值变迁

机制详解

log_filename：设置日志文件名模式。logging_collector 每次打开新文件时按 log_timezone 展开 strftime 转义，因此重复名称必须与轮转和截断协调。

log_filename 属于 SIGHUP 上下文：重新加载配置即可在不重启的情况下激活服务器新值，后续读取它的操作使用刷新值。

实际路径由 log_destination、logging_collector 或 syslog/eventlog、文件命名与权限、轮转触发条件，以及外部转运或保留共同构成。

调优建议

Pigsty 取值

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

常见坑

• 编辑 log_filename 后没有重新加载配置，也没有核对有效值与后续行为。
• 组合互不兼容的目标、收集器、文件名与轮转假设，最终丢失或覆盖日志。
• 未监控写满或不可写的日志目标；不同路径下它可能阻塞日志甚至数据库活动。
• 使用重复的 strftime 文件名，却未匹配轮转与截断策略，造成持续追加或意外覆盖。

关联参数

logging_collector · log_destination · log_directory · log_rotation_age · log_rotation_size

参考资料

• PostgreSQL 19 Beta 3 — log_filename
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

20 - log_hostname

身份

生命周期

默认值变迁

机制详解

log_hostname：在连接日志中记录主机名。为把客户端地址转换为名称会执行反向 DNS；名称服务缓慢时可能增加连接延迟甚至造成停顿。

log_hostname 属于 SIGHUP 上下文：重新加载配置即可在不重启的情况下激活服务器新值，后续读取它的操作使用刷新值。

它改变输出的诊断数据而非查询语义，但日志量、敏感内容、log_line_prefix、目标、收集器吞吐与保留策略共同决定运维成本和价值。

调优建议

Pigsty 取值

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

常见坑

• 编辑 log_hostname 后没有重新加载配置，也没有核对有效值与后续行为。
• 增加日志内容却未预算收集器吞吐、存储、保留与下游查询成本。
• 记录 SQL 文本、绑定值、身份或主机数据，却没有脱敏与访问控制策略。
• 在解析器延迟位于连接路径时启用反向 DNS。

关联参数

application_name · cluster_name · update_process_title · log_line_prefix · log_timezone

参考资料

• PostgreSQL 19 Beta 3 — log_hostname
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

21 - log_line_prefix

身份

生命周期

默认值变迁

机制详解

log_line_prefix：控制每行日志前添加的信息。百分号转义可加入会话、用户、数据库、进程、应用与时间上下文；csvlog 和 jsonlog 已单独携带结构化字段。

log_line_prefix 属于 SIGHUP 上下文：重新加载配置即可在不重启的情况下激活服务器新值，后续读取它的操作使用刷新值。

它改变输出的诊断数据而非查询语义，但日志量、敏感内容、log_line_prefix、目标、收集器吞吐与保留策略共同决定运维成本和价值。

调优建议

Pigsty 取值

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

常见坑

• 编辑 log_line_prefix 后没有重新加载配置，也没有核对有效值与后续行为。
• 增加日志内容却未预算收集器吞吐、存储、保留与下游查询成本。
• 记录 SQL 文本、绑定值、身份或主机数据，却没有脱敏与访问控制策略。
• 遗漏关联多行文本日志所需的进程、会话、数据库、用户或应用身份。

关联参数

application_name · cluster_name · update_process_title · log_timezone · log_hostname

参考资料

• PostgreSQL 19 Beta 3 — log_line_prefix
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

22 - log_lock_failures

身份

生命周期

默认值变迁

机制详解

log_lock_failures 引入于 PostgreSQL 18，在受支持的锁获取失败时输出详细消息。PostgreSQL 18 当前支持范围明确只有 SELECT … NOWAIT 导致的锁失败；它不是所有 NOWAIT 类命令或所有锁错误的通用日志器。

它属于 SUPERUSER 上下文。超级用户或获授相应 SET 权限的角色可按会话修改，因此角色/数据库默认值与连接池重置行为决定哪些会话产生记录。

它补充 log_lock_waits：后者记录超过 deadlock_timeout 的等待，而 SELECT … NOWAIT 会立即失败并可由本参数记录。详细消息可能暴露关系、锁与语句上下文，必须遵循常规日志访问策略。

调优建议

Pigsty 取值

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

常见坑

• 误以为 PostgreSQL 18 会记录所有锁获取失败；当前只支持 SELECT … NOWAIT。
• 用它替代 log_lock_waits，而立即失败与等待超过 deadlock_timeout 是不同事件。
• 只在一个池化会话中启用，却认为其他会话继承了该值。
• 在没有适当日志访问、脱敏与保留控制时保存详细锁和语句上下文。

关联参数

log_checkpoints · log_autovacuum_min_duration · log_lock_waits · log_temp_files · log_replication_commands

参考资料

• PostgreSQL 19 Beta 3 — log_lock_failures
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

23 - log_lock_waits

身份

生命周期

默认值变迁

机制详解

log_lock_waits：记录持续时间较长的锁等待。锁等待超过 deadlock_timeout 后才记录，因此诊断阈值与死锁检测节奏相互耦合。

log_lock_waits 属于 SUPERUSER 上下文。超级用户或获授相应 SET 权限的角色可在会话内修改，ALTER ROLE 或 ALTER DATABASE 可为未来会话建立默认值。

它改变输出的诊断数据而非查询语义，但日志量、敏感内容、log_line_prefix、目标、收集器吞吐与保留策略共同决定运维成本和价值。

调优建议

Pigsty 取值

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

常见坑

• 只在一个会话中修改 log_lock_waits，却认为角色默认值、数据库默认值或其他池化会话也已随之改变。
• 增加日志内容却未预算收集器吞吐、存储、保留与下游查询成本。
• 记录 SQL 文本、绑定值、身份或主机数据，却没有脱敏与访问控制策略。
• 修改 deadlock_timeout，却未意识到锁等待诊断出现时间也随之改变。

关联参数

log_checkpoints · log_autovacuum_min_duration · log_lock_failures · log_temp_files · log_replication_commands

参考资料

• PostgreSQL 19 Beta 3 — log_lock_waits
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

24 - log_min_duration_sample

身份

生命周期

默认值变迁

机制详解

log_min_duration_sample 让执行时长达到阈值的已完成语句进入由 log_statement_sample_rate 控制的随机日志路径。-1 关闭该路径，零让所有已完成语句进入，再由抽样率决定实际输出。

log_min_duration_statement 优先级更高。达到其阈值的语句始终记录且不参与抽样，即使同时超过 log_min_duration_sample。扩展查询协议下，Parse、Bind 与 Execute 的时长分别记录。

它属于 SUPERUSER 上下文的会话参数。抽样条目与 log_min_duration_statement 具有相同的语句文本、Bind 值、关联、开销和安全问题，因此 log_line_prefix 与 log_parameter_max_length 仍决定可用性与暴露范围。

调优建议

Pigsty 取值

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

常见坑

• 期待抽样影响已被更高优先级 log_min_duration_statement 阈值捕获的语句。
• 忘记扩展查询协议会分别计时并记录 Parse、Bind 与 Execute。
• 把阈值设为零且 log_statement_sample_rate 为 1，意外记录每条已完成语句的时长。
• 在没有关联标识、脱敏、访问控制与实测容量预算时抽样 SQL 和 Bind 值。

关联参数

log_min_messages · log_min_error_statement · log_min_duration_statement · log_statement_sample_rate · log_transaction_sample_rate

参考资料

• PostgreSQL 19 Beta 3 — log_min_duration_sample
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

25 - log_min_duration_statement

身份

生命周期

默认值变迁

机制详解

未写单位时按毫秒解释。-1 关闭按时长记录，0 记录所有已完成语句，正数则记录达到或超过阈值的语句。

由本参数选中的语句会始终记录而不参与抽样，因此优先于 log_min_duration_sample。使用扩展查询协议时，Parse、Bind、Execute 阶段的时长可能分别出现。

该参数只观察并记录已经完成的工作，不会终止慢语句；取消执行应使用独立的 statement_timeout。

调优建议

Pigsty 取值

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

常见坑

• 高吞吐系统上的低阈值可能制造巨量日志与 I/O。
• SQL 文本可能含敏感字面量，日志应按应用数据同等级保护。
• 它只记录慢语句而不取消；取消应使用 statement_timeout。
• 扩展协议阶段可能分开记录，需要会话或 PID 关联。
• 与 log_statement、抽样和 log_line_prefix 的组合可能造成重复或碎片化理解。

关联参数

log_min_duration_sample · log_statement_sample_rate · log_statement · log_duration · log_line_prefix · statement_timeout

参考资料

• PostgreSQL 19 Beta 3 — log_min_duration_statement
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

26 - log_min_error_statement

身份

生命周期

默认值变迁

机制详解

log_min_error_statement：记录所有产生不低于指定级别错误的语句。它控制是否附带产生错误级消息的 SQL 语句；消息本身是否输出则由 log_min_messages 分别决定。

log_min_error_statement 属于 SUPERUSER 上下文。超级用户或获授相应 SET 权限的角色可在会话内修改，ALTER ROLE 或 ALTER DATABASE 可为未来会话建立默认值。

它改变输出的诊断数据而非查询语义，但日志量、敏感内容、log_line_prefix、目标、收集器吞吐与保留策略共同决定运维成本和价值。

调优建议

Pigsty 取值

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

常见坑

• 只在一个会话中修改 log_min_error_statement，却认为角色默认值、数据库默认值或其他池化会话也已随之改变。
• 增加日志内容却未预算收集器吞吐、存储、保留与下游查询成本。
• 记录 SQL 文本、绑定值、身份或主机数据，却没有脱敏与访问控制策略。
• 没有回滚计划及客户端或运维兼容测试，就全局修改 log_min_error_statement。

关联参数

log_min_messages · log_min_duration_statement · log_min_duration_sample · log_statement_sample_rate · log_transaction_sample_rate

参考资料

• PostgreSQL 19 Beta 3 — log_min_error_statement
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

27 - log_min_messages

身份

生命周期

默认值变迁

机制详解

log_min_messages：设置写入服务器日志的消息级别。服务器日志严重级别中 LOG 的位置特殊，且顺序不同于 client_min_messages，因此不能在二者之间盲目照搬阈值名。

log_min_messages 属于 SUPERUSER 上下文。超级用户或获授相应 SET 权限的角色可在会话内修改，ALTER ROLE 或 ALTER DATABASE 可为未来会话建立默认值。

它改变输出的诊断数据而非查询语义，但日志量、敏感内容、log_line_prefix、目标、收集器吞吐与保留策略共同决定运维成本和价值。

调优建议

Pigsty 取值

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

常见坑

• 只在一个会话中修改 log_min_messages，却认为角色默认值、数据库默认值或其他池化会话也已随之改变。
• 增加日志内容却未预算收集器吞吐、存储、保留与下游查询成本。
• 记录 SQL 文本、绑定值、身份或主机数据，却没有脱敏与访问控制策略。
• 没有回滚计划及客户端或运维兼容测试，就全局修改 log_min_messages。

关联参数

log_min_error_statement · log_min_duration_statement · log_min_duration_sample · log_statement_sample_rate · log_transaction_sample_rate

参考资料

• PostgreSQL 19 Beta 3 — log_min_messages
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

28 - log_parameter_max_length

身份

生命周期

默认值变迁

机制详解

log_parameter_max_length 控制附加到非错误语句日志消息的 Bind 值。零不记录，-1 允许完整值，正字节数把每个文本值截断到该上限。

它作用于 log_statement、log_min_duration_statement 及相关语句日志产生的消息。任何非零值都会增加工作量；二进制参数必须先转换为文本才能记录。

它属于 SUPERUSER 上下文的会话参数，并与 log_parameter_max_length_on_error 相互独立。因此普通路径与错误路径需要分别决定保密性与开销。

调优建议

Pigsty 取值

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

常见坑

• 使用 -1，在普通语句日志中暴露完整凭据、令牌或大载荷。
• 把截断当作脱敏；敏感前缀仍可能完整可见。
• 值非零时忽略二进制 Bind 参数的文本转换开销。
• 误以为它也限制由 log_parameter_max_length_on_error 控制的错误路径参数。

关联参数

log_statement · log_duration · log_connections · log_disconnections · log_parameter_max_length_on_error

参考资料

• PostgreSQL 19 Beta 3 — log_parameter_max_length
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

29 - log_parameter_max_length_on_error

身份

生命周期

默认值变迁

机制详解

log_parameter_max_length_on_error 控制错误报告中包含的 Bind 值。默认零不记录，-1 允许完整值，正字节数把每个文本值截断到该上限。

只要值非零，PostgreSQL 就必须在每条语句开始时保留参数的文本表示，以备发生错误。即使语句成功也要支付该开销，二进制参数还需要转换而不只是复制文本。

它属于 USER 上下文的会话参数，并与 log_parameter_max_length 相互独立。因此即使普通语句日志不记录值，应用也可能在错误路径意外暴露。应联合评审错误详情、访问、脱敏与保留。

调优建议

Pigsty 取值

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

常见坑

• 误以为只有语句失败时才支付转换与内存成本；值非零时每条语句都会支付。
• 使用 -1，把完整秘密或大载荷暴露在错误报告中。
• 忽略二进制 Bind 值的文本转换成本，以及成功语句也会保留参数表示。
• 误以为 log_parameter_max_length 会保护错误路径；两个上限彼此独立。

关联参数

log_statement · log_duration · log_connections · log_disconnections · log_parameter_max_length

参考资料

• PostgreSQL 19 Beta 3 — log_parameter_max_length_on_error
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

30 - log_recovery_conflict_waits

身份

生命周期

默认值变迁

机制详解

log_recovery_conflict_waits：记录备用库恢复冲突等待。在备用库上，恢复冲突等待超过 deadlock_timeout 后会被记录，可在尚未必须取消查询前暴露回放延迟。

log_recovery_conflict_waits 属于 SIGHUP 上下文：重新加载配置即可在不重启的情况下激活服务器新值，后续读取它的操作使用刷新值。

它改变输出的诊断数据而非查询语义，但日志量、敏感内容、log_line_prefix、目标、收集器吞吐与保留策略共同决定运维成本和价值。

调优建议

Pigsty 取值

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

常见坑

• 编辑 log_recovery_conflict_waits 后没有重新加载配置，也没有核对有效值与后续行为。
• 增加日志内容却未预算收集器吞吐、存储、保留与下游查询成本。
• 记录 SQL 文本、绑定值、身份或主机数据，却没有脱敏与访问控制策略。
• 没有回滚计划及客户端或运维兼容测试，就全局修改 log_recovery_conflict_waits。

关联参数

log_checkpoints · log_autovacuum_min_duration · log_lock_waits · log_lock_failures · log_temp_files · log_replication_commands

参考资料

• PostgreSQL 19 Beta 3 — log_recovery_conflict_waits
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

31 - log_replication_commands

身份

生命周期

默认值变迁

机制详解

log_replication_commands：记录每条复制命令。它既覆盖复制协议命令，也覆盖 SQL 复制命令，因此能够暴露复制拓扑与复制槽活动。

log_replication_commands 属于 SUPERUSER 上下文。超级用户或获授相应 SET 权限的角色可在会话内修改，ALTER ROLE 或 ALTER DATABASE 可为未来会话建立默认值。

它改变输出的诊断数据而非查询语义，但日志量、敏感内容、log_line_prefix、目标、收集器吞吐与保留策略共同决定运维成本和价值。

调优建议

Pigsty 取值

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

常见坑

• 只在一个会话中修改 log_replication_commands，却认为角色默认值、数据库默认值或其他池化会话也已随之改变。
• 增加日志内容却未预算收集器吞吐、存储、保留与下游查询成本。
• 记录 SQL 文本、绑定值、身份或主机数据，却没有脱敏与访问控制策略。
• 没有回滚计划及客户端或运维兼容测试，就全局修改 log_replication_commands。

关联参数

log_checkpoints · log_autovacuum_min_duration · log_lock_waits · log_lock_failures · log_temp_files

参考资料

• PostgreSQL 19 Beta 3 — log_replication_commands
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

32 - log_rotation_age

身份

生命周期

默认值变迁

机制详解

log_rotation_age：设置强制轮转日志文件前等待的时间。收集器在达到间隔后打开新文件；零关闭这一触发器，但仍可使用按大小或外部轮转。

log_rotation_age 属于 SIGHUP 上下文：重新加载配置即可在不重启的情况下激活服务器新值，后续读取它的操作使用刷新值。

实际路径由 log_destination、logging_collector 或 syslog/eventlog、文件命名与权限、轮转触发条件，以及外部转运或保留共同构成。

调优建议

Pigsty 取值

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

常见坑

• 编辑 log_rotation_age 后没有重新加载配置，也没有核对有效值与后续行为。
• 组合互不兼容的目标、收集器、文件名与轮转假设，最终丢失或覆盖日志。
• 未监控写满或不可写的日志目标；不同路径下它可能阻塞日志甚至数据库活动。
• 没有回滚计划及客户端或运维兼容测试，就全局修改 log_rotation_age。

关联参数

logging_collector · log_destination · log_directory · log_filename · log_rotation_size

参考资料

• PostgreSQL 19 Beta 3 — log_rotation_age
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

33 - log_rotation_size

身份

生命周期

默认值变迁

机制详解

log_rotation_size：设置触发轮转前单个日志文件可达到的最大大小。当前文件约达到该大小时收集器轮转；零只关闭大小触发器，不关闭按时间轮转。

log_rotation_size 属于 SIGHUP 上下文：重新加载配置即可在不重启的情况下激活服务器新值，后续读取它的操作使用刷新值。

实际路径由 log_destination、logging_collector 或 syslog/eventlog、文件命名与权限、轮转触发条件，以及外部转运或保留共同构成。

调优建议

Pigsty 取值

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

常见坑

• 编辑 log_rotation_size 后没有重新加载配置，也没有核对有效值与后续行为。
• 组合互不兼容的目标、收集器、文件名与轮转假设，最终丢失或覆盖日志。
• 未监控写满或不可写的日志目标；不同路径下它可能阻塞日志甚至数据库活动。
• 设为零却没有有效的按时间或外部轮转策略，导致文件无界增长。

关联参数

logging_collector · log_destination · log_directory · log_filename · log_rotation_age

参考资料

• PostgreSQL 19 Beta 3 — log_rotation_size
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

34 - log_startup_progress_interval

身份

生命周期

默认值变迁

机制详解

log_startup_progress_interval：设置耗时启动操作的进度日志间隔。启动进程在 WAL 回放等操作持续超过该间隔时周期性输出进度；零关闭这些更新。

log_startup_progress_interval 属于 SIGHUP 上下文：重新加载配置即可在不重启的情况下激活服务器新值，后续读取它的操作使用刷新值。

它改变输出的诊断数据而非查询语义，但日志量、敏感内容、log_line_prefix、目标、收集器吞吐与保留策略共同决定运维成本和价值。

调优建议

Pigsty 取值

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

常见坑

• 编辑 log_startup_progress_interval 后没有重新加载配置，也没有核对有效值与后续行为。
• 增加日志内容却未预算收集器吞吐、存储、保留与下游查询成本。
• 记录 SQL 文本、绑定值、身份或主机数据，却没有脱敏与访问控制策略。
• 没有回滚计划及客户端或运维兼容测试，就全局修改 log_startup_progress_interval。

关联参数

log_checkpoints · log_autovacuum_min_duration · log_lock_waits · log_lock_failures · log_temp_files · log_replication_commands

参考资料

• PostgreSQL 19 Beta 3 — log_startup_progress_interval
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

35 - log_statement

身份

生命周期

默认值变迁

机制详解

log_statement 可选 none、ddl、mod、all。ddl 记录数据定义命令，mod 再加入数据变更命令，all 记录所有到达日志点的语句；PREPARE、EXECUTE 与 EXPLAIN ANALYZE 按其包含命令分类。

使用扩展查询协议时，收到 Execute 才记录，并包含 Bind 参数值。即使设为 all，基本解析失败的简单语句，以及在 Execute 前的解析分析或规划阶段失败的扩展协议语句也不会记录；这些错误路径需要 log_min_error_statement。

它属于 SUPERUSER 上下文的会话参数。语句文本与 Bind 值可能暴露个人数据、令牌，甚至明文密码，因此范围选择、访问、脱敏、传输与保留必须同时作为安全控制和可观测性选择。

调优建议

Pigsty 取值

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

常见坑

• 误以为 all 会捕获语法错误或 Execute 前的扩展协议失败；这些路径应使用 log_min_error_statement。
• 忘记扩展协议在 Execute 日志中包含 Bind 参数值。
• 在没有脱敏与严格访问控制时记录含明文密码、Bearer Token、个人数据或应用秘密的 SQL。
• 未限制日志吞吐、磁盘、转运与保留就集群级启用 mod 或 all。

关联参数

log_duration · log_connections · log_disconnections · log_parameter_max_length · log_parameter_max_length_on_error

参考资料

• PostgreSQL 19 Beta 3 — log_statement
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

36 - log_statement_sample_rate

身份

生命周期

默认值变迁

机制详解

log_statement_sample_rate：设置超过 log_min_duration_sample 的语句被记录的比例。该概率只对达到 log_min_duration_sample 的语句生效，不会抽样 log_statement 或 log_min_duration_statement 的输出。

log_statement_sample_rate 属于 SUPERUSER 上下文。超级用户或获授相应 SET 权限的角色可在会话内修改，ALTER ROLE 或 ALTER DATABASE 可为未来会话建立默认值。

它改变输出的诊断数据而非查询语义，但日志量、敏感内容、log_line_prefix、目标、收集器吞吐与保留策略共同决定运维成本和价值。

调优建议

Pigsty 取值

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

常见坑

• 只在一个会话中修改 log_statement_sample_rate，却认为角色默认值、数据库默认值或其他池化会话也已随之改变。
• 增加日志内容却未预算收集器吞吐、存储、保留与下游查询成本。
• 记录 SQL 文本、绑定值、身份或主机数据，却没有脱敏与访问控制策略。
• 期待它抽样所有语句日志，而实际上只控制 log_min_duration_sample。

关联参数

log_min_messages · log_min_error_statement · log_min_duration_statement · log_min_duration_sample · log_transaction_sample_rate

参考资料

• PostgreSQL 19 Beta 3 — log_statement_sample_rate
• PostgreSQL 19 发行说明
• 机器可读 GUC 全量导出

37 - log_temp_files

身份

生命周期

默认值变迁

机制详解

log_temp_files：记录大于指定千字节数的临时文件使用。临时文件删除时会记录名称与大小；-1 关闭记录，零包含每个文件。

log_temp_files 属于 SUPERUSER 上下文。超级用户或获授相应 SET 权限的角色可在会话内修改，ALTER ROLE 或 ALTER DATABASE 可为未来会话建立默认值。

它改变输出的诊断数据而非查询语义，但日志量、敏感内容、log_line_prefix、目标、收集器吞吐与保留策略共同决定运维成本和价值。

调优建议

Pigsty 取值

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