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/05/21 11:32:33 UTC
logging-log4j2 git commit: site improvements: refer to performance
test results from AsyncAppender
Repository: logging-log4j2
Updated Branches:
refs/heads/master e10fd0450 -> a711b6174
site improvements: refer to performance test results from AsyncAppender
Project: http://git-wip-us.apache.org/repos/asf/logging-log4j2/repo
Commit: http://git-wip-us.apache.org/repos/asf/logging-log4j2/commit/a711b617
Tree: http://git-wip-us.apache.org/repos/asf/logging-log4j2/tree/a711b617
Diff: http://git-wip-us.apache.org/repos/asf/logging-log4j2/diff/a711b617
Branch: refs/heads/master
Commit: a711b6174efbcdddd6b7f95b44575d6279d79efb
Parents: e10fd04
Author: rpopma <rp...@apache.org>
Authored: Sat May 21 20:30:26 2016 +0900
Committer: rpopma <rp...@apache.org>
Committed: Sat May 21 20:30:26 2016 +0900
----------------------------------------------------------------------
src/site/xdoc/manual/appenders.xml | 9 +++++++++
1 file changed, 9 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/a711b617/src/site/xdoc/manual/appenders.xml
----------------------------------------------------------------------
diff --git a/src/site/xdoc/manual/appenders.xml b/src/site/xdoc/manual/appenders.xml
index 4a2f7c5..6199cab 100644
--- a/src/site/xdoc/manual/appenders.xml
+++ b/src/site/xdoc/manual/appenders.xml
@@ -55,6 +55,15 @@
on a separate Thread. Note that exceptions while writing to those Appenders will be hidden from
the application. The AsyncAppender should be configured after the appenders it references to allow it
to shut down properly.</p>
+ <p>
+ Note that AsyncAppender internally uses the built-in java.util.concurrent.ArrayBlockingQueue,
+ so it does not have any dependencies on external libraries. However, multi-threaded applications
+ should exercise care before using this appender:
+ the blocking queue is susceptible to lock contention and our
+ <a href="../performance.html#asyncLogging">tests showed</a>
+ performance may become worse when more threads are logging concurrently.
+ Consider using <a href="async.html">lock-free Async Loggers</a> for optimal performance.
+ </p>
<table>
<caption align="top">AsyncAppender Parameters</caption>
<tr>