Skip to content

Commit 923d9c1

Browse files
authored
Advertise Log4cxx 1.6 benefits in web-site documentation (#553)
1 parent ccaa3ab commit 923d9c1

File tree

2 files changed

+13
-1
lines changed

2 files changed

+13
-1
lines changed

src/site/markdown/configuration-samples.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -86,7 +86,7 @@ The variable names are [documented here](@ref log4cxx.spi.Configurator.propertie
8686
To check the correct values are used when your configuration file is loaded,
8787
use [Log4cxx internal debugging].
8888

89-
# Configuring a logger to use asynchronous output
89+
# Configuring a logger to use asynchronous output {#asynch-output}
9090

9191
Log4cxx 1.6 allows you to more easily attach an [AsyncAppender](@ref log4cxx.AsyncAppender)
9292
to a logger using a configuration file.

src/site/markdown/performance.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,17 @@ One important question with a logging library is: is it fast enough?
2525
While Log4cxx may not be the fastest logging implementation, it is more than fast
2626
enough for the vast majority of cases.
2727

28+
Using Log4cxx 1.6 you can even use microsecond timestamps
29+
in TRACE level logging messages to quickly get a sense of
30+
where your application's workload is concentrated.
31+
The LOG4CXX_XXXX_ASYNC macros in Log4cxx 1.6
32+
just capture values in a buffer
33+
and by adding the new [asynchronous output setting] to your configuration file,
34+
the values are converted to text in a background thread.
35+
That combination prevents TRACE level logging being the dominate CPU load
36+
of your application's thread and
37+
provides the lowest overhead logging in the history of Log4cxx.
38+
2839
While Log4cxx can generate 2,000,000 log messages/second,
2940
skipping a disabled logging request requires only a few nano-seconds,
3041
so application performance is not affected when
@@ -142,3 +153,4 @@ When logging floating point values from a high priority thread,
142153
and you cannot use a background thread to format and write the log data,
143154
the LOG4CXX_[level]_FMT series of macros impose the least overhead.
144155

156+
[asynchronous output setting]:configuration-files.html#asynch-output

0 commit comments

Comments
 (0)