Repository
Munin (contrib)
Last change
2019-08-31
Graph Categories
Family
auto
Capabilities
Keywords
Language
Shell
License
GPL-2.0-only
Authors

postfix_stats

Name

postfix_stats - Munin plugin to monitor postfix statistics.

Applicable Systems

Any system where pflogsumm script can be executed.

Configuration

There is no default configuration. This is an example config for Ubuntu:

[postfix_stats*]
 group adm
 env.logfiles /var/log/mail.log /var/log/mail.log.1
 env.pflogsumm pflogsumm

env.logfiles contains space separated syslog logfiles, usually current log and previous log. You can add more log files if you want, but this may increase the time required for analysis.

env.pflogsumm The “pflogsumm” script, can be pflogsumm.pl if it was manually downloaded and installed, or “pflogsumm” if it was installed by a package manager (like apt-get).

Use the last part of the symlink name for filtering by hostname from logfile, which contains logs from multiple hosts (e.g. received via rsyslog from remote hosts).

For example:

cd /etc/munin/plugins
ln -s /path/to/postfix_stats postfix_stats_HOSTNAME

Interpretation

This plugin displays the messages: received, delivered, rejected… Average per minute is made and it shows the total message count. It is useful to know the load and messages being processed.

Magic Markers

#%# family=auto
#%# capabilities=autoconf

Version

0.3 support for hostname grep (useful when multiple hosts in one log) 0.2 plugin completely rewritten 0.1 first release.

Bugs

None known

Author

Originally: David Obando (david@cryptix.de) Modified by: github.com/cristiandeluxe Modified by: github.com/4nd3r Thanks to: sumpfralle

License

GPLv2

#!/bin/sh
# -*- sh -*-

: <<=cut

=head1 NAME

postfix_stats - Munin plugin to monitor postfix statistics.

=head1 APPLICABLE SYSTEMS

Any system where pflogsumm script can be executed.

=head1 CONFIGURATION

There is no default configuration. This is an example config for Ubuntu:

  [postfix_stats*]
   group adm
   env.logfiles /var/log/mail.log /var/log/mail.log.1
   env.pflogsumm pflogsumm

env.logfiles contains space separated syslog logfiles, usually current log
and previous log. You can add more log files if you want, but this may
increase the time required for analysis.

env.pflogsumm The "pflogsumm" script, can be pflogsumm.pl if it was manually
downloaded and installed, or "pflogsumm" if it was installed by a package
manager (like apt-get).

Use the last part of the symlink name for filtering by hostname from logfile,
which contains logs from multiple hosts (e.g. received via rsyslog from remote
hosts).

For example:

  cd /etc/munin/plugins
  ln -s /path/to/postfix_stats postfix_stats_HOSTNAME

=head1 INTERPRETATION

This plugin displays the messages: received, delivered, rejected...
Average per minute is made and it shows the total message count.
It is useful to know the load and messages being processed.

=head1 MAGIC MARKERS

  #%# family=auto
  #%# capabilities=autoconf

=head1 VERSION
  0.3 support for hostname grep (useful when multiple hosts in one log)
  0.2 plugin completely rewritten
  0.1 first release.

=head1 BUGS

None known

=head1 AUTHOR

Originally: David Obando (david@cryptix.de)
Modified by: github.com/cristiandeluxe
Modified by: github.com/4nd3r
Thanks to: sumpfralle

=head1 LICENSE

GPLv2

=cut

#set -xv
MAIL_LOG="${logfiles:-/var/log/mail.log /var/log/mail.log.1}"

FILTER_HOSTNAME=$(basename "$0" | sed -r 's/postfix_stats_?//')

# shellcheck disable=SC2154
PFLOGSUMM="${pflogsumm}"
[ -z "$PFLOGSUMM" ] && PFLOGSUMM="$(which pflogsumm pflogsumm.pl | head -1)"

# Fields (Array to avoid code duplication) must be space separated
FIELDS_ARR="received delivered forwarded deferred bounced rejected held discarded"

#
# Autoconf Section
#
if [ "$1" = 'autoconf' ]; then
	# Check if pflogsumm exist
	if [ -z "${PFLOGSUMM}" ]
		then
		echo 'no (pflogsumm not found in your system)'
	else
		echo 'yes'
	fi
	exit 0
fi

#
# Config Section
#
if [ "$1" = 'config' ]; then
	if [ -n "${FILTER_HOSTNAME}" ]; then
		echo "graph_title Postfix statistics for ${FILTER_HOSTNAME}"
	else
		echo 'graph_title Postfix statistics'
	fi
	echo 'graph_vlabel Postfix statistics'
	echo 'graph_category mail'
	echo 'graph_scale no'
	echo 'graph_period minute'
	echo 'graph_total Total'

	# Generate config for each field
	for i in $FIELDS_ARR; do
		echo "${i}.label ${i}"
		echo "${i}.type DERIVE"
		echo "${i}.min 0"
		echo "${i}.draw AREASTACK"
	done

	exit 0
fi

#
# Plugin Script
#

# Variable to store the pflogsumm result.
if [ -n "${FILTER_HOSTNAME}" ]; then
	# shellcheck disable=SC2086
	TMP_RAW=$(grep -Fh " ${FILTER_HOSTNAME} postfix/" ${MAIL_LOG} | "${PFLOGSUMM}" -d today --detail 0 --zero-fill)
else
	# shellcheck disable=SC2086
	TMP_RAW=$("${PFLOGSUMM}" -d today --detail 0 --zero-fill ${MAIL_LOG})
fi

# Parse value from Raw result
#
# Return digit if regex are parsed correctly
#
# Return U (undefined) if any error occurs
#
parseValue() {
	# shellcheck disable=SC2155
	local TMP_RETURN=$(echo "${TMP_RAW}" | grep -Ei "^[[:space:]]+[[:digit:]]+[[:space:]]+${1}.*$" | grep -oEi '[[:digit:]]+[[:space:]]+' | head -n 1 | sed 's: ::g')
	if [ -z "${TMP_RETURN}" ]; then
		echo 'U'
	else
		echo "${TMP_RETURN}"
	fi
}

# Print results
for i in $FIELDS_ARR; do
	printf "%s.value " "${i}"
	parseValue "${i}"
done