PostgreSQL在Ubuntu上的日志管理指南

一、日志配置基础

PostgreSQL在Ubuntu上的日志配置主要通过postgresql.conf文件实现，该文件通常位于/etc/postgresql/< 版本号> /main/目录下（如/etc/postgresql/14/main/postgresql.conf）。以下是关键配置参数及说明：

• logging_collector：是否启用日志收集器（默认off），设为on可捕获stderr和csvlog输出，生成结构化日志文件。
• log_directory：日志存储目录（默认pg_log，相对于$PGDATA），可设置为绝对路径（如/var/log/postgresql/pg_log）。
• log_filename：日志文件命名格式（支持时间戳变量），常用postgresql-%Y-%m-%d_%H%M%S.log（按日期和时间生成唯一文件）。
• log_statement：记录的SQL语句类型，可选none（不记录）、ddl（仅数据定义语句，如CREATE/ALTER/DROP）、mod（DDL+数据修改语句，如INSERT/UPDATE/DELETE）、all（所有语句，生产环境慎用）。
• log_min_duration_statement：记录执行时间超过指定毫秒数的SQL语句（如1000表示记录超过1秒的查询），用于慢查询排查。
• log_rotation_age：日志文件切割周期（如1d表示每天生成新文件），避免单个文件过大。
• log_rotation_size：日志文件大小阈值（如100MB），达到后自动切割。

二、配置步骤

1. 修改配置文件：使用文本编辑器（如vim）打开postgresql.conf，调整上述参数。例如：

   sudo vim /etc/postgresql/14/main/postgresql.conf
   

   添加/修改以下内容：

   logging_collector = on
   log_directory = 'pg_log'
   log_filename = 'postgresql-%Y-%m-%d_%H%M%S.log'
   log_statement = 'mod'
   log_min_duration_statement = 1000  # 记录慢查询（超过1秒）
   log_rotation_age = 1d
   log_rotation_size = 100MB
   

2. 重启PostgreSQL服务：修改配置后，需重启服务使更改生效：

   sudo systemctl restart postgresql
   

3. 验证配置：通过psql命令行工具查看参数是否生效：

   sudo -u postgres psql
   SHOW logging_collector;
         -- 应返回'on'
   SHOW log_directory;
             -- 应返回配置的目录路径
   \q
   

三、日志查看与管理

1. 查看日志文件位置：Ubuntu下PostgreSQL日志默认存储在/var/log/postgresql/目录下，文件名格式为postgresql-< 版本号> -main.log（如postgresql-14-main.log）：

   ls /var/log/postgresql/
   

2. 查看最新日志：使用tail命令查看日志文件末尾内容（如最后100行）：

   sudo tail -n 100 /var/log/postgresql/postgresql-14-main.log
   

3. 实时监控日志：使用tail -f命令实时输出日志新增内容（按Ctrl+C停止）：

   sudo tail -f /var/log/postgresql/postgresql-14-main.log
   

4. 搜索特定日志：使用grep命令过滤关键词（如“error”表示错误日志）：

   sudo grep "error" /var/log/postgresql/postgresql-14-main.log
   

四、日志轮转配置

为防止日志文件无限增长，需通过log_rotation_age和log_rotation_size参数控制切割周期和大小（已在配置步骤中说明）。Ubuntu系统还会自动调用logrotate工具管理PostgreSQL日志（默认配置位于/etc/logrotate.d/postgresql-common），无需额外设置。

五、日志分析工具（pgBadger）

pgBadger是一款强大的PostgreSQL日志分析工具，可生成HTML格式的详细报告（包含查询频率、执行时间、锁等待等信息）。

1. 安装pgBadger：

   sudo apt-get install pgbadger
   

2. 生成报告：

   pgbadger /var/log/postgresql/postgresql-14-main.log -o report.html
   

3. 查看报告：用浏览器打开report.html，即可直观分析数据库活动（如慢查询、连接统计等）。

注意事项

• 生产环境中，建议将log_statement设为ddl或mod，避免all对性能造成影响。
• 日志文件需定期清理（如通过cron定时任务删除7天前的日志），释放磁盘空间。
• 若日志中包含中文乱码，可修改postgresql.conf中的lc_messages参数为UTF8：

  lc_messages = 'UTF8'
  

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！