Whether to enable backend statistics collection. Backend statistics consists of the following values:
If enabled, these values are made available via poundctl
(see poundctl list) and telemetry output (see Metrics).
Sets the request balancing algorithm to use. Allowed values for algo are:
Use weighted random balancing algorithm.
Use interleaved weighted round robin balancing.
See Request balancing, for a detailed discussion of these algorithms.
The Balancer
statement in global scope applies to all Service
definitions in the file that don’t contain Balancer
definitions
of their own.
Sets default header addition options. One or more arguments are allowed, each being one of:
off
Disable additional headers.
forwarded
Add X-For-warded-For
, X-Forwarded-Proto
, and
X-Forwarded-Port
headers.
ssl
Pass information about SSL certificates in a set of X-SSL-*
headers. This will add the following headers:
SSL version followed by a slash and active cipher algorithm.
The full client certificate (multi-line).
Information about the certificate issuer (CA).
Information about the certificate owner.
End of validity date for the certificate.
Start of validity date for the certificate.
Certificate serial number (in decimal).
The default is:
HeaderOption forwarded ssl
This setting can be overridden for a particular listener using the
HeadOption
within it.
HTTP protocol allows for certain headers to appear in the message multiple times. Namely, multiple headers with the same header name are permitted if that header field is defined as a comma-separated list.
The standard specifies that such fields can be combined in a single header line, by appending each subsequent field value to the combined field value in order, separated by a comma.
The CombineHeaders
statement declares names of the headers to
which pound
is to apply this operation. Each header name
should be listed on a separate line, enclosed in double-quotes. The
keyword End
on a line by itself ends the statement. E.g.:
CombineHeaders "Accept" "Allow" "Cache-Control" End
The include
statement (see File inclusion) can be used in
CombineHeaders
statement.
Pound
distribution includes file mvh.inc,
which declares all known multiple-value headers in a form suitable for
inclusion to pound.cfg. This file is installed in the package
data directory, so that in order to use it, it suffices to add the
following to the configuration file:
CombineHeaders Include "mvh.inc" End