1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
.TH eximstats 8
.SH NAME
eximstats \- exim mail statistics
.SH SYNOPSIS
.B eximstats [options]
.SH "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
'envelope' (e.g. an SMTP transaction with more than one RCPT TO command) is
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:
.SH OPTIONS
.TP
.B -nt
Suppress the statistics about delivery by transport.
.TP
.B -h<n>
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 <n> gives the number of divisions per hour, so -h2 sets an
interval of 30 minutes, and the default is equivalent to -h1.
.TP
.B -q0
Suppress information about times messages spend on the queue.
.TP
.B -q<n1>...
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.
.TP
.B -nr
Suppress information about messages relayed through this host.
.TP
.B -nr/pattern/
Suppress information about relayed messages that match the pattern,
which is matched against a string of the form
H=<host> A=<address> => H=<host> A=<address>
for example
H=in.host A=from@some.where => H=out.host A=to@else.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.
.TP
.B -t<n>
Sets the 'top' count to <n>. This controls the listings of the 'top
<n>' hosts and users by count and volume. The default is 50, and
setting 0 suppresses the output altogether.
.TP
.B -tnl
Omit local information from the 'top' listings.
.TP
.B -ne
Suppress the list of delivery errors.
.SH "SEE ALSO"
There is extensive documentation available in
.I /usr/doc/exim
and in the info system regarding exim.
Please be sure to have the
.B exim-doc
package installed.
.SH AUTHOR
This manual page was stitched together by Christoph Lameter <clameter@debian.org>
from the original documentation coming with the sourcepackage
for the Debian GNU/Linux system.
|
