MongoDB故障排查在Debian上有哪些技巧

Debian上MongoDB故障排查技巧

一 快速定位流程

• 服务状态与端口：使用systemctl status mongod确认服务是否运行；用netstat -anp | grep 27017或ss -ltnp | grep 27017检查是否监听默认端口27017。
• 日志优先：查看**/var/log/mongodb/mongod.log**，优先关注启动失败、权限、配置解析、复制集等关键报错。
• 配置核对：检查**/etc/mongod.conf中关键项（如net.bindIp**、net.port、storage.dbPath、systemLog.path）及路径是否存在。
• 连接验证：本地用**mongo --eval 'db.runCommand({ connectionStatus: 1 })'测试；远程用mongo “mongodb://host:27017”**验证网络与认证。
• 防火墙与网络：确认iptables/firewalld已放行27017；云环境同时检查安全组规则。
• 资源与磁盘：用df -h、free -m、iostat -x 1排查磁盘空间、内存与I/O瓶颈。

二 常见故障与处理要点

• 服务无法启动：查看mongod.log定位配置解析、权限或目录问题；核对**/etc/mongod.conf**路径与权限；必要时以单用户模式启动排查数据目录一致性。
• Connection refused：确认服务已启动并监听27017；检查bindIp是否限制了来源IP；排查防火墙/安全组；验证连接字符串的主机与端口。
• Write concern failed：多见于副本集/分片环境，检查rs.status()、成员健康与网络连通性，确认写关注级别与多数派条件是否满足。
• No Server Chosen by ReadPreference：核对ReadPreference设置与副本集拓扑，确保有可用节点匹配策略。
• 查询性能问题：用mongostat、mongotop观察吞吐与耗时；用**explain()**分析执行计划并补充或调整索引；配置并分析慢查询日志。
• 权限与认证错误：核对**/etc/mongod.conf中的security.authorization**设置与用户角色；确保应用连接串包含正确凭据。

三 日志与诊断工具

• 日志位置与实时查看：MongoDB日志默认在**/var/log/mongodb/mongod.log**；使用tail -f /var/log/mongodb/mongod.log实时跟踪；用grep “query” /var/log/mongodb/mongod.log检索关键词。
• 动态调级与组件日志：在Shell中通过db.setLogLevel(1)调整全局日志级别（范围0–15），用**db.getLogComponents()查看组件；用db.adminCommand({ getLog: “query” })**获取特定组件日志。
• 配置化日志管理：在**/etc/mongod.conf设置systemLog.destination/file/path/verbosity**；通过logrotate管理轮转，示例配置保留7天、压缩、按大小或按日轮转，并在轮转后向进程发送SIGUSR1以重新打开日志文件。
• 结构化分析：若日志为JSON格式，可配合jq进行字段筛选与统计，提高定位效率。

四 性能与复制集专项

• 性能瓶颈定位：用mongostat观察插入/查询/更新/删除速率与延迟；用mongotop查看集合级耗时；对慢查询开启阈值记录并用**explain()**验证索引命中与扫描方式。
• 索引优化：为高频查询建立复合索引，避免全表扫描；利用覆盖索引减少回表；定期使用**db.collection.validate()**检查索引与数据一致性。
• 系统层面：监控CPU、内存、磁盘I/O与网络带宽，识别资源争用导致的性能劣化。
• 副本集健康：使用rs.status()、rs.printReplicationInfo()、**rs.printSecondaryReplicationInfo()**检查成员状态、复制延迟与oplog窗口，确保数据同步与故障切换正常。

五 安全与维护建议

• 最小暴露面：在**/etc/mongod.conf将bindIp限制为内网网段或应用服务器IP，避免使用0.0.0.0暴露到公网；远程访问必须配合TLS/SSL**与强认证。
• 防火墙与云安全组：仅放行27017来源IP段；定期审计规则与访问来源。
• 备份与恢复：定期执行mongodump/mongorestore或采用文件系统快照；变更前先备份**/etc/mongod.conf**与关键数据目录。
• 版本与驱动：保持MongoDB与驱动版本兼容，及时修补已知问题；升级前阅读发行说明并制定回滚方案。
• 日志合规：通过logrotate控制日志保留周期与大小，避免磁盘被撑满导致实例异常。