Modlogan is a modular logfile anaylizer. It is designed to have variable
input, processing and output modules to give one a good flexiblity.
The input modules parse the logfiles. The processor modules summarize
the various data elements of a log file and is handed to the output
module which makes in most cases a pretty webpage showing all the
results.
So far there the following
input modules
supported: bsdftpd, clf, elmeg, flow, flowraw, hicom116, ipchains, isdn4bsd
isdnlog, msiis, msmedia, netscape, pureftpd, qmail, qmailscanner, qtss,
realserver, sendmail, shoutcast, squid, wuftpd (also includes lgofiles from
proftpd and the like).
The following
processor modules
are supported: accounting, mail, telecom, web.
And finally the
output modules
: csv, modlogan, template, tkcontrol, text, webalizer
OPTIONS
-c configfile
Specify another configuration file than the default
/etc/modlogan/modlogan.conf
-r
It is not recommended to run modlogan as root. By default this is not
permitted. If you still want to run it as root you have to use this option.
-u username
If you want to run modlogan as a specific user, you can use this option.
In order to use this function you have to combine it with the
-r
command line switch.
-o <section>:<key>=<value>
If you want to override certain configuration parameters this is how
it is done.
-h, --help
Shows the help text of the program and exits.
-v, --version
Shows the version number of the program and exits.
FILES
/etc/modlogan/modlogan.conf
This is the name and location of the default configuration file.
modlogan.def.conf
This file contains the default settings for all the necessary options that
modlogan can function.
group.*.conf
These files contain regular expressions to group certain aspects of
a logfile under a common term, like operating system, user agent, etc.
match.*.conf
These configuration files also contain regular expressions to match
a certain aspect of a logfile.
ignore.searchengines.conf
This is a blacklist for all the known searchengines to filter them out from
the logfiles.
FAQ
Setting the output directory via the commandline can be achieved using the
-o output_modlogan:outputdir=directory
option. You probably want to override
global:statedir
, too.