log_line_prefix

手册说明

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

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

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

机制详解

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 文本、绑定值、身份或主机数据，却没有脱敏与访问控制策略。
• 遗漏关联多行文本日志所需的进程、会话、数据库、用户或应用身份。

演化历史

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

1. PostgreSQL 20 ← 19 沿用 19

   事实沿用 19

2. PostgreSQL 18 ← 17 仅描述更新

   补充说明 If blank, no prefix is used. → An empty string means no prefix.

3. PostgreSQL 10 ← 9.6 默认值变更

   默认值 空字符串 → %m [%p]

逐版本快照

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

关联参数

application_namecluster_nameupdate_process_titlelog_timezonelog_hostname

参考资料

• PostgreSQL 19 Beta 3：log_line_prefix
• PostgreSQL 19 发行说明

同类参数