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 <[email protected]> Authored: Sat May 21 20:30:26 2016 +0900 Committer: rpopma <[email protected]> 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>
