MongoDB 在 Debian 上的日志分析方法
一 基础定位与快速查看
- 确认日志路径与配置：MongoDB 默认日志位于 /var/log/mongodb/mongod.log，配置文件为 /etc/mongod.conf。在配置文件的 systemLog 段落可查看或调整 path、destination、logAppend、verbosity 等参数。若路径或级别被自定义，应以其为准。
- 常用命令：
- 实时查看最新日志：tail -f /var/log/mongodb/mongod.log
- 分页查看：less /var/log/mongodb/mongod.log
- 关键字检索：grep -i “error|exception” /var/log/mongodb/mongod.log
- 按时间窗口检索（配合 mtools）：mlogfilter /var/log/mongodb/mongod.log --from “2025-12-05T00:00:00” --to “2025-12-05T12:00:00”
以上方法适用于快速定位启动失败、连接异常、权限错误等常见问题。
二 提升日志信息量与获取组件日志
- 调整日志级别：
- 全局临时调整（Shell）：db.setLogLevel(1)（数值越大越详细，范围 0–15）
- 配置文件持久化：在 /etc/mongod.conf 设置 systemLog.verbosity
- 组件级日志：
- 查看组件：db.getLogComponents()
- 拉取组件日志：db.adminCommand({ getLog: “query” })
- 慢查询日志：
- 设置阈值（Shell）：db.setProfilingLevel(1, { slowms: 100 })（记录执行时间超过 100 ms 的操作）
- 启动时设置：mongod --slowms 100
这些方法有助于聚焦 command、network、query 等关键组件，并快速抽取慢查询以进行优化。
三 命令行与可视化工具分析
- mtools（强烈推荐）：
- 安装：pip3 install mtools
- 用法示例：
- 统计概览：mloginfo /var/log/mongodb/mongod.log
- 按时间/慢阈值筛选：mlogfilter /var/log/mongodb/mongod.log --from “8h” --slow 60000
- 查询可视化：mplotqueries /var/log/mongodb/mongod.log --group namespace
- jq（结构化解析）：
- 若日志为 JSON 格式，可用 jq 做字段筛选与统计，例如：
- 提取消息：sudo cat /var/log/mongodb/mongod.log | jq ‘.msg’
- 第三方平台：
- 集中式日志：ELK（Elasticsearch、Logstash、Kibana）或 Filebeat/Fluentd 收集与可视化
- 监控联动：Prometheus + Grafana、Datadog 等
这些工具适合做趋势分析、热点集合/操作定位、慢查询画像与可视化报表。
四 日志轮转与长期分析
- 使用 logrotate 管理日志生命周期（示例配置 /etc/logrotate.d/mongodb）：
- 按日轮转、保留 7 天、压缩、按大小触发、轮转后通知 mongod 重新打开日志：
/var/log/mongodb/mongod.log {
daily
rotate 7
compress
missingok
notifempty
size 200M
postrotate
/bin/kill -SIGUSR1 $(cat /var/log/mongodb/mongod.lock)
endscript
}
- 要点：
- 选择 copytruncate 或 postrotate + SIGUSR1 方式，确保日志句柄正确切换
- 监控日志目录容量（如 du -sh /var/log/mongodb/），避免磁盘被占满
合理的轮转策略可保障长期分析的可追溯性与系统稳定性。
五 典型场景与命令清单
- 启动失败或服务异常：
- 查看服务状态：systemctl status mongod
- 实时跟踪错误：tail -f /var/log/mongodb/mongod.log | grep -i “error”
- 连接被拒绝或超时：
- 检查端口与防火墙、监听地址；用 mongo 客户端直连测试
- 慢查询定位与优化：
- 开启/调整慢查询阈值：db.setProfilingLevel(1, { slowms: 100 })
- 抽取并分析：mlogfilter /var/log/mongodb/mongod.log --slow 100 | less
- 结合 explain() 验证索引与执行计划
- 性能波动排查：
- 实时指标：mongostat、mongotop
- 实例状态：db.serverStatus()
以上流程覆盖连接、启动、性能与一致性等常见故障的日志驱动排查路径。