Author: fschumacher
Date: Thu Sep 6 20:46:24 2018
New Revision: 1840264
URL: http://svn.apache.org/viewvc?rev=1840264&view=rev
Log:
Update logging page to currently used configuration.
Apart from some markup changes this change uses the
OneLineFormatter for the example and mentions the
AsyncFileHandler.
Modified:
tomcat/trunk/webapps/docs/logging.xml
Modified: tomcat/trunk/webapps/docs/logging.xml
URL:
http://svn.apache.org/viewvc/tomcat/trunk/webapps/docs/logging.xml?rev=1840264&r1=1840263&r2=1840264&view=diff
==============================================================================
--- tomcat/trunk/webapps/docs/logging.xml (original)
+++ tomcat/trunk/webapps/docs/logging.xml Thu Sep 6 20:46:24 2018
@@ -17,6 +17,7 @@
-->
<!DOCTYPE document [
<!ENTITY project SYSTEM "project.xml">
+ <!ENTITY le "≤" >
]>
<document url="logging.html">
@@ -241,11 +242,12 @@
The default <code>logging.properties</code> in the JRE specifies a
<code>ConsoleHandler</code> that routes logging to System.err.
The default <code>conf/logging.properties</code> in Apache Tomcat also
- adds several <code>FileHandler</code>s that write to files.
+ adds several <code>AsyncFileHandler</code>s that write to files.
</p>
<p>
- A handler's log level threshold is INFO by default and can be set using
- SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST or ALL.
+ A handler's log level threshold is <code>INFO</code> by default and can be
set using
+ <code>SEVERE</code>, <code>WARNING</code>, <code>INFO</code>,
<code>CONFIG</code>,
+ <code>FINE</code>, <code>FINER</code>, <code>FINEST</code> or
<code>ALL</code>.
You can also target specific packages to collect logging from and specify
a level.
</p>
@@ -272,7 +274,7 @@ java.util.logging.ConsoleHandler.level=A
digit, and ends with '.'. For example, <code>22foobar.</code> is a valid
prefix.</li>
<li>System property replacement is performed for property values which
- contain ${systemPropertyName}.</li>
+ contain <code>${systemPropertyName}</code>.</li>
<li>If using a class loader that implements the
<code>org.apache.juli.WebappProperties</code> interface (Tomcat's
web application class loader does) then property replacement is also
@@ -290,14 +292,14 @@ java.util.logging.ConsoleHandler.level=A
<li> By default the log files will be kept on the file system
<code>90</code> days. This may be changed per handler using the
<code>handlerName.maxDays</code> property. If the specified value for the
- property is <code><=0</code> then the log files will be kept on the
+ property is <code>≤0</code> then the log files will be kept on the
file system forever, otherwise they will be kept the specified maximum
days.</li>
</ul>
<p>
There are several additional implementation classes, that can be used
- together with the ones provided by Java. The notable one is
- <code>org.apache.juli.FileHandler</code>.
+ together with the ones provided by Java. The notable ones are
+ <code>org.apache.juli.FileHandler</code> and
<code>org.apache.juli.AsyncFileHandler</code>.
</p>
<p>
<code>org.apache.juli.FileHandler</code> supports buffering of the
@@ -310,6 +312,12 @@ java.util.logging.ConsoleHandler.level=A
applied.
</p>
<p>
+ <code>org.apache.juli.AsyncFileHandler</code> is a subclass of
<code>FileHandler</code>
+ that queues the log messages and writes them asynchronously to the log
files.
+ Its additional behaviour can be configured by setting some
+ <a href="config/systemprops.html#Logging">system properties</a>.
+ </p>
+ <p>
Example logging.properties file to be placed in $CATALINA_BASE/conf:
</p>
<source><![CDATA[handlers = 1catalina.org.apache.juli.FileHandler, \
@@ -338,7 +346,7 @@ java.util.logging.ConsoleHandler.level=A
3manager.org.apache.juli.FileHandler.bufferSize = 16384
java.util.logging.ConsoleHandler.level = FINE
-java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
+java.util.logging.ConsoleHandler.formatter = java.util.logging.OneLineFormatter
############################################################
@@ -374,7 +382,7 @@ org.apache.juli.FileHandler.directory =
org.apache.juli.FileHandler.prefix = ${classloader.webappName}.
java.util.logging.ConsoleHandler.level = FINE
-java.util.logging.ConsoleHandler.formatter =
java.util.logging.SimpleFormatter]]></source>
+java.util.logging.ConsoleHandler.formatter =
java.util.logging.OneLineFormatter]]></source>
<subsection name="Documentation references">
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
