Linux MongoDB配置中的日志管理技巧

Linux 上 MongoDB 日志管理实用技巧

一 基础配置与路径

• 建议在配置文件中显式声明日志行为，便于稳定轮转与排查：
  • 将日志写入文件：设置 systemLog.destination: file、systemLog.path（常见路径为 /var/log/mongodb/mongod.log）。
  • 避免重启截断：开启 systemLog.logAppend: true。
  • 降低噪音：仅在必要时使用 systemLog.quiet: true（会显著减少日志量，生产慎用）。
  • 输出到系统日志：将 systemLog.destination: syslog，由 syslog/rsyslog 负责轮转与归档。
• 示例片段：
  • systemLog:
    • destination: file
    • path: /var/log/mongodb/mongod.log
    • logAppend: true
    • quiet: false
  • 如需 syslog：将 destination 改为 syslog 并配置 rsyslog 的日志轮转策略。

二 日志轮转的三种方式

• 内置轮转
  • 触发方式：向进程发送 SIGUSR1，或在 mongosh 执行 db.adminCommand({ logRotate: “server” })；审计日志可用 { logRotate: “audit” }。
  • 行为模式：
    • rename（默认）：MongoDB 将当前日志重命名为带 UTC 时间戳 的新文件，然后新建同名日志继续写入，便于按时间归档。
    • reopen：MongoDB 仅关闭并重新打开同名日志文件，需配合外部先将旧日志重命名（适合与 Linux logrotate 配合）。
• Linux logrotate 配合 reopen
  • 思路：外部按时间/大小重命名日志后，向 mongod 发送 SIGUSR1 触发重新打开。
  • 示例（/etc/logrotate.d/mongodb）：
    • /var/log/mongodb/mongod.log {
      • daily
      • rotate 7
      • compress
      • delaycompress
      • missingok
      • notifempty
      • create 644 mongodb mongodb
      • sharedscripts
      • postrotate
        • /bin/kill -SIGUSR1 $(cat /var/run/mongodb/mongod.pid 2>/dev/null) 2>/dev/null || true
      • endscript
      • }
  • 要点：使用 reopen 模式时不要使用 copytruncate；确保 pid 文件路径正确；副本集需在各实例上分别执行轮转。

三 日志级别与组件化控制

• 全局与组件级别
  • 全局详细程度：db.setLogLevel(level)，范围 0–5（0 默认；1–5 递增调试信息；从 4.2 起日志前缀显示 D1–D5）。
  • 组件级别：db.setLogLevel(level, “component”)，如 “storage.journal”、“query”、“replication” 等，便于定位问题而不放大全局噪音。
  • 查询当前：
    • 组件列表：db.getLogComponents()
    • 全局级别：db.adminCommand({ getParameter: 1, logLevel: 1 })
• 配置与运行时
  • 可在 mongod.conf 的 systemLog.component..verbosity 设定，或用 setParameter logComponentVerbosity 批量设置；运行时用 db.setLogLevel() 快速调整，验证后再固化到配置。

四 审计日志与慢查询

• 慢查询
  • 通过性能分析阈值记录慢操作：在 operationProfiling.slowOpThresholdMs 设置毫秒阈值（如 100），结合日志或 profiler 分析。
• 审计日志
  • 启用后在 mongod.conf 配置 auditLog（常见为 destination: file、format: JSON、指定 path），可按 filter 精简输出。
  • 轮转：审计日志可与服务器日志分别或同时轮转，使用 db.adminCommand({ logRotate: “audit” }) 或 SIGUSR1 触发。

五 日常运维与分析

• 实时查看与检索
  • 实时跟踪：tail -f /var/log/mongodb/mongod.log
  • 组件日志：db.adminCommand({ getLog: “componentName” })
• 分析与可视化
  • 使用 mtools（如 mlogfilter、mplotqueries）做时间窗筛选、慢查询统计与可视化。
  • 结构化日志（JSON/audit）可用 jq 进行字段筛选与统计。
• 容量与合规
  • 将日志目录置于独立磁盘分区，避免影响数据盘；配置 rotate 与 compress 控制保留周期与体积。
  • 设置严格的文件权限（如 mongodb:mongodb 644），并监控 /var/log/mongodb 所在磁盘使用率，防止写满导致实例异常。