HAProxy 监控指标 exporters 怎么对接 Prometheus？

HAProxy 对接 Prometheus 主要有两种方案：使用 HAProxy 2.0 及以上版本自带的 Prometheus Exporter 功能，或通过独立的 haproxy_exporter 采集 stats socket 数据。推荐优先使用 HAProxy 原生导出功能，减少组件依赖和维护成本。

先说结论：HAProxy 2.0+ 版本建议直接启用原生 prometheus-exporter 监听模块，旧版本需部署独立 exporter 程序对接 stats socket。

适合：生产环境负载均衡监控、需要实时获取后端服务器健康状态和请求量的场景。
先准备：确认 HAProxy 版本不低于 2.0，规划监控端口防火墙策略，准备 Prometheus scrape 配置。
验收：Prometheus Target 状态显示 UP，Grafana 面板能正常渲染 HAProxy 后端服务器健康状态和并发连接数。

命令速用版

以下是 HAProxy 原生导出配置和 Prometheus 抓取配置的核心片段，可直接参考修改。

# HAProxy 配置片段 (haproxy.cfg)
listen prometheus-exporter
    bind *:8404
    mode http
    monitor-uri /metrics

# Prometheus 配置片段 (prometheus.yml)
scrape_configs:
  - job_name: 'haproxy'
    static_configs:
      - targets: ['<haproxy_ip>:8404']
    metrics_path: /metrics

为什么会这样

Prometheus 采用 Pull 模型拉取指标，HAProxy 需要暴露一个 HTTP 接口供其抓取。HAProxy 2.0 之前版本不支持原生 HTTP 指标输出，必须通过外部 exporter 读取 stats socket 并转换为 Prometheus 格式；2.0 版本后内置了 prometheus-exporter 模块，可直接在配置文件中定义监听端口和 URI，简化了架构。

分步处理

按照以下顺序完成配置，每步完成后建议检查语法或连通性，避免服务中断。

第一步：确认 HAProxy 版本
执行命令 haproxy -v 查看版本信息。如果版本低于 2.0，需下载 prometheus-community/haproxy_exporter 二进制文件并配置 systemd 服务，指向 HAProxy stats socket 路径。

第二步：配置 HAProxy 原生导出
在 haproxy.cfg 中添加 listen prometheus-exporter 段落，绑定端口（如 8404），设置 monitor-uri /metrics。确保该监听段落不包含业务流量 ACL，仅用于监控。

第三步：配置 Prometheus 抓取
在 Prometheus 配置文件的 scrape_configs 中添加新 job，targets 填写 HAProxy 服务器 IP 和导出端口，metrics_path 设置为 /metrics。

第四步：重载服务
执行 haproxy -c -f /etc/haproxy/haproxy.cfg 检查配置语法。确认无误后执行 systemctl reload haproxy 和 systemctl reload prometheus 使配置生效。

怎么验证是否生效

通过命令行和 Prometheus 界面双重验证，确保指标可达且数据准确。

1. 命令行 curl 测试
在 Prometheus 服务器或同网段机器执行 curl http://<haproxy_ip>:8404/metrics。如果返回包含 haproxy_ 前缀的指标文本，说明 HAProxy 导出正常。

2. Prometheus Target 状态
登录 Prometheus Web UI，进入 Status -> Targets 页面。找到 haproxy job，确认 State 列为 UP，且 Last Scraped 时间在最近几秒内。

3. 指标查询验证
在 Prometheus Graph 页面输入查询语句 haproxy_backend_up。如果返回后端服务器状态数据（1 表示 up，0 表示 down），说明指标采集完整。

常见坑

配置过程中容易遇到网络拦截、权限不足或指标基数过大的问题，需提前规避。

防火墙拦截：HAProxy 监控端口（如 8404）默认可能未开放。需在安全组或 iptables 中允许 Prometheus 服务器 IP 访问该端口，避免 Target 状态显示 DOWN。

ACL 权限限制：如果 HAProxy 配置了严格的访问控制，需确保监控 URI /metrics 不被业务 ACL 拒绝。建议在 listen 段落单独配置 monitor-uri，不继承全局 ACL。

指标基数爆炸：开启所有统计选项可能导致指标数量过多。建议仅在需要的 backend 或 frontend 开启详细统计，避免 Prometheus 存储压力过大。

常见问题

HAProxy 1.8 版本能直接对接 Prometheus 吗？

不能直接对接，需使用外部 exporter。HAProxy 1.8 版本不支持原生 prometheus-exporter 模块，必须部署独立的 haproxy_exporter 程序，通过 Unix Socket 或 TCP Socket 读取 HAProxy stats 数据并转换格式。

监控端口暴露在外网有风险吗？

有风险，建议限制访问来源。HAProxy 监控接口可能泄露后端服务器 IP 和负载情况。应在防火墙层面仅允许内网 Prometheus 服务器访问，或通过 HAProxy ACL 限制允许访问 /metrics 的源 IP 段。

开启监控会影响 HAProxy 性能吗？

影响极小，通常可忽略。原生导出功能仅在 Prometheus 发起请求时生成指标数据，不开启持续推送。公开资料中没有看到可靠的量化数据表明会对高并发场景产生显著性能损耗，但建议在生产前进行压测验证。

参考来源

HAProxy Documentation, "Prometheus exporter", https://www.haproxy.com/documentation/haproxy-configuration-manual/latest/#prometheus-exporter
Prometheus Community, "haproxy_exporter", https://github.com/prometheus-community/haproxy_exporter
DigitalOcean, "How To Configure Prometheus to Monitor HAProxy", https://www.digitalocean.com/community/tutorials/how-to-configure-prometheus-to-monitor-haproxy