Debian系统中MongoDB日志管理

Debian 上 MongoDB 日志管理实操指南

一 配置文件与日志路径

• 配置文件默认路径：/etc/mongod.conf。常用日志相关参数：
  • systemLog.destination：输出目标，可选 file、syslog、console。
  • systemLog.path：当 destination 为 file 时生效，常见路径 /var/log/mongodb/mongod.log。
  • systemLog.logAppend：是否追加写入，建议设为 true。
  • systemLog.verbosity：全局日志详细度，范围 0–5，数值越大越详细。
• 示例片段：

  systemLog:
    destination: file
    path: /var/log/mongodb/mongod.log
    logAppend: true
    verbosity: 1
  

• 修改配置后，使用以下命令使配置生效（注意数据安全与可用性）：

  sudo systemctl restart mongod
  

  以上路径、参数与生效方式均为 Debian 上常见做法。

二 查看与动态调节日志级别

• 查看日志文件：
  • 列出日志目录：

    ls /var/log/mongodb/
    

  • 实时查看最新日志：

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

• 在 Mongo Shell 中查看与调整日志：
  • 查看各组件日志级别：

    db.getLogComponents()
    

  • 设置全局或组件日志级别（例如将全局设为 1）：

    db.setLogLevel(1, "global")
    

  • 获取某组件的日志内容（例如 query 组件）：

    db.adminCommand({ getLog: "query" })
    

  以上命令适用于日常的日志排查与临时提升日志细粒度。

三 日志轮转方案

• 方式一 MongoDB 内置命令轮转（推荐，零停机）
  • 在 Mongo Shell 执行：

    use admin
    db.runCommand({ logRotate: 1 })
    

  • 适合临时轮转或无法使用外部轮转工具的场景。
• 方式二 使用 logrotate 进行系统级轮转
  • 安装（如未安装）：

    sudo apt-get update
    sudo apt-get install logrotate
    

  • 创建配置文件 /etc/logrotate.d/mongodb，示例一（按大小触发，保留 7 份并压缩）：

    /var/log/mongodb/mongod.log {
      size 500M
      rotate 7
      compress
      missingok
      notifempty
      create 640 mongodb adm
      postrotate
        if [ -f /var/run/mongodb.pid ]; then
          kill -SIGUSR1 $(cat /var/run/mongodb.pid)
        fi
      endscript
    }
    

  • 示例二（按天触发，保留 7 天，配合 copytruncate 避免信号依赖）：

    /var/log/mongodb/mongod.log {
      daily
      rotate 7
      compress
      missingok
      notifempty
      sharedscripts
      copytruncate
      dateext
      size 200M
      postrotate
        /bin/kill -SIGUSR1 $(cat /var/log/mongodb/mongod.lock 2>/dev/null || cat /var/run/mongodb.pid 2>/dev/null)
      endscript
    }
    

  • 测试与生效：

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

  • 说明：
    • 使用 copytruncate 时无需向 mongod 发送信号；否则通过 SIGUSR1 通知 mongod 重新打开日志文件。
    • 不同安装包或版本中，pid/lock 文件路径可能不同，常见有 /var/run/mongodb.pid 与 /var/log/mongodb/mongod.lock，建议按实际环境调整。

四 日志分析与容量监控

• 容量与清理
  • 定期检查日志占用：

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

  • 可结合监控告警，当日志目录或单文件超过阈值时触发轮转或清理。
• 内容分析
  • 若日志为 JSON 格式，可借助 jq 进行快速检索与统计：

    sudo cat /var/log/mongodb/mongod.log | jq '.msg'
    

  • 也可使用第三方分析工具（如 mongo-logging-analyzer）做更深入的查询与性能分析。