libra/doc/worker/drivers/haproxy.rst
David Shrewsbury 6800219e68 [DOCS] Document statsfile option
Add documentation for the new 'statsfile' option for the HAProxy
driver.

Change-Id: I8c0df688c9942bb6c5c7008a87b89c54df08ce50
2013-11-22 08:51:23 -05:00

1.6 KiB

HAProxy driver

Configuration File

The [worker:haproxy] section is read by the HAProxy driver.

[worker:haproxy]
service = ubuntu
logfile = /var/log/haproxy.log

Options supported in this section:

logfile

Path where HAProxy will store its logs. Note that this file is not created by the worker, but rather by the haproxy process itself. Its contents will be delivered in response to an ARCHIVE request from the API server.

Note

See libra-worker-driver-haproxy-archiving for information on archiving.

statsfile

Location of the HAProxy statistics cache file. This file needs to be placed in a location where the worker has write access and where it will not be deleted by external processes (so don't place it in /tmp). This is used to deliver usage reports to the API server in response to a STATS requests.

service

The underlying OS Service implementation to use. Default is 'ubuntu'.

Log archiving

In order to support log-archiving with haproxy you need to redirect the rsyslog feed from local0 to a dedicated file

Note

Change the /var/log/haproxy.log to the path you have set in the worker section of the config.

cat >/etc/rsyslog.d/10-haproxy.conf<<EOF
$template Haproxy,"%TIMESTAMP% %msg%\n"
local0.* -/var/log/haproxy.log;Haproxy
# don't log anywhere else
local0.* ~
EOF