You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@logging.apache.org by rp...@apache.org on 2016/03/16 14:38:49 UTC
[32/50] logging-log4j2 git commit: LOG4J2-1080 updated documentation
after removing support for dropping events on partially full queue
LOG4J2-1080 updated documentation after removing support for dropping events on partially full queue
Project: http://git-wip-us.apache.org/repos/asf/logging-log4j2/repo
Commit: http://git-wip-us.apache.org/repos/asf/logging-log4j2/commit/e91ea510
Tree: http://git-wip-us.apache.org/repos/asf/logging-log4j2/tree/e91ea510
Diff: http://git-wip-us.apache.org/repos/asf/logging-log4j2/diff/e91ea510
Branch: refs/heads/LOG4J2-1278-gc-free-logger
Commit: e91ea510a6b6689e7b7a84102312cde969aa0530
Parents: ba2ee52
Author: rpopma <rp...@apache.org>
Authored: Tue Mar 15 01:58:20 2016 +1100
Committer: rpopma <rp...@apache.org>
Committed: Tue Mar 15 01:58:20 2016 +1100
----------------------------------------------------------------------
src/site/xdoc/manual/async.xml | 8 ++++----
src/site/xdoc/manual/configuration.xml.vm | 16 +++-------------
2 files changed, 7 insertions(+), 17 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/e91ea510/src/site/xdoc/manual/async.xml
----------------------------------------------------------------------
diff --git a/src/site/xdoc/manual/async.xml b/src/site/xdoc/manual/async.xml
index 911c27a..36c7ebe 100644
--- a/src/site/xdoc/manual/async.xml
+++ b/src/site/xdoc/manual/async.xml
@@ -279,8 +279,8 @@
There are also a few system properties that can be used to maintain application throughput even when
the underlying appender cannot keep up with the logging rate and the queue is filling up.
See the details for system properties
- <a href="configuration.html#AsyncEventRouter"><tt>log4j2.AsyncEventRouter</tt>,
- <tt>log4j2.DiscardThreshold</tt> and <tt>log4j2.DiscardQueueRatio</tt></a>.
+ <a href="configuration.html#AsyncEventRouter"><tt>log4j2.AsyncEventRouter</tt> and
+ <tt>log4j2.DiscardThreshold</tt></a>.
</p>
</subsection>
<a name="MixedSync-Async" />
@@ -398,8 +398,8 @@
There are also a few system properties that can be used to maintain application throughput even when
the underlying appender cannot keep up with the logging rate and the queue is filling up.
See the details for system properties
- <a href="configuration.html#AsyncEventRouter"><tt>log4j2.AsyncEventRouter</tt>,
- <tt>log4j2.DiscardThreshold</tt> and <tt>log4j2.DiscardQueueRatio</tt></a>.
+ <a href="configuration.html#AsyncEventRouter"><tt>log4j2.AsyncEventRouter</tt> and
+ <tt>log4j2.DiscardThreshold</tt></a>.
</p>
</subsection>
<a name="Location" />
http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/e91ea510/src/site/xdoc/manual/configuration.xml.vm
----------------------------------------------------------------------
diff --git a/src/site/xdoc/manual/configuration.xml.vm b/src/site/xdoc/manual/configuration.xml.vm
index 5e0a5fb..f1e72f0 100644
--- a/src/site/xdoc/manual/configuration.xml.vm
+++ b/src/site/xdoc/manual/configuration.xml.vm
@@ -1881,25 +1881,15 @@ public class AwesomeTest {
<p>If no value is specified (the default) events are never discarded. If the queue is full, the
logger call blocks until the event can be added to the queue.</p>
<p>Specify <tt>Discard</tt> to drop events whose level is equal or less than the threshold level
- (INFO by default) when the queue has been filled to the discard ratio (0.8 by default).</p>
- <p>It is also possible to specify the fully qualified class name of a custom class that implements the
- <tt>org.apache.logging.log4j.core.async.AsyncEventRouter</tt> interface.</p>
+ (INFO by default) when the queue is full.</p>
</td>
</tr>
<tr>
<td>log4j2.DiscardThreshold</td>
<td>INFO</td>
<td>Used by the DiscardingAsyncEventRouter to determine which events to drop when the queue
- becomes too full. By default, <tt>INFO</tt>, <tt>DEBUG</tt> and <tt>TRACE</tt> level
- events are discarded when the queue has been filled up to or beyond the discard ratio.
- This property only has effect if <tt>Discard</tt> is specified as the
- <tt>log4j2.AsyncEventRouter</tt>.</td>
- </tr>
- <tr>
- <td>log4j2.DiscardQueueRatio</td>
- <td>0.8</td>
- <td>Used by the DiscardingAsyncEventRouter to determine when the queue is becoming too full.
- By default, events may be discarded when the queue is 80% full or more.
+ becomes full. By default, <tt>INFO</tt>, <tt>DEBUG</tt> and <tt>TRACE</tt> level
+ events are discarded when the queue is full.
This property only has effect if <tt>Discard</tt> is specified as the
<tt>log4j2.AsyncEventRouter</tt>.</td>
</tr>