RousselTMLEARNING

Proxy & réseau

Monitoring et Statistiques dans HAProxy

Comment activer le tableau de bord de statistiques natif et exposer des métriques pour Prometheus.

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:MonMotDePasse

2. 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 app

4. 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'UI
curl -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'exposer

Runtime API avec socat #

Statistiques via la Runtime API
Le champ status indique UP, DOWN ou MAINT pour chaque serveur.
# 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.sock

Exporter 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 > 0

Mise à 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.

Articles liés

Anatomie de la configuration HAProxy, Clustering et Haute Disponibilité

Comprendre la structure d'un fichier haproxy.cfg : sections global, defaults, frontend (haute performance), b…

HAProxy dans Kubernetes : L'Ingress Controller Haute Performance

Découvrez en profondeur l'intégration de HAProxy dans Kubernetes. Architecture Direct-to-Pod, options de mise…

Nouveautés HAProxy : OpenTelemetry, JWT Natif, et Optimisations de Performance

Explorez les dernières innovations de HAProxy : OpenTelemetry (3.4), validation JWT à l'edge, threads automat…

Pour aller plus loin

Soutenir

♥ SOUTENIR

Soutenez RousselTM Learning

Les formations, articles, TP et attestations restent gratuits et sans publicité intrusive. Une contribution libre, du montant de votre choix, finance l’hébergement, les environnements de TP et l’écriture de nouveaux contenus.

Contribuer avec PayPal Montant libre · carte bancaire ou compte PayPalEn savoir plus
QR code PayPal
Ou scannez ce QR code avec votre téléphone

Merci, chaque contribution compte !