HAProxy Enterprise Documentation 1.6r2

Alerts

HAProxy Enterprise can email alerts to notify an administrator about HAProxy Enterprise events. When an event is generated, it is categorized under a specific level of importance. These levels range from debug (the least serious) to emergency (the most serious). You will set the level for which you want to receive alerts.

Alerts are sent when:

  • An active server is marked as down and the configured alert level is alert or lower.

  • A disabled server is marked as down and the configured alert level is 'notice' or lower.

  • A server is marked as up or enters the drain state and the configured alert level is notice or lower.

  • The option log-health-checks directive is enabled with the configured alert level as info or lower, and a health check status update occurs.

Configure mail servers

To use emails for alerts, you first configure a mailers section where you list Message Transfer Agent (MTA) servers. These servers deliver your messages to recipients. Emails are sent using the SMTP protocol. Messages are sent to each server in the list. You can define multiple mailer sections.

  1. Create a new mailers section in your configuration file with a label of your choice, such as smtp_servers.

    In the example below, we list two MTA servers:

    mailers smtp_servers
   mailer smtp1 192.168.1.10:587
   mailer smtp2 192.168.1.11:587

    A mailer line has these parameters:

    • A label, such as smtp1

    • An IP address and port

  2. Add email-alert directives to a frontend, listen, or defaults section:

    defaults
   mode http
   log global
   option httplog
   timeout connect 10s
   timeout client 1m
   timeout server 1m

   # email settings
   email-alert mailers smtp_servers
   email-alert from alerts@mycompany.com
   email-alert to helpdesk@mycompany.com
   email-alert level info
   email-alert myhostname LoadBalancer1

The table below describes each email-alert option:

email-alert mailers <mailersectionname>

The mailers section to use to send emails.

email-alert from <emailaddr>

The email sender's address, also known as the From field.

email-alert to <emailaddr>

The recipient's address, also known as the To field.

email-alert level <level>

The maximum log level of messages for which email alerts will go out; The <level> can be any of these syslog levels: emerg, alert, crit, err, warning, notice, info, debug.

email-alert myhostname <hostname>

The hostname to use when communicating with mailers; by default, it is the system's hostname.

Next up

Monitor URI