Logmonster Install

From The Network People, Inc. - Wiki
Jump to: navigation, search

Installation

Download Logmonster

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

Logmonster 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.