|Linux & Unix Commands - Search Man Pages
LOGWATCH(8) User Manuals LOGWATCH(8)
logwatch - system log analyzer and reporter
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 ] [--help|--usage]
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.
This is the detail level of the report. level can be high, med, low.
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
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
Print the results to stdout (i.e. the screen).
Mail the results to the email address or user specified in address.
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 Log-
Watch 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.
You can specify a date-range to process. This option is currently limited to only
Yesterday, Today and All.
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 the output to file-name instead of displaying or mailing it.
Look in directory for log files instead of the default directory.
Use hostname for the reports instead of this system's hostname. In addition, if
HostLimit is set in /etc/log.d/logwatch.conf, then only logs from this hostname
will be processed (where appropriate).
Displays usage information
--help same as --usage.
Really a symlink to /etc/log.d/conf/logwatch.conf. This file sets the default val-
ues 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.
Configuration files for the various services whose log entries LogWatch can
Configuration files for the various logfiles that the above service's log entries
are stored in.
Filters common to many services and/or logfiles.
Filters specific to just particular logfiles.
Actual filter programs for the various services.
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
logwatch --service pam_pwdb --range yesterday --detail high --print
This will print out login information for the previous day...
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
The --range option is very weak... this will be fixed in the future.
Kirk Bauer <email@example.com>
Linux MARCH 1998 LOGWATCH(8)
All times are GMT -4. The time now is 10:18 PM.