log_connections

英文手册覆盖始于 PostgreSQL 7.4. 来源历史与运行验证各自保留独立版本边界。

当前阅读 PG 18·选择有来源记录的版本

版本定义 PG 18

控制是否记录到服务器的每次连接的相关信息。默认值为空字符串 ''，表示禁用所有连接日志。下列选项既可以单独指定，也可以用逗号分隔的列表指定：

表 19.3. 连接日志选项

名字	描述
`receipt`	记录收到连接。
`authentication`	记录认证方法用于识别用户的原始身份。在大多数情况下，该身份字符串与PostgreSQL用户名一致，但某些第三方认证方法可能会在服务器存储之前修改原始用户标识符。无论此设置为何值，认证失败始终都会被记录。
`authorization`	记录授权成功完成。此时连接已经建立，但后端尚未完全初始化。日志消息会包含授权后的用户名，以及数据库名和应用名（如果适用）。
`setup_durations`	记录从 postmaster 接受传入连接开始，到连接准备好执行第一条查询为止，建立连接并完成后端初始化所花费的时间。日志消息会包含三个时长：总设置时长、fork 新后端所花费的时间，以及用户认证所花费的时间。
`all`	一个便捷别名，相当于指定所有选项。如果在其他选项列表中包含`all`，则会记录连接的所有方面。

断开连接的日志由log_disconnections单独控制。

出于向后兼容性考虑，on、off、true、false、yes、no、1和0仍然受支持。表示启用的值等价于指定receipt、authentication和 authorization选项。

只有超级用户和具有适当SET权限的用户可以在会话开始时更改此参数，并且在会话内部完全不能更改。

注意

某些客户端程序（例如psql）在判断是否需要密码时会尝试连接两次，因此重复的“收到连接”消息并不一定表示一个错误。

定义来源

center · PostgreSQL 18 · english-manuals:d1aa1205ab03836060f589eb1cc56b51412a4c5aa3f8d189883e627ac43730a8

正文语言: zh-Hans · 2026-09-11@29c86d9