Ubuntu下Node.js日志如何实时查看

Ubuntu下Node.js日志实时查看实用指南

在处理Node.js应用的运维与调试时，实时查看日志几乎是最高频的需求之一。无论是追踪线上bug、监控系统状态，还是分析异常行为，能第一时间看到日志输出往往能省下大量排查时间。下面直接梳理几套实用方案，覆盖从开发到生产的不同场景。

最常用方法：tail 与它的朋友们

最经典也最直接的方法，当然是 tail -f。它适合日志被直接写入文件、或控制台输出被重定向到文件的场景：

• 基础命令：tail -f /var/log/myapp.log，会持续跟踪文件的增量内容。

• 如果只想关注某些关键词，比如“error”，可以配合 grep 过滤：tail -f app.log | grep --line-buffered "error"。这里的 --line-buffered 参数很关键，它保证 grep 在每读入一行后立即输出，而不是等待缓冲区填满，这样才能真正实现实时过滤。

当需要同时盯多个日志文件时，multitail 就派上用场了。它支持分屏显示、高亮关键词，甚至对每个窗口单独设置过滤条件。安装很简单：sudo apt-get install multitail，然后直接 multitail app.log 或 multitail app.log error.log 即可。

如果只是简单轮询查看，watch + tail 的组合也很实用：watch -n 1 'tail -n 50 app.log'。这条命令会让屏幕每1秒刷新一次，始终显示日志的最后50行。适合那些不需要持续跟踪、但想周期性查看最新情况的场景。

PM2 环境下的日志查看

如果你在用 PM2 管理 Node.js 进程，日志查看会方便得多。PM2自带了一套完整的日志管理工具：

• 所有应用的日志实时输出：pm2 logs。这条命令会同时显示所有进程的日志，并按应用名标记来源。

• 只看某个具体应用：pm2 logs 。这样能避免被其他无关进程的日志干扰。

• JSON 格式输出：pm2 logs --json。适合用工具做进一步处理或自动化分析。

• 限制显示的日志行数：pm2 logs --lines 1000。避免一次性加载过多内容导致终端卡顿。

• 启动时带上时间戳：pm2 start app.js --time。这个参数会在每条日志前加上服务器时间，对定位问题非常有帮助。

• 指定日志文件路径：pm2 start app.js --log /path/to/logfile。方便统一管理日志归档。

• 集群模式下合并日志：pm2 start app.js -i max --merge-logs。多进程实例的日志会被合并到一个文件中，避免分散。

• 清理日志：pm2 flush 清空所有应用日志，pm2 flush 只清空指定应用。

• 想实时监控资源占用和日志概要，用 pm2 monit 打开内置监控面板，CPU、内存、日志都在同一个界面里。

systemd 服务下的日志查看

如果 Node.js 是以 systemd 服务形式运行的，那 journalctl 就是你的首选工具：

• 实时跟踪：journalctl -u your-nodejs-service-name -f。这里的 -f 参数实现类似 tail -f 的持续输出效果。

• 按时间范围过滤：journalctl -u your-nodejs-service-name --since "10 min ago" -f。只显示最近10分钟的日志，大幅减少信息噪音。

• 持续跟随输出：记住在命令末尾加上 -f 参数，否则只会显示一次然后退出。

日志轮转与长期管理

日志文件如果不加管理，很可能会膨胀到占用整个磁盘。这时候 logrotate 就是必不可少的工具。它配合 rsyslog 可以实现自动轮转、压缩和归档：

• 首先创建配置：sudo nano /etc/logrotate.d/yourapp

• 一个典型的配置示例：

  /path/to/your/logfile.log {
      daily
      rotate 7
      compress
      delaycompress
      notifempty
      create 640 root adm
  }

  意思是：每天轮转一次，保留最近7个轮转文件，压缩旧日志，但延迟一天压缩（方便随时查看最近一天的未压缩日志），如果日志文件为空则不轮转，新创建的日志文件属主为 root、组为 adm、权限 640。

• 如果需要通过 rsyslog 集中转发日志，可以在 /etc/rsyslog.conf 或 /etc/rsyslog.d/50-default.conf 中添加规则，比如：

  if $programname == 'yourapp' then /var/log/yourapp.log
  & stop

  这条规则会把所有来自名为 yourapp 的程序的日志写入指定文件，并且不再进一步处理（避免重复写入）。配置完成后重启 rsyslog 即可生效：sudo systemctl restart rsyslog。

• 轮转后继续使用 tail -f 跟踪：tail -f /var/log/yourapp.log。注意，如果日志文件被轮转替换，tail -f 在旧文件被删除后会自动停止，需要重新执行命令跟踪新文件。

在Node.js中输出便于实时查看的日志

上面的工具只解决了“怎么看”的问题，而“怎么输出”同样关键。推荐使用成熟的日志库，比如 winston 或 bunyan，按级别输出到文件和终端，便于后续的筛选和持久化：

• 下面是用 winston 的一个简单示例，它会把日志同时写入文件和控制台，天然适合 tail -f 实时查看：

  const winston = require('winston');
  
  const logger = winston.createLogger({
      level: 'info',
      format: winston.format.combine(
          winston.format.timestamp(),
          winston.format.printf(({ timestamp, level, message }) => {
              return `${timestamp} [${level.toUpperCase()}]: ${message}`;
          })
      ),
      transports: [
          new winston.transports.File({ filename: 'app.log' }),
          new winston.transports.Console()
      ]
  });
  
  logger.info('Server started on port 3000');
  logger.error('Database connection failed');

  这个配置的输出格式包含了精确到秒的时间戳和日志级别，配合 tail -f 或 pm2 logs --time，几乎能一眼定位问题发生的时间点。

• 结合 PM2 的 --time 参数或日志库自带的时间戳，实时查看时能快速锁定异常发生的时刻。这一点在生产环境中尤其重要——当日志文件中满屏都是输出，带时间戳的行就是你的救命稻草。

从开发调试到生产运维，实时查看日志的方法有很多。核心思路其实就两条：一是选对查看工具（tail、multitail、pm2 logs、journalctl），二是做好日志输出（结构化、带时间戳、按级别分类）。两者配合好，排查效率会提升不止一个量级。