Node.js 应用如何在 Debian 上高效日志记录

在 Debian 系统上跑 Node.js 应用，日志记录这件事，看似简单，但一旦流量上来，或者需要排查线上问题，你就知道“随便写写”和“高效管理”之间的差距有多大。很多开发者最开始只是用 console.log 打几行输出，结果日志文件越滚越大，关键信息淹没在汪&洋大海里。今天我们就来聊一聊，在 Debian 环境下，如何把 Node.js 应用的日志管得既高效又省心。

1. 内置 console 模块：最轻量的起步方案

先从最基础的讲起。Node.js 自带的 console 模块其实已经够应付大部分小项目了。console.log、console.error、console.warn、console.info 分别对应不同级别的输出。如果你只是想简单地把日志存到文件里，自己封装一个函数就行，不用引入任何第三方依赖。

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

function log(message, level = 'info') {
    const timestamp = new Date().toISOString();
    const logEntry = `${timestamp} [${level}] ${message}\n`;
    fs.appendFile(logFile, logEntry, (err) => {
        if (err) console.error('Failed to write to log file:', err);
    });
}

log('This is an info message', 'info');
log('This is an error message', 'error');

注意，这个方案虽然简单，但性能一般，因为每次写文件都是异步追加。如果日志量很大，建议还是交给专门的日志库来处理。

2. 第三方日志库：灵活与性能的平衡

当应用规模变大，就需要更专业的工具了。这里重点介绍两个：winston 和 pino，它们各有各的强项。

使用 winston

winston 是社区里知名度最高的日志库之一，最大的亮点是传输方式（transport）极其灵活。你可以把错误级别的日志单独写到 error.log，把所有日志写到 combined.log，同时还在控制台输出一条简化版日志。配置起来非常直观：

const winston = require('winston');

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

logger.info('This is an info message');
logger.error('This is an error message');

这种“多通道”的设计，在排查问题时特别有用——你可以只看错误日志，也可以全局搜索所有日志。

使用 pino

如果你的应用对吞吐量要求很高，比如每秒要记录成千上万条日志，那么 pino 是更好的选择。它的设计哲学就是极致性能，JSON 序列化速度比 winston 快很多。配合 pino-pretty 在本地开发时做格式化输出，体验非常好：

const pino = require('pino');

const logger = pino({
    level: 'info',
    transport: {
        target: 'pino-pretty',
        options: { colorize: true },
    },
});

logger.info('This is an info message');
logger.error('This is an error message');

一句话总结：追求灵活性选 winston，追求极致性能选 pino。

3. 日志轮转：防止磁盘爆炸

无论用哪种方式写日志，如果不做轮转，日志文件会随着时间无限膨胀，最后撑爆磁盘。Linux 系统自带的 logrotate 就是干这个的，而且它和 Node.js 应用配合得天衣无缝。

安装 logrotate：

sudo apt-get install logrotate

然后为你的 Node.js 应用创建一个配置文件，比如 /etc/logrotate.d/nodejs-app：

/path/to/your/nodejs-app/*.log {
    daily
    missingok
    rotate 7
    compress
    notifempty
    create 0640 root adm
}

这个配置的意思很直白：每天轮转一次，保留最近 7 天的日志，旧的自动压缩，如果日志为空就不轮转。这样一来，日志管理完全交给系统，应用层只需要关心怎么写日志就好。

4. 监控与报警：让日志说话

日志不只是用来事后翻看的，更要能实时反映应用的健康状况。结合 Prometheus 和 Grafana，你可以把日志中的关键指标抽取出来，比如错误率、请求延迟等，做成可视化的仪表盘，甚至在异常时触发报警。

部署步骤很简单：

1. 安装 Prometheus 和 Grafana：

sudo apt-get install prometheus grafana

2. 配置 Prometheus 抓取 Node.js 应用的指标（需要应用暴露 metrics 端点）。
3. 在 Grafana 中创建仪表盘，把日志数据转化为图表。

这套组合拳打下来，你的日志系统就不再是“死”的文本文件，而是变成了活生生的监控工具。

总结

在 Debian 上为 Node.js 应用做日志管理，其实是一套组合方案：console 模块可以应付极简场景，winston 和 pino 提供了专业级的能力，logrotate 负责维护磁盘空间，Prometheus 和 Grafana 则让日志发挥更大的价值。从简单到复杂，从小项目到大流量，这套思路可以平滑扩展，关键是——别等到出了问题才想起来日志没管好。