Logmonster Install
Installation
Step 1. Install like any other perl module:
perl Makefile.PL make test make install
If you are missing any dependencies, they will be listed in the first step. The dependent modules can be installed via CPAN, or if you are running FreeBSD, you can have these installed from ports by running the included script:
bin/install_freebsd_deps.sh
Required dependencies:
- Compress::Zlib
- Date::Parse (TimeDate)
- Params::Validate
Step 2. Install the config file
make conf or make newconf
newconf will overwrite any existing config file, so use it only for new installs.
Step 3. Edit logmonster.conf
vi /usr/local/etc/logmonster.conf
Documentation is included inline. Configure it to match the way your server is set up.
Step 4 - Edit web server config
For Apache:
Adjust the CustomLog and ErrorLog directives. We make three changes, adding our custom LogFormat definition, CustomLog adding cronolog to automatically rotate the log files.
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %v" logmonster
CustomLog "| /usr/local/sbin/cronolog /var/log/http/%Y/%m/%d/access.log" logmonster
ErrorLog "| /usr/local/sbin/cronolog /var/log/http/%Y/%m/%d/error.log"
For lighttpd:
accesslog.format = "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %v"
accesslog.filename = "|/usr/local/sbin/cronolog /var/log/http/%Y/%m/%d/access.log"
server.errorlog = "/var/log/http/error.log"
Step 5 - Test manually, then add to cron.
/usr/local/bin/logmonster.pl -i day -v crontab -u root -e 5 1 * * * /usr/local/bin/logmonster.pl -i day
Step 5 - Read the FAQ
Step 6 - Enjoy
Allow Logmonster to make your life easier by handling your log processing. Enjoy the daily summary emails, and then express your gratitude by making a small donation to support future development efforts.