From c574ddb0f91d130a38beb253401cc4396ebbfdc4 Mon Sep 17 00:00:00 2001 From: bneradt Date: Fri, 9 Oct 2020 21:20:44 +0000 Subject: [PATCH] Document external log rotation support via SIGUSR2 --- doc/appendices/command-line/traffic_manager.en.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/doc/appendices/command-line/traffic_manager.en.rst b/doc/appendices/command-line/traffic_manager.en.rst index 671db8d7f7e..5c7b3547cbb 100644 --- a/doc/appendices/command-line/traffic_manager.en.rst +++ b/doc/appendices/command-line/traffic_manager.en.rst @@ -52,6 +52,14 @@ SIGHUP SIGINT, SIGTERM These signals cause :program:`traffic_manager` to exit after also shutting down :program:`traffic_server`. +SIGUSR2 + This signal causes the :program:`traffic_manager` and :program:`traffic_server` processes to close + and reopen their file descriptors for all of their log files. This allows the use of external + tools to handle log rotation and retention. For instance, logrotate(8) can be configured to rotate + the various |ATS| logs and, via the logrotate postrotate script, send a `-SIGUSR2` to the + :program:`traffic_manager` process. After the signal is received, |ATS| will stop logging to the + now-rolled files and will reopen log files with the originally configured log names. + Exponential Back-off Delay ==========================