Linux系统中MongoDB如何进行故障排查

Linux下MongoDB故障排查实战指南

一 快速定位流程

• 服务状态与自启
  • 检查运行状态：sudo systemctl status mongod
  • 启动服务：sudo systemctl start mongod
  • 设置开机自启：sudo systemctl enable mongod
• 日志优先
  • 默认日志路径：/var/log/mongodb/mongod.log
  • 实时查看：tail -f /var/log/mongodb/mongod.log
• 配置核对
  • 配置文件：/etc/mongod.conf
  • 重点项：net.port: 27017、net.bindIp（仅本地为127.0.0.1，远程需改为服务器IP或0.0.0.0并配合安全策略）
• 本地连通性
  • 本机连接测试：mongo --host 127.0.0.1 --port 27017
• 远程连通性
  • 端口可达性：telnet <服务器IP> 27017 或 nc -vz 27017
  • 防火墙放行：UFW 示例 sudo ufw allow 27017；iptables 示例 sudo iptables -A INPUT -p tcp --dport 27017 -j ACCEPT
  • 云上安全组：入站放行 TCP 27017，来源限制为可信网段

二 常见故障与修复对照表

三 日志与性能分析

• 日志查看与检索
  • 实时跟踪：tail -f /var/log/mongodb/mongod.log
  • 关键字过滤：grep “ERROR|Failed” /var/log/mongodb/mongod.log
  • 时间范围与慢查询筛选：使用 mtools（如 mlogfilter、mplotqueries、mloginfo）做统计与可视化
• 运行时状态与性能
  • 实时监控：mongostat（吞吐、连接、faults）、mongotop（按库表耗时）
  • 深入诊断：db.serverStatus()（锁、内存、连接、缓存命中）、慢查询阈值与日志组件分析

四 配置与权限关键点

• 绑定地址与端口
  • 仅本地：bindIp: 127.0.0.1；允许远程：设为服务器IP或0.0.0.0（生产务必配合防火墙/安全组最小权限）
• 数据目录与权限
  • 常见路径：/var/lib/mongo；确保属主为 mongod:mongod，否则可能因权限导致启动失败
• 认证与连接串
  • 开启认证后，驱动/Shell 连接串使用：mongodb://user:pass@host:27017/db?authSource=admin
  • 密码含特殊字符（如 @、%）需 URL 编码（例如 ab@123 → ab%40123）
• 防火墙与安全组
  • 放行 27017/TCP；云上仅对可信来源开放，避免 0.0.0.0/0 的过度放行

五 安全与变更建议

• 变更前备份配置与数据（如 mongodump、快照），变更后在维护窗口滚动重启
• 远程开放仅限必要来源IP，优先使用 VPC/专线 与 安全组白名单
• 启用认证与最小权限账户；定期审计用户与角色
• 为慢查询建立合适索引，结合 mongostat/mongotop 与慢日志持续优化
• 生产环境避免将 bindIp 设为 0.0.0.0 且不做访问控制