如何利用Ubuntu JS日志进行故障恢复

利用 Ubuntu 上的 JS 日志进行故障恢复

一 定位与收集日志

• 系统与服务层日志：使用 journalctl 查看与你的 Node.js 服务相关的日志，例如：journalctl -u your-service-name -f；如需从启动开始查看，可加 --since today。系统级日志可查 /var/log/syslog，并配合 grep 过滤关键字：grep -i “myapp” /var/log/syslog。
• 应用层日志：检查应用安装目录或用户主目录下的日志文件，常见路径包含 /var/log/ 与应用根目录；实时跟踪可用 tail -f /path/to/your.log。
• 前端 JS 日志：打开浏览器开发者工具，在 Console 查看报错，在 Network 检查请求状态与响应数据。
• 远程错误聚合：若集成了 Sentry/Bugsnag 等，优先查看错误详情与堆栈，以快速定位生产问题。

二 快速恢复操作清单

• 端口占用导致服务起不来：常见于 “Error: listen EADDRINUSE :::3000”。执行 lsof -iTCP:3000 -sTCP:LISTEN 或 ss -ltnp | grep 3000 找到占用进程 PID，kill -9 后重启服务。
• 权限问题：若日志出现 “EACCES permission denied”，检查应用目录与日志文件的 用户/组 与 权限，必要时用 chown/chmod 修正，再以正确用户启动服务。
• 依赖或代码异常：执行 npm install 确保依赖完整；使用 node inspect your-script.js 或在 Chrome 打开 chrome://inspect 进行断点调试；修复后重启服务。
• 资源与磁盘：用 top/htop 观察 CPU/内存，用 df -h 与 du -sh 检查 磁盘空间，先释放或扩容再重启，避免反复崩溃。
• 版本与环境：确认 Node.js/npm 版本匹配项目要求（node -v、npm -v），必要时升级；同时校对 环境变量 与配置文件路径。

三 日志解析与定位技巧

• 命令行快速检索：grep -i “error|exception|fail” app.log 过滤错误；结合 awk ‘{print $1,$2,$NF}’ 提取时间、级别与关键信息；sed 用于文本替换与抽取。
• JSON 日志解析：若日志为 JSON 格式，先安装 jq（sudo apt-get install jq），再按字段查询，例如：jq ‘select(.level==“error”) | .message’ app.log；可按时间窗口、请求 ID 等字段聚合分析。
• 结构化字段解读：重点关注 时间戳、日志级别、PID、模块/组件、用户信息、请求/事务ID、状态码、错误堆栈、性能指标，据此还原故障现场与调用链。
• 集中化与可视化：将日志接入 ELK Stack（Elasticsearch/Logstash/Kibana） 或 Graylog，实现实时检索、可视化与告警，缩短恢复时间。

四 常见错误与修复对照表

五 预防与加固建议

• 使用结构化日志：在 Node.js 中采用 winston/pino 输出 JSON 日志，并按级别分流到 error.log 与 combined.log，便于检索与告警。
• 接入错误追踪：在生产环境集成 Sentry/Bugsnag，第一时间获取异常堆栈、用户与设备上下文。
• 建立集中式日志平台：部署 ELK/Graylog，统一采集 syslog、journalctl、应用日志，配置可视化看板与阈值告警。
• 监控与自愈：对 PID、端口、内存、磁盘、HTTP 5xx 设置监控与自动恢复（如 systemd 重启策略、进程守护）。
• 发布与回滚：保留最近几次可工作的 artifact 与配置，出现大面积错误时按 版本/配置 快速回滚。