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) ------------------------------------------------------------------------------