prom/haproxy-exporter

HAProxy Exporter for Prometheus（已退役）

镜像概述和主要用途

HAProxy Exporter for Prometheus 是一个简单的服务，用于抓取 HAProxy 的统计数据（stats）并通过 HTTP 暴露，供 Prometheus 采集。注意：此导出器已退役，所有受支持版本的 HAProxy 均已内置 Prometheus 导出器模块，可在构建时通过单个标志集成到二进制文件中，并提供原生 Prometheus 端点。建议尽快迁移至 HAProxy 内置支持。

核心功能和特性

• 多源数据抓取：支持通过 HTTP、HTTPS 或 Unix Socket 抓取 HAProxy stats 数据
• 认证支持：兼容 HAProxy stats 接口的基本认证（Basic Auth）
• 安全配置：支持 HTTPS 抓取时的证书验证控制，可禁用 SSL 验证
• 代理支持：可通过环境变量（$http_proxy/$https_proxy/$no_proxy）配置 HTTP 代理
• 扩展功能：支持通过配置文件启用 TLS 和基本认证保护导出器自身端点

使用场景和适用范围

该导出器原本适用于需要将 HAProxy 运行指标（如连接数、请求量、健康状态等）导出至 Prometheus 进行监控的场景。但由于 HAProxy 官方已在 2.0.0 及以上版本内置 Prometheus 导出功能，此独立导出器已停止维护。仅推荐在无法升级 HAProxy 或临时过渡场景下使用，长期应迁移至官方内置方案。

详细使用方法和配置说明

基本运行方式

通过命令行启动导出器，核心配置通过标志（flags）指定：

bash
./haproxy_exporter [flags]

查看所有可用标志：

bash
./haproxy_exporter --help

核心配置参数

配置示例

1. HTTP Stats URL 抓取

若 HAProxy stats 接口路径为 /baz（非默认）：

bash
haproxy_exporter --haproxy.scrape-uri="http://localhost:5000/baz?stats;csv"

抓取远程 HAProxy 实例：

bash
haproxy_exporter --haproxy.scrape-uri="http://haproxy.example.com/haproxy?stats;csv"

2. 带基本认证的 Stats 接口

若 stats 接口受基本认证保护，可在 URI 中包含凭据：

bash
haproxy_exporter --haproxy.scrape-uri="http://user:pass@haproxy.example.com/haproxy?stats;csv"

为避免凭据暴露在进程列表中，可通过文件传递参数：

bash
echo '--haproxy.scrape-uri=http://user:pass@haproxy.example.com/haproxy?stats;csv' > args
haproxy_exporter @args

3. HTTPS 抓取

抓取 HTTPS 接口，禁用证书验证（仅测试环境使用）：

bash
haproxy_exporter --no-haproxy.ssl-verify --haproxy.scrape-uri="https://haproxy.example.com/haproxy?stats;csv"

4. 通过代理抓取远程 HAProxy

设置环境变量并启用代理支持：

bash
export HTTP_PROXY="http://proxy:3128"
haproxy_exporter --http.proxy-from-env --haproxy.scrape-uri="http://haproxy.example.com/haproxy?stats;csv"

5. Unix Socket 抓取

若 HAProxy 配置了 Unix Socket stats 接口（如 /run/haproxy/admin.sock）：

bash
haproxy_exporter --haproxy.scrape-uri=unix:/run/haproxy/admin.sock

Docker 部署

通过 Docker 容器运行导出器（镜像托管于 Quay 和 Docker Hub）：

bash
docker run -p 9101:9101 quay.io/prometheus/haproxy-exporter:latest \
  --haproxy.scrape-uri="http://user:pass@haproxy.example.com/haproxy?stats;csv"

注：容器默认暴露 9101 端口，需映射至主机端口以提供 Prometheus 采集。

TLS 和基本认证

导出器支持通过配置文件启用 TLS 和基本认证，需通过 --web.config.file 指定配置文件路径，配置格式参考 https://github.com/prometheus/exporter-toolkit/blob/master/docs/web-configuration.md%E3%80%82

替代方案：HAProxy 内置 Prometheus 导出器

构建带 Prometheus 支持的 HAProxy

HAProxy 2.0.0 及以上版本内置 Prometheus 导出模块，2.4 及以上版本可通过构建时添加 USE_PROMEX=1 标志启用：

bash
make TARGET=linux-glibc USE_PROMEX=1

预构建版本（如 https://hub.docker.com/_/haproxy%EF%BC%89%E9%80%9A%E5%B8%B8%E5%B7%B2%E9%BB%98%E8%AE%A4%E5%90%AF%E7%94%A8%E6%AD%A4%E5%8A%9F%E8%83%BD%E3%80%82

配置内置 Prometheus 端点

在 haproxy.cfg 中添加前端配置，暴露 /metrics 端点：

haproxy
frontend stats
    bind *:8404  # 暴露指标的端口
    http-request use-service prometheus-exporter if { path /metrics }  # Prometheus 指标端点
    stats enable  # 传统 stats 页面（可选）
    stats uri /stats  # 传统 stats 页面路径（可选）
    stats refresh 10s  # stats 页面刷新间隔（可选）

重启 HAProxy 后，访问 http://<haproxy-ip>:8404/metrics 即可获取 Prometheus 格式指标。

许可证

Apache License 2.0，详见 https://github.com/prometheus/haproxy_exporter/blob/main/LICENSE%E3%80%82