quay.io/prometheus/haproxy-exporter:v0.15.0

quay.io/prometheus/haproxy-exporter 是 Prometheus 官方维护的一款开源工具，专门用于监控 HAProxy 负载均衡器。作为 Prometheus 生态的重要组件，它的核心作用是从 HAProxy 实例中采集运行指标，并将这些数据转换为 Prometheus 可识别的格式，供后续存储、分析和告警使用。

核心功能与数据来源

该工具主要通过两种方式获取 HAProxy 数据：一是访问 HAProxy 内置的统计页面（通常通过 [***]），二是连接 HAProxy 的 Unix Socket 接口（需在 HAProxy 配置中启用 stats socket）。采集的指标覆盖 HAProxy 运行全链路，包括：

• 流量与连接：如当前活跃连接数、累计请求量、每秒请求数（RPS）；
• 健康状态：后端服务器的在线状态、响应时间、错误率（如 4xx/5xx 状态码占比）；
• 资源占用：HAProxy 进程的 CPU、内存使用率，以及后端服务的连接超时、重试次数等。

部署与配置特性

工具设计轻量，支持多种部署方式：

• 容器化部署：可直接通过 Docker 或 Kubernetes 拉取镜像运行，例如 docker run -p 9101:9101 quay.io/prometheus/haproxy-exporter --haproxy.scrape-uri=[***]；
• 二进制运行：从源码编译后生成可执行文件，通过命令行参数指定 HAProxy 地址、超时时间（默认 5 秒）、指标暴露端口（默认 9101）等。

配置上支持灵活定制，例如通过 --haproxy.timeout 调整采集超时，或用 --collector.metrics-filter 筛选关注的指标，减少数据冗余。

优势与适用场景

作为官方工具，它与 Prometheus、Grafana 等组件兼容性极佳，无需额外适配即可接入监控体系。运维团队可基于采集的数据快速搭建可视化面板，实时观察 HAProxy 流量波动、后端服务健康度，或通过 Prometheus Alertmanager 设置告警规则（如“后端服务错误率超过 5%”“连接数突增 200%”），及时发现负载均衡器或后端服务的异常。

此外，工具体积小巧（镜像约 20MB）、资源占用低，适合在生产环境长期运行，尤其适用于依赖 HAProxy 实现流量分发的业务场景，如 Web 服务集群、API 网关等。

使用注意事项

部署时需确保：

1. HAProxy 已开启统计功能（配置 stats enable），且 exporter 有权限访问统计页面或 Socket；
2. 若通过网络访问 HAProxy 统计页面，建议启用 Basic Auth 或 IP 白名单，避免敏感数据泄露；
3. 根据业务规模调整采集频率（默认 Prometheus 每 15 秒拉取一次），平衡监控精度与资源消耗。

总结

quay.io/prometheus/haproxy-exporter 以简单、可靠的特性，成为 HAProxy 监控的首选工具。通过它，运维人员能直观掌握负载均衡器的实时状态，为业务稳定性提供数据支撑，尤其适合与 Prometheus 生态结合，构建完整的监控告警闭环。