Permalink
Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
86 lines (55 sloc) 2.62 KB
-----------------------------------------------------
mailgraph - a RRDtool frontend for Postfix Statistics
by David Schweikert <david@schweikert.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://mailgraph.schweikert.ch/
===============================
Required Modules
----------------
- rrdtool and it's perl module (RRDs)
-> http://oss.oetiker.ch/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)
in the current directory.
It is a deamon and will monitor your log-file for changes.
DO NOT RUN IT WITH CRON!
usage: mailgraph.pl [*options*]
-h, --help display this help and exit
-v, --verbose be verbose about what you do
-V, --version output version information and exit
-c, --cat causes the logfile to be only read and not monitored
-l, --logfile f monitor logfile f instead of /var/log/syslog
-y, --year starting year of the log file (default: current year)
--host=HOST use only entries for HOST (regexp) in syslog
-d, --daemon start in the background
--daemon-pid=FILE write PID to FILE instead of /var/run/mailgraph.pid
--daemon-rrd=DIR write RRDs to DIR instead of /var/log
--daemon-log=FILE write verbose-log to FILE instead of /var/log/mailgraph.log
--ignore-localhost ignore mail to/from localhost (used for virus scanner)\n";
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.
Note that "Bounced", "Viruses", and "Spam" are stacked one on another in the
graph, whereas "Rejected" is a line.
Installation
------------
See the file mailgraph-init for an example init script that you can use to
start mailgraph at system boot.
You need to put mailgraph.cgi on somewhere accessible though a web-server, it
needs to be executeable and the web-server needs to execute it as a CGI.
License
-------
mailgraph is released under the GPL license. See the file COPYING included in
the distribution for details.