Debian环境下JS日志管理方法

Debian环境下JS日志管理方法

一 日志库选择与快速配置

• 常用库与适用场景
  • Winston：生态成熟、传输多（文件、控制台、HTTP 等），适合大多数应用。
  • Pino：高性能、低开销，适合高并发与 JSON 结构化场景。
  • Bunyan：结构化 JSON 输出，便于检索与分析。
  • Log4js：功能丰富，支持按级别与按文件输出、轮转等。
  • Morgan：HTTP 请求日志中间件，常与 Express 搭配使用。
• 最小可用配置示例
  • Winston（区分错误与全量日志，开发环境输出到控制台）
    • 安装：npm i 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’ })
        • ]
      • });
      • if (process.env.NODE_ENV !== ‘production’) {
        • logger.add(new winston.transports.Console({ format: winston.format.simple() }));
      • }
      • logger.info(‘Hello distributed log files!’);
  • Log4js（控制台与按日滚动文件）
    • 安装：npm i log4js
    • 代码示例：
      • const log4js = require(‘log4js’);
      • log4js.configure({
        • appenders: {
          • console: { type: ‘console’ },
          • file: { type: ‘file’, filename: ‘logs/app.log’, pattern: ‘yyyy-MM-dd’, alwaysIncludePattern: true, daysToKeep: 90, compress: true }
        • },
        • categories: { default: { appenders: [‘console’, ‘file’], level: ‘info’ } }
      • });
      • const logger = log4js.getLogger();
      • logger.info(‘Started’);

二 日志轮转与系统级集成

• 应用内轮转（推荐用于容器/不可变基础设施）
  • 使用 winston-daily-rotate-file：npm i winston-daily-rotate-file
  • 示例：
    • const DailyRotateFile = require(‘winston-daily-rotate-file’);
    • new DailyRotateFile({
      • filename: ‘application-%DATE%.log’,
      • datePattern: ‘YYYY-MM-DD-HH’,
      • zippedArchive: true,
      • maxSize: ‘20m’,
      • maxFiles: ‘14d’
    • })
• 系统级轮转（推荐用于物理机/虚拟机）
  • 安装与配置 logrotate：sudo apt-get install logrotate
  • 新建配置：/etc/logrotate.d/nodejs
    • /path/to/your/nodejs/logs/*.log {
      • daily
      • rotate 7
      • compress
      • missingok
      • notifempty
      • create 0644 root root
    • }
  • 校验与强制执行：
    • sudo logrotate -d /etc/logrotate.d/nodejs（干跑）
    • sudo logrotate -f /etc/logrotate.d/nodejs（强制执行）
• 写入系统日志（syslog/rsyslog）
  • 安装 rsyslog：sudo apt-get install rsyslog
  • 配置 /etc/rsyslog.d/50-default.conf 或自定义文件：
    • if $programname == ‘yourapp’ then /var/log/yourapp.log
    • & stop
  • 重启服务：sudo systemctl restart rsyslog
• 使用 PM2 管理进程与日志
  • 安装：sudo npm install -g pm2
  • 启动：pm2 start app.js
  • 查看：pm2 logs；分离错误与标准输出：
    • {
      • “name”: “my-app”,
      • “script”: “app.js”,
      • “error_file”: “err.log”,
      • “out_file”: “out.log”
    • }

三 日志分析与可视化

• 命令行快速检索
  • 实时查看：tail -f app.log
  • 关键字过滤：cat app.log | grep "error"
  • 系统服务日志：journalctl -u your-app.service（若以 systemd 托管）
• 集中式日志平台
  • ELK Stack（Elasticsearch/Logstash/Kibana）：强大的检索与可视化，适合复杂查询与合规归档。
  • Graylog：集中接收、索引与告警，部署相对简洁。
  • Grafana Loki：与 Grafana 深度集成，低成本聚合与查询，适合云原生/微服务。
  • Splunk：商业方案，搜索与可视化能力强，适合企业级场景。

四 生产实践与日志瘦身

• 控制日志量与性能
  • 调整日志级别：生产环境优先 warn/error，开发环境开启 debug。
  • 条件日志：仅在必要时记录，避免冗余调试信息。
  • 异步与高性能库：优先 Pino 等异步方案，降低 I/O 阻塞。
• 规范与治理
  • 统一使用结构化日志（如 JSON），便于检索与聚合。
  • 避免记录敏感信息（密码、密钥、卡号等），必要时进行脱敏。
  • 合理设置保留周期与归档策略，配合监控告警（如关键错误触发通知）。