nicko 2005/05/02 14:31:47
Modified: xdocs/src index.xml
Added: xdocs/src/release/howto chainsaw.xml index.xml
Log:
Added Ron to list of contributors. Added how-to folder. Added Chainsaw how-to
Revision Changes Path
1.5 +5 -0 logging-log4net/xdocs/src/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/logging-log4net/xdocs/src/index.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- index.xml 2 May 2005 20:57:50 -0000 1.4
+++ index.xml 2 May 2005 21:31:47 -0000 1.5
@@ -94,6 +94,11 @@
</li>
<li>
<p>
+ <strong>Ron
Grabowski</strong><!-- [EMAIL PROTECTED] -->
+ </p>
+ </li>
+ <li>
+ <p>
<strong>Aspi
Havewala</strong><!-- [EMAIL PROTECTED] -->
</p>
</li>
1.1 logging-log4net/xdocs/src/release/howto/chainsaw.xml
Index: chainsaw.xml
===================================================================
<?xml version="1.0" ?>
<!--
Copyright 2004-2005 The Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<properties>
<author email="rongrabowski at yahoo dot com">Ron
Grabowski</author>
<author email="nicko at apache dot org">Nicko Cadell</author>
<title>How To view logging events using Apache log4j
Chainsaw</title>
</properties>
<meta name="keywords" content="chainsaw log4net, log4net" />
<body>
<section id="main" name="How To view logging events using
Apache log4j Chainsaw">
<sectionMenu name="Contents" />
<p>
Apache log4j includes <a
href="http://logging.apache.org/log4j/docs/chainsaw.html";>Chainsaw</a>
a graphical log viewer.
</p>
<p>
Chainsaw can either receive and display log
events in realtime over
the network, or it can load a previously
created log file.
</p>
<p>
Before Chainsaw can display data, one or more
receivers must be setup.
This is usually done by specifying an xml
config file when the program
first starts up. <br />
Save one or more of the sample xml config files
to your local system and
load them when Chainsaw starts.
</p>
<section id="udp" name="Logging via UDP">
<p>
log4net can be configured to log
messages via UDP in such a way that Chainsaw
can receive and display them.
</p>
<section id="udp-conf" name="log4net UDP
Configuration">
<p>
Configure log4net to use a
UdpAppender with the following config snippet:
</p>
<source language="xml"><![CDATA[
<appender name="UdpAppender" type="log4net.Appender.UdpAppender">
<remoteAddress value="127.0.0.1" />
<remotePort value="8080" />
<layout type="log4net.Layout.XmlLayoutSchemaLog4j">
<locationInfo value="true" />
</layout>
</appender>]]></source>
</section>
<section id="udp-chainsaw" name="Chainsaw UDP
receiver Configuration">
<p>
Chainsaw should be configured
to start a <c>UDPReceiver</c> using the
following configuration
document:
</p>
<source language="xml"><![CDATA[
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/";
debug="true">
<plugin name="UDPReceiver" class="org.apache.log4j.net.UDPReceiver">
<param name="Port" value="8080" />
</plugin>
</log4j:configuration>]]></source>
</section>
</section>
<section id="xml-file" name="Logging to XML file">
<p>
Chainsaw can also load an XML log file
if it is formatted according
to the log4j schema. Use the following
log4net config to output
to file using the log4j schema:
</p>
<source language="xml"><![CDATA[
<appender name="FileAppender" type="log4net.Appender.FileAppender">
<file value="log-file.txt" />
<appendToFile value="true" />
<layout type="log4net.Layout.XmlLayoutSchemaLog4j">
<locationInfo value="true" />
</layout>
</appender>]]></source>
<p>
To load the file into Chainsaw drag the
file into the Chainsaw
app and drop it on the tab labeled
<i>Drag & Drop log files here</i>.
</p>
</section>
</section>
</body>
</document>
1.1 logging-log4net/xdocs/src/release/howto/index.xml
Index: index.xml
===================================================================
<?xml version="1.0" ?>
<!--
Copyright 2004-2005 The Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<properties>
<author email="nicko at apache dot org">Nicko Cadell</author>
<title>log4net How Tos</title>
</properties>
<meta name="keywords" content="howto log4net, log4net" />
<body>
<section id="main" name="log4net How Tos">
<p>
Below are presented, in no particular order, a
series of documents
on how to get stuff done.
</p>
<p>
New documents can be contributed via the issue
tracking system.
See the <a
href="../../contributing.html">Contributing</a> page for
details.
</p>
<ul>
<li>
<p><a href="chainsaw.html">How To view
logging events using Apache log4j Chainsaw</a></p>
</li>
<!--
<li>
<p><a href="custom-appender.html">How
To write your own appender</a></p>
</li>
-->
</ul>
</section>
</body>
</document>
