如何配置 Nginx 监控后端服务器的 max_conns 限制触发告警-Nginx-PHP中文网

Nginx 无原生 max_conns 告警功能，需结合错误日志监控（如“upstream queue is full”）与外部监控系统（如 Prometheus + Alertmanager）采集 upstream server 连接数并设置阈值告警。

如何配置 nginx 监控后端服务器的 max_conns 限制触发告警

Nginx 本身不直接提供 max_conns 触发告警的内置机制，它没有“连接数超限就自动发邮件/调用 webhook”的原生告警能力。但你可以通过 监控 max_conns 的实际效果 + 外部监控系统联动，实现等效的“max_conns 触发告警”目标。核心逻辑是：当某个 upstream server 因达到 max_conns 被主动拒绝连接时，Nginx 会在 error log 中记录特定错误，并且该 server 的活跃连接数、失败计数等指标会出现可识别异常。

下面分三步说明如何落地：

查看 max_conns 是否生效及是否被触发

max_conns 是 upstream server 指令中的参数，用于限制单个后端节点同时处理的最大连接数（需配合 queue 指令才具备排队能力，否则直接拒绝）：

upstream backend {
    server 192.168.1.10:8080 max_conns=100;
    server 192.168.1.11:8080 max_conns=100;
}

⚠️ 注意：

max_conns 仅在 worker 进程内 统计本 worker 到该 server 的连接数，不是全局总连接数；
若未配置 queue，超出 max_conns 的请求会立即返回 503 Service Temporarily Unavailable；
若配置了 queue timeout=30s, 请求会排队等待，超时仍返回 503。

验证是否触发：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

检查 Nginx 错误日志中是否出现类似条目：
upstream queue is full while connecting to upstream
或
no live upstreams while connecting to upstream（当所有 server 都因 max_conns 拒绝且无备用时）
使用 curl -I http://your-domain/ 观察响应码是否偶发 503；
对应 server 的 nginx_status 中 Active connections 可能持续贴近 max_conns 值（需结合 stub_status + 自定义采集）。

采集关键指标用于告警判定

你需要从两个层面采集数据：

Nginx 内置状态（推荐启用 stub_status）
在某 location 暴露 /nginx_status，再用 Prometheus exporter（如 nginx-prometheus-exporter）或自定义脚本定期抓取。重点关注：
- Active connections（全局活跃连接）
- 各 upstream server 的连接分布（需 nginx-module-vts 或 OpenResty 的 lua-resty-upstream-healthcheck 才能细粒度获取单 server 连接数）
错误日志关键词监控（最直接有效）
使用 filebeat / fluentd / rsyslog 实时监听 /var/log/nginx/error.log，匹配：
- upstream queue is full
- no live upstreams
- connect() failed (110: Connection timed out) while connecting to upstream（可能关联连接打满）
  这些日志行出现频次突增，就是 max_conns 瓶颈已实际影响服务。

配置外部监控系统实现告警

以 Prometheus + Alertmanager 为例（主流且轻量）：

部署 nginx-prometheus-exporter，它能解析 stub_status 并暴露 nginx_upstream_server_active_connections 等指标；
编写告警规则（例如当某 server 连接数 > 95% max_conns 并持续 2 分钟）：

- alert: UpstreamServerMaxConnsExceeded
  expr: nginx_upstream_server_active_connections{upstream="backend", server="192.168.1.10:8080"} > 95
  for: 2m
  labels:
    severity: warning
  annotations:
    summary: "Upstream server {{ $labels.server }} near max_conns limit"