如何配置 Debian Node.js 日志记录

在Debian系统上为Node.js应用搭建一套得心应手的日志系统，是确保应用稳定运行和问题排查的关键一步。具体怎么配，很大程度上取决于你的应用架构和你偏好的日志库。下面咱们就来聊聊几种主流方案和它们的配置要点。

从基础开始：使用内置的 `console` 模块

如果你的应用比较简单，直接用的就是Node.js自带的`console`模块来打日志，那么把日志输出到文件是最直接的升级。

首先，得有个地方存日志：

touch /var/log/myapp.log

接下来，在应用代码里动点手脚，把`console.log`和`console.error`的输出重定向到文件，同时最好带上时间戳，方便追溯：

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

const logFile = path.join(__dirname, 'logs', 'myapp.log');
const logStream = fs.createWriteStream(logFile, { flags: 'a' });

console.log = function(...args) {
  logStream.write(`${new Date().toISOString()} - ${args.join(' ')}\n`);
  process.stdout.write(`${args.join(' ')}\n`);
};

console.error = function(...args) {
  logStream.write(`${new Date().toISOString()} - ERROR - ${args.join(' ')}\n`);
  process.stderr.write(`${args.join(' ')}\n`);
};

这样一来，日志既会按格式写入文件，也会在终端显示，两不耽误。

进阶选择：拥抱第三方日志库

对于更复杂的生产级应用，社区里成熟的第三方日志库，比如`winston`或`pino`，能提供更强大的功能，像日志分级、多种输出格式和传输方式等。这里以`winston`为例。

第一步，先把它安装上：

npm install winston

然后，通常我们会单独创建一个日志配置文件（比如`logger.js`），让配置更清晰：

const winston = require('winston');

const logger = winston.createLogger({
  level: 'info',
  format: winston.format.json(),
  transports: [
    new winston.transports.File({ filename: '/var/log/myapp.log' }),
    new winston.transports.Console()
  ]
});

module.exports = logger;

配置好后，在应用的其他地方引入这个`logger`实例就能用了：

const logger = require('./logger');
logger.info('This is an info message');
logger.error('This is an error message');

与系统集成：对接 systemd 日志

如果你的Node.js应用是通过systemd管理的服务，那么把日志直接发送到systemd日志系统（journal）是个好主意，这样可以用`journalctl`命令统一查看和管理。

确保系统安装了`systemd-cat`工具：

sudo apt-get install systemd-cat

然后在应用代码中，可以创建一个子进程，通过`systemd-cat`来转发日志：

const { spawn } = require('child_process');
const logger = spawn('systemd-cat', ['-t', 'myapp']);

logger.stdin.write('This is an info message\n');
logger.stdin.write('This is an error message\n');
logger.stdin.end();

长治久安：设置日志轮转

日志文件可不能让它无限增长下去，否则迟早会撑满磁盘。这时候就需要日志轮转工具出场了，Linux下标配的就是`logrotate`。

先安装它：

sudo apt-get install logrotate

接着，为你的应用创建一个专属的配置文件，例如放在`/etc/logrotate.d/myapp`：

/var/log/myapp.log {
  daily
  missingok
  rotate 7
  compress
  notifempty
  create 640 root adm
}

这个配置的意思是：每天轮转一次，允许日志文件暂时缺失，保留最近7天的日志，对旧日志进行压缩，只在日志非空时轮转，并在创建新日志文件时设置好权限和属主。

好了，以上就是在Debian系统上为Node.js应用配置日志记录的几种核心路径。从简单的文件输出，到功能丰富的专业日志库，再到与系统服务深度集成，你可以根据项目的实际需求和复杂度，灵活选择和组合这些方案。