haproxy 2.6+ 通过内置 stats 接口启用 format prometheus 可直接暴露 scur、slim、qcur、bin/bout 等并发指标,配合 prometheus 抓取实现可视化监控,无需额外 exporter。

HAProxy 本身不直接提供 Prometheus 原生指标格式,但可通过内置的 stats 接口 或 stats socket 暴露关键并发类指标,再配合 Prometheus 抓取实现可视化监控。核心目标是获取并持续观测如 scur(当前会话数)、slim(会话上限)、qcur(当前队列请求数)、bin/bout(吞吐带宽)等实时并发指标。
启用 HAProxy 的 stats HTTP 接口(推荐)
这是最简单、安全可控且便于 Prometheus 直接抓取的方式:
- 在
/etc/haproxy/haproxy.cfg的global或defaults块后添加一个专用 frontend:
frontend stats
bind *:8404
mode http
stats enable
stats uri /metrics
stats refresh 10s
stats show-legends
stats auth admin:prom2026 # 建议设强密码,或后续用 Nginx 做反向代理+ Basic Auth
stats hide-version
- 重启 HAProxy:
sudo systemctl reload haproxy - 访问
http://<haproxy-ip>:8404/metrics</haproxy-ip>,你将看到类似 Prometheus 格式的文本输出(含haproxy_frontend_scur、haproxy_backend_qcur等自动转换指标)——这是 HAProxy 2.6+ 内置支持的format prometheus特性,无需额外 Exporter。
配置 Prometheus 抓取并发指标
确保 Prometheus 能定期拉取上述接口:
安装并运行 Aperture(Lightning Labs 的 L402 闪电反向代理),用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。
- 编辑
prometheus.yml,添加 job:
scrape_configs:
- job_name: 'haproxy-concurrent'
static_configs:
- targets: ['haproxy-server:8404']
metrics_path: '/metrics'
params:
format: ['prometheus']
- 重启 Prometheus 后,在表达式浏览器中可直接查:
-
haproxy_frontend_scur{frontend="www"}—— 当前前端活跃连接数 -
haproxy_backend_qcur{backend="api_servers"}—— 后端当前排队请求数 -
rate(haproxy_frontend_bin_bytes_total[1m])—— 入向字节速率(反映并发吞吐压力)
关键并发指标含义与告警建议
以下指标直接影响服务容量和稳定性,需重点盯控:
-
scur(当前会话):实时并发连接数。持续接近slim(会话上限)说明容量逼近瓶颈;建议设置告警:haproxy_frontend_scur / haproxy_frontend_slim > 0.85 -
qcur(当前队列):请求等待转发的队列长度。非零值即存在排队,> 0 持续 30 秒应触发预警,反映后端处理慢或过载 -
ereq(请求错误) +hrsp_5xx:结合并发突增时的错误率上升,可快速定位是否因连接挤压导致拒绝服务 -
bin/bout增长趋势:配合rate()观察带宽使用率,避免网卡或 TCP 栈打满
进阶:用 socat + textfile 替代方案(兼容旧版 HAProxy)
若 HAProxy 版本
- 写定时脚本(如每 10 秒执行):
echo "show stat" | socat unix:/var/run/haproxy.sock stdio 2>/dev/null | \
awk -F',' '$1!="" && $2!="" && $3!="" {print "haproxy_server_current_sessions{pxname=\""$2"\",svname=\""$3"\"} "$4}' \
> /var/lib/node_exporter/haproxy.prom
- 启用 Node Exporter 的 textfile collector,Prometheus 即可采集
haproxy_server_current_sessions等自定义指标










