HAProxy stats for Collectd

A plugin for collectd to gather metrics for a local HAProxy instance, with a focus on easy installation and configuration.

Graphs made with HAProxy stats

(graphs made with Grafana)


The project is on PyPI so installation is a simple pip command:

pip install collectd-haproxy

To install manually, first download the current tarball at collectd-haproxy-1.2.1.tar.gz then:

tar -zxvf collectd-haproxy-1.2.1.tar.gz
cd collectd-haproxy-1.2.1
python setup.py install


If collectd is running with a virtualenv activated (under an isolated supervisord setup, for instance) make sure the collectd-haproxy package is installed and available in the virtualenv’s module path or collectd will run into an ImportError.

In order to function properly, the local HAProxy instance will need to have the “stats socket” enabled, details about how to do that can be found here.


The most basic configuration is to specify where the HAProxy socket file is located:

LoadPlugin "python"

<Plugin python>
    Import "collectd_haproxy"

    <Module haproxy>
      Socket "/var/run/haproxy.sock"

For details on all of the options available, see the Configuration docs.


The code is hosted on GitHub

To file a bug or possible enhancement see the Issue Tracker, also found on GitHub.


(c) 2015-2016 William Glass

collectd-haproxy is licensed under the terms of the MIT license. See the LICENSE file for more details.