Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

HAProxy default checks and policies

Agent Client Collector provides the following default checks and policies for HAProxy monitoring.

TypeCheckDescriptionUsageOutput
Eventcheck-haproxyRetrieves the details of the HAProxy load balancer to determine whether it is running.
commonchecks    check-haproxy (options)
-h    host host
-P    port Port on which the HAProxy server is running
-A    all services all services
-q    Path on which HAProxy Stats URI is configured
-use ssl    ssl
Usage example: `check-haproxy.rb -h localhost -P 8080 -A true -q stats -use_ssl false`
`CheckHAProxy OK: UP: 50% of 4 // services, DOWN: backend/nginx1[L4CON], backend/BACKEND`
TypeCheckDescriptionUsageOutput
Metricmetrics-check-haproxyRetrieves the HAProxy load balancer metrics to determine whether it is running.
commonchecks metrics-check-haproxy (options) 

-q host     Path on which HAProxy Stats URI is configured 

-P port     Port on which the HAProxy server is running 

-c host        host name
Usage example: `metrics-check-haproxy.rb -q stats -P 8080 -c localhost`
<hostname>.haproxy.frontend.session_current 0 1652265603
<hostname>.haproxy.frontend.session_total 0 1652265603
<hostname>.haproxy.backend.session_current 0 1652265603 
<hostname>.haproxy.backend.session_total 1 1652265603

Parent Topic:Agent Client Collector Monitoring default checks and policies