如何通过 Debian Node.js 日志监控应用状态

如何通过 Debian 系统监控 Node.js 应用状态（聚焦日志管理）

在 Debian 环境中，通过日志监控掌握 Node.js 应用的运行状态（如错误发生、请求响应、资源使用），需结合日志收集、实时查看、分析与告警等环节。以下是具体方法：

一、基础准备：配置 Node.js 应用日志输出

要让日志可监控，需先确保应用将日志输出到标准输出（stdout）/标准错误（stderr）或文件（便于后续工具捕获）。

使用日志库（推荐）：通过 winston 或 morgan 等库实现结构化日志记录（如 JSON 格式），支持日志分级（info/warn/error）、文件轮转等功能。
示例（winston 配置）：

const winston = require('winston');
const logger = winston.createLogger({
  level: 'info',
  format: winston.format.json(), // 结构化日志（便于后续分析）
  transports: [
    new winston.transports.Console(), // 输出到控制台
    new winston.transports.File({ filename: 'logs/error.log', level: 'error' }), // 错误日志单独存储
    new winston.transports.File({ filename: 'logs/combined.log' }) // 所有日志汇总
  ]
});
logger.info('Server started on port 3000'); // 记录正常日志
logger.error('Database connection failed'); // 记录错误日志

直接输出到 stdout/stderr：若未使用日志库，可通过 console.log() 或 console.error() 输出，systemd 会自动捕获这些日志。

二、通过 Systemd 管理 Node.js 服务并查看日志

将 Node.js 应用配置为 systemd 服务，可实现后台运行、自动重启及日志集中管理（通过 journalctl 命令查看）。

创建 systemd 服务文件：
在 /etc/systemd/system/ 下创建文件（如 my-nodejs-app.service），内容如下：

[Unit]
Description=My Node.js Application
After=network.target

[Service]
User=your-debian-user  # 替换为实际用户（避免使用 root）
WorkingDirectory=/path/to/your/app  # 应用代码目录
ExecStart=/usr/bin/node /path/to/your/app/app.js  # 启动命令
Restart=always  # 崩溃后自动重启
Environment=NODE_ENV=production  # 生产环境
StandardOutput=syslog  # 标准输出重定向到 syslog
StandardError=syslog   # 标准错误重定向到 syslog
SyslogIdentifier=my-nodejs-app  # 日志标识（用于 journalctl 筛选）

[Install]
WantedBy=multi-user.target

启动服务并设置开机自启：

sudo systemctl daemon-reload  # 重新加载 systemd 配置
sudo systemctl start my-nodejs-app  # 启动服务
sudo systemctl enable my-nodejs-app  # 开机自启

查看应用日志：

sudo journalctl -u my-nodejs-app -f  # 实时查看该服务的日志（-f 表示 follow）
sudo journalctl -u my-nodejs-app --since "2025-10-01" --until "2025-10-07"  # 查看指定时间段的日志

日志会包含应用输出的 console.log/console.error 内容，以及 systemd 的服务状态信息（如启动/停止时间）。

三、使用 PM2 进行进程管理与日志监控

PM2 是 Node.js 生态中常用的进程管理工具，内置日志管理功能，适合生产环境使用。

安装与启动应用：

sudo npm install pm2 -g  # 全局安装 PM2
pm2 start app.js --name "my-app"  # 启动应用并命名（便于管理）

查看应用状态：

pm2 list  # 列出所有 PM2 管理的应用（显示状态、CPU/内存使用率）

查看与实时监控日志：

pm2 logs my-app  # 查看指定应用的日志（合并 stdout/stderr）
pm2 logs my-app --lines 100  # 查看最近 100 行日志
pm2 monit  # 实时监控应用状态（包括日志流、CPU/内存使用率）

日志轮转（防止日志过大）：
PM2 支持自动轮转日志，通过以下命令设置：

pm2 install pm2-logrotate  # 安装日志轮转插件
pm2 set pm2-logrotate:max_size 10M  # 单个日志文件最大 10MB
pm2 set pm2-logrotate:retain 7  # 保留最近 7 天日志

四、日志分析与告警

为了从日志中提取有价值信息（如错误频率、请求延迟），需借助日志分析工具，并在检测到异常时触发告警。

ELK Stack（Elasticsearch + Logstash + Kibana）：
适合大规模日志集中管理。通过 winston-elasticsearch 或 logstash 将 Node.js 日志发送到 Elasticsearch，再用 Kibana 可视化分析（如错误日志趋势、请求响应时间分布）。
Graylog：
开源集中日志管理工具，支持日志收集、搜索、告警。配置 Node.js 应用将日志发送到 Graylog（通过 GELF 格式），可实现实时监控与告警规则设置（如“1 分钟内出现 5 次 error 日志则发送邮件”）。

简单告警（grep + 邮件）：
若无需复杂分析，可通过 grep 过滤错误日志，并用 mail 命令发送告警：

# 监控 error.log 文件，发现新错误时发送邮件
tail -f /path/to/your/logs/error.log | grep --line-buffered "ERROR" | while read line; do
  echo "$line" | mail -s "Node.js Error Alert" your-email@example.com
done

五、辅助工具：实时查看日志

tail -f：基础命令行工具，实时查看日志文件末尾内容（如 tail -f /path/to/app.log）。
watch：定期执行命令（如 watch -n 2 tail -f /path/to/app.log，每 2 秒刷新一次日志）。
less：分页查看日志，结合 tail -f 实现实时查看（如 tail -f /path/to/app.log | less）。

通过以上方法，可在 Debian 系统中实现对 Node.js 应用状态的日志监控，覆盖从日志收集到分析告警的全流程。根据应用规模（如小型应用用 PM2+journalctl，大型应用用 ELK），选择合适的工具组合即可。