Ubuntu上MongoDB日志管理指南

一、日志配置基础

1. 配置文件位置

Ubuntu系统中，MongoDB的主配置文件默认位于/etc/mongod.conf，所有日志相关的设置均在此文件中完成。

2. 关键配置项说明

在/etc/mongod.conf中，systemLog部分是日志管理的核心配置，主要参数如下：

• destination：日志输出目标，设为file表示输出到文件（默认），stderr表示输出到标准错误；
• path：日志文件路径，建议设置为/var/log/mongodb/mongod.log（需确保目录存在且MongoDB用户有写入权限）；
• logAppend：是否追加日志，默认true（避免重启服务时覆盖旧日志）；
• verbosity：日志详细程度，取值范围0-5（0=仅致命错误，1=错误+一般信息，2=包含慢查询，3=调试信息，4=更详细调试，5=最大详细程度）；
• logRotate：日志轮转策略，设为reopen（配合logrotate工具使用时推荐）。

二、日志轮转设置

为防止日志文件过大占用磁盘空间，需通过logrotate工具实现自动轮转。步骤如下：

1. 安装logrotate（若未安装）

sudo apt-get install logrotate

2. 创建MongoDB专用轮转配置

新建或编辑/etc/logrotate.d/mongodb文件，添加以下内容：

/var/log/mongodb/mongod.log {
    daily                # 每天轮转一次
    missingok            # 日志文件丢失时不报错
    rotate 7             # 保留最近7个轮转文件
    compress             # 压缩旧日志（节省空间）
    delaycompress        # 延迟压缩（避免立即压缩影响性能）
    notifempty           # 日志为空时不轮转
    create 0640 mongodb mongodb  # 新日志文件权限及属主（需与MongoDB运行用户一致）
    sharedscripts        # 多个日志文件共享同一个postrotate脚本
    postrotate           # 轮转后执行的命令（通知MongoDB重新打开日志文件）
        /bin/kill -SIGUSR1 $(cat /var/lib/mongodb/mongod.lock 2>/dev/null) 2>/dev/null || true
    endscript
}

注：/var/lib/mongodb/mongod.lock是MongoDB的锁文件路径，用于获取进程ID；若路径不同，需根据实际情况调整。

3. 测试轮转配置

手动触发轮转以验证配置是否正确：

sudo logrotate -vf /etc/logrotate.d/mongodb

三、日志查看与分析

1. 命令行查看

• 实时追踪日志：使用tail -f命令实时查看最新日志内容；

  sudo tail -f /var/log/mongodb/mongod.log
  

• 搜索特定关键词：使用grep命令过滤日志（如查找“error”相关日志）；

  sudo grep -i "error" /var/log/mongodb/mongod.log
  

• 查看日志文件大小：使用du命令监控日志文件占用空间；

  sudo du -sh /var/log/mongodb/mongod.log*
  

2. MongoDB Shell操作

• 获取当前日志组件配置：通过getLogComponents命令查看各组件的日志级别；

  mongo --eval 'db.getLogComponents()'
  

• 修改日志级别：使用setLogLevel命令动态调整指定组件的日志详细程度（如将“query”组件的日志级别设为2）；

  mongo --eval 'db.setLogLevel(2, "query")'
  

• 获取所有日志条目：通过adminCommand命令导出所有日志；

  mongo --eval 'db.adminCommand({getLog: 1})'
  

3. 图形化工具

• MongoDB Compass：官方图形化管理工具，支持日志可视化分析（如过滤、排序、统计）；
• 第三方工具：如ELK Stack（Elasticsearch+Logstash+Kibana）可用于集中收集、解析和展示日志，适合大规模集群环境。

四、日志清理与维护

1. 自动清理旧日志

通过logrotate的rotate参数控制保留的日志文件数量（如rotate 7保留7天），超出数量的旧日志会自动删除。

2. 手动删除过期日志

若需立即清理，可直接删除旧日志文件（注意：删除前确保日志已轮转）：

sudo rm /var/log/mongodb/mongod.log.1.gz  # 删除压缩的旧日志
sudo rm /var/log/mongodb/mongod.log      # 删除当前日志（需重启MongoDB重新生成）
sudo systemctl restart mongod

3. 日志备份

重要日志可通过cp命令备份到其他存储介质（如外接硬盘、云存储）：

sudo cp /var/log/mongodb/mongod.log /mnt/backup/mongodb_logs_$(date +%F).log

五、常见问题排查

1. 日志不生成

• 检查配置文件中的path路径是否存在，且MongoDB用户（通常为mongodb）是否有写入权限；

  sudo mkdir -p /var/log/mongodb
  sudo chown mongodb:mongodb /var/log/mongodb
  

• 检查logAppend是否设为true（避免重启时覆盖日志）。

2. 日志级别过高/过低

• 若日志过于冗长（如包含大量调试信息），可将verbosity调低（如设为1）；
• 若需更多调试信息（如排查性能问题），可将verbosity调高（如设为3）。

3. 日志轮转失败

• 检查logrotate配置中的postrotate脚本是否正确（需获取MongoDB进程ID并发送SIGUSR1信号）；
• 手动执行postrotate脚本测试是否正常：

  /bin/kill -SIGUSR1 $(cat /var/lib/mongodb/mongod.lock 2>/dev/null) 2>/dev/null || true