Debian JS 日志级别设置指南

Debian 环境下 JavaScript 日志级别设置指南

一 前置说明

• 在 Debian 上，日志级别通常由 Node.js 应用或所用日志库控制；前端浏览器 JavaScript 的日志受浏览器/前端框架控制，服务端无法统一设置。
• 常见日志级别顺序为：error < warn < info < debug（数值越大输出越详细）。
• 建议通过环境变量或配置文件管理级别，便于不同环境快速切换，无需改代码。

二 快速上手 Node.js 内置日志

• 使用内置 console 区分级别，并通过环境变量控制输出：

// 级别映射：数值越大越详细
const levels = {
 error: 0, warn: 1, info: 2, debug: 3 }
    ;
    
const current = levels[process.env.LOG_LEVEL || 'info'];


function log(level, msg) {
    
  if (levels[level] >
    = current) console[level](msg);

}
    

log('info', '服务已启动');
    
log('debug', '调试信息');
     // 仅在 LOG_LEVEL=debug 时输出

• 启动示例：

LOG_LEVEL=debug node app.js

• 说明：内置 console 简单直接，适合小型项目或快速验证。

三 使用日志库 Winston 与 Pino

• Winston（多传输、结构化日志）

// npm i winston
const winston = require('winston');


const logger = winston.createLogger({

  level: process.env.LOG_LEVEL || 'info',
  format: winston.format.json(),
  transports: [
    new winston.transports.Console(),
    new winston.transports.File({
 filename: 'error.log', level: 'error' }
),
    new winston.transports.File({
 filename: 'combined.log' }
)
  ]
}
    );


logger.info('应用启动', {
 pid: process.pid }
    );

logger.error('发生错误', {
 err: new Error('boom') }
    );
    

• Pino（高性能、低开销）

// npm i pino
const pino = require('pino');


const logger = pino({
 level: process.env.LOG_LEVEL || 'info' }
    );
    
logger.info('应用启动');

logger.error({
 err: new Error('boom') }
    , '发生错误');
    

• 要点：将 level 绑定到 process.env.LOG_LEVEL，生产常用 info，排障切 debug。

四 框架与中间件日志

• Express + Morgan（HTTP 请求日志）

// npm i express morgan
const express = require('express');
    
const morgan = require('morgan');
    
const app = express();
    

// 开发：简洁；生产：combined（更详细）
app.use(morgan(process.env.NODE_ENV === 'development' ? 'dev' : 'combined'));
    

app.get('/', (req, res) =>
     res.send('Hello World'));
    
app.listen(3000, () =>
     console.log('Server on :3000'));

• 说明：Morgan 负责 HTTP 访问日志，通常与业务日志库配合使用。

五 运行环境与进程管理

• 环境变量方式（通用）

# 临时
LOG_LEVEL=debug node app.js

# 持久（当前会话）
export LOG_LEVEL=debug
node app.js

• PM2 管理（多环境配置）

// ecosystem.config.js
module.exports = {

  apps: [{

    name: 'my-app',
    script: 'app.js',
    env: {

      NODE_ENV: 'development',
      LOG_LEVEL: 'debug'
    }
,
    env_production: {

      NODE_ENV: 'production',
      LOG_LEVEL: 'info'
    }

  }
]
}
    ;

启动：

pm2 start ecosystem.config.js --env production

• Nginx 访问日志级别（仅影响 Nginx 自身访问日志，不影响 Node.js）

http {
    
  log_level info;
   # 可选：debug | info | notice | warn | error
  server {
 ... }

}

# 修改后执行：sudo systemctl restart nginx

• 配置文件方式（示例）

{

  "logging": {
 "level": "debug" }

}
    

读取：

const config = require('config');
    
const level = config.get('logging.level') || 'info';
    

• 建议：生产用 info，排障切 debug；变更后重启应用生效。

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