3 The amavis-logwatch(1) utility is an Amavisd-new log parser, that pro-
4 duces summaries, details, and statistics regarding the operation of
7 This utility can be used as a standalone program, or as a Logwatch fil-
8 ter module to produce Amavis summary and detailed reports from within
11 A key feature of amavis-logwatch is its ability to produce a very wide
12 range of reports with data grouped and sorted as much as possible to
13 reduce noise and highlight patterns. Brief summary reports provide a
14 quick overview of general Amavis operations and message scanning,
15 calling out warnings that may require attention. Detailed reports pro-
16 vide easy to scan, hierarchically-arranged and organized information,
17 with as much or little detail as desired.
19 ##### Installation: standalone
21 The included Makefile will install the amavis-logwatch utility
24 make install-standalone
26 to install the utility and its configuration file. Installation
27 will default to /usr/local/bin and /usr/local/etc, respectively.
29 ##### Installation: logwatch
31 To use amavis-logwatch as a logwatch script, the files:
36 will need to be installed into one of logwatch's known directories.
37 To avoid overwriting your existing default logwatch filter files,
38 the enclosed files can be installed into the global logwatch
39 installation directory, which is typically:
43 The included Makefile can be used to install the files into
44 /etc/logwatch for you. To install the filter into an existing
45 logwatch installation, run:
49 NOTE: the files amavis-logwatch and amavis-logwatch.conf must be
50 renamed (by removing the "-logwatch" suffix), for logwatch to
51 function correctly. The Makefile takes care of this. The
52 Makefile also disables perl's taint mode (-T) when running under
53 logwatch. If you install the files manually, be sure to remove
54 the -T from the first line of the amavis filter.
56 For non-standard installations, you will need to determine your
57 global logwatch directory, and define "prefix" in the attached
60 Alternatively, you can manually copy the files to their proper
63 cp amavis-logwatch /etc/logwatch/scripts/services/amavis
64 cp amavis-logwatch.conf /etc/logwatch/conf/services/amavis.conf
65 [ remove -T from line 1 of /etc/logwatch/scripts/services/amavis ]
68 cp amavis-logwatch.1 /usr/local/man/man1/amavis-logwatch.1
72 The amavis-logwatch utility is used standalone as:
74 amavis-logwatch /path/to/amavislog
78 amavis-logwatch --help
80 To use within logwatch:
82 logwatch --service amavis ...
84 See the amavis-logwatch(1) man page for complete details, and
85 see comments in the postfix-logwatch.conf file for additional
89 mike (at) cappella (dot) us
90 last updated: 01/11/2012