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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
.\" Process this file with
.\" groff -man -Tascii foo.1
.\"
.TH LOGWATCH 8 "MARCH 1998" Linux "User Manuals"
.SH NAME
logwatch \- system log analyzer and reporter
.SH SYNOPSIS
.B logwatch [--detail
.I level
.B ] [--logfile
.I log-file-group
.B ] [--service
.I service-name
.B ] [--print] [--mailto
.I address
.B ] [--archives] [--range
.I range
.B ] [--debug
.I level
.B ] [--save
.I file-name
.B ] [--logdir
.I directory
.B ] [--hostname
.I hostname
.B ] [--help|--usage]
.SH DESCRIPTION
.B LogWatch
is a customizable, pluggable log-monitoring system. It will go
through your logs for a given period of time and make a report in the areas
that you wish with the detail that you wish. Easy to use - works right out
of the package on almost all systems.
.SH OPTIONS
.IP "--detail level"
This is the detail level of the report.
.I level
can be high, med, low.
.IP "--logfile log-file-group"
This will force LogWatch to process only the set of logfiles
defined by
.I log-file-group
(i.e. messages, xferlog, ...). LogWatch will therefore process
all services that use those logfiles. This option can be specified
more than once to specify multiple logfile-groups.
.IP "--service service-name"
This will force LogWatch to process only the service specified in
.I service-name
(i.e. login, pam, identd, ...). LogWatch will therefore also process
any log-file-groups necessary to process these services. This option
can be specified more than once to specify multiple services to process.
A useful
.I service-name
is
.I All
which will process all services (and logfile-groups) for which you have
filters installed.
.IP --print
Print the results to stdout (i.e. the screen).
.IP "--mailto address"
Mail the results to the email address or user specified in
.I address.
.IP --archives
Each log-file-group has basic logfiles (i.e. /var/log/messages) as
well as archives (i.e. /var/log/messages.? or /var/log/messages.?.gz).
This option will make LogWatch search through the archives in addition
to the regular logfiles. The entries must still be in the proper date
range (see below) to be processed, however.
.IP "--range range"
You can specify a date-range to process. This option is currently limited
to only
.I Yesterday, Today
and
.I All.
.IP "--debug level"
For debugging purposes.
.I level
can range from 0 to 100. This will
.I really
clutter up your output. You probably don't want to use this.
.IP "--save file-name"
Save the output to
.I file-name
instead of displaying or mailing it.
.IP "--logdir directory"
Look in
.I directory
for log files instead of the default directory.
.IP "--hostname hostname"
Use
.I hostname
for the reports instead of this system's hostname. In addition,
if HostLimit is set in
.I /etc/log.d/logwatch.conf,
then only logs from this hostname will be processed (where appropriate).
.IP --usage
Displays usage information
.IP --help
same as --usage.
.SH FILES
.I /etc/log.d/logwatch.conf
.RS
Really a symlink to /etc/log.d/conf/logwatch.conf.
This file sets the default values of all the above
options. These defaults are used when LogWatch is
called without any parameters (i.e. from cron.daily).
The file is well-documented, but the explanations above
also apply to this config file.
.RE
.I /etc/log.d/conf/services/*
.RS
Configuration files for the various services whose log
entries LogWatch can process.
.RE
.I /etc/log.d/conf/logfiles/*
.RS
Configuration files for the various logfiles that the
above service's log entries are stored in.
.RE
.I /etc/log.d/scripts/shared/*
.RS
Filters common to many services and/or logfiles.
.RE
.I /etc/log.d/scripts/logfiles/*
.RS
Filters specific to just particular logfiles.
.RE
.I /etc/log.d/scripts/services/*
.RS
Actual filter programs for the various services.
.RE
.SH EXAMPLES
.B logwatch --service ftpd-xferlog --range all --detail high --print --archives
.RS
This will print out all FTP transfers that are stored in all current and archived
xferlogs.
.RE
.B logwatch --service pam_pwdb --range yesterday --detail high --print
.RS
This will print out login information for the previous day...
.RE
.SH MORE INFORMATION
For information on adding your own filter, please see the file HOWTO-Make-Filter
which should have been included with Logwatch. If you installed from an RPM,
it is probably under /usr/share/doc/logwatch-XXX.
.SH BUGS
The --range option is very weak... this will be fixed in
the future.
.SH AUTHOR
Kirk Bauer <kirk@kaybee.org>
http://www.kaybee.org/~kirk
ftp://ftp.kaybee.org/pub/redhat/RPMS
|
