Modular Log Analyzer (modlogan) - 0.8.x
Last edited: $Date: 2002/10/28 09:55:37 $
Overview
========
Modlogan is a modular logfile analyzer which is currently able to parse
ftp-, webserver and squid logs. The generated output can be viewed by a
webbrowser (->moglogan, webalizer) or your favorite text editor (->text).
The template engine allows you to create the output with your prefered look
and feel.
The different input and output modes are provided by some surrounding
plugins. For example the modlogan output plugin provides three different
menu structure for the same colourfull output while the output which is
generated by the webalizer output plugin looks similar to the output
generated by the original Webalizer known from
http://www.mrunix.net/webalizer/.
The input is handled the same way. One plugin is for the web server logs,
the next is for xferlog from FTP-servers like WuFTP and some others are for
mail-servers, streaming-server and so on.
Installation
------------
Read INSTALL for installation instructions.
Incompatible Changes
--------------------
0.7.x -> 0.8.0
..............
The update of the internal-files is done automaticly. Only the config-files
have to be changed.
0.6.x -> 0.7.0
..............
Can't convert anything. If you have script, commit them.
0.5.x -> 0.6.0
..............
the state file format has changed again. use the supplied
script to fix it. -> ./doc/convert_to_060.pl
call it on every state file:
$ mv modlogan.state.gz modlogan.state.gz.old
$ gzip -cd modlogan.state.gz.old | perl convert_to_060.pl | gzip -c > \
modlogan.state.gz
0.5.x -> 0.5.5
..............
some keys of the configfile have changed there layout. use the convert
script to fix it. -> ./doc/convert_to_055.pl
Configuration
-------------
Read INSTALL for a quickstart for more detailed instructions.
Mailinglists
------------
It is recommend to subscribe to the mailinglist of modlogan. It covers the
announces of new releases, some of the hotfixes which are regulary posted as
soon as a major bug is found and the normal discussion.
[You have to subscribe to the list before you can post to the list.]
Send a mail to (body and subject don't matter)
modlogan-subscribe@lists.netuse.de
The mailinglist-adress is
modlogan@lists.netuse.de
Updates
-------
You can get the latest source from
http://jan.kneschke.de/projects/modlogan/download/
Please make sure that you're using the lastest release if you find bug as
a new versions of modlogan is released multiple times a month.
New versions are announced on the mailinglist.
For the experienced
===================
Some parts of modlogan are tied to the fast moving internet. Especially the
list of the country strings will never be complete. You
could tell that the number of countries on earth is limited but watch out
for the new top level domain that will come up in the near future.
To be able to stay tuned modlogan has some special debug option that print
out the neccessary information.
Country Strings
---------------
If you get a message like
unknown country code: pa -> 0x70610000
appears on your screen, you discovered a new country in the world out there.
please, feel happy ... NOW.
ney, it's not a new country. it's just a country that isn't recognised by
modlogan, yet. just send me the line and i'll add it the list of detected
countries.
currently, modlogan knowns 236 countries by it's TLD.
please forward your country(string)s to Jan Kneschke <jan@kneschke.de>.
Input Parser
------------
There is no limitation in the number of different input types. If want that
the logfiles of your servers should be parsed by modlogan, send me the
logfile format definition and a sample logfile. this will enable me to write
the corresponding plugin.
it would be nice if you allow me to include the sample logfile into the CVS
which will ease the test process for external developers.
------------------------------------------------------------------------------
If you've found a bug, need a special feature or just want to tell me how
you like this piece of software, send your mail to:
Jan Kneschke <jan@kneschke.de> || modlogan@lists.netuse.de
(subscription required)
------------------------------------------------------------------------------
