PostgreSQL / 系统课时

配置与查看数据库日志

配置与查看数据库日志

本课解决 PostgreSQL 出现连接失败、慢 SQL 或后台错误时缺少证据的问题。你将检查当前日志配置,启用基础审计信息,并掌握修改后何时重载、何时必须重启。

学习目标

  • 查看日志收集方式、目录和文件名规则
  • 配置连接日志与慢 SQL 阈值
  • 根据参数上下文选择重载或重启

先检查当前配置

日志是否写入文件取决于 logging_collector 和 log_destination。log_directory 可以是相对数据目录的路径,也可以是绝对路径;实际文件名由 log_filename 决定。

sql
SHOW logging_collector;
SHOW log_destination;
SHOW log_directory;
SHOW log_filename;
SHOW log_connections;
SHOW log_disconnections;
SHOW log_min_duration_statement;

预期结果

text
每条 SHOW 返回一个当前值。
路径、文件名格式和开关状态取决于服务器配置,实际结果可能不同。

配置基础日志

以下命令需要具备修改系统参数的权限。它会记录连接建立、连接断开,以及执行时间达到 500 毫秒的语句。

sql
ALTER SYSTEM SET log_connections = 'on';
ALTER SYSTEM SET log_disconnections = 'on';
ALTER SYSTEM SET log_min_duration_statement = '500ms';

SELECT pg_reload_conf();

SHOW log_connections;
SHOW log_disconnections;
SHOW log_min_duration_statement;

预期结果

text
ALTER SYSTEM
ALTER SYSTEM
ALTER SYSTEM
 pg_reload_conf
----------------
 t

后续 SHOW 应分别返回 on、on 和 500ms。

ALTER SYSTEM 会写入自动配置文件。上述三个参数支持重新加载,不需要重启。若修改 logging_collector,则必须重启 PostgreSQL 才能生效,可通过 pg_settings.context 判断参数属于重载级还是重启级。

定位日志文件

当日志收集器开启时,可查询当前正在使用的日志文件。返回路径通常相对于数据目录。

sql
SELECT pg_current_logfile();

SELECT
  name,
  setting,
  context,
  pending_restart
FROM pg_settings
WHERE name IN (
  'logging_collector',
  'log_destination',
  'log_directory',
  'log_filename',
  'log_min_duration_statement'
)
ORDER BY name;

预期结果

text
pg_current_logfile 返回当前日志文件路径;若日志收集器未启用,可能返回 NULL。
pending_restart 为 true 表示参数已修改但仍需重启。

日志定位顺序

连接问题先看认证失败、客户端地址和数据库名;慢 SQL 先看执行时长和语句文本,再结合 EXPLAIN 分析;系统错误则关注 ERROR、FATAL、PANIC 及其前后文。

日志应配合轮转和保留策略,避免无限增长。生产环境还应控制语句记录范围,防止敏感参数进入日志,并评估高日志量对磁盘 I/O 的影响。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置与查看数据库日志

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通