1. La page de statistiques native #
Une interface web légère pour surveiller vos serveurs.
Configuration du bloc Listen #
Il est recommandé d'écouter sur un port séparé et de sécuriser l'accès par mot de passe.
listen stats
bind *:8404
stats enable
stats uri /admin?stats
stats refresh 10s
stats auth admin:MonMotDePasse2. Intégration avec Prometheus #
Exposer les métriques pour une surveillance à long terme.
Utilisation du module prometheus-exporter #
Depuis la version 2.0, HAProxy peut exposer directement des métriques au format Prometheus sans agent tiers.
frontend stats
bind *:8405
http-request use-service prometheus-exporter if { path /metrics }3. OpenTelemetry dans HAProxy #
HAProxy s'intègre désormais au standard de l'industrie pour les traces et les métriques.
OpenTelemetry : état des lieux #
HAProxy 3.4 (juin 2026) apporte la prise en charge d'OpenTelemetry sous la forme d'un module complémentaire (un filtre compilé avec HAProxy, maintenu hors des sources principales). Il remplace le filtre OpenTracing, déprécié et retiré en 3.5. Il crée des spans pour les requêtes, propage le contexte W3C (traceparent) vers les backends et exporte en OTLP vers un collecteur (OpenTelemetry Collector, Grafana Alloy) puis vers Jaeger, Tempo ou tout autre outil.
Le module n'est pas compilé dans toutes les distributions : vérifiez sa présence avec haproxy -vv et suivez la documentation du module pour votre version. Quelle que soit la version, vous pouvez déjà journaliser le contexte de trace reçu pour relier les logs HAProxy aux traces de vos services :
frontend http_in
bind :80
mode http
# Journaliser le contexte de trace W3C reçu : corrélation logs <-> traces dans Tempo ou Jaeger
http-request set-var(txn.traceparent) req.hdr(traceparent)
log-format "%ci:%cp [%tr] %ft %b/%s %TR/%Tw/%Tc/%Tr/%Ta %ST %B %{+Q}r traceparent=%[var(txn.traceparent)]"
default_backend app4. Interpréter les indicateurs clés #
Quelles métriques surveiller en priorité ?
Sessions et Erreurs #
- Cur : Nombre de connexions actives.
- Rate : Nombre de nouvelles connexions par seconde.
- Check status : État de santé des serveurs backends.
- Errors (Req/Resp) : Taux d'erreurs 4xx ou 5xx.
Conclusion #
L'observabilité est la clé.
Anticiper les pannes #
Grâce aux statistiques, vous pouvez détecter un serveur qui ralentit avant qu'il ne tombe complètement en panne.
Mise en pratique : page de stats, Runtime API et Prometheus #
Activer et exploiter les statistiques.
Activer la page de statistiques #
listen stats
bind 127.0.0.1:8404
mode http
stats enable
stats uri /stats
stats refresh 5s
stats auth admin:MotDePasseFort
stats admin if LOCALHOST # permet de mettre un serveur en maintenance depuis l'UIcurl -s -u admin:MotDePasseFort "http://127.0.0.1:8404/stats;csv" | head -3
ssh -L 8404:127.0.0.1:8404 admin@lb1 # accéder à la page sans l'exposerRuntime API avec socat #
# global : stats socket /var/run/haproxy.sock mode 660 level admin
echo "show info" | sudo socat stdio /var/run/haproxy.sock | head
echo "show servers state" | sudo socat stdio /var/run/haproxy.sock
echo "set server app/web3 state maint" | sudo socat stdio /var/run/haproxy.sock # sortir un serveur
echo "set server app/web3 state ready" | sudo socat stdio /var/run/haproxy.sock
echo "set server app/web1 weight 50%" | sudo socat stdio /var/run/haproxy.sockExporter vers Prometheus #
frontend prometheus
bind *:8405
mode http
http-request use-service prometheus-exporter if { path /metrics }
no log# prometheus.yml
scrape_configs:
- job_name: haproxy
static_configs: [{ targets: ["lb1:8405", "lb2:8405"] }]
# PromQL utiles
sum by (proxy) (rate(haproxy_frontend_http_responses_total{code="5xx"}[5m]))
haproxy_backend_up == 0
haproxy_backend_current_queue > 0Mise à jour 2026 : ce qui a changé #
Évolutions récentes à connaître (vérifiées en novembre 2026).
Repères de versions #
- Exporteur Prometheus intégré : depuis HAProxy 2.0 (activé par défaut à la compilation depuis 2.4).
- OpenTelemetry : module complémentaire à partir de 3.4 ; OpenTracing est retiré en 3.5.
- Branches à privilégier : 3.2 (mai 2025) et 3.4 (juin 2026), toutes deux LTS, maintenues cinq ans. Les branches impaires (3.3…) sont maintenues environ un an : à réserver à ceux qui veulent les dernières fonctionnalités.
