On a HAProxy Enterprise server, the SNMP stack is split into two main components and one optional component:

  • The Operating system SNMP daemon, called snmpd. It listens on a network interface on port 161/UDP and handles SNMP requests from clients.

  • The SNMP plugin for HAProxy, called hapee-snmp-lb. This plugin collects data from hapee-1.9-lb for snmpd.

  • The HAProxy Enterprise SNMP daemon: called hapee-snmp (optional and does not require configuration or update).

The diagram below illustrates the flow:

HAProxy Enterprise SNMP Daemon

HAProxy Enterprise SNMP Daemon

Install the operating system's SNMP daemon

Run the following command:

$ # RedHat / CentOS
$ yum install net-snmp

$ # Ubuntu / Debian
$ apt-get install snmpd


Skip this step if your system already has an SNMP daemon installed.

Install the HAProxy Enterprise SNMP plugin

For the package hapee-extras-snmp-lb, run this command:

$ # RedHat / CentOS
$ yum install hapee-extras-snmp-lb

$ # Ubuntu / Debian
$ apt-get install hapee-extras-snmp-lb

Configure the system SNMP daemon

  1. Edit the file /etc/snmp/snmpd.conf to have the snmp daemon listen on the correct address:

    • Comment out agentAddress udp:

    • Uncomment agentAddress udp:161,udp6:[::1]:161.

    • Enable the SNMP server snmpd:

      view systemonly included .
    • Add the SNMP extension: pass_persist:

      pass_persist  . /opt/hapee-extras/bin/hapee-snmp-lb
  2. Create a new read-only socket:

    $ # RedHat / CentOS
    $ stats socket /var/run/hapee-extras/hapee-lb.sock user hapee-lb group hapee mode 660 level user
    $ # Ubuntu / Debian
    $ stats socket /var/run/hapee-extras/hapee-lb.sock user hapee-lb group Debian-snmp mode 660 level user


    On RedHat and CentOS runs snmpd as root; hence there is no need for a specific user or group on the socket.

    On Debian and Ubuntu runs snmpd as Debian-snmp.

  3. Restart HAProxy.

  4. Restart snmpd.


There is nothing to configure for this software, as the package provides its configuration and it does not require any update.