Linux环境下JS日志记录有哪些最佳实践

在Linux环境下做Ja vaScript日志记录，看似简单，但真正落地的时候，坑其实不少。很多团队一开始只是随手console.log，等到线上出问题，才发现日志根本没法用。下面这十个实践，算是从实际项目中摸爬滚打出来的经验，希望对你有帮助。

1. 使用结构化日志

• JSON格式：别再写那种纯文本拼接的日志了，解析起来费劲。用JSON格式记录，后续分析、聚合都方便得多。

  const log = require('pino')();
  log.info({ message: 'User logged in', userId: '12345' });

2. 日志级别管理

• 设置合适的日志级别：别一股脑把所有信息都打出来，也别把错误级别设得太高，漏掉关键信息。根据场景选info、warn、error，配合环境变量动态调整。

  const log = require('pino')({ level: 'info' });

3. 日志轮转

• 使用日志轮转工具：日志文件不控制，一个月就能把磁盘撑爆。Linux下logrotate是标配，配置好压缩、保留天数，省心省力。

  /var/log/myapp/*.log {
  daily
  rotate 7
  compress
  delaycompress
  missingok
  notifempty
  create 0640 root adm
  }

4. 日志分割

• 按模块或功能分割日志：所有日志混在一起，排查问题就像大海捞针。按模块打标签，或者直接写到不同文件，效率翻倍。

  const log = require('pino')({ level: 'info' });
  const userLog = log.child({ module: 'user' });
  userLog.info('User logged in');

5. 日志时间戳

• 记录时间戳：没有时间戳的日志基本等于废纸。确保每条日志都带上精确到毫秒的时间，方便回溯。

  const log = require('pino')({ level: 'info' });
  log.info({ timestamp: new Date().toISOString(), message: 'User logged in' });

6. 日志聚合

• 使用日志聚合工具：单机看日志还行，微服务一多，必须上集中式平台。ELK Stack（Elasticsearch, Logstash, Kibana）或Graylog都是成熟选择，搜索、可视化一步到位。

7. 日志安全

• 敏感信息过滤：密码、信用卡、Token这些绝对不能出现在日志里。哪怕开发环境也要养成习惯，用净化函数处理后再输出。

  const log = require('pino')();
  const sanitize = require('sanitize-html');
  const userInput = sanitize(req.body.input);
  log.info({ userInput }, 'User input received');

8. 异步日志记录

• 使用异步日志记录：日志写得太慢，会影响业务响应。选支持异步的库（比如Pino默认就是异步），或者用后台线程写入，避免阻塞主流程。

  const log = require('pino')();
  log.info('User logged in', { async: true });

9. 日志监控和告警

• 设置监控和告警：日志不是写出来就算完，关键错误要能实时通知。可以结合Prometheus、Alertmanager，或者直接对接日志平台的告警规则。

  const log = require('pino')();
  log.error({ message: 'Critical error occurred' }, 'Error handling');

10. 文档和规范

• 制定日志记录规范：团队大了，每个人写日志的风格都不一样，统一规则才能发挥日志的价值。把格式、级别、字段含义都写清楚，新人来了也能快速上手。

这些实践说起来简单，但真正坚持下来，系统可维护性和故障排查效率都会有质的提升。关键是养成习惯，把这套流程固化到项目模板和CI/CD里，后续就不用操心了。