]> git.ipfire.org Git - thirdparty/haproxy.git/commitdiff
DOC: config: mention that a single monitor-uri rule is supported
authorWilly Tarreau <w@1wt.eu>
Fri, 25 Nov 2022 09:24:44 +0000 (10:24 +0100)
committerWilly Tarreau <w@1wt.eu>
Fri, 25 Nov 2022 09:27:05 +0000 (10:27 +0100)
It was reported in issue #1059 that when multiple monitor-uri rules are
specified, only the last one is used. While this was done on purpose
since a single URI is used, it was not clearly mentioned in the doc,
possibly leading to confusion or wasted time trying to establish a
working setup. Let's clarify this point.

doc/configuration.txt

index 3e8d5a6873c3d2dbd591d7b7c4a4635265dfc8f1..afe2498e7d8a003d915ec2e58f4660dd08c3d055 100644 (file)
@@ -8526,7 +8526,9 @@ monitor-uri <uri>
   Monitor requests are processed very early, just after the request is parsed
   and even before any "http-request". The only rulesets applied before are the
   tcp-request ones. They cannot be logged either, and it is the intended
-  purpose. They are only used to report HAProxy's health to an upper component,
+  purpose. Only one URI may be configured for monitoring; when multiple
+  "monitor-uri" statements are present, the last one will define the URI to
+  be used. They are only used to report HAProxy's health to an upper component,
   nothing more. However, it is possible to add any number of conditions using
   "monitor fail" and ACLs so that the result can be adjusted to whatever check
   can be imagined (most often the number of available servers in a backend).