Quick start

Quick start guide

This is a short usage example for getting started with SaLoMon.

Starting situation

Inside the samples sub-directory you can find the file foobar.log containing these lines

2014-04-02 01:04:16 Starting foobar service
2014-04-02 01:04:17 Reading config file
2014-04-02 01:04:17 Warning: Config file 'foobar.cfg' not found
2014-04-02 01:04:18 Notice: Using fallback config file instead
2014-04-02 01:04:19 Configuration has been loaded successfully
2014-04-02 01:04:20 Running process #1
2014-04-02 01:04:24 Running process #2
2014-04-02 01:04:28 Running process #3
2014-04-02 01:04:32 Running process #4
2014-04-02 01:04:33 Error while running process #4
2014-04-02 01:04:34 Warning: At least one process has failed
2014-04-02 01:04:36 Stopping foobar service

and let us assume that you want to highlight its contents as follows.

Colorize lines containing the term ...

• notice in light blue,
• start in light cyan,
• stop also in light cyan,
• success in light green,
• read in light purple,
• error in light red and
• warn in yellow.

Color config file

Create a file with the following content:

lightblue       notice
lightcyan       start
lightcyan       stop
lightgreen      success
lightpurple     read
lightred        error
yellow          warn

Save it as foobar.cfg into the colors sub-directory.

Run SaLoMon

Now, you can simply execute the following command

$ ./salomon.sh -a analyze -c foobar.cfg -i samples/foobar.log

to get the requested result: