1EXIMSTATS(8) EXIM EXIMSTATS(8)
2
6 eximstats - generates statistics from Exim mainlog or syslog files.
7
9 eximstats [Output] [Options] mainlog1 mainlog2 ...
10 eximstats -merge [Options] report.1.txt report.2.txt ... > weekly_report.txt
11 Output:
13 -txt
15 Output the results in plain text to STDOUT.
16 -txt=filename
18 Output the results in plain text. Filename '-' for STDOUT is
19 accepted.
20 -html
22 Output the results in HTML to STDOUT.
23 -html=filename
25 Output the results in HTML. Filename '-' for STDOUT is accepted.
26 -xls
28 Output the results in Excel compatible Format to STDOUT. Requires
29 the Spreadsheet::WriteExcel CPAN module.
30 -xls=filename
32 Output the results in Excel compatible format. Filename '-' for
33 STDOUT is accepted.
34 Options:
36 -hnumber
38 histogram divisions per hour. The default is 1, and 0 suppresses
39 histograms. Valid values are:
40 0, 1, 2, 3, 5, 10, 15, 20, 30 or 60.
42 -ne Don't display error information.
44 -nr Don't display relaying information.
46 -nr/pattern/
48 Don't display relaying information that matches.
49 -nt Don't display transport information.
51 -nt/pattern/
53 Don't display transport information that matches
54 -qlist
56 List of times for queuing information single 0 item suppresses.
57 -tnumber
59 Display top <number> sources/destinations default is 50, 0 sup‐
60 presses top listing.
61 -tnl
63 Omit local sources/destinations in top listing.
64 -t_remote_users
66 Include remote users in the top source/destination listings.
67 -include_original_destination
69 Include the original destination email addresses rather than just
70 using the final ones. Useful for finding out which of your mailing
71 lists are receiving mail.
72 -show_dtlist
74 Show the delivery times (DT)for all the messages.
75 Exim must have been configured to use the +delivery_time logging
77 option for this option to work.
78 list is an optional list of times. Eg -show_dt1,2,4,8 will show the
80 number of messages with delivery times under 1 second, 2 seconds, 4
81 seconds, 8 seconds, and over 8 seconds.
82 -show_rtlist
84 Show the receipt times for all the messages. The receipt time is
85 defined as the Completed hh:mm:ss - queue_time_overall - the
86 Receipt hh:mm:ss. These figures will be skewed by pipelined mes‐
87 sages so might not be that useful.
88 Exim must have been configured to use the +queue_time_overall log‐
90 ging option for this option to work.
91 list is an optional list of times. Eg -show_rt1,2,4,8 will show the
93 number of messages with receipt times under 1 second, 2 seconds, 4
94 seconds, 8 seconds, and over 8 seconds.
95 -byhost
97 Show results by sending host. This may be combined with -bydomain
98 and/or -byemail and/or -byedomain. If none of these options are
99 specified, then -byhost is assumed as a default.
100 -bydomain
102 Show results by sending domain. May be combined with -byhost
103 and/or -byemail and/or -byedomain.
104 -byemail
106 Show results by sender's email address. May be combined with
107 -byhost and/or -bydomain and/or -byedomain.
108 -byemaildomain or -byedomain
110 Show results by sender's email domain. May be combined with
111 -byhost and/or -bydomain and/or -byemail.
112 -pattern Description /Pattern/
114 Look for the specified pattern and count the number of lines in
115 which it appears. This option can be specified multiple times. Eg:
116 -pattern 'Refused connections' '/refused connection/'
118 -merge
120 This option allows eximstats to merge old eximstat reports
121 together. Eg:
122 eximstats mainlog.sun > report.sun.txt
124 eximstats mainlog.mon > report.mon.txt
125 eximstats mainlog.tue > report.tue.txt
126 eximstats mainlog.wed > report.web.txt
127 eximstats mainlog.thu > report.thu.txt
128 eximstats mainlog.fri > report.fri.txt
129 eximstats mainlog.sat > report.sat.txt
130 eximstats -merge report.*.txt > weekly_report.txt
131 eximstats -merge -html report.*.txt > weekly_report.html
132 * You can merge text or html reports and output the results as
134 text or html.
135 * You can use all the normal eximstat output options, but only
137 data included in the original reports can be shown!
138 * When merging reports, some loss of accuracy may occur in the
140 top n lists. This will be towards the ends of the lists.
141 * The order of items in the top n lists may vary when the data
143 volumes round to the same value.
144 -charts
146 Create graphical charts to be displayed in HTML output. Only valid
147 in combination with -html.
148 This requires the following modules which can be obtained from
150 http://www.cpan.org/modules/01modules.index.html
151 GD
153 GDTextUtil
154 GDGraph
155 To install these, download and unpack them, then use the normal
157 perl installation procedure:
158 perl Makefile.PL
160 make
161 make test
162 make install
163 -chartdirI <dir>
165 Create the charts in the directory <dir>
166 -chartrelI <dir>
168 Specify the relative directory for the "img src=" tags from where
169 to include the charts
170 -emptyok
172 Specify that it's OK to not find any valid log lines. Without this
173 we will output an error message if we don't find any.
174 -d Debug flag. This outputs the eval()'d parser onto STDOUT which
176 makes it easier to trap errors in the eval section. Remember to add
177 1 to the line numbers to allow for the title!
178
180 Eximstats parses exim mainlog and syslog files to output a statistical
181 analysis of the messages processed. By default, a text analysis is gen‐
182 erated, but you can request other output formats using flags. See the
183 help (-help) to learn about how to create charts from the tables.
184
186 There is a web site at http://www.exim.org - this contains details of
187 the mailing list exim-users@exim.org.
188
190 This program does not perfectly handle messages whose received and
191 delivered log lines are in different files, which can happen when you
192 have multiple mail servers and a message cannot be immeadiately deliv‐
193 ered. Fixing this could be tricky...
194 Merging of xls files is not (yet) possible. Be free to implement :)
196perl v5.8.8 2007-02-08 EXIMSTATS(8)