RepoMirrors/haproxy
1
0
Fork 0
mirror of http://git.haproxy.org/git/haproxy.git/ synced 2025-03-25 04:17:42 +00:00
Code Issues Packages Projects Releases Wiki Activity

DOC: Document email alerts

Browse Source 
Signed-off-by: Simon Horman <horms@verge.net.au>
This commit is contained in:
Simon Horman 2015-02-03 13:00:44 +09:00 committed by Willy Tarreau
parent 0ba0e4ac07
commit 51a1cf6bb4
1 changed files with 104 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

104
doc/configuration.txt
View File

@ -1224,6 +1224,36 @@ peer <peername> <ip>:<port>
server srv2 192.168.0.31:80
3.6. Mailers
------------
It is possible to send email alerts when the state of servers changes.
If configured email alerts are sent to each mailer that is configured
in a mailers section. Email is sent to mailers using SMTP.
mailer <mailersect>
Creates a new mailer list with the name <mailersect>. It is an
independent section which is referenced by one or more proxies.
mailer <mailername> <ip>:<port>
Defines a mailer inside a mailers section.
Example:
mailers mymailers
mailer smtp1 192.168.0.1:587
mailer smtp2 192.168.0.2:587
backend mybackend
mode tcp
balance roundrobin
email-alert mailers mymailers
email-alert from test1@horms.org
email-alert to test2@horms.org
server srv1 192.168.0.30:80
server srv2 192.168.0.31:80
4. Proxies
----------
@ -1344,6 +1374,10 @@ default_backend X X X -
description - X X X
disabled X X X X
dispatch - - X X
email-alert from X X X X
email-alert mailers X X X X
email-alert myhostname X X X X
email-alert to X X X X
enabled X X X X
errorfile X X X X
errorloc X X X X
@ -2650,6 +2684,76 @@ errorloc303 <code> <url>
See also : "errorfile", "errorloc", "errorloc302"
email-alert from <emailaddr>
Declare the from email address to be used in both the envelope and header
of email alerts. This is the address that email alerts are sent from.
May be used in sections: defaults | frontend | listen | backend
yes | yes | yes | yes
Arguments :
<emailaddr> is the from email address to use when sending email alerts
Also requires "email-alert mailers" and "email-alert to" to be set
and if so sending email alerts is enabled for the proxy.
See also : "email-alert mailers", "email-alert myhostname", "email-alert to",
section 3.6 about mailers.
email-alert mailers <mailersect>
Declare the mailers to be used when sending email alerts
May be used in sections: defaults | frontend | listen | backend
yes | yes | yes | yes
Arguments :
<mailersect> is the name of the mailers section to send email alerts.
Also requires "email-alert from" and "email-alert to" to be set
and if so sending email alerts is enabled for the proxy.
See also : "email-alert from", "email-alert myhostname", "email-alert to",
section 3.6 about mailers.
email-alert myhostname <hostname>
Declare the to hostname address to be used when communicating with
mailers.
May be used in sections: defaults | frontend | listen | backend
yes | yes | yes | yes
Arguments :
<emailaddr> is the to email address to use when sending email alerts
By default the systems hostname is used.
Also requires "email-alert from", "email-alert mailers" and
"email-alert to" to be set and if so sending email alerts is enabled
for the proxy.
See also : "email-alert from", "email-alert mailers", "email-alert to",
section 3.6 about mailers.
email-alert to <emailaddr>
Declare both the recipent address in the envelope and to address in the
header of email alerts. This is the address that email alerts are sent to.
May be used in sections: defaults | frontend | listen | backend
yes | yes | yes | yes
Arguments :
<emailaddr> is the to email address to use when sending email alerts
Also requires "email-alert mailers" and "email-alert to" to be set
and if so sending email alerts is enabled for the proxy.
See also : "email-alert from", "email-alert mailers",
"email-alert myhostname", section 3.6 about mailers.
force-persist { if | unless } <condition>
Declare a condition to force persistence on down servers
May be used in sections: defaults | frontend | listen | backend