Difference between revisions of "Email Statistics"

From SME Server
Jump to navigationJump to search
(mention qplogsumm.pl & server-manager.)
Line 1: Line 1:
 
==Email Statistics==
 
==Email Statistics==
 
How to get statistics about the performance of your mail server
 
How to get statistics about the performance of your mail server
===Brian Read's spamfilter-stats-7.pl===
+
 
 +
===Built-In Statistical Reports===
 +
====Server-Manager====
 +
Some email statistics can be seen from server-manager under "Administration", "Mail log file analysis"
 +
 
 +
====qplogsumm.pl====
 +
SME 7.2 and later include the 'logterse' plugin to qpsmtpd as well as the 'qplogsumm.pl' statistics script.  'qplogsumm.pl' creates and updates /var/log/qpsmtpd/state which shows per-plugin statistics for any qpsmtpd plugin that appears in a qpsmtpd logterse entry.
 +
 
 +
===Contribs & Addons===
 +
====Brian Read's spamfilter-stats-7.pl====
 
Brian Read's mailstats.pl script analyzes your qpsmtpd log files and sends a daily email to "admin" summarizing that day's email activity.
 
Brian Read's mailstats.pl script analyzes your qpsmtpd log files and sends a daily email to "admin" summarizing that day's email activity.
  
====Download & Installation====
+
=====Download & Installation=====
 
  <nowiki>wget -O /etc/cron.d/mailstats.cron \
 
  <nowiki>wget -O /etc/cron.d/mailstats.cron \
 
http://mirror.contribs.org/smeserver/contribs/bread/mailstats/mailstats.cron</nowiki>
 
http://mirror.contribs.org/smeserver/contribs/bread/mailstats/mailstats.cron</nowiki>
Line 11: Line 20:
 
'''WARNING''': Make sure that these files are accessible before executing the above commands!  If you are unable to access http://mirror.contribs.org/smeserver/contribs/bread/mailstats/ the above commands will create empty files, overwriting existing versions.
 
'''WARNING''': Make sure that these files are accessible before executing the above commands!  If you are unable to access http://mirror.contribs.org/smeserver/contribs/bread/mailstats/ the above commands will create empty files, overwriting existing versions.
  
====Change Email Recipient====
+
=====Change Email Recipient=====
 
The email recipient is specified in the spamfilter-stats-7.pl file, currently (v0.6.11) at line 108, using:
 
The email recipient is specified in the spamfilter-stats-7.pl file, currently (v0.6.11) at line 108, using:
 
   $opt{'mail'}    = "admin";
 
   $opt{'mail'}    = "admin";
 
which will deliver email to the local 'admin' account on your SME server.  Configure email forwarding in server-manager::Collaboration::Users::admin to deliver the emails to another location.
 
which will deliver email to the local 'admin' account on your SME server.  Configure email forwarding in server-manager::Collaboration::Users::admin to deliver the emails to another location.
  
====Handling @*.u Logfiles====
+
=====Handling @*.u Logfiles=====
 
Multilog occasionally generates log files that end in ".u" instead of ".s".  The [http://cr.yp.to/daemontools/multilog.html| multilog manual] says this:
 
Multilog occasionally generates log files that end in ".u" instead of ".s".  The [http://cr.yp.to/daemontools/multilog.html| multilog manual] says this:
 
* ''.s: This file is completely processed and safely written to disk.''
 
* ''.s: This file is completely processed and safely written to disk.''

Revision as of 17:14, 28 August 2007

Email Statistics

How to get statistics about the performance of your mail server

Built-In Statistical Reports

Server-Manager

Some email statistics can be seen from server-manager under "Administration", "Mail log file analysis"

qplogsumm.pl

SME 7.2 and later include the 'logterse' plugin to qpsmtpd as well as the 'qplogsumm.pl' statistics script. 'qplogsumm.pl' creates and updates /var/log/qpsmtpd/state which shows per-plugin statistics for any qpsmtpd plugin that appears in a qpsmtpd logterse entry.

Contribs & Addons

Brian Read's spamfilter-stats-7.pl

Brian Read's mailstats.pl script analyzes your qpsmtpd log files and sends a daily email to "admin" summarizing that day's email activity.

Download & Installation
wget -O /etc/cron.d/mailstats.cron \
http://mirror.contribs.org/smeserver/contribs/bread/mailstats/mailstats.cron
wget -O /usr/bin/spamfilter-stats-7.pl \
http://mirror.contribs.org/smeserver/contribs/bread/mailstats/spamfilter-stats-7.pl

WARNING: Make sure that these files are accessible before executing the above commands! If you are unable to access http://mirror.contribs.org/smeserver/contribs/bread/mailstats/ the above commands will create empty files, overwriting existing versions.

Change Email Recipient

The email recipient is specified in the spamfilter-stats-7.pl file, currently (v0.6.11) at line 108, using:

 $opt{'mail'}     = "admin";

which will deliver email to the local 'admin' account on your SME server. Configure email forwarding in server-manager::Collaboration::Users::admin to deliver the emails to another location.

Handling @*.u Logfiles

Multilog occasionally generates log files that end in ".u" instead of ".s". The multilog manual says this:

  • .s: This file is completely processed and safely written to disk.
  • .u: This file was being created at the moment of an outage. It may have been truncated. It has not been processed.

While these files should not be generated under normal circumstances, they are (as attested by personal experience, forum posts and bug reports). In order to include these files when reporting email statistics, you will need to modify /etc/cron.d/mailstats.cron by changing

0    0   *    *   *    root    perl /usr/bin/spamfilter-stats-7.pl /var/log/qpsmtpd/*.s /var/log/qpsmtpd/current

to

0    0   *    *   *    root    perl /usr/bin/spamfilter-stats-7.pl /var/log/qpsmtpd/*.[us] /var/log/qpsmtpd/current

or

0    0   *    *   *    root    perl /usr/bin/spamfilter-stats-7.pl /var/log/qpsmtpd/@* /var/log/qpsmtpd/current