logtool1

Usage

Options

-o [ ANSI | ASCII | CSV | HTML | RAW ]

Allows you to specify the output format to be one of the following: ANSI (default), ASCII, CSV, HTML, RAW. Options are not case sensitive (ie: -o CSV and -o csv should yield the same results)

-t [ long | short ]

Allows you to specify the time display format to be one of the following: (Long [default]) Mon Dy HH:MM:SS or (Short) HH:MM

-b

Causes logtool to beep on RED events (ANSI output only). This is usefull when you want to monitor a logfile on an ongoing basis, and wish to have your terminal beep whenever something out of the ordinary happens.

-s

Causes logtool to not display the syslog "source" field

-p

Causes logtool to not display the "program" field

-c [/path/config.file]

Allows you to specify a config file other than the default /etc/logtool/logtool.conf

-i [/path/includefile]

Allows you to specify an alterate file containing regex's for inclusion [default=/etc/logtool/include]

-e [/path/excludefile]

Allows you to specify an alternate file containing regex's for exclusion [default=/etc/logtool/exclude]

-n

Causes logtool to skip any attempts to resolve IP->Hostname by the various modules (handy when your DNS is down temporairly).

-v

Set logtool to operate in verbose mode (does nothing currently)

-V

Causes logtool to print it's version information and exit

-h

Display the help message

Suggested usage(s)

As a 'live' logfile monitoring tool:

tail -f /var/log/messages | logtool -o ANSI -b

To generate colorized webpages of logfiles:

cat /var/log/messages | logtool -o HTML > /home/httpd/html/logs/messages.html

To generate reports via a cronjob:

retail /var/log/messages | logtool -o ASCII | mail -s "Daily report" [email protected]

Config file

/etc/logtool/logtool.conf

The config file should be commented to the point of being self-documenting, so we will not comment very extensively on it here. Suffice to say, this is the place where you should configure 99% of your runtime options for logtool. You may also have a collection of different default configurations, and select amongst them by the '-c' option of logtool.