[IMP] doc: add logrotate warning in cmdline doc

Fixes #24542
2018-07-26 10:20:04 +02:00
parent 5e58ac16c3
commit 8198fb6473
1 changed files with 7 additions and 0 deletions
@@ -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