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 的影响。
按自己的节奏,确认真正理解。