s/qmail:

Section: Misc. Reference Manual Pages (qmail-mrtg)
Updated: 8
Index Return to Main Contents

 

NAME

qmail-mrtg - prepare s/qmail logs for MRTG analysis  

SYNOPSIS

qmail-mrtg [ -1 | -2 | -3 | -4 | -5 | -6 | -a | -b | -c | -d | -e | -f | -g | -h | -i | -j | k | -z | -A | -B ] [time]

 

DESCRIPTION

qmail-mrtg reads the multilog tagged s/qmail logs with TAI64N timestamps on standard input to produce a counter for specifc s/qmail events and display them on standard output suitable for MRTG processing.

 

USAGE

qmail-mrtg can be used to analyse qmail-send, qmail-smtpd, and qmail-pop3d logs in order to feed the results into MRTG.

Typically, qmail-mrtg is called by the crontab facility together with a configuration files telling qmail-mrtg what to analyse.

 

ARGUMENTS

qmail-mrtg posses three different sets of commands. Reading qmail-send logs: -1 Deliveries/TLS transmitted, -2 Message KBytes enqueued, -3 Local/Remote Concurrency, -4 Failure/Deferred Messages, -5 Bounces/Triple bounces, -6 qmtp/qmtps Messages.

qmail-smtpd logs: -a total sessions, -b accepted/rejected sessions, -c rejected sessions (MTA), -d rejected originator, -e rejected recipient, -f rejected data (Mime + Loader), -g rejected data (Virus + Spam), -h authenticated sessions, -i accepted/rejected TLS sessions, -j recognized/rejected SPF sessions. -k deferred SMTP sessions (greylisted). Summaries are provided by -z total sessions, including qmail-smtpd and tcpserver/ sslserver/ rblsmtpd.

qmail-pop3d/ qmail-popup logs: -A accepted/rejected POP3 user, -B qmail-pop3d/ tcpserver/ sslserver connections.

The intervals to evaluate the information given on STDIN defaults to 305 secs and can be changed by the second argument for qmail-mrtg providing a value as minutes increased by an offset of 5 sec to cover a roll-over cut-off by crontab.  

CONFIGURATION FILES

qmail-mrtg depends on a configuration file for each service. Sample configuration files are provided.

 

CRON INVOCATION

Since qmail-mrtg typically is invoked by the cron facility, additional information neeeds to be supplied:


  */5 * * * * env LANG=C mrtg /etc/qmail-mrtg.send.cfg &>/dev/null
  */5 * * * * env LANG=C mrtg /etc/qmail-mrtg.smtpd.cfg &>/dev/null
  */5 * * * * env LANG=C mrtg /etc/qmail-mrtg.pop3d.cfg &>/dev/null

Note: The default interval of 305 secs allows a certain overlap for cron not to loose events at the very edge.

 

CREDITS

MRTG is a program created by Tobias Oetiker and Dave Rand (http://oss.oetiker.ch/mrtg/).

 

SEE ALSO

mrtg(1), crontab(5), cron(8), qmail-log(8), qmail-send(8), qmail-smtpd(8), qmail-popup(8).


 

Index

NAME
SYNOPSIS
DESCRIPTION
USAGE
ARGUMENTS
CONFIGURATION FILES
CRON INVOCATION
CREDITS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 12:19:24 GMT, December 09, 2024