View Source: eximstats(8) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages
eximstats
!!!eximstats
NAME
SYNOPSIS
DESCRIPTION
OPTIONS
SEE ALSO
AUTHOR
----
!!NAME


eximstats - exim mail statistics
!!SYNOPSIS


__eximstats [[options] __
!!DESCRIPTION


A Perl script called eximstats is supplied in the util
directory. This has been hacked about quite a bit over time.
It now gives quite a lot of information by default, but
there are options for suppressing various parts of it.
Following any options, the arguments to the script are a
list of files, which should be main log files.


Eximstats extracts information about the number and volume
of messages received from or delivered to various hosts. The
information is sorted both by message count and by volume,
and the top 50 hosts in each category are listed on the
standard output. For messages delivered and received
locally, similar statistics are produced per
user.


The output also includes total counts and statistics about
delivery errors, and histograms showing the number of
messages received and deliveries made in each hour of the
day. A delivery with more than one address in its counted as
a single delivery by eximstats.


Though normally more deliveries than receipts are reported
(as messages may have multiple recipients), it is possible
for eximstats to report more messages received than
delivered, even though the spool is empty at the start and
end of the period in question. If an incoming message
contains no valid recipients, no deliveries are recorded for
it. An error report is handled as an entirely separate
message.


Eximstats always outputs a grand total summary giving the
volume and number of messages received and deliveries made,
and the number of hosts involved in each case. It also
outputs the number of messages that were delayed (that is,
not completely delivered at the first attempt), and the
number that had at least one address that
failed.


The remainder of the output is in sections that can be
independently disabled or modified by various options. It
consists of a summary of deliveries by transport, histograms
of messages received and delivered per time interval
(default per hour), information about the time messages
spent on the queue, a list of relayed messages, lists of the
top 50 sending hosts, local senders, destination hosts, and
destination local users by count and by volume, and a list
of delivery errors that occurred. The options are as
follows:
!!OPTIONS


__-nt__


Suppress the statistics about delivery by
transport.


__-h__


This option controls the histograms of messages received and
deliveries per time interval. By default the time interval
is one hour. If -h0 is given, the histograms are suppressed;
otherwise the value of


__-q0__


Suppress information about times messages spend on the
queue.


__-q__


This option sets an alternative list of time intervals for
the queueing information. The values are separated by commas
and are in seconds, but can involve arithmetic multipliers,
so for example you can set 3*60 to specify 3 minutes. A
setting such as


-q60,5*60,10*60


causes eximstats to give counts of messages that stayed on
the queue for less than one minute, less than five minutes,
less than ten minutes, and over ten minutes.


__-nr__


Suppress information about messages relayed through this
host.


__-nr/pattern/__


Suppress information about relayed messages that match the
pattern, which is matched against a string of the
form


H=


for example


H=in.host A=from@some.where =


The addresses are taken from the envelope, not the headers.
This option allows you to screen out hosts whom you are
happy to have using your host as a relay.


__-t__


Sets the 'top' count to


__-tnl__


Omit local information from the 'top' listings.


__-ne__


Suppress the list of delivery errors.
!!SEE ALSO


There is extensive documentation available in
''/usr/share/doc/exim'' and in the info system regarding
exim. Please be sure to have the __exim-doc__ package
installed.
!!AUTHOR


This manual page was stitched together by Christoph Lameter
----
One page links to eximstats(8):
Man8e
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
Last edited on Monday, June 3, 2002 6:56:37 pm by "perry"
Edit PageHistory Diff Info LikePages