如何在Ubuntu上配置Node.js日志管理

在Ubuntu上配置Node.js日志管理
日志管理是Node.js应用生产环境运行的关键环节，能有效监控应用状态、快速定位问题并优化性能。以下是Ubuntu系统下配置Node.js日志管理的具体方法，涵盖基础日志输出、第三方库增强、日志轮转、进程管理及集中式管理等方面。

一、基础日志输出：使用内置`console`模块

Node.js内置的console模块是最简单的日志记录方式，适合开发或调试阶段。通过console.log()输出普通信息，console.error()输出错误信息，日志直接显示在终端或应用日志文件中（若重定向了标准输出/错误）。
示例代码：

const express = require('express');
const app = express();

app.get('/', (req, res) => {
  console.log('Received request at /'); // 普通信息
  res.send('Hello World!');
});

app.listen(3000, () => {
  console.log('Server running on port 3000'); // 启动信息
});

局限性：缺乏日志级别控制、格式化功能和持久化存储，不适合生产环境。

二、使用第三方日志库增强功能

第三方日志库提供更完善的日志管理能力，推荐以下常用库：

1. Winston：功能全面的日志库

Winston支持多传输方式（控制台、文件、HTTP等）、日志级别（trace/debug/info/warn/error/fatal）和格式化（JSON/文本），是当前最流行的选择。
安装：npm install winston
配置示例：

const winston = require('winston');
const logger = winston.createLogger({
  level: 'info', // 最低日志级别
  format: winston.format.json(), // 结构化日志（便于后续分析）
  transports: [
    new winston.transports.File({ filename: 'logs/error.log', level: 'error' }), // 错误日志单独存储
    new winston.transports.File({ filename: 'logs/combined.log' }), // 所有日志合并
    new winston.transports.Console({ format: winston.format.simple() }) // 开发环境输出到控制台
  ]
});

// 使用示例
logger.info('Server started on port 3000');
logger.error('Database connection failed');

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

2. Bunyan：结构化JSON日志库

Bunyan输出结构化JSON日志，便于与日志分析工具（如ELK）集成，适合大型应用。
安装：npm install bunyan
配置示例：

const bunyan = require('bunyan');
const logger = bunyan.createLogger({
  name: 'my-app', // 应用名称（日志中标识）
  level: 'info',
  streams: [
    { level: 'info', stream: process.stdout }, // 控制台输出
    { level: 'error', path: 'logs/app-error.log' } // 错误日志写入文件
  ]
});

// 使用示例
logger.info('User logged in', { userId: 123 }); // 带附加字段的结构化日志
logger.error('Invalid request', { requestId: 'abc123', error: 'Invalid input' });

优势：日志格式统一，便于自动化处理。

三、配置日志轮转（避免文件过大）

当日志文件过大时，需通过轮转分割日志，推荐使用logrotate（Ubuntu系统自带）。

1. 安装与配置logrotate

创建针对Node.js应用的配置文件（如/etc/logrotate.d/nodejs-app），内容如下：

/var/log/nodejs/*.log { # 匹配Node.js日志路径（需替换为实际路径）
  daily                # 每天轮转
  missingok            # 日志不存在时不报错
  rotate 7             # 保留最近7份日志
  compress             # 压缩旧日志（.gz格式）
  notifempty           # 日志为空时不轮转
  create 0640 root adm # 新日志文件权限和所有者
}

验证配置：手动触发轮转（测试是否生效）：

sudo logrotate -f /etc/logrotate.d/nodejs-app

2. 使用Winston的DailyRotateFile传输

若不想依赖系统工具，可在Winston中直接配置日志轮转：

const winston = require('winston');
require('winston-daily-rotate-file'); // 需额外安装

const transport = new winston.transports.DailyRotateFile({
  filename: 'logs/application-%DATE%.log', // 日志文件名（含日期）
  datePattern: 'YYYY-MM-DD',                 // 日期格式
  zippedArchive: true,                       // 压缩旧日志
  maxSize: '20m',                            // 单个日志文件最大20MB
  maxFiles: '14d'                            // 保留14天日志
});

const logger = winston.createLogger({
  transports: [transport]
});

优势：无需系统配置，直接在应用中管理。

四、使用PM2进行进程与日志管理

PM2是Node.js进程管理工具，内置日志管理功能，适合生产环境部署。

1. 安装与启动应用

sudo npm install pm2 -g  # 全局安装PM2
pm2 start app.js --name my-app  # 启动应用并命名

2. 日志查看与轮转

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

配置日志轮转：创建ecosystem.config.js文件，内容如下：

module.exports = {
  apps: [{
    name: 'my-app',
    script: 'app.js',
    log_date_format: 'YYYY-MM-DD HH:mm:ss', // 日志时间格式
    out_file: './logs/out.log',              // 标准输出日志路径
    error_file: './logs/err.log',            // 错误输出日志路径
    merge_logs: true,                        // 合并日志（可选）
    log_rotation: true,                      // 启用日志轮转
    log_rotation_interval: '1d',             // 每天轮转
    log_rotation_size: '10M'                 // 单个文件最大10MB
  }]
};

启动应用：pm2 start ecosystem.config.js。

五、集中式日志管理（可选）

对于分布式系统，建议将日志发送到集中式平台（如ELK Stack、Splunk），实现统一搜索、分析和告警。以ELK为例：

安装Elasticsearch、Logstash、Kibana（参考官方文档）。
配置Logstash接收Node.js日志：创建logstash.conf文件，添加Node.js输入插件（如TCP/UDP）和Elasticsearch输出插件。

Node.js应用发送日志到Logstash：使用winston-logstash库将日志发送到Logstash。

const winston = require('winston');
require('winston-logstash');

const logger = winston.createLogger({
  transports: [
    new winston.transports.Logstash({
      port: 5000,        // Logstash端口
      host: 'localhost', // Logstash主机
      node_name: 'my-app'
    })
  ]
});

优势：实现日志集中存储、实时分析和可视化，适合大规模应用。

通过以上方法，可在Ubuntu系统上实现Node.js日志的有效管理，满足开发调试、生产监控等不同场景的需求。根据应用规模和需求选择合适的工具组合（如Winston+logrotate、PM2+ELK），能显著提升日志管理的效率和可靠性。

0 赞

0 踩

一、基础日志输出：使用内置console模块