Linux Node.js应用如何进行日志管理

Linux环境下，Node.js应用的日志管理其实是个老生常谈但又极易踩坑的话题。很多开发者最初只靠console.log走天下，等线上出了问题才追悔莫及——日志要么被冲得七零八落，要么磁盘被撑爆，要么关键错误信息根本找不到。实际上，只要把几个核心环节理清楚，日志管理完全可以做到既省心又可靠。

咱们一步步来拆解。

第一步：选对日志库，这事就成功了一半。社区里成熟的选择不少，比如winston和pino。前者功能全面、生态丰富，后者以极致性能见长。无论选哪个，它们都内置了日志级别、格式化、传输（transports）等核心能力，让你不用从头造轮子。

第二步：日志级别要分清楚，别让无关信息淹没关键线索。通常我们会定义error、warn、info、debug、verbose这几个级别。生产环境建议只保留error和warn，开发环境再开debug。这样既控制了磁盘消耗，又能快速定位问题。

第三步：日志格式不能含糊。时间戳、日志级别、模块名、请求ID——这些信息就像破案时的指纹，缺一环都可能让你多花几个小时排查。用winston.format.combine()可以轻松组合出想要的格式，比如2025-04-24 10:15:30 [ERROR]: 数据库连接超时，一眼就能看出问题发生的时间和严重程度。

第四步：日志轮转是必须的，否则磁盘迟早会爆。通过winston-daily-rotate-file这类库，可以设置按日期或文件大小自动切分，旧日志还能自动压缩归档。比如每天生成一个文件，单个文件最大20MB，保留最近14天——这已经能覆盖大多数场景。

第五步：日志往哪存？本地文件系统是最直接的方案，但如果服务规模上去了，最好把日志统一收集到远程服务器。常用的工具有rsyslog、fluentd、logstash，它们能帮你把分散在多台机器上的日志聚合起来，方便后续分析。

第六步：监控和报警才是最后一道防线。光有日志还不够，得有人盯着。借助ELK（Elasticsearch、Logstash、Kibana）或Graylog这类平台，可以实时搜索、可视化日志，并设置告警规则——比如当error级别日志在5分钟内出现超过10次，就通过邮件或钉钉通知你。

下面是一个用winston实现的完整示例，把上面提到的要点都整合进去了：

const winston = require('winston');
const DailyRotateFile = require('winston-daily-rotate-file');

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 DailyRotateFile({
      filename: 'logs/app-%DATE%.log',
      datePattern: 'YYYY-MM-DD',
      zippedArchive: true,
      maxSize: '20m',
      maxFiles: '14d'
    })
  ]
});

// 示例日志输出
logger.error('An error occurred');
logger.warn('A warning occurred');
logger.info('An info message');
logger.debug('A debug message');
logger.verbose('A verbose message');

这段代码创建了一个日志记录器，每天自动轮转，保留最近14天，同时开启压缩。生产环境中，你只需要关注error和warn的输出，其他级别的日志按需开启即可。

从数据来看，大多数线上故障的根因都能在日志中找到蛛丝马迹。把日志管理这件事做扎实，相当于给系统装了一台“黑匣子”——平时不显眼，关键时刻能救命。