It looks good to me. The biggest problem I had when first using Chainsaw was that I ignored the popup screen it showed me when the program first started that prompted me to specify a config file. I would always hit cancel instead of picking an xml config file. You might want to add a sentance saying something like "Before Chainsaw can display data, one or more receivers must be setup. This is usually done by specifiying an xml config file when the program first starts up. Save one or more of the sample xml config files to your local system and load them when Chainsaw starts." Of course you can modify the verbage on that...
I had been using a local copy of Chainsaw from September 2, 2004. I went to the Chainsaw webpage this weekend and clicked on the: *** Got Java Web Start installed?: [Launch now!]*** link and loaded the latest version of Chainsaw from February 22, 2005. Everything worked fine (locationInfo displayed correctly) using log4net 1.2.0 beta 8. I'll work on writing up more examples like how to use Chainsaw to connect to a MySql or Sql Server database and query it for information every XX seconds. Or how to setup Chainsaw so it automatically starts new tabs for certain receivers. Scott posted his file but not every .Net developer knows what .jars are needed and where they need to be placed for things like this: <param name="driverClass" value="com.mysql.jdbc.Driver"/> to work correctly. --- Nicko Cadell <[EMAIL PROTECTED]> wrote: > Ron, > > I hereby appoint you the expert on Chainsaw interoperability ;) > > I have tried to extract the important points from the list and put > them > together in the html page attached. (If nothing is attached then the > list is dropping attachments again :( > > The real document is the xml version, that it used to generate the > html > page, I have not included the style sheet so the html doesn't look to > great. > > Can you have a look at this and see if it makes sense; factually > correct > would be a good start. > > Cheers, > Nicko > > > > -----Original Message----- > > From: Ron Grabowski [mailto:[EMAIL PROTECTED] > > Sent: 22 April 2005 22:26 > > To: Log4NET User > > Subject: Re: Log4Net Viewer > > > > In this thread: > > > > http://marc.theaimsgroup.com/?t=111401309600006&r=1&w=2 > > > > on the log4j mailing list, Scott Deboy posted his Chainsaw: > > > > http://logging.apache.org/log4j/docs/chainsaw.html > > > > config file that he uses to query a Sql Server database every > > 3 seconds for new log entries. It doesn't matter how the data > > got into the database (i.e. log4net, log4j, log4php, etc.). > > > > I use Chainsaw and log4net's UDPAppender to view logs from > > remote machines as well as my own machine. > > > > Here is a link (I think this is the 4th time I've described > > this process...can we add this to the log4net website Nicko?) > > on how to set things up: > > > > http://marc.theaimsgroup.com/?l=log4net-user&m=110816680703194&w=4 > > > > - Ron > > > > --- Howard Weisberg <[EMAIL PROTECTED]> wrote: > > > What kind of Log4Net viewers are available either thru the > > project or > > > from other sources? > > > > > > Particularly useful would be a viewer that works with logs > > kept in SQL > > > Server. We'd like to avoid reinventing the wheel. > > > > > --------------------------------- log4net - How To view logging events using Apache log4j Chainsaw How To view logging events using Apache log4j Chainsaw Contents Logging via UDP log4net UDP Configuration Chainsaw UDP receiver Configuration Logging to XML file Apache log4j includes Chainsaw a graphical log viewer. Chainsaw can either receive and display log events in realtime over the network, or it can load a previously created log file. Logging via UDP log4net can be configured to log messages via UDP in such a way that Chainsaw can receive and display them. log4net UDP Configuration Configure log4net to use a UdpAppender with the following config snippet: <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> Chainsaw UDP receiver Configuration Chainsaw should be configured to start a UDPReceiver using the following configuration document: <?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> Logging to XML file 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: <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> To load the file into Chainsaw drag the file into the Chainsaw app and drop it on the tab labeled Drag & Drop log files here. Copyright #169; 2004-2005, Apache Software Foundation Apache Apache Home Logging Services log4net Project About License Support Roadmap Contributing History Downloads log4net 1.2 Documentation Features Supported Frameworks Release Notes Example Apps Config Examples Building FAQ SDK Reference log4net 1.2 Manual Introduction Configuration Contexts Plugins Repositories Internals > <?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>How To view logging events using Apache log4j > Chainsaw</title> > </properties> > > <meta name="keywords" content="chainsaw log4net, log4net" /> > > <body> > <section 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> > > <section 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 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 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 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> >
