Ubuntu JS日志管理有哪些最佳实践

Ubuntu下JavaScript（Node.js）日志管理最佳实践

1. 选择合适的日志库

根据应用需求选型：

Winston：功能全面，支持多传输（文件、控制台、HTTP等）、自定义格式和日志级别，适合需要高度定制的场景；
Pino：以高性能著称（比Winston快3-5倍），采用流式处理，适合高并发、大数据量应用；
Bunyan：默认输出JSON格式，自带CLI工具，便于日志解析和过滤。
示例（Winston）：

const winston = require('winston');
const logger = winston.createLogger({
  level: 'info',
  format: winston.format.json(),
  transports: [
    new winston.transports.File({ filename: 'error.log', level: 'error' }),
    new winston.transports.File({ filename: 'combined.log' }),
    new winston.transports.Console() // 开发环境可输出到控制台
  ]
});

示例（Pino）：

const pino = require('pino');
const logger = pino({ level: 'info' }, pino.destination('app.log'));
logger.info('Application started');

2. 合理配置日志级别

根据环境调整日志详细程度，避免不必要的性能消耗：

开发环境：使用debug级别，输出详细调试信息；
生产环境：使用info或warn级别，仅记录关键操作（如请求响应、状态变更）和潜在问题（如数据库连接超时）；
错误场景：使用error级别记录致命错误（如服务崩溃、未捕获异常）。
示例（环境区分）：

const env = process.env.NODE_ENV || 'development';
const level = env === 'production' ? 'info' : 'debug';
const logger = winston.createLogger({ level });

3. 实施日志轮转

避免单个日志文件过大导致磁盘空间耗尽，推荐两种方式：

使用Winston插件：winston-daily-rotate-file自动按日期分割日志，保留最近7天：

const winston = require('winston');
require('winston-daily-rotate-file');
const transport = new winston.transports.DailyRotateFile({
  filename: 'application-%DATE%.log',
  datePattern: 'YYYY-MM-DD',
  maxSize: '20m', // 单个文件最大20MB
  maxFiles: '7d'  // 保留7天
});
logger.add(transport);

使用系统工具：logrotate配置文件示例（/etc/logrotate.d/nodejs-app）：

/var/log/nodejs/app.log {
  daily
  missingok
  rotate 7
  compress
  delaycompress
  notifempty
  create 640 nodejs nodejs
}

4. 采用异步日志记录

避免同步写入阻塞主线程，提升应用性能。多数现代日志库（如Winston、Pino）默认支持异步：

Winston：通过transports的async选项开启（默认开启）；
Pino：内部使用流式处理，无需额外配置。
示例（Winston异步确认）：

const logger = winston.createLogger({
  transports: [
    new winston.transports.File({ filename: 'async.log', async: true })
  ]
});

5. 使用结构化日志

以JSON格式输出日志，便于后续解析、过滤和分析（如通过ELK提取字段）：

logger.info('User login', { userId: 123, ip: '192.168.1.1', status: 'success' });
// 输出：{"level":"info","message":"User login","userId":123,"ip":"192.168.1.1","status":"success"}

结构化日志的优势：

支持按字段查询（如grep "userId":123 app.log）；
方便日志聚合工具（如ELK）进行分析。

6. 集中化日志管理

将日志发送至集中式系统，解决分布式应用日志分散问题，便于统一监控和分析：

ELK Stack（Elasticsearch+Logstash+Kibana）：
- 配置Winston发送日志到Logstash（通过winston-logstash插件）；
- Elasticsearch存储和索引日志，Kibana提供可视化界面；

PM2：内置日志管理，支持日志轮转、实时查看和远程传输：

pm2 start app.js --log-date-format "YYYY-MM-DD HH:mm Z" # 格式化时间
pm2 logs myapi --lines 100 # 查看最近100行日志

7. 性能优化技巧

更新Node.js版本：新版本修复了日志模块的性能bug（如v18+优化了console.log的性能）；
减少同步操作：避免在日志回调中使用fs.writeFileSync等同步方法；
精简日志内容：不记录敏感信息（如密码、银行卡号），移除不必要的日志字段；
启用缓存：Winston的transports支持buffer选项，批量写入磁盘减少I/O次数。

8. 安全性考虑

权限控制：日志文件权限设置为640（所有者可读写，组可读），避免未授权访问：
```
chown nodejs:nodejs /var/log/nodejs/app.log
chmod 640 /var/log/nodejs/app.log
```

敏感信息过滤：使用winston-deny或自定义format移除日志中的敏感字段：

const winston = require('winston');
const deny = require('winston-deny');
const logger = winston.createLogger({
  format: winston.format.combine(
    winston.format.json(),
    deny({ paths: ['password', 'creditCard'] }) // 过滤指定字段
  ),
  transports: [new winston.transports.File({ filename: 'secure.log' })]
});