summaryrefslogtreecommitdiff
path: root/doc/reference
diff options
context:
space:
mode:
Diffstat (limited to 'doc/reference')
-rw-r--r--doc/reference/cmdline.rst7
1 files changed, 7 insertions, 0 deletions
diff --git a/doc/reference/cmdline.rst b/doc/reference/cmdline.rst
index 058eac51ddd..575e93af327 100644
--- a/doc/reference/cmdline.rst
+++ b/doc/reference/cmdline.rst
@@ -305,6 +305,13 @@ customize the amount of logging output
enables `log rotation <https://docs.python.org/2/library/logging.handlers.html#timedrotatingfilehandler>`_
daily, keeping 30 backups. Log rotation frequency and number of backups is
not configurable.
+
+ .. danger::
+
+ Built-in log rotation is not reliable in multi-workers scenarios
+ and may incur significant data loss. It is *strongly recommended* to
+ use an external log rotation utility or use system loggers (--syslog)
+ instead.
.. option:: --syslog