CONFIGURATION PARAMETER错误报告和日志 / 记录什么

log_line_prefix

这是一个 printf 风格的字符串，它在发送到 stderr、syslog 或 eventlog 的每条日志条目的开头输出。

Controls information prefixed to each log line.

字符串重载生效引入 8.0 现存至 20 devel 1 次默认值变更

类型: 字符串string
上下文: 重载生效改配置文件后重载（pg_ctl reload / SIGHUP）即可生效
默认值: %m [%p]
分类: 错误报告和日志 / 记录什么
引入版本: 8.0
状态: 现存

PostgreSQL 18.7 手册官方文档

版本轨迹

相对 PostgreSQL 17 仅简述或分类有更新。

默认值变迁

空字符串 9.0 – 9.6 %m [%p] 10 – 19

默认值一共换过 2 档，每段的宽度按它覆盖的大版本数伸展，深色的一段是当前查看的 PostgreSQL 18.7。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。

手册说明

PostgreSQL 18.7 手册 · 19.8 错误报告和日志本站手册官方原文

这是一个 printf 风格的字符串，它在每个发送到 stderr、syslog 或 eventlog 的日志条目开头输出。% 字符开始“转义序列”，它将按下文描述被替换为状态信息。未识别的转义被忽略。其他字符被直接复制到日志行。某些转义只被会话进程识别并且被主服务器进程等后台进程当作空。通过指定一个在% 之后和该选项之前的数字可以让状态信息左对齐或右对齐。负值将导致在右边用空格填充状态信息以达到最小宽度，而正值则在左边填充。填充对于日志文件的人类可读性大有帮助。

这个参数只能在 postgresql.conf 文件中或在服务器命令行上设置。默认值是'%m [%p] '，它记录时间戳和进程 ID。

转义	效果	只限会话
`%a`	应用名	是
`%u`	用户名	是
`%d`	数据库名	是
`%r`	远程主机名或 IP 地址，以及远程端口	是
`%h`	远程主机名或 IP 地址	是
`%L`	本地地址（客户端所连接的服务器 IP 地址）	是
`%b`	后端类型	否
`%p`	进程 ID	否
`%P`	如果该进程是并行查询工作进程，则为并行组领导者的进程 ID	否
`%t`	无毫秒的时间戳	否
`%m`	带毫秒的时间戳	否
`%n`	带毫秒精度的 Unix 时间戳	否
`%i`	命令标签：会话当前命令的类型	是
`%e`	SQLSTATE 错误代码	否
`%c`	会话 ID：见下文	否
`%l`	对每个会话或进程的日志行号，从 1 开始	否
`%s`	进程开始的时间戳	否
`%v`	虚拟事务 ID（procNumber/localXID）；参见第 67.1 节	否
`%x`	事务 ID（如果未分配则为 0）；参见第 67.1 节	否
`%q`	不产生输出，但是告诉非会话进程在字符串的这一点停止；会话进程忽略	否
`%Q`	当前查询的查询标识符。查询标识符默认是不计算的，所以该字段将为零，除非 compute_query_id 参数被激活或者配置了计算查询标识符的第三方模块	是
`%%`	字面字符 `%`	否

后端类型对应视图 pg_stat_activity 中的 backend_type 列。但是其他类型可能会出现在日志中而不显示在该视图中。

%c 转义打印一个准唯一的会话标识符，它由两个 4 字节的十六进制数（不带先导零）组成，以点号分隔。这些数字是进程启动时间和进程 ID，因此 %c 也可以用来节省空间地输出这两项信息。例如，要从 pg_stat_activity 生成会话标识符，使用这个查询：

SELECT to_hex(trunc(EXTRACT(EPOCH FROM backend_start))::integer) || '.' ||
       to_hex(pid)
FROM pg_stat_activity;

提示

如果你为 log_line_prefix 设置了非空值，你通常应该让它的最后一个字符为空格，这样可与日志行的其余部分在视觉上区分开。也可以使用标点符号。

提示

Syslog 产生自己的时间戳和进程 ID 信息，因此如果你记录到 syslog 你可能不希望包括那些转义。

提示

在包括仅在会话（后端）上下文中可用的信息（如用户名或者数据库名）时，%q 转义很有用。例如：

log_line_prefix = '%m [%p] %q%u@%d/%a '

注意

对于 log_statement 输出的行，%Q 总是报告零标识符，因为 log_statement 在标识符能被计算之前生成输出，也包括无法计算标识符的无效语句。

机制详解

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

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

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

调优建议

按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。

OLTP在线事务处理

围绕明确的可观测性问题和实测日志容量预算调节 log_line_prefix；优先使用选择性阈值、抽样或角色级覆盖，而非无差别采集。
OLAP分析与批处理

分析作业可以需要更丰富的 log_line_prefix 遥测，但应把长语句、大绑定值与集中完成造成的日志突发计入管线容量。
小规格低配实例与开发机

让 log_line_prefix 保持有用且有界：提高详细度或频率前，先验证磁盘、收集器、保留与脱敏能力。

常见问题

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

演化历史

相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。

PostgreSQL 18 ← 17 仅描述更新

补充说明 If blank, no prefix is used. An empty string means no prefix.
PostgreSQL 10 ← 9.6 默认值变更

默认值 空字符串 %m [%p]
PostgreSQL 8.0 ← 7.4 新增此参数

PostgreSQL 8.0 起可用

逐版本快照

每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。

版本	默认值	单位	上下文	类型	最小值	最大值	枚举值
8.0	—	—	—	`字符串`	—	—	—
8.1	—	—	—	`字符串`	—	—	—
8.2	—	—	—	`字符串`	—	—	—
8.3	—	—	—	`字符串`	—	—	—
8.4	—	—	—	`字符串`	—	—	—
9.0	`空字符串`	`—`	`重载生效`	`字符串`	`—`	`—`	`—`
9.1	`空字符串`	`—`	`重载生效`	`字符串`	`—`	`—`	`—`
9.2	`空字符串`	`—`	`重载生效`	`字符串`	`—`	`—`	`—`
9.3	`空字符串`	`—`	`重载生效`	`字符串`	`—`	`—`	`—`
9.4	`空字符串`	`—`	`重载生效`	`字符串`	`—`	`—`	`—`
9.5	`空字符串`	`—`	`重载生效`	`字符串`	`—`	`—`	`—`
9.6	`空字符串`	`—`	`重载生效`	`字符串`	`—`	`—`	`—`
10	`%m [%p]`	`—`	`重载生效`	`字符串`	`—`	`—`	`—`
11	`%m [%p]`	`—`	`重载生效`	`字符串`	`—`	`—`	`—`
12	`%m [%p]`	`—`	`重载生效`	`字符串`	`—`	`—`	`—`
13	`%m [%p]`	`—`	`重载生效`	`字符串`	`—`	`—`	`—`
14	`%m [%p]`	`—`	`重载生效`	`字符串`	`—`	`—`	`—`
15	`%m [%p]`	`—`	`重载生效`	`字符串`	`—`	`—`	`—`
16	`%m [%p]`	`—`	`重载生效`	`字符串`	`—`	`—`	`—`
17	`%m [%p]`	`—`	`重载生效`	`字符串`	`—`	`—`	`—`
18	`%m [%p]`	`—`	`重载生效`	`字符串`	`—`	`—`	`—`
19	`%m [%p]`	`—`	`重载生效`	`字符串`	`—`	`—`	`—`
20	—	—	—	`字符串`	—	—	—

参考资料

同类参数

参数	类型	上下文	默认值	最近变更
Reporting and Logging 错误报告和日志 25 个 ↗
记录什么 25
`application_name`	字符串	会话	`空字符串`	—
application_name 可以是任意小于 NAMEDATALEN 个字符（标准编译中是 64 个字符）的字符串。				现存
`debug_pretty_print`	布尔	会话	`on`	—
当被设置时，debug_pretty_print 会缩进由 debug_print_raw_parse、debug_print_parse、debug_print_rewritten 或 debug_print_plan 产生的输出。				现存
`debug_print_parse`	布尔	会话	`off`	—
这些参数会启用多种调试输出。				现存
`debug_print_plan`	布尔	会话	`off`	—
这些参数会启用多种调试输出。				现存
`debug_print_raw_parse`	布尔		—	—
这些参数会启用多种调试输出。				现存
`debug_print_rewritten`	布尔	会话	`off`	—
这些参数会启用多种调试输出。				现存
`log_autoanalyze_min_duration`	整数		—	—
当自动清理执行的分析操作运行时间至少达到指定时间时，就会记录该操作。				现存
`log_autovacuum_min_duration`	整数	重载生效	`10 min`	152 次
当自动清理执行的清理操作运行时间至少达到指定时间时，就会记录该操作。				现存
`log_checkpoints`	布尔	重载生效	`on`	151 次
导致检查点和重启点在服务器日志中记录。				现存
`log_connections`	字符串	连接时（超级用户）	`空字符串`	182 次
控制是否记录到服务器的每次连接的相关信息。				现存
`log_disconnections`	布尔	连接时（超级用户）	`off`	9.51 次
导致会话终止被记录。				现存
`log_duration`	布尔	会话（超级用户）	`off`	—
记录每个已完成语句的持续时间。				现存
`log_error_verbosity`	枚举	会话（超级用户）	`default`	8.41 次
控制在服务器日志中记录的每条消息的详细程度。				现存
`log_hostname`	布尔	重载生效	`off`	—
默认情况下，连接日志消息只显示连接主机的 IP 地址。				现存
`log_line_prefix`	字符串	重载生效	`%m [%p]`	101 次
这是一个 printf 风格的字符串，它在发送到 stderr、syslog 或 eventlog 的每条日志条目的开头输出。				现存
`log_lock_failures`	布尔	会话（超级用户）	`off`	—
控制当获取锁失败时是否生成详细日志消息。				现存
`log_lock_waits`	布尔	会话（超级用户）	`off`	191 次
控制会话为获取锁而等待的时间超过 deadlock_timeout 时是否生成日志消息。				现存
`log_parameter_max_length`	整数	会话（超级用户）	`-1 B`	—
如果大于零，则记录在非错误语句日志消息中的每个绑定参数值都会被截断为指定的字节数。				现存
`log_parameter_max_length_on_error`	整数	会话	`0 B`	—
如果大于零，则错误消息中报告的每个绑定参数值都将裁剪为这么多字节。				现存
`log_recovery_conflict_waits`	布尔	重载生效	`off`	—
控制启动进程因恢复冲突而等待超过 deadlock_timeout 时是否产生日志消息。				现存
`log_replication_commands`	布尔	会话（超级用户）	`off`	—
在服务器日志中记录每个复制命令，以及 walsender 进程获取和释放复制槽的操作。				现存
`log_statement`	枚举	会话（超级用户）	`none`	8.42 次
控制哪些 SQL 语句被记录。				现存
`log_statement_max_length`	整数		—	—
如果大于零，通过 log_statement、log_min_duration_statement、log_min_duration_sample 或 log_transaction_sample_rate 记录的每条语句，其文本都会被截断为最多这么多字节。				现存
`log_temp_files`	整数	会话（超级用户）	`-1 kB`	—
控制临时文件名和大小的日志记录。				现存
`log_timezone`	字符串	重载生效	`GMT`	9.22 次
设置在服务器日志中写入的时间戳的时区。				现存