qmailmrtg.1

NAME

qmailmrtg - log indimail statistics to MRTG

SYNOPSYS

qmailmrtg options logdir [ servicedir ]

DESCRIPTION

qmailmrtg(1) reads multilog output files in logdir and prints output suitable for Multi Router Traffic Gropher MRTG(1). If the optional servicedir is given, qmailmrtg prints the uptime for the supervise(1) service configured in that directory. qmailmrtg reads from stdin if logdir is -.

qmailmrtg processes entries which aren't more than 5 minutes older than the start time and not newer than the start time. The default interval of 5 minutes can be changed by using the -I option, the end time can be changed by specifying the -E option. You can process the full log by specifying the -f option. qmailmrtg is called every 5 minutes to process 5 minutes of data in /etc/indimail/indimail.mrtg.cfg. If you desire a different frequency you need to also change the time interval of records to be processed.

qmailmrtg originates from qmailmrtg7 written by Inter7 using the standard C library. qmailmrtg has been re-written using libqmail, a library of general purpose APIs extracted from Dan Bernstein's qmail, reimplemented and covered by the GNU General Public License Version 2.

Take a look at /etc/indimail/indimail.mrtg.cfg for usage examples. indimail.mrtg.cfg expects qmailmrtg to be in /usr/libexec/indimail directory.

OPTIONS

-D
Turn on debugging

-E end_time
Use end_time as the maximum timestamp of records to be processed in logs in logdir.

-I interval
Change the time interval of records to process from the current time. As a default qmailmrtg processes only records which are less than 5 minutes older from end_time.

-f
Process all records in logs present in logdir.

-t
print current and configured concurrency for tcpserver(1)

-a
print allowed and denied connections by tcpserver(1)

-s
print success and failure rate per hour from qmail-send(8) mail delivery log.

-m
print success and attempt rate per hour from qmail-send(8) mail delivery log. An attempt is calculated as the sum of successful attempt and a deferred attempt.

-c
print remote and local delivery concurrency from qmail-send(8) mail delivery log.

-b
print bits transferred from qmail-send(8) mail delivery log.

-q
print total messages in queue and total unprocessed messages in queue /var/indimail/queue.

-Q
print total local messages in queue and total remote messages in queue /var/indimail/queue.

-l
This option counts the number of lines of all files in dir and prints the hourly rate lines per hour.

-u
print total unsubscriptions per hour.

-v
print total pages viewed and total pages clicked.

-S
print total ham and total spam messages delivered.

-C
print messages found to have virus and messages that failed to be scanned.

-d
print dnscache cached and total requests.

-i subopt
print stats for inlookup queries where subopt specfies stats for user, relay, password, limit, alias, host domain, cached requests respectiviely.

-p split
Use confsplit for indimail queue as split. Default 23

-B
Use bigtodo configuration for indimail queue. Default is not to use.

SEE ALSO

mrtg(1) snmpd(8) supervise(8), multilog(8), tcpserver(8) qmail-send(8), slowq-send(8), qmta-send(8), inlookup(8),