|
%init>
Content-type: text/html
Manpage of LOGWATCH
LOGWATCH
Section: User Manuals (8) Updated: October 2005 Index
Return to Main Contents
NAME
logwatch - system log analyzer and reporter
SYNOPSIS
logwatch [--detail
level
] [--logfile
log-file-group
] [--service
service-name
] [--print] [--mailto
address
] [--archives] [--range
range
] [--debug
level
] [--save
file-name
] [--logdir
directory
] [--hostname
hostname
] [--splithosts] [--multiemail] [--output
output-type
] [--numeric] [--version] [--help|--usage]
DESCRIPTION
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. Logwatch is being used for
Linux and many types of UNIX.
OPTIONS
- --detail level
-
This is the detail level of the report.
level
can be a positive integer, or high, med, low, which correspond to the
integers 10, 5, and 0, repectively.
- --logfile log-file-group
-
This will force Logwatch to process only the set of logfiles
defined by
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.
- --service service-name
-
This will force Logwatch to process only the service specified in
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
service-name
is
All
which will process all services (and logfile-groups) for which you have
filters installed.
- --print
-
Print the results to stdout (i.e. the screen).
- --mailto address
-
Mail the results to the email address or user specified in
address.
This option overrides the --print option.
- --range range
-
You can specify a date-range to process. Common ranges are
Yesterday, Today, All,
and
Help.
Additional options are listed when invoked with the
Help
parameter.
- --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).
When used with "--range all", this option will make Logwatch search
through the archives in addition to the regular logfiles. For other
values of --range, Logwatch will search the appropriate archived logs.
- --debug level
-
For debugging purposes.
level
can range from 0 to 100. This will
really
clutter up your output. You probably don't want to use this.
- --save file-name
-
Save the output to
file-name
instead of displaying or mailing it.
- --logdir directory
-
Look in
directory
for log subdirectories or log files instead of the default directory.
- --hostname hostname
-
Use
hostname
for the reports instead of this system's hostname. In addition,
if HostLimit is set in the logwatch.conf configuration file (see
MORE INFORMATION, below),
then only logs from this hostname will be processed (where appropriate).
- --numeric
-
Inhibits additional name lookups, displaying IP addresses numerically.
- --usage
-
Displays usage information
- --help
-
same as --usage.
FILES
- /usr/share/logwatch/
-
-
This directory contains all the perl executables and
configuration files shipped with the logwatch distribution.
- /etc/logwatch
-
-
This directory contains local configuration files that override
the default configuration. See MORE INFORMATION below for more
information.
EXAMPLES
logwatch --service ftpd-xferlog --range all --detail high --print --archives
-
This will print out all FTP transfers that are stored in all current and archived
xferlogs.
logwatch --service pam_pwdb --range yesterday --detail high --print
-
This will print out login information for the previous day...
MORE INFORMATION
The directory /usr/share/doc/logwatch-* contains several files with additional
documentation:
HOWTO-Customize-LogWatch
-
Documents the directory structure of Logwatch configuration and executable
files, and describes how to customize Logwatch by overriding these default
files.
License
-
Describes the License under which Logwatch is distributed. Additional
clauses may be specified in individual files.
README
-
Describes how to install, where to find it, mailing lists, and
other useful information.
AUTHOR
Kirk Bauer <kirk@kaybee.org>
http://www.kaybee.org/~kirk
ftp://ftp.kaybee.org/pub/redhat/RPMS
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- FILES
-
- EXAMPLES
-
- MORE INFORMATION
-
- AUTHOR
-
This document was created by
man2html,
using the manual pages.
Time: 00:24:50 GMT, May 20, 2007
|
|