目录

log_connections

一个决定是否记录连接的服务器参数

log_connections 是一个 配置参数，用于确定是否记录连接。

log_connections 添加于 PostgreSQL 7.1。

默认值

log_connections 的默认值为

用法

默认情况下，PostgreSQL 只记录连接失败时产生的错误。

PostgreSQL 18 及更高版本

log_connections 可以包含一个逗号分隔的列表，指定要记录的与连接建立相关的信息类型

  • receipt
  • authentication
  • authorization
  • setup_durations
  • all

PostgreSQL 17 及更早版本

如果将 log_connections 设置为 on，则会记录成功和失败连接的详细信息。

按 PostgreSQL 版本详细信息

log_connections (PostgreSQL 19)

设置
单位  
类别 报告和日志记录 / 记录什么
简短描述 记录连接建立和设置的指定方面。
扩展描述  
上下文 superuser-backend
变量类型 string
来源 默认
最小值  
最大值  
枚举值  
启动值
重置值
源文件  
源行  
需要重启 false

文档：log_connections

log_connections (PostgreSQL 18)

设置
单位  
类别 报告和日志记录 / 记录什么
简短描述 记录连接建立和设置的指定方面。
扩展描述  
上下文 superuser-backend
变量类型 string
来源 默认
最小值  
最大值  
枚举值  
启动值
重置值
源文件  
源行  
需要重启 false

文档：log_connections

log_connections (PostgreSQL 17)

设置 off
单位  
类别 报告和日志记录 / 记录什么
简短描述 记录每次成功的连接。
扩展描述  
上下文 superuser-backend
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  
需要重启 false

文档：log_connections

log_connections (PostgreSQL 16)

设置 off
单位  
类别 报告和日志记录 / 记录什么
简短描述 记录每次成功的连接。
扩展描述  
上下文 superuser-backend
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  
需要重启 false

文档：log_connections

log_connections (PostgreSQL 15)

设置 off
单位  
类别 报告和日志记录 / 记录什么
简短描述 记录每次成功的连接。
扩展描述  
上下文 superuser-backend
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  
需要重启 false

文档：log_connections

log_connections (PostgreSQL 14)

设置 off
单位  
类别 报告和日志记录 / 记录什么
简短描述 记录每次成功的连接。
扩展描述  
上下文 superuser-backend
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  
需要重启 false

文档：log_connections

log_connections (PostgreSQL 13)

设置 off
单位  
类别 报告和日志记录 / 记录什么
简短描述 记录每次成功的连接。
扩展描述  
上下文 superuser-backend
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  
需要重启 false

文档：log_connections

log_connections (PostgreSQL 12)

设置 off
单位  
类别 报告和日志记录 / 记录什么
简短描述 记录每次成功的连接。
扩展描述  
上下文 superuser-backend
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  
需要重启 false

文档：log_connections

log_connections (PostgreSQL 11)

设置 off
单位  
类别 报告和日志记录 / 记录什么
简短描述 记录每次成功的连接。
扩展描述  
上下文 superuser-backend
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  
需要重启 false

文档：log_connections

log_connections (PostgreSQL 10)

设置 off
单位  
类别 报告和日志记录 / 记录什么
简短描述 记录每次成功的连接。
扩展描述  
上下文 superuser-backend
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  
需要重启 false

文档：log_connections

log_connections (PostgreSQL 9.6)

设置 off
单位  
类别 报告和日志记录 / 记录什么
简短描述 记录每次成功的连接。
扩展描述  
上下文 superuser-backend
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  
需要重启 false

文档：log_connections

log_connections (PostgreSQL 9.5)

设置 off
单位  
类别 报告和日志记录 / 记录什么
简短描述 记录每次成功的连接。
扩展描述  
上下文 superuser-backend
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  
需要重启 false

文档：log_connections

log_connections (PostgreSQL 9.4)

设置 off
单位  
类别 报告和日志记录 / 记录什么
简短描述 记录每次成功的连接。
扩展描述  
上下文 backend
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  

文档：log_connections

log_connections (PostgreSQL 9.3)

设置 off
单位  
类别 报告和日志记录 / 记录什么
简短描述 记录每次成功的连接。
扩展描述  
上下文 backend
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  

文档：log_connections

log_connections (PostgreSQL 9.2)

设置 off
单位  
类别 报告和日志记录 / 记录什么
简短描述 记录每次成功的连接。
扩展描述  
上下文 backend
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  

文档：log_connections

log_connections (PostgreSQL 9.1)

设置 off
单位  
类别 报告和日志记录 / 记录什么
简短描述 记录每次成功的连接。
扩展描述  
上下文 backend
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  

文档：log_connections

log_connections (PostgreSQL 9.0)

设置 off
单位  
类别 报告和日志记录 / 记录什么
简短描述 记录每次成功的连接。
扩展描述  
上下文 backend
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  

文档：log_connections

log_connections (PostgreSQL 8.4)

设置 off
单位  
类别 报告和日志记录 / 记录什么
简短描述 记录每次成功的连接。
扩展描述  
上下文 backend
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  

文档：log_connections

log_connections (PostgreSQL 8.3)

设置  
单位  
类别 报告和日志记录 / 记录什么
简短描述 记录每次成功的连接。
扩展描述  
上下文 backend
变量类型 bool
来源 默认
最小值  
最大值  

文档：log_connections

log_connections (PostgreSQL 8.2)

设置  
单位  
类别 报告和日志记录 / 记录什么
简短描述 记录每次成功的连接。
扩展描述  
上下文 backend
变量类型 bool
来源 默认
最小值  
最大值  

文档：log_connections

变更历史

示例

当 log_connections 为 on 时，成功连接的日志输出示例（PostgreSQL 13 及更早版本）

[2020-12-07 12:54:20 CET 192.168.1.2 [unknown]/[unknown] ] LOG:  connection received: host=192.168.1.2 port=56974
[2020-12-07 12:54:20 CET 192.168.1.2 postgres/postgres authentication] LOG:  connection authorized: user=postgres database=postgres application_name=psql

在 PostgreSQL 14 及更高版本中，将添加一行包含已认证身份详细信息的日志（除非连接是通过 trust 认证）

[2021-04-06 20:15:24 UTC] [unknown] [unknown] [unknown] LOG:  00000: connection received: host=::1 port=59774
[2021-04-06 20:15:24 UTC] [unknown] dbuser appsdb LOG:  00000: connection authenticated: identity="dbuser" method=md5 (/var/lib/postgres/data/pg_hba.conf:12)
[2021-04-06 20:15:24 UTC] [unknown] dbuser appsdb LOG:  00000: connection authorized: user=dbuser database=appsdb application_name=psql

当 log_connections 为 off 时，连接失败的日志输出示例

[2020-12-07 13:38:22 CET 192.168.1.2 postgres/postgree startup] FATAL:  database "postgree" does not exist

当 log_connections 为 on 时，连接失败的日志输出示例

[2020-12-07 13:39:10 CET 192.168.1.2 [unknown]/[unknown] ] LOG:  connection received: host=192.168.1.2 port=59480
[2020-12-07 13:39:10 CET 192.168.1.2 postgres/postgree authentication] LOG:  connection authorized: user=postgres database=postgree application_name=psql
[2020-12-07 13:39:10 CET 192.168.1.2 postgres/postgree startup] FATAL:  database "postgree" does not exist

分类

GUC 配置项, 日志记录

另请参阅

log_disconnections

反馈

提交有关“log_connections”的任何评论、建议或更正，请在此处 提交。