Node.js日志在Ubuntu中的错误追踪方法

Node.js 日志在 Ubuntu 的错误追踪方法

一 定位日志来源与快速查看

• 应用日志：优先查看应用配置或代码中定义的日志路径，常见位置为项目目录下的 logs/、app.log、error.log，或使用日志库写入的自定义文件。使用命令实时查看与检索：
  • 实时跟踪：tail -f /path/to/your.log
  • 关键字检索：grep -i ‘Error’ /path/to/your.log
• PM2 管理：若使用 PM2，可直接查看与过滤进程日志：
  • 全部日志：pm2 logs
  • 指定应用：pm2 logs <app_name_or_id>
  • 最近 N 行并持续跟踪：pm2 logs --lines 1000 --follow
• systemd 服务日志：若以服务运行（如 /etc/systemd/system/node-app.service），使用 journalctl 查看：
  • 指定服务：journalctl -u your-app-service-name
  • 实时跟踪：journalctl -u your-app-service-name -f
• 系统日志：部分未捕获的崩溃或系统级事件会进入 /var/log/syslog，可辅助排查：
  • 实时跟踪：sudo tail -f /var/log/syslog 以上方法覆盖应用日志、进程管理日志与系统日志的常见场景，适合快速定位错误入口与上下文。

二 应用内日志与错误追踪集成

• 结构化日志（Winston）：便于分级、落盘与后续检索，建议区分 error 与 combined 两类日志，开发环境同时输出到控制台。
  • 安装：npm install winston
  • 示例：
    • const winston = require(‘winston’);
    • const logger = winston.createLogger({ level: ‘info’, format: winston.format.combine( winston.format.timestamp(), winston.format.json() ), transports: [ new winston.transports.File({ filename: ‘error.log’, level: ‘error’ }), new winston.transports.File({ filename: ‘combined.log’ }) ] });
    • if (process.env.NODE_ENV !== ‘production’) { logger.add(new winston.transports.Console({ format: winston.format.simple() })); }
    • logger.info(‘服务启动’, { port: 3000 });
    • logger.error(‘异常发生’, { err: err.message, stack: err.stack });
• HTTP 请求日志（Morgan）：记录访问日志，配合文件流落盘，便于分析接口调用与响应状态。
  • 安装：npm install morgan
  • 示例：
    • const morgan = require(‘morgan’);
    • const fs = require(‘fs’);
    • const path = require(‘path’);
    • const accessLogStream = fs.createWriteStream(path.join(__dirname, ‘access.log’), { flags: ‘a’ });
    • app.use(morgan(‘combined’, { stream: accessLogStream }));
• 异常监控平台（Sentry）：捕获未处理异常与性能问题，形成事件聚合与告警。
  • 安装：npm install @sentry/node
  • 示例：
    • const Sentry = require(‘@sentry/node’);
    • Sentry.init({ dsn: ‘YOUR_SENTRY_DSN’, environment: ‘production’ });
    • app.use(Sentry.Handlers.errorHandler());
    • app.get(‘/’, () => { throw new Error(‘Test error’); }); 以上集成能在应用侧输出高质量结构化日志，并将关键异常上报至平台，提升定位效率。

三 系统级追踪与调试

• 运行时调试：使用 Node.js 调试协议定位复杂问题。
  • 启动：node --inspect-brk app.js
  • 在 Chrome 打开 chrome://inspect 连接调试器，设置断点、观察调用栈与变量。
• 资源与依赖排查：
  • 端口占用（如 EADDRINUSE）：sudo lsof -i :端口号，释放占用进程：sudo kill -9
  • 依赖问题：npm list 检查版本与缺失依赖，npm install <模块名> 修复 Module not found
  • 配置与环境：核对 config 文件与 环境变量（如 printenv），避免错配导致启动或运行异常
• 系统日志联动：结合 journalctl 与 /var/log/syslog 检索服务启动、崩溃、权限与 OOM 等系统层线索，与业务日志交叉验证。

四 集中化与长期运维

• 集中日志平台（ELK/Graylog）：将应用日志统一采集、解析与可视化，适合多实例与多环境。
  • 思路：Filebeat/Logstash 采集 /var/log/nodejs/*.log，以 Grok 解析时间戳与日志级别，写入 Elasticsearch，在 Kibana 构建查询与仪表盘。
• 指标与告警（Prometheus + Grafana）：暴露 /metrics 端点，采集 HTTP 延迟、吞吐、错误率 等指标，配置阈值告警与可视化面板。
• 日志轮转与容量管理：使用 logrotate 定期压缩归档，防止磁盘被占满。
  • 示例（/etc/logrotate.d/nodejs）：
    • /var/log/nodejs/*.log { daily missingok rotate 7 compress notifempty create 0640 root adm } 上述方案适合生产环境的长期可观测性建设，便于快速检索、趋势分析与容量治理。