syslog-summary1
Summarize the contents of a syslog log file
Usage
syslog-summary [{-s | --state
filename}]
[{-i | --ignore
filename}]
[{-d | --debug}]
[{-r | --repeat}]
logfile ...
syslog-summary [{-h | --help}]
Overview
This manual page documents briefly the syslog-summary command.
syslog-summary summarizes the contents of log files via the syslog(3) service, by displaying each unique (except for the time) line once, and also the number of times such a line occurs in the input. The lines are displayed in the order they occur in the input.
Options
-
-i filename, --ignore=filename -
Read regular expressions from filename and ignore lines in the logfiles that match them.
-
-s filename, --state=filename -
Read state information from filename. The state contains information about the already reported parts of a log file, and prevents
syslog-summaryfrom reporting the same things many times. This is useful whensyslog-summaryis run fromcrontabevery hour. The file is created, if it doesn´t exist already.
-
-r, --repeat -
Merge "last message repeated * times" lines with the repeated event.
-
-d, --debug -
Enable verbose messages when errors occur (i.e. "debug mode").
-
-h, --help -
Show summary of options.
Files
/etc/syslog-summary/ignore.rules
Default ignore.rules file with default regular expressions.
Diagnostics
When reporting a bug, please run syslog-summary with the -d (or --debug) flag enabled.
syslog-summary provides some return codes, that can be used in scripts:
| Code | Diagnostic |
| 0 | Program exited successfully. |
| 1 | Something went wrong, please run the program with the debug messages enabled. |
Releases
12 releases since Debian 2.1 (Slink); the text changed 2 times.
--debug since Debian 5.0 (Lenny);
--help since Debian 5.0 (Lenny);
--repeat since Debian 5.0 (Lenny);
--state since Debian 2.2 (Potato);
-d since Debian 5.0 (Lenny);
-h since Debian 5.0 (Lenny);
-r since Debian 5.0 (Lenny);
-s since Debian 2.2 (Potato).
--quiet until Debian 4.0 (Etch);
-q until Debian 4.0 (Etch).