munin-postfix/README.md

Low volume postfix_mailqueue munin plugin
=========================================

The original postfix_mailqueue plugin delivered with munin does very well
in many aspects. But it has a design related problem: to measure the number
of mails per queue (active, incomming, deferred, ...) it counts the entries
in the corresponding spool directories every 5 minutes (when munin core asks).
If a mail only stays a short time in a queue (especially active and incomming
queues) it won't get recognized by postfix_mailqueue.

Since on my low volume mailserver I'm interested in the total number of sent/
recieved messages in the last 5 minutes (for the deferred and hold queues the
original method is good enough since a mail there probably stays longer than
5 minutes) I changed the behavior and meaning of the "active" and "incomming"
graphs to "outgoing" (to the network) and "incomming" (from the network).
To determine the number of mails for these graphs the recent (5 minutes, hardcoded)
syslog entries are grep'ed for signaling sequences indicating some kind of
action of postfix.

Install
-------

Clone this repository or download the postfix_mailqueue file and create a
symlinkas *root* in /etc/munin/plugins by using e.g.:

	cd /etc/munin/plugins; ln -s /your/path/to/postfix_mailqueue postfix_mailqueue

(In case you already used the original plugin you should remove the old symlink.
Then **wait** about 10 minutes before add the new symlink described above.)

Next make sure that munin is allowed or at least allows this script to read
your *mail.log*. How to do this depends on your system.

On Debian 6 *mail.log* is owned by `root:adm` and readable by nobody but them.
The recommended way here is to advice munin to run postfix_mailqueue with group
adm (and user postfix, by default) by modifying */etc/munin/plugin-conf.d/munin-node*
where you should change/add a line to the `[postfix_mailqueue]` section:

	group adm

If you use LMTP (e.g. with dovecot) and want to count delivery via LMTP as 'incoming'
mail add another line with:

	env.incoming_regex postfix/lmtp\\[.*status=sent

If your *mail.log* is not located at */var/log/mail.log* (the default)
you should add another line with your custom path:

	env.maillog /var/log/mail.log

**Don't forget to restart your munin-node deamon.**

syslog5mins
-----------

This little bash function returns the entries of a file (created in format of
syslog default template; especially timestamp) of the last 5 minutes.