From 286199c24ff9fecb1a2c502a490ad9256c621202 Mon Sep 17 00:00:00 2001
From: Willy Tarreau <w@1wt.eu>
Date: Fri, 25 Nov 2022 09:40:06 +0100
Subject: [PATCH] DOC: halog: explain how to use -ac and -ad in the help
 message

Tim reported in issue #1435 that halog options -ac/-ad were poorly
documented. They're indeed used to spot infrastructure outages between
the clients and haproxy by detecting abnormal periods of silence followed
by bursts, either affecting the network itself, or also a single machine
(e.g. swapping on an edge client or proxy can cause such patterns).
---
 admin/halog/halog.c | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/admin/halog/halog.c b/admin/halog/halog.c
index 45eec7576b..7ff4363870 100644
--- a/admin/halog/halog.c
+++ b/admin/halog/halog.c
@@ -207,6 +207,11 @@ void help()
 	       "       -uao, -uto: average times computed on valid ('OK') requests\n"
 	       "       -uba, -ubt: average bytes returned, total bytes returned\n"
 	       " -hdr  output captured header at the given <block>:<field>\n",
+	       " -ac <count> -ad <delay>:\n
+	       "       Report periods corresponding to a grouped accept of <count> requests at\n"
+	       "       the same millisecond after a delay of at least <ad> milliseconds with no\n"
+	       "       incoming accept (used to spot network outages). Output format contains:\n"
+	       "          <accept_date> <date_ms> <delta_ms from previous one> <nb_entries>\n"
 	       (int)SOURCE_FIELD, (int)SOURCE_FIELD
 	       );
 	exit(0);
-- 
2.39.5