log_connections

手册说明

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

机制详解

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 单独控制；连接身份与拓扑仍属于敏感日志数据。

调优建议

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

• OLTP在线事务处理

  常规 OLTP 只记录审计或延迟问题真正需要的阶段；authorization 以较低日志量保留成功连接轨迹，receipt 与 authentication 增加授权前证据。只有排查连接启动延迟时才加入 setup_durations。

• OLAP分析与批处理

  分析会话更少但更长，authorization 加 setup_durations 可用于归因昂贵的连接初始化；不要仅因查询量较低就使用 all。

• 小规格低配实例与开发机

  列表保持最小，并继续监控不受本参数影响的认证失败。确认日志存储与脱敏能够安全保留原始身份和应用名称。

常见问题

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

演化历史

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

1. PostgreSQL 20 ← 19 沿用 19

   事实沿用 19

2. PostgreSQL 18 ← 17 默认值变更

   默认值 off → 空字符串 类型 布尔 → 字符串 简述 Logs each successful connection. → Logs specified aspects of connection establishment and setup.

3. PostgreSQL 9.5 ← 9.4 属性变更

   上下文 连接时 → 连接时（超级用户）

逐版本快照

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

关联参数

log_statementlog_durationlog_disconnectionslog_parameter_max_lengthlog_parameter_max_length_on_error

参考资料

• PostgreSQL 19 Beta 4：log_connections
• PostgreSQL 19 发行说明

同类参数