The version of Apache log4j used by SoundHelix.
Clone
HTTPS:
git clone https://vervis.peers.community/repos/aEp6o
SSH:
git clone USERNAME@vervis.peers.community:aEp6o
Branches
Tags
- 1.3alpha-7
- CHAINSAW_2_SANDBOX_MERGE
- CORE_VERSION
- LEVEL_REPLACES_PRIORITY
- PREALPHA_1_3_AS_OF_2004_05_12
- PRE_CHAINSAW_MODEL_CONVERSION
- PRE_UGLI_MOVE
- TAG_CHAINSAW2_MOVE
- log4j-1.2.17
- log4j-1.2.17-rc1
- v1.3alpha8
- v1.3alpha8-temp
- v1_2_1
- v1_2_10-recalled
- v1_2_11
- v1_2_11_rc1
- v1_2_11rc3
- v1_2_12
- v1_2_12_rc1
- v1_2_12_rc2
- v1_2_12_rc3
- v1_2_12_rc4
- v1_2_12_rc5
- v1_2_12_rc6
- v1_2_13
- v1_2_13_rc1
- v1_2_13_rc2
- v1_2_13_site_update
- v1_2_14
- v1_2_14_maven
- v1_2_14_rc1
- v1_2_14_site_update
- v1_2_15
- v1_2_15_rc1
- v1_2_15_rc2
- v1_2_15_rc3
- v1_2_15_rc4
- v1_2_15_rc5
- v1_2_15_rc6
- v1_2_16
- v1_2_16_rc1
- v1_2_16_rc2
- v1_2_17
- v1_2_17-rc1
- v1_2_17_rc1
- v1_2_17_rc2
- v1_2_17_rc3
- v1_2_2
- v1_2_3
- v1_2_4
- v1_2_6
- v1_2_7
- v1_2_9
- v1_2_alpha0
- v1_2_alpha7
- v1_2beta1
- v1_2final
- v1_3alpha_1
- v1_3alpha_6
- v_1_0
- v_1_0_1
- v_1_0_4
- v_1_1
- v_1_1_1
- v_1_1_2
- v_1_1_3
- v_1_1_b1
- v_1_1b2
- v_1_1b3
- v_1_1b5
- v_1_1b6
- v_1_1b7
- v_1_2beta3
v1_2_14_site_update
:: docs
/
chainsaw.html
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- Content Stylesheet for Site -->
<!-- start the processing -->
<!-- ====================================================================== -->
<!-- GENERATED FILE, DO NOT EDIT, EDIT THE XML FILE IN xdocs INSTEAD! -->
<!-- Main Page Section -->
<!-- ====================================================================== -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
<meta name="author" value="Paul Smith">
<meta name="email" value="psmith@apache.org">
<link href="./css/site.css" rel="stylesheet" type="text/css"/>
<title>Log4j project - Chainsaw v2 Documentation</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
<!-- START Header table -->
<table class="banner" border="0">
<tr>
<td valign="top">
<a href="http://logging.apache.org/">
<img src="http://logging.apache.org/images/ls-logo.jpg" border="0"/>
</a>
<td align="right">
<a href="http://logging.apache.org/log4j/docs/">
<img src="./images/logo.jpg" alt="The log4j project" border="0"/>
</a>
</td>
</tr>
</table>
<!-- END Header table -->
<div class="centercol">
<hr noshade="" size="1"/>
<h1>Chainsaw v2 - Introduction/Table of Contents</strong></h1>
<p>Welcome to the home of Chainsaw v2!</p>
<p>Chainsaw v2 is a companion application to Log4j written by members of the Log4j development
community. Like a number of Open Source
projects, this new version was built upon inspirations, ideas and creations of others.
Chainsaw v2 has it's roots from the original Chainsaw utility written by Oliver Burn,
and with inspiration from the Log Factor 5 utility contributed by ThoughtWorks Inc. </p>
<h1>Download</strong></h1>
<p>Latest Build Date: 2006-03-02 (SVN tag 'release_20060302')
</p>
<p>
<ul>
<li><a href="http://logging.apache.org/log4j/docs/webstart/chainsaw/chainsawWebStart.jnlp">Java Web Start <img alt="WebStart distribution" src="http://java.sun.com/products/jfc/tsc/sightings/images/webstart.small.jpg" border="0" /></a></li>
<li><a href="http://logging.apache.org/log4j/docs/webstart/chainsaw/chainsaw.dmg">OS X 'native' distribution</a> <font size="-1">(uses Java still, but looks like a real OSX application)</font></li>
<li><a href="http://logging.apache.org/log4j/docs/webstart/chainsaw/chainsaw-bundle.zip">Unix/Dos standalone</a> <font size="-1">(.bat/.sh)</font></li>
<p /> <ul>
<li><font size="-1"><a href="#VFSNotes"><b>Important Distribution notes!!/Using DB/JMS or VFS with Chainsaw</b></a></font></li>
</ul>
</ul>
</p>
<h1>Table of Contents</strong></h1>
<ul>
<li><a href="#WhatIsIt">So what is it really?</a></li>
<li><a href="#QuickTour">Quick Tour of Chainsaw features</a></li>
<li><a href="#ProjectStatus">Project Status/Support/Feedback</a></li>
<li><a href="#Installation">Installation</a></li>
<li><a href="#GettingStarted">Getting Started</a></li>
<li><a href="#Tutorial">Tutorial and User Manual</a></li>
<li><a href="#ZeroConf">ZeroConf - Zero Configuration</a></li>
<!--<li><a href="#Screenshots">Screenshots</a></li>-->
</ul>
<h1>So what is it really?</strong></h1>
<p><a name="WhatIsIt">�</a>It's a GUI-based Log viewer. A picture tells a thousand words...</p>
<p><a href="images/chainsaw-fullscreen.jpg" target="_new"><img src="images/chainsaw-fullscreen-small.jpg" /></a></p>
<p><a href="images/chainsaw-fullscreen.jpg" target="_new">[zoom image]</a></p>
<p>These screen shots were taken on Windows 2000, running Sun JDK 1.4.2.</p>
<p>Rather than rely on a combination of tail/grep/vi or equivalent to view/query/trace-through
a huge trail of logging events, you can use Chainsaw. Chainsaw can read log files formatted in Log4j's XMLLayout, receive
events from remote locations, read events from a DB, it can even work with the JDK 1.4 logging events.</p>
<h1>Quick Tour of Chainsaw features</strong></h1>
<p><a name="QuickTour">�</a> Heres just a <b>brief</b> run down of some of the features of Chainsaw v2:</p>
<ul>
<li><b>View remote events</b> - Remote events are "received" by Chainsaw using Log4j 1.3's new Receiver concept.</li>
<li><b>Saved Preferences</b> - You can fully customize each Tab the way you want it, and it will restore it's state the next time.</li>
<li><b>Responsive</b> - When events are screaming in, you don't want the GUI to meltdown. You can control
how responsive the GUI is and determine the frequency of updates.</li>
<li><b>Tabs/Docking</b> - Chainsaw routes separate applications/remote hosts' events to a unique Tab within the GUI.
These tabs can be undocked from the main window. Using these features you can manage multiple application logs using the one GUI.</li>
<li><b>Coloring</b> - You can specify your own rules to color each event row depending on the attributes of a LoggingEvent to
help you locate important events.</li>
<li><b>Dynamic and powerful filtering</b> - Helps you locate stuff. There's support for quick-and-dirty filtering, right through to advanced expression-based filtering (e.g. <code> "LOGGER == 'com.mycompany' && LEVEL == ERROR" </code>).</li>
<li><b>Cyclic</b> - A tab view can support a Cyclic-based model, which constrains it's view to the last
X events, ensuring you don't hog memory. This is great for monitoring live applications.</li>
<li><b>Built-in documentation and tutorial</b> - HTML-based documentation included in the package.</li>
</ul>
<h1>Tutorial and User Manual</strong></h1>
<p><a name="ExtraDocs">�</a>Chainsaw already includes help with
with a Quick Reference and a Tutorial to get you started, all viewable from <b>within the GUI</b>!. A User Manual will be made available around release time. </p>
<h1>Distribution Notes</strong></h1>
<p><a name="VFSNotes" />Due to Java classloading rules, it is impossible to ship the <a href="http://jakarta.apache.org/commons/vfs">Jakarta Commons VFS</a> extension to Chainsaw
<b>OR</b> have DBReceiver or JMSReceiver bundled with Chainsaw.
Several VFS filestore implementation jars cannot be shipped with Chainsaw because of licensing issues, and for JMSReceiver and DBReceiver you are required
to have proprietary driver jars locally which we obviously can't ship. You can follow these steps to enable the DB, JMS and/or VFS components inside Chainsaw.
<ol>
<li>[DBReceiver] Download the <a href="http://logging.apache.org/log4j/docs/webstart/chainsaw/log4j-db-1.3alpha-7.jar">DB extension</a> to Chainsaw</li>
<li>[JMSReceiver] Download the <a href="http://logging.apache.org/log4j/docs/webstart/chainsaw/log4j-jms-1.3alpha-7.jar">JMS extension</a> to Chainsaw</li>
<li>[VFS] Download the <a href="http://logging.apache.org/log4j/docs/webstart/chainsaw/log4j-chainsaw-vfs.jar">VFS extension</a> to Chainsaw</li>
<li>[VFS] Download <a href="http://cvs.apache.org/builds/jakarta-commons/nightly/commons-vfs/">VFS</a></li>
<li>[VFS] Download <a href="http://jakarta.apache.org/site/downloads/downloads_commons-logging.cgi">Commons Logging</a> Jars</li>
<li>[VFS] Download the VFS <a href="http://jakarta.apache.org/commons/vfs/download.html">filestore implementation jars</a> you wish to use</li>
<li>Place all these jars in your .chainsaw/plugins directory (the .chainsaw directory is in your home directory)</li>
<li>Start Chainsaw, which should now recognize the existence of these components and allow you to use them.</li>
</ol>
</p>
<p>This applies to all distributions.</p>
<h1>ZeroConf - Zero Configuration</strong></h1>
<p><a name="ZeroConf" />Chainsaw has ZeroConf elements embedded within it, but you'll need to add a few things
to your application to enable <b>your</b> application for ZeroConf.</p>
<p>Download:</p>
<ol>
<li><a href="http://logging.apache.org/log4j/docs/webstart/chainsaw/log4j-zeroconf.zip">log4j ZeroConf extension</a></li>
<li><a href="http://sourceforge.net/projects/jmdns/">JmDNS bundle</a></li>
<li>Add the <code>log4j-zeroconf.jar</code> and the <code>jmdns.jar</code> from these bundles and add them to your
application's classpath. </li>
<li>Modify your log4j configuration so that it use the ZeroConfSocketHubAppender. Here is a complete log4j.xml file that you can use as a base:
<pre>
<log4j:configuration debug="false" threshold="debug" xmlns:log4j="http://jakarta.apache.org/log4j/>
<appender name="zeroconf" class="org.apache.log4j.net.ZeroConfSocketHubAppender">
<param name="Name" value="MyZeroConfSockeHubAppender" />
</appender>
<!--ROOT Logger-->
<root>
<level value="INFO" />
<appender-ref ref="zeroconf" />
</root>
</log4j:configuration>
</pre>
</li>
</ol>
<hr/>
<!-- FOOTER -->
<div align="center"><font color="#525D76" size="-1"><em>
Copyright © 1999-2006, Apache Software Foundation.<br />
Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
</em></font></div>
<!-- END main table -->
<!-- LEFT SIDE NAVIGATION -->
<!-- ============================================================ -->
<div class="leftcol">
<div class="menu_header">Log4j Project</div>
<div class="menu_item"> <a href="./index.html">Introduction</a>
</div>
<div class="menu_item"> <a href="./download.html">Download</a>
</div>
<div class="menu_item"> <a href="./documentation.html">Documentation</a>
</div>
<div class="menu_item"> <a href="./chainsaw.html">Chainsaw</a>
</div>
<div class="menu_item"> <a href="./plan.html">Roadmap</a>
</div>
<div class="menu_item"> <a href="http://wiki.apache.org/logging-log4j/Log4JProjectPages">Wiki</a>
</div>
<div class="menu_item"> <a href="./history.html">History</a>
</div>
<div class="menu_header">Logging Services</div>
<div class="menu_item"> <a href="http://logging.apache.org/">Home page</a>
</div>
<div class="menu_item"> <a href="http://logging.apache.org/site/news.html">News</a>
</div>
<div class="menu_item"> <a href="http://logging.apache.org/site/mailing-lists.html">Mailing Lists</a>
</div>
<div class="menu_item"> <a href="http://logging.apache.org/site/bugreport.html">Bug Reporting</a>
</div>
<div class="menu_header">Translations</div>
<div class="menu_item"> <a href="http://jakarta.apache-korea.org/log4j/index.html">Korean</a>
</div>
<div class="menu_item"> <a href="http://www.ingrid.org/jajakarta/log4j/">Japanese</a>
</div>
</div>
</body>
</html>
<!-- end the processing -->