HAProxy default checks and policies

  • Release version: Zurich
  • Updated July 31, 2025
  • 1 minute to read
  • Agent Client Collector provides the following default checks and policies for HAProxy monitoring.

    Table 1. HAProxy events policy
    Type Check Description Usage Output
    Event check-haproxy Retrieves 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
    Table 2. HAProxy metrics policy
    Type Check Description Usage Output
    Metric metrics-check-haproxy Retrieves 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