This is an automated email from the ASF dual-hosted git repository.
amc pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/trafficserver.git
commit 859c34389346636b8fe548289130b7e030e83562
Author: dyrock <zeyu...@gmail.com>
AuthorDate: Tue Oct 30 18:29:53 2018 +0000
docs
---
doc/admin-guide/files/records.config.en.rst | 6 +++---
doc/admin-guide/logging/rotation.en.rst | 11 ++++++++---
2 files changed, 11 insertions(+), 6 deletions(-)
diff --git a/doc/admin-guide/files/records.config.en.rst
b/doc/admin-guide/files/records.config.en.rst
index c773e97..8cb2a03 100644
--- a/doc/admin-guide/files/records.config.en.rst
+++ b/doc/admin-guide/files/records.config.en.rst
@@ -277,7 +277,7 @@ System Variables
Specifies the minimum count of rolled output logs to keep. This value will
be used to decide the
order of auto-deletion (if enabled). A default value of 0 means
auto-deletion will try to keep
- output logs as much as possible.
+ output logs as much as possible. See :doc:`../logging/rotation.en.rst` for
guidance.
Thread Variables
----------------
@@ -2961,7 +2961,7 @@ Logging Configuration
Specifies the minimum count of rolled (event) logs to keep. This value will
be used to decide the
order of auto-deletion (if enabled). A default value of 0 means
auto-deletion will try to keep
- logs as much as possible. This value can be and should be overridden in
logging.yaml.
+ logs as much as possible. This value can be and should be overridden in
logging.yaml. See :doc:`../logging/rotation.en.rst` for guidance.
.. ts:cv:: CONFIG proxy.config.log.auto_delete_rolled_files INT 1
:reloadable:
@@ -3130,7 +3130,7 @@ Diagnostic Logging Configuration
Specifies the minimum count of rolled diagnostic logs to keep. This value
will be used to decide the
order of auto-deletion (if enabled). A default value of 0 means
auto-deletion will try to keep
- diagnostic logs as much as possible.
+ diagnostic logs as much as possible. See :doc:`../logging/rotation.en.rst`
for guidance.
Reverse Proxy
=============
diff --git a/doc/admin-guide/logging/rotation.en.rst
b/doc/admin-guide/logging/rotation.en.rst
index 5e01242..01441c8 100644
--- a/doc/admin-guide/logging/rotation.en.rst
+++ b/doc/admin-guide/logging/rotation.en.rst
@@ -195,9 +195,14 @@ following actions:
- If the autodelete option is enabled, then |TS| identifies previously-rolled
log files (log files with the ``.old`` extension). It starts deleting files
- one by one, beginning with the oldest file with largest ratio to the minimum
- rolling count, until it emerges from the low state. |TS| logs a record of
all
- deleted files in the system error log.
+ one by one, beginning with the oldest file with largest ratio between
current
+ number of files and the minimum rolling count, until it emerges from the low
+ state. The default minimum rolling count of 0 is treated as INT_MAX during
+ ratio calculation. Hence the `rolling_min_count` is not guaranteed to be
+ reserved; instead, it is used as a reference to decide the priority of log
+ files to delete. In low space state, even when all log files are below
minimum
+ count, |TS| still tries to delete files until it emerges from the low state.
+ |TS| logs a record of all deleted files in the system error log.
- If the autodelete option is disabled or there are not enough old log files
to delete for the system to emerge from its low space state, then |TS|
