
      -----------------------------------------------------
      mailgraph - a RRDtool frontend for Postfix Statistics
      by David Schweikert <dws@ee.ethz.ch>
      -----------------------------------------------------

mailgraph is a very simple mail statistics RRDtool frontend for Postfix
that produces daily, weekly, monthly and yearly graphs of received/sent 
and bounced/rejected mail (SMTP traffic).

Get it from:


         http:people.ee.ethz.ch/~dws/software/mailgraph/
	 ===============================================


Required Modules
----------------

- rrdtool and it's perl module (RRDs)
  -> http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/

- File::Tail (which requires Time::HiRes)
  -> get it from CPAN

Note that several Linux distributions will already have these modules as RPMs.


Usage
-----

mailgraph is made of two scripts:

- mailgraph.pl

  This script does parse syslog and updates the RRD database (mailgraph.rrd).
  
  usage: mailgraph.pl [*options*]
  
    -c, --cat          causes the logfile to be only read and not monitored
    -l, --logfile f    monitor logfile f instead of /var/log/syslog
    -h, --help         display this help and exit
    -v, --version      output version information and exit
    -y, --year         starting year of the log file (default: current year)
  
  If -c is not specified, mailgraph will monitor logfile for Postfix log entries
  in logfile (/var/log/syslog unless -l is specified).

- mailgraph.cgi

  This is a CGI script that does generate graphics from the RRD database.

  You have probably to change $rrd to point to where the RRD database is stored.


License
-------

mailgraph is released under the GPL license. See the file COPYING included in
the distribution for details.
