如何通过Ubuntu Node.js日志排查问题

Ubuntu 下用日志高效排查 Node.js 问题

一 定位日志来源

• 应用日志：优先查看应用配置或代码中指定的日志路径，常见位置为应用根目录的 logs/ 或项目根目录，文件名如 app.log、error.log、combined.log。若使用日志库（如 winston、morgan），以库配置的 filename 为准。
• 进程管理日志：使用 PM2 时，日志统一由 PM2 管理，支持按应用名或 ID 查看、实时跟踪与行数限制。
• 系统日志：若以 systemd 服务运行，用 journalctl 查看服务日志；通用系统事件可查 /var/log/syslog。
• 反向代理与网关：若经 Nginx/Apache 转发，同时检查其错误日志（如 /var/log/nginx/error.log）以定位上游连通与权限问题。

二 快速查看与检索

• 实时查看应用日志：tail -f /path/to/app.log；按关键字过滤：grep -i ‘Error’ app.log。
• PM2 日志：pm2 logs 查看全部；pm2 logs < app_name_or_id> 查看单个应用；pm2 logs --lines 1000 查看最近 1000 行；pm2 logs --follow 实时跟踪。
• 系统日志：sudo tail -f /var/log/syslog；按服务查看：sudo journalctl -u < service_name> ；查看最近 10 分钟：journalctl -u < service_name> --since “10 minutes ago” --no-pager。
• 前端问题：打开浏览器开发者工具，查看 Console 与 Network 选项卡，核对请求状态与响应数据。

三 常见日志模式与处理要点

• 权限错误（如 EACCES）：日志含 “EACCES: permission denied”。处理：校正文件/目录权限或以合适用户运行。
• 未处理的 Promise 拒绝：出现 “UnhandledPromiseRejectionWarning”。处理：为所有 Promise 加 .catch() 或使用 try/catch；可临时监听 process.on(‘unhandledRejection’) 记录并告警。
• 事件监听器泄漏：出现 “MaxListenersExceededWarning”。处理：避免重复添加监听器，必要时 emitter.setMaxListeners() 并显式 removeListener。
• 内存不足：出现 “FATAL ERROR: Reached heap limit”。处理：短期提升堆上限 node --max-old-space-size=4096 app.js；长期用 clinic/heapdump 分析泄漏并优化数据结构与缓存策略。
• 废弃 API 警告（DeprecationWarning）：如 Buffer() 被弃用。处理：按官方建议改用 Buffer.alloc()/Buffer.from()，并升级依赖与 Node 版本。

四 提升日志可观测性

• 结构化与上下文：使用 winston/pino/log4js 输出 JSON 日志，并在每条日志中携带 timestamp、requestId、userId、level 等上下文，便于检索与链路追踪。
• 日志级别与输出策略：区分 error/warn/info/debug，生产以 warn/error 为主，调试期临时提升；对请求日志使用 morgan 记录 HTTP 方法、路径、状态码与耗时。
• 日志轮转与容量控制：长期运行务必配置 logrotate（按日/按大小切割、保留份数），避免单文件过大影响检索与磁盘。
• 集中式日志：多实例/多服务建议接入 ELK Stack（Elasticsearch/Logstash/Kibana）/Graylog，统一检索、聚合与可视化。
• 监控与告警：结合 Prometheus/Grafana 或 APM（如 New Relic）对错误率、延迟、内存等指标设置阈值告警，缩短 MTTR。

五 系统化排查流程

• 明确现象与范围：记录触发时间、频率、影响接口/用户，优先复现。
• 收集证据：同时抓取应用日志、PM2 日志、systemd 日志与反向代理日志，形成时间线。
• 定位根因：用关键字与时间窗筛选，结合堆栈与请求上下文定位到模块/函数/SQL/配置。
• 临时止血与验证：如调整日志级别、重启服务、限流降级，确认问题是否缓解。
• 修复与回归：修复代码/配置/依赖，补充日志与单测，回放流量或压测验证。
• 复盘与预防：完善日志字段与告警阈值，补齐缺失的异常捕获与资源清理，更新 runbook/SOP。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！