怎样自定义Ubuntu JS日志格式

怎样自定义Ubuntu JS日志格式
在Ubuntu系统中，自定义JavaScript（Node.js）应用程序的日志格式主要通过第三方日志库（如Winston、Morgan）实现，也可直接通过代码手动配置。以下是具体方法：

1. 使用Winston库（推荐，适用于大多数场景）

Winston是Node.js最流行的日志库之一，支持时间戳、日志级别、自定义消息格式、多传输目标（控制台、文件、数据库等），功能强大且灵活。

• 安装Winston：在项目目录下运行npm install winston。
• 配置自定义格式：创建logger.js文件，通过winston.format.combine组合多个格式化器（如时间戳、消息模板），并通过transports指定日志输出位置（控制台、文件）。示例如下：

  const {
   createLogger, format, transports }
       = require('winston');
  
  const logger = createLogger({
  
    level: 'info', // 设置最低日志级别（info及以上会输出）
    format: format.combine(
      format.timestamp({
   format: 'YYYY-MM-DD HH:mm:ss' }
  ), // 添加时间戳（格式可自定义）
      format.printf(({
   timestamp, level, message }
      ) =>
   {
   // 自定义日志输出模板
        return `[${
  timestamp}
  ] ${
  level.toUpperCase()}
  : ${
  message}
      `;
  
      }
  )
    ),
    transports: [
      new transports.Console(), // 输出到控制台
      new transports.File({
   filename: 'logs/error.log', level: 'error' }
  ), // 错误日志单独存文件
      new transports.File({
   filename: 'logs/combined.log' }
  ) // 所有日志存合并文件
    ]
  }
      );
      
  module.exports = logger;
      
  

• 在应用中使用：引入配置好的logger，调用对应方法记录日志（如logger.info('Hello, world.')、logger.error('Something went wrong.')）。运行应用后，日志将按自定义格式输出到控制台和指定文件。

2. 使用Morgan库（适用于Express.js HTTP请求日志）

若你的应用基于Express.js框架，可使用Morgan中间件快速记录HTTP请求日志（如请求方法、URL、状态码、响应时间），并自定义格式。

• 安装Morgan：运行npm install morgan。
• 配置自定义格式：在Express应用中，通过morgan.token定义自定义token（如请求路径、状态码），再用morgan函数生成自定义格式字符串。示例如下：

  const express = require('express');
      
  const morgan = require('morgan');
      
  const app = express();
      
  
  // 定义自定义token（获取请求方法、URL、状态码）
  morgan.token('customFormat', (req, res) =>
   {
  
    return `${
  req.method}
   ${
  req.originalUrl}
   - ${
  res.statusCode}
      `;
  
  }
      );
      
  
  // 使用自定义格式（格式为：方法 URL - 状态码）
  app.use(morgan(':customFormat'));
      
  
  // 示例路由
  app.get('/', (req, res) =>
   {
      
    res.send('Hello, world!');
  
  }
      );
      
  
  app.listen(3000, () =>
   {
      
    console.log('Server is running on port 3000');
  
  }
      );
      
  

• 效果：访问http://localhost:3000时，控制台将输出类似GET / - 200的日志（表示GET请求、路径/、状态码200）。

3. 直接通过代码手动配置（适合小型/快速原型）

若不想引入第三方库，可通过Node.js内置的fs模块手动写入日志文件，实现简单的格式化（时间戳+日志级别+消息）。

• 配置代码：创建logger.js文件，定义log函数，拼接时间戳、日志级别和消息，写入文件。示例如下：

  const fs = require('fs');
      
  const path = require('path');
  
  
  // 创建日志文件流（追加模式）
  const logStream = fs.createWriteStream(path.join(__dirname, 'logs/combined.log'), {
   flags: 'a' }
      );
  
  
  // 自定义log函数
  function log(level, message) {
      
    const timestamp = new Date().toISOString().replace('T', ' ').substring(0, 19);
   // 格式：YYYY-MM-DD HH:mm:ss
    const logEntry = `[${
  timestamp}
  ] ${
  level.toUpperCase()}
  : ${
  message}
      \n`;
       // 拼接日志条目
    logStream.write(logEntry);
       // 写入文件
    console.log(logEntry.trim());
   // 同时输出到控制台（可选）
  }
  
  
  module.exports = {
   log }
      ;
      
  

• 在应用中使用：引入log函数，调用时传入日志级别（如info、error）和消息（如log('info', 'Application started.')、log('error', 'Database connection failed.')）。日志将写入logs/combined.log文件和控制台。

注意事项

• 日志轮转：若日志文件过大，建议使用winston-daily-rotate-file等库实现按日期/大小分割日志，避免单个文件过大。
• 环境适配：通过环境变量（如process.env.NODE_ENV）控制日志级别（开发环境用debug，生产环境用info/error），提高日志管理的灵活性。
• 系统级日志：若需将日志集成到Ubuntu系统日志（如journalctl），可使用winston-systemd等库，或配置rsyslog（编辑/etc/rsyslog.conf），但这属于系统级配置，非JS应用本身的日志格式自定义。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！