1LOGWATCH(8) User Manuals LOGWATCH(8)
2
6 logwatch - system log analyzer and reporter
7
9 logwatch [--detail level ] [--logfile log-file-group ] [--service ser‐
10 vice-name ] [--mailto address ] [--archives] [--range range ] [--debug
11 level ] [--filename file-name ] [--logdir directory ] [--hostlimit
12 hosts ] [--hostname hostname ] [--html_wrap number of characters ]
13 [--hostformat host based options ] [--output output-type ] [--format
14 report format ] [--subject email subject ] [--encode encoding to use ]
15 [--numeric] [--version] [--help|--usage]
16
18 Logwatch is a customizable, pluggable log-monitoring system. It will
19 go through your logs for a given period of time and make a report in
20 the areas that you wish with the detail that you wish. Logwatch is be‐
21 ing used for Linux and many types of UNIX.
22
24 --detail level
25 This is the detail level of the report. level can be a positive
26 integer, or high, med, low, which correspond to the integers 10,
27 5, and 0, respectively.
28 --logfile log-file-group
30 This will force Logwatch to process only the set of logfiles de‐
31 fined by log-file-group (i.e. messages, xferlog, ...). Logwatch
32 will therefore process all services that use those logfiles.
33 This option can be specified more than once to specify multiple
34 logfile-groups.
35 --service service-name
37 This will force Logwatch to process only the service specified
38 in service-name (i.e. login, pam, identd, ...). Logwatch will
39 therefore also process any log-file-groups necessary to process
40 these services. This option can be specified more than once to
41 specify multiple services to process. A useful service-name is
42 All which will process all services (and logfile-groups) for
43 which you have filters installed.
44 --mailto address
46 Mail the results to the email address or user specified in ad‐
47 dress.
48 --range range
50 You can specify a date-range to process. Common ranges are Yes‐
51 terday, Today, All, and Help. Additional options are listed
52 when invoked with the Help parameter.
53 --archives
55 Each log-file-group has basic logfiles (i.e. /var/log/messages)
56 as well as archives (i.e. /var/log/messages.? or /var/log/mes‐
57 sages.?.gz). When used with "--range all", this option will
58 make Logwatch search through the archives in addition to the
59 regular logfiles. For other values of --range, Logwatch will
60 search the appropriate archived logs.
61 --debug level
63 For debugging purposes. level can range from 0 to 100. This
64 will really clutter up your output. You probably don't want to
65 use this.
66 --filename file-name
68 Save the output to file-name instead of displaying or mailing
69 it.
70 --logdir directory
72 Look in directory for log subdirectories or log files first be‐
73 fore looking in the default directories.
74 --hostlimit host1,host2
76 Limit report to hostname - host1, host2.
77 --hostname hostname
79 Use hostname for the reports instead of this system's hostname.
80 In addition, if HostLimit is set in the logwatch.conf configura‐
81 tion file (see MORE INFORMATION, below), then only logs from
82 this hostname will be processed (where appropriate).
83 --html_wrap num-characters
85 Number of characters that html output should be wrapped to. De‐
86 fault is 80.
87 --hostformat split
89 Use split approach when formatting report for multiple hosts -
90 none [default], split, splitmail.
91 --output output-type
93 Report using output-type - stdout [default], mail, file.
94 --format format
96 Format report using format - text [default], html.
97 --subject email-subject
99 Customize the email subject sent by Logwatch. Option --output
100 must be set to mail.
101 --encode encoding
103 Encode report using encoding - none [default], base64, 7bit,
104 8bit [same as 'none'].
105 --numeric
107 Inhibits additional name lookups, displaying IP addresses numer‐
108 ically.
109 --usage
111 Displays usage information
112 --help same as --usage.
114
116 /usr/share/logwatch/
117 This directory contains all the perl executables and configura‐
118 tion files shipped with the logwatch distribution.
119 /etc/logwatch
121 This directory contains local configuration files that override
122 the default configuration. See MORE INFORMATION below for more
123 information.
124
126 logwatch --service ftpd-xferlog --range all --detail high --archives
127 This will print out all FTP transfers that are stored in all
128 current and archived xferlogs.
129 logwatch --service pam_pwdb --range yesterday --detail high
130 This will print out login information for the previous day...
131
133 The directory /usr/share/doc/logwatch-* contains several files with ad‐
134 ditional documentation:
135 HOWTO-Customize-LogWatch
136 Documents the directory structure of Logwatch configuration and
137 executable files, and describes how to customize Logwatch by
138 overriding these default files.
139 LICENSE
140 Describes the License under which Logwatch is distributed. Ad‐
141 ditional clauses may be specified in individual files.
142 README
143 Describes how to install, where to find it, mailing lists, and
144 other useful information.
145
147 Kirk Bauer <kirk@kaybee.org>
148 http://sourceforge.net/projects/logwatch
149Linux May 2012 LOGWATCH(8)