22<html lang="en">
33 <head>
44 <meta charset="utf-8" />
5- <title>HAProxy version 3.4-dev6-130 - Configuration Manual</title>
5+ <title>HAProxy version 3.4-dev7-5 - Configuration Manual</title>
66 <link href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet" />
77 <link href="https://raw.githubusercontent.com/thomaspark/bootswatch/v3.3.7/cerulean/bootstrap.min.css" rel="stylesheet" />
88 <link href="../css/page.css?0.4.2-15" rel="stylesheet" />
48214821 You can use <strong>left</strong> and <strong>right</strong> arrow keys to navigate between chapters.<br>
48224822 </p>
48234823 <p class="text-right">
4824- <small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2026/03/19 </b></small>
4824+ <small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2026/03/20 </b></small>
48254825 </p>
48264826 </div>
48274827 <!-- /.sidebar -->
48324832 <div class="text-center">
48334833 <h1><a href="http://www.haproxy.org/" title="HAProxy"><img src="../img/HAProxyCommunityEdition_60px.png?0.4.2-15" /></a></h1>
48344834 <h2>Configuration Manual</h2>
4835- <p><strong>version 3.4-dev6-130 </strong></p>
4835+ <p><strong>version 3.4-dev7-5 </strong></p>
48364836 <p>
4837- 2026/03/05 <br>
4837+ 2026/03/20 <br>
48384838
48394839 </p>
48404840 </div>
@@ -20054,15 +20054,14 @@ <h2 id="chapter-4.4" data-target="4.4"><small><a class="small" href="#4.4">4.4.<
2005420054<pre class="text">This disables any attempt to retry the request if it fails for any other
2005520055reason than a connection failure. This can be useful for example to make
2005620056sure POST requests aren't retried on failure.
20057- </pre><a class="anchor" name="do-log"></a><a class="anchor" name="4-do-log"></a><a class="anchor" name="4.4-do-log"></a><a class="anchor" name="do-log (Proxies)"></a><a class="anchor" name="do-log (Alphabetically sorted actions reference)"></a><div class="keyword"><b><a class="anchor" name="do-log"></a><a href="#4.4-do-log">do-log</a></b></div><div><p> Usable in :</p><table class="table table-bordered" border="0" cellspacing="0" cellpadding="0">
20057+ </pre><a class="anchor" name="do-log"></a><a class="anchor" name="4-do-log"></a><a class="anchor" name="4.4-do-log"></a><a class="anchor" name="do-log (Proxies)"></a><a class="anchor" name="do-log (Alphabetically sorted actions reference)"></a><div class="keyword"><b><a class="anchor" name="do-log"></a><a href="#4.4-do-log">do-log</a></b>
<span style="color: #008">[profile <span style="color: #080"><log_profile></span>]</span> </div><div><p> Usable in :</p><table class="table table-bordered" border="0" cellspacing="0" cellpadding="0">
2005820058<thead><tr><th>QUIC Ini</th><th>TCP RqCon</th><th>RqSes</th><th>RqCnt</th><th>RsCnt</th><th>HTTP Req</th><th>Res</th><th>Aft</th></tr></thead>
2005920059<tr><td class="pagination-centered"><img src="../css/check.png" alt="X" title="yes" /></td><td class="pagination-centered"><img src="../css/check.png" alt="X" title="yes" /></td><td class="pagination-centered"><img src="../css/check.png" alt="X" title="yes" /></td><td class="pagination-centered"><img src="../css/check.png" alt="X" title="yes" /></td><td class="pagination-centered"><img src="../css/check.png" alt="X" title="yes" /></td><td class="pagination-centered"><img src="../css/check.png" alt="X" title="yes" /></td><td class="pagination-centered"><img src="../css/check.png" alt="X" title="yes" /></td><td class="pagination-centered"><img src="../css/check.png" alt="X" title="yes" /></td></tr>
2006020060</table></div>
2006120061<pre class="text">This action manually triggers a log emission on the proxy. This means
2006220062log options on the proxy will be considered (including formatting options
2006320063such as "<a href="#log-format">log-format</a>"), but it will not interfere with the logs automatically
20064- generated by the proxy during transaction handling. It currently doesn't
20065- support any argument, though extensions may appear in future versions.
20064+ generated by the proxy during transaction handling.
2006620065
2006720066Using "<a href="#log-profile">log-profile</a>", it is possible to precisely describe how the log should
2006820067be emitted for each of the available contexts where the action may be used.
@@ -20071,17 +20070,30 @@ <h2 id="chapter-4.4" data-target="4.4"><small><a class="small" href="#4.4">4.4.<
2007120070'http-res', 'http-after-res'.
2007220071
2007320072Also, they will be properly reported when using "%OG" logformat alias.
20073+
20074+ Optional "profile" argument may be used to specify the name of a log-profile
20075+ section that should be used for this do-log action specifically instead of
20076+ the one associated to the current logger that applies by default.
2007420077</pre><div class="separator">
2007520078<span class="label label-success">Example:</span>
2007620079<pre class="prettyprint">
20077- <code>log-profile myprof
20080+ <code>log-profile my-dft-prof
2007820081 on tcp-req-conn format "Connect: %ci"
2007920082
20083+ log-profile my-local-prof
20084+ on tcp-req-conn format "Local Connect: %ci"
20085+
2008020086frontend myfront
20081- log stdout format rfc5424 profile myprof local0
20087+ log stdout format rfc5424 profile my-dft-prof local0
2008220088 log-format "log generated using proxy logformat, from '%OG'"
20083- tcp-request connection do-log <span class="comment">#uses special log-profile format</span>
20084- tcp-request content do-log <span class="comment">#uses proxy logformat</span>
20089+ acl local src 127.0.0.1
20090+ <span class="comment"># on connection use either log-profile from the logger (my-dft-prof) or</span>
20091+ <span class="comment"># explicit my-local-prof if source ip is localhost</span>
20092+ tcp-request connection do-log if !local
20093+ tcp-request connection do-log profile my-local-prof if local
20094+ <span class="comment"># on content use proxy logformat, since no override was specified</span>
20095+ <span class="comment"># in my-dft-prof</span>
20096+ tcp-request content do-log
2008520097</code></pre>
2008620098</div><a class="anchor" name="do-resolve"></a><a class="anchor" name="4-do-resolve"></a><a class="anchor" name="4.4-do-resolve"></a><a class="anchor" name="do-resolve (Proxies)"></a><a class="anchor" name="do-resolve (Alphabetically sorted actions reference)"></a><div class="keyword"><b><a class="anchor" name="do-resolve"></a><a href="#4.4-do-resolve">do-resolve</a></b>(<span style="color: #080"><var></span>,<span style="color: #080"><resolvers></span><span style="color: #008">[,ipv4|ipv6]</span>) <span style="color: #080"><expr></span></div><div><p> Usable in :</p><table class="table table-bordered" border="0" cellspacing="0" cellpadding="0">
2008720099<thead><tr><th>QUIC Ini</th><th>TCP RqCon</th><th>RqSes</th><th>RqCnt</th><th>RsCnt</th><th>HTTP Req</th><th>Res</th><th>Aft</th></tr></thead>
@@ -34794,8 +34806,8 @@ <h2 id="chapter-12.8" data-target="12.8"><small><a class="small" href="#12.8">12
3479434806 <br>
3479534807 <hr>
3479634808 <div class="text-right">
34797- HAProxy 3.4-dev6-130 – Configuration Manual<br>
34798- <small>, 2026/03/05 </small>
34809+ HAProxy 3.4-dev7-5 – Configuration Manual<br>
34810+ <small>, 2026/03/20 </small>
3479934811 </div>
3480034812 </div>
3480134813 <!-- /.col-lg-12 -->
0 commit comments