https://github.com/schweikert/mailgraph

Mail plotting script
https://github.com/schweikert/mailgraph

Last synced: about 1 month ago
JSON representation

Mail plotting script

• Host: GitHub
• URL: https://github.com/schweikert/mailgraph
• Owner: schweikert
• License: gpl-2.0
• Created: 2013-02-17T22:31:26.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2019-05-28T15:07:52.000Z (over 5 years ago)
• Last Synced: 2024-05-02T17:14:42.355Z (5 months ago)
• Language: Perl
• Size: 135 KB
• Stars: 68
• Watchers: 25
• Forks: 27
• Open Issues: 14
• Metadata Files:
  • Readme: README
  • Changelog: CHANGES
  • License: COPYING

Awesome Lists containing this project

README

        

      -----------------------------------------------------

      mailgraph - a RRDtool frontend for Postfix Statistics

      by David Schweikert 

      -----------------------------------------------------

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.