CONFIGURATION PARAMETER错误报告和日志 / 何时记录
log_min_duration_statement
记录运行时间达到配置阈值的已完成语句。
Sets the minimum execution time above which all statements will be logged.
整数 会话（超级用户） 引入 9.0（基线） 现存至 20 devel 0 次默认值变更
- 类型
- 整数integer
- 上下文
- 会话（超级用户）超级用户可在会话内用 SET 修改
- 默认值
-1 ms原始值 -1 ms- 取值范围
-1 – 2147483647- 引入版本
- 9.0（基线）
- 状态
- 现存
版本轨迹
相对 PostgreSQL 17 仅简述或分类有更新。
默认值变迁
默认值自 PostgreSQL 9.0 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
记录每个已完成语句的持续时间，如果语句运行时间至少达到指定时间。 例如，如果将其设置为250ms，那么所有运行时间为250ms或更长的SQL语句将被记录。 启用此参数可帮助跟踪应用程序中的未优化查询。 如果未指定单位，则将其视为毫秒。 将此值设置为零将打印所有语句持续时间。 -1（默认值）禁用记录语句持续时间。 只有超级用户和具有适当SET权限的用户才能更改此设置。
这会覆盖log_min_duration_sample，意味着持续时间超过此设置的查询不进行抽样，并且始终被记录。
对于使用扩展查询协议的客户端，解析、绑定和执行步骤的持续时间将被独立记录。
当把这个选项和log_statement一起使用时，已经被log_statement记录的语句文本不会在持续时间日志消息中重复。如果你没有使用syslog，我们推荐你使用log_line_prefix记录 PID 或会话 ID，这样你可以使用进程 ID 或会话 ID 把语句消息链接到后来的持续时间消息。
机制详解
未写单位时按毫秒解释。-1 关闭按时长记录，0 记录所有已完成语句，正数则记录达到或超过阈值的语句。
由本参数选中的语句会始终记录而不参与抽样，因此优先于 log_min_duration_sample。使用扩展查询协议时，Parse、Bind、Execute 阶段的时长可能分别出现。
该参数只观察并记录已经完成的工作，不会终止慢语句；取消执行应使用独立的 statement_timeout。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
根据应用延迟目标和可接受日志量选择阈值。高 QPS 场景可用有意义的硬阈值捕获真正慢查询，并对更快的语句采用抽样。
-
OLAP分析与批处理
采用更高阈值，避免正常的长分析查询淹没日志；结合 query identifier 和工作负载标签，让重复记录仍然可行动。
-
小规格低配实例与开发机
调优期可使用较低阈值，但要观察磁盘与轮转；一旦日志本身成为可测负载，应提高阈值或改用抽样。
常见问题
- 高吞吐系统上的低阈值可能制造巨量日志与 I/O。
- SQL 文本可能含敏感字面量，日志应按应用数据同等级保护。
- 它只记录慢语句而不取消；取消应使用 statement_timeout。
- 扩展协议阶段可能分开记录，需要会话或 PID 关联。
- 与 log_statement、抽样和 log_line_prefix 的组合可能造成重复或碎片化理解。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
-
PostgreSQL 18 ← 17 仅描述更新
补充说明
Zero prints all queries. -1 turns this feature off.-1 disables logging statement durations. 0 means log all statement durations. -
PostgreSQL 13 ← 12 仅描述更新
简述
Sets the minimum execution time above which statements will be logged.Sets the minimum execution time above which all statements will be logged. -
PostgreSQL 9.1 ← 9.0 属性变更
最大值
21474832147483647
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
| 版本 | 默认值 | 单位 | 上下文 | 类型 | 最小值 | 最大值 | 枚举值 |
|---|---|---|---|---|---|---|---|
| 9.0 | -1 ms |
ms |
会话（超级用户） |
整数 |
-1 |
2147483 |
— |
| 9.1 | -1 ms |
ms |
会话（超级用户） |
整数 |
-1 |
2147483647 |
— |
| 9.2 | -1 ms |
ms |
会话（超级用户） |
整数 |
-1 |
2147483647 |
— |
| 9.3 | -1 ms |
ms |
会话（超级用户） |
整数 |
-1 |
2147483647 |
— |
| 9.4 | -1 ms |
ms |
会话（超级用户） |
整数 |
-1 |
2147483647 |
— |
| 9.5 | -1 ms |
ms |
会话（超级用户） |
整数 |
-1 |
2147483647 |
— |
| 9.6 | -1 ms |
ms |
会话（超级用户） |
整数 |
-1 |
2147483647 |
— |
| 10 | -1 ms |
ms |
会话（超级用户） |
整数 |
-1 |
2147483647 |
— |
| 11 | -1 ms |
ms |
会话（超级用户） |
整数 |
-1 |
2147483647 |
— |
| 12 | -1 ms |
ms |
会话（超级用户） |
整数 |
-1 |
2147483647 |
— |
| 13 | -1 ms |
ms |
会话（超级用户） |
整数 |
-1 |
2147483647 |
— |
| 14 | -1 ms |
ms |
会话（超级用户） |
整数 |
-1 |
2147483647 |
— |
| 15 | -1 ms |
ms |
会话（超级用户） |
整数 |
-1 |
2147483647 |
— |
| 16 | -1 ms |
ms |
会话（超级用户） |
整数 |
-1 |
2147483647 |
— |
| 17 | -1 ms |
ms |
会话（超级用户） |
整数 |
-1 |
2147483647 |
— |
| 18 | -1 ms |
ms |
会话（超级用户） |
整数 |
-1 |
2147483647 |
— |
| 19 | -1 ms |
ms |
会话（超级用户） |
整数 |
-1 |
2147483647 |
— |
| 20 沿用 | -1 ms |
ms |
会话（超级用户） |
整数 |
-1 |
2147483647 |
— |
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| 何时记录 7 | |||||
log_min_duration_sample |
整数 | 会话（超级用户） | -1 ms |
— | |
| 设置进入语句抽样记录所需达到的最短执行时间，抽样由 log_statement_sample_rate 决定。 | 现存 | ||||
log_min_duration_statement |
整数 | 会话（超级用户） | -1 ms |
9.11 次 | |
| 记录运行时间达到配置阈值的已完成语句。 | 现存 | ||||
log_min_error_statement |
枚举 | 会话（超级用户） | error |
— | |
| 记录所有产生不低于指定级别错误的语句。 | 现存 | ||||
log_min_messages |
枚举 | 会话（超级用户） | warning |
191 次 | |
| 设置写入服务器日志的消息级别。 | 现存 | ||||
log_startup_progress_interval |
整数 | 重载生效 | 10 s |
— | |
| 设置耗时启动操作的进度日志间隔。 | 现存 | ||||
log_statement_sample_rate |
浮点 | 会话（超级用户） | 1 |
— | |
| 设置超过 log_min_duration_sample 的语句被记录的比例。 | 现存 | ||||
log_transaction_sample_rate |
浮点 | 会话（超级用户） | 0 |
— | |
| 设置抽取整笔事务并记录其中所有语句的比例。 | 现存 | ||||