Ubuntu Node.js日志如何设置报警机制

Ubuntu 上 Node.js 日志报警机制落地指南

一方案总览与选型

轻量快速：使用 PM2 的日志流与进程守护，配合简单的 shell 规则做关键词告警，适合单机或少量实例。
集中化与可视化：采用 ELK（Elasticsearch + Logstash + Kibana） 或 Graylog 收集与检索日志，在 Kibana/Graylog 中配置阈值与通知规则，适合多服务、多主机。
指标与异常联动：在 Node.js 暴露 Prometheus 指标，用 Grafana 做阈值/异常检测告警，同时保留日志用于根因分析。
异常追踪平台：接入 Sentry 捕获未处理异常并配置告警，适合前端/全栈与后端错误快速响应。

二方案一 PM2 日志关键词告警（轻量）

安装与启动
- 安装：sudo npm i -g pm2
- 启动：pm2 start app.js --name my-api
实时查看与过滤
- 实时日志：pm2 logs my-api
- 过滤错误：pm2 logs my-api --raw | grep --line-buffered ‘ERROR’

简单告警脚本（systemd 或 cron 定时）

示例脚本 check-pm2-errors.sh

#!/usr/bin/env bash
LOG=$(pm2 logs my-api --raw --since 5m 2>&1)
if echo "$LOG" | grep --quiet 'ERROR'; then
  echo "[$(date)] ERROR found, sending alert" | mail -s "PM2 Node.js ERROR" ops@example.com
  # 也可替换为 curl 调用企业微信/钉钉/Slack Webhook
fi

赋权并加入定时：chmod +x check-pm2-errors.sh；在 crontab -e 加入
```
*/5 * * * * /path/check-pm2-errors.sh >> /var/log/pm2-alert.log 2>&1
```

适用场景：快速上线、无中心化日志平台时的临时或低成本告警。

三方案二集中化日志平台 ELK 或 Graylog（推荐）

日志采集与解析
- 应用侧使用 winston/pino/morgan 输出结构化日志（JSON），便于检索与聚合。
- 使用 rsyslog/syslog-ng 或 Filebeat 将日志发往 Logstash/Graylog；也可由应用直接写入 Syslog。

Logstash 示例（文件输入）

input {
  file {
    path => "/var/log/nodejs/*.log"
    start_position => "beginning"
    codec => json
  }
}
filter {
  # 可添加 grok/date 解析
}
output {
  elasticsearch {
    hosts => ["localhost:9200"]
    index => "nodejs-logs-%{+YYYY.MM.dd}"
  }
}

告警配置
- Kibana：在 Stack Management > Rules and Alerts 中创建规则，例如“过去 5 分钟 内 message 包含 ERROR 的次数 > 0”，通过 Email/Slack/Webhook 通知。
- Graylog：在 Alerts 中定义条件（如字段 level:ERROR 的计数阈值），绑定通知方式。
运维要点
- 日志轮转：使用 logrotate 管理文件大小与保留期，避免磁盘被占满。
- 远程集中：通过 Syslog/UDP/TCP 或 Filebeat 将多机日志汇聚到中心集群。

四方案三 Prometheus Grafana 指标告警与日志联动

Node.js 暴露指标

安装 prom-client，添加 Histogram 记录请求时延，暴露 /metrics 端点。

示例：

const client = require('prom-client');
const httpRequestDuration = new client.Histogram({
  name: 'http_request_duration_seconds',
  help: 'Duration of HTTP requests in seconds',
  labelNames: ['method','route','code'],
  buckets: [0.01,0.05,0.1,0.5,1,2,5]
});
app.use((req,res,next)=>{
  const start=Date.now();
  res.on('finish',()=>{
    httpRequestDuration.labels(req.method,req.route?.path||'unknown',res.statusCode)
      .observe((Date.now()-start)/1000);
  });
  next();
});
app.get('/metrics', async (_,res)=>{
  res.set('Content-Type', client.register.contentType);
  res.end(await client.register.metrics());
});

告警规则（Prometheus）

groups:
- name: nodejs
  rules:
  - alert: HighErrorRate
    expr: sum(rate(http_request_duration_seconds_count{code=~"5.."}[5m])) / sum(rate(http_request_duration_seconds_count[5m])) > 0.01
    for: 5m
    labels:
      severity: page
    annotations:
      summary: High 5xx error rate on {{ $labels.instance }}

通知与联动
- Grafana Alerting 或 Alertmanager 配置 Email/Slack/Webhook 通知。
- 在告警中附带日志查询链接（如 Kibana Discover 链接），实现“指标告警 → 日志定位”的闭环。

五方案四异常追踪平台 Sentry（错误类告警）

快速接入

安装：npm i @sentry/node

初始化（入口文件）：

const Sentry = require('@sentry/node');
Sentry.init({ dsn: 'YOUR_SENTRY_DSN', environment: 'production' });

告警配置
- 在 Sentry → Alerts 中创建规则，如“新错误出现”“错误率超过阈值”“每 5 分钟 重复次数 > N”，通过 Email/Slack/Webhook 通知。
适用场景：未捕获异常、Promise 异常、前端/后端错误快速发现与定位。

最新问答

相关标签