This plugin provides native HAProxy instrumentation for monitoring and metrics collection, including: service health and backend server metrics.


Build Status Gem Version Code Climate Test Coverage Dependency Status



  • bin/check-haproxy.rb
  • bin/metrics-haproxy.rb



$ /opt/sensu/embedded/bin/metrics-haproxy.rb --help
Usage: /opt/sensu/embedded/bin/metrics-haproxy.rb (options)
    -f BACKEND1[,BACKEND2],          comma-separated list of backends to fetch stats from. Default is all backends
    -c HOSTNAME|SOCKETPATH,          HAproxy web stats hostname or path to stats socket (required)
    -a, --expose-all                 Expose all possible metrics, includes "--server-metrics", "--backends" will still in effect
    -p, --pass PASSWORD              HAproxy web stats password
    -q, --statspath STATUSPATH       HAproxy web stats path (the / will be prepended to the STATUSPATH e.g stats)
    -P, --port PORT                  HAproxy web stats port
    -r, --retries RETRIES            Number of times to retry fetching stats from haproxy before giving up.
    -i, --retry_interval SECONDS     Interval (seconds) between retries
    -s, --scheme SCHEME              Metric naming scheme, text to prepend to metric
        --server-metrics             Gathers additional frontend metrics, i.e. total requests
        --use-explicit-names         Use explicit names for frontend, backend, server, listener
        --use-haproxy-names          Use raw names as used in haproxy CSV format definition rather than human friendly names
    -S, --use-ssl                    Use SSL to connect to HAproxy web stats
    -u, --user USERNAME              HAproxy web stats username


Installation and Setup


Get Integration


8 stars on GitHub
7 open issues on GitHub
23 open forks on GitHub

Sensu Integrations

Sensu integrations and extensions are available for dozens of modern applications and services.