Debian Node.js 日志如何配置

Debian系统下Node.js日志配置指南

在Debian系统中，Node.js日志配置需根据生产/开发环境需求选择合适方案，核心目标是将日志结构化、持久化，并实现高效管理。以下是常见配置方法及步骤：

一、基础日志记录：内置`console`模块

最简单的日志方式是使用Node.js内置的console.log/console.error，适用于开发调试。若需将日志写入文件，可通过重定向或自定义函数实现：

const fs = require('fs');
const path = require('path');
const logFile = path.join(__dirname, 'app.log');

// 自定义日志函数（带时间戳）
function logToFile(message) {
  const timestamp = new Date().toISOString();
  const logEntry = `${timestamp}: ${message}\n`;
  fs.appendFile(logFile, logEntry, (err) => {
    if (err) throw err;
  });
}

// 重写console.log
console.log = (...args) => {
  const message = args.join(' ');
  logToFile(message); // 写入文件
  process.stdout.write(message + '\n'); // 同时输出到控制台
};

// 示例使用
console.log('Hello, world!');

缺点：缺乏日志级别、格式化、轮转等功能，不适合生产环境。

二、使用日志库：Winston/Pino（推荐）

1. Winston（功能全面）

Winston是Node.js最流行的日志库，支持多传输（文件、控制台、Syslog等）、格式化（JSON/文本）和日志级别。

安装：npm install winston

配置示例：

const { createLogger, format, transports } = require('winston');
const path = require('path');

const logger = createLogger({
  level: process.env.LOG_LEVEL || 'info', // 通过环境变量动态设置级别
  format: format.combine(
    format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),
    format.json() // 生产环境建议用JSON格式（便于ELK等工具分析）
  ),
  transports: [
    new transports.File({ filename: path.join(__dirname, 'logs/error.log'), level: 'error' }), // 错误日志单独存储
    new transports.File({ filename: path.join(__dirname, 'logs/combined.log') }), // 所有日志合并
    ...(process.env.NODE_ENV !== 'production' ? [ // 开发环境输出到控制台
      new transports.Console({ format: format.simple() })
    ] : [])
  ]
});

// 示例使用
logger.info('Application started');
logger.error('Database connection failed');

优势：灵活、可扩展，支持自定义传输和格式化。

2. Pino（高性能）

Pino专注于高性能，日志输出为JSON格式，适合对性能敏感的生产环境。

安装：npm install pino pino-pretty

配置示例：

const pino = require('pino');
const path = require('path');

// 生产环境：写入文件
const logger = pino({ level: 'info' }, pino.destination(path.join(__dirname, 'logs/app.log')));

// 开发环境：输出到控制台（美化格式）
if (process.env.NODE_ENV !== 'production') {
  logger.level = 'debug';
  logger = pino({ level: 'debug' }, pino.destination(process.stdout));
}

// 示例使用
logger.info('User logged in', { userId: 123 });
logger.error('Invalid API key', { apiKey: 'abc123' });

优势：日志输出速度快，资源占用低。

三、日志轮转：防止日志文件过大

使用logrotate工具自动轮转、压缩和删除旧日志，避免日志文件占用过多磁盘空间。

安装：sudo apt install logrotate

配置：创建/etc/logrotate.d/nodejs文件，内容如下：

/path/to/your/nodejs/logs/*.log {
  daily                # 每天轮转
  rotate 7             # 保留7天日志
  compress             # 压缩旧日志（如.gz格式）
  missingok            # 若日志文件不存在也不报错
  notifempty           # 若日志为空则不轮转
  create 0644 root root # 新日志文件权限
}

测试：logrotate -d /etc/logrotate.d/nodejs（模拟运行，检查配置是否正确）；logrotate -f /etc/logrotate.d/nodejs（强制立即轮转）。

四、进程管理：PM2集成日志

PM2是Node.js进程管理工具，可自动重启应用并管理日志，适合生产环境。

安装：npm install pm2 -g

启动应用并配置日志：

pm2 start app.js --name "my-app" \
  --log /var/log/my-app.log \       # 合并日志路径
  --error /var/log/my-app-error.log # 错误日志路径

查看日志：pm2 logs my-app（实时日志）；pm2 logs my-app --lines 100（查看最近100条）。

配置文件：也可通过ecosystem.config.js配置：

module.exports = {
  apps: [{
    name: 'my-app',
    script: 'app.js',
    error_file: '/var/log/my-app-error.log',
    out_file: '/var/log/my-app.log',
    log_date_format: 'YYYY-MM-DD HH:mm Z'
  }]
};

优势：自动管理进程、日志分割、支持远程日志（如Logstash）。

五、系统日志集成：Syslog

将Node.js日志发送到Debian系统的Syslog（集中管理所有系统日志），适合需要统一日志管理的场景。

使用Winston-Syslog：

安装：npm install winston-syslog

配置示例：

const winston = require('winston');
const Syslog = require('winston-syslog').Syslog;

const logger = winston.createLogger({
  level: 'info',
  format: winston.format.json(),
  transports: [
    new Syslog({
      host: 'localhost',    // Syslog服务器地址（本地则为localhost）
      port: 514,            // Syslog端口（默认UDP 514）
      app_name: 'my-node-app', // 应用名称（在Syslog中标识）
      facility: 'local0',   // 设施类型（如local0-local7）
      eol: '\n'             // 行结束符
    })
  ]
});

// 示例使用
logger.info('Application started', { pid: process.pid });

查看Syslog：journalctl -t my-node-app（过滤应用名称）；tail -f /var/log/syslog（查看系统日志）。

六、环境变量配置日志级别

通过环境变量动态调整日志级别，无需修改代码即可适应不同环境（开发/测试/生产）。

示例：

const winston = require('winston');

const logger = winston.createLogger({
  level: process.env.LOG_LEVEL || 'info', // 默认info级别
  format: winston.format.json(),
  transports: [new winston.transports.Console()]
});

// 启动应用时设置环境变量
// 生产环境：LOG_LEVEL=error node app.js
// 开发环境：LOG_LEVEL=debug node app.js

优势：灵活控制日志详细程度，减少生产环境不必要的日志输出。

七、自定义日志存储路径

通过代码或配置文件指定日志存储位置，确保日志文件存放在合适目录（如/var/log）。

代码配置（Winston示例）：

const path = require('path');
const winston = require('winston');

const logger = winston.createLogger({
  transports: [
    new winston.transports.File({ 
      filename: path.join('/var/log', 'my-app', 'combined.log') // 绝对路径
    })
  ]
});

配置文件（config.json）：

{
  "logPath": "/var/log/my-app/app.log"
}

代码中读取：

const config = require('./config.json');
const logPath = path.resolve(__dirname, config.logPath);

注意事项：确保应用对日志目录有写入权限（如sudo chown -R nodeuser:nodegroup /var/log/my-app）。

以上方法覆盖了Debian系统下Node.js日志配置的主要场景，可根据应用规模、性能需求选择合适的方案。生产环境推荐使用Winston/Pino+PM2+logrotate组合，实现日志的结构化、持久化和高效管理。

一、基础日志记录：内置`console`模块

二、使用日志库：Winston/Pino（推荐）

1. Winston（功能全面）

2. Pino（高性能）

三、日志轮转：防止日志文件过大

四、进程管理：PM2集成日志

五、系统日志集成：Syslog

六、环境变量配置日志级别

七、自定义日志存储路径

最新问答

相关标签

Debian Node.js 日志如何配置

一、基础日志记录：内置console模块

二、使用日志库：Winston/Pino（推荐）

1. Winston（功能全面）

2. Pino（高性能）

三、日志轮转：防止日志文件过大

四、进程管理：PM2集成日志

五、系统日志集成：Syslog

六、环境变量配置日志级别

七、自定义日志存储路径

最新问答

相关标签

一、基础日志记录：内置`console`模块