Mapping Values

Home  Previous  Next

When monitored technologies report problems or errors, they do not always provide a clear portrait of what the issue consists in or about its severity. IT administrators may be provided with long files or command outputs from which they are expected to extract valuable information and establish a link between this information and a clear status about the nature and the level of gravity of the problem. Unfortunately, few technologies report problems the same way, which makes their task difficult and time consuming. Monitoring Studio provides an easy way to map the standard PATROL status to any value from a monitored technology output.

The Value Map Monitor allows you to extract values from result outputs generated by other Monitors and map up to 25 of these values to user-defined status that match your specific needs. Based on these statuses, it becomes easy to apply thresholds and have Monitoring Studio trigger PATROL standard alerts directly in your PATROL environment.

The Value Map Monitor only requires a few steps to set the search requirements:

1.Specify the source
2.Delimit the value location area (several options are available to cover a large range of possibility)
3.Provide the value to status mapping information

 

Monitoring Studio reports the Value Map Monitor instance output as graphs in the PATROL Console.

To map values to user-defined status

1.In the PATROL Console, right-click a Monitor instance icon (file, command line, Web query, etc.) and select KM Commands > New > Value Map...

WIZ_ValueMap_1

Value Map —Source Selection

2.Specify the line(s) from which you wish to extract values:
all lines: All lines of the source file will be scanned. There is no need to provide further information.
the line numbers below: Only specific line numbers from the source file will be scanned. If this mode is selected, the line numbers must be specified in the text field below. Line numbers are specified as follows:
x, y: line x and line y
x-y: all lines from x to y inclusively
x: only line x
x-: all lines from x to the end of the source file inclusively

Example

Here are some examples of formats that can be used when specifying line numbers: "4;6;8", or "3-", or "-5", or "1;3-5;7-9"

Lines matching the regular expression below: The lines scanned from the source file will be the lines matching the regular expression specified in the field.
If the Skip blank lines option is selected, empty lines will be ignored during the search process.
3.Click Next to continue.
4.Indicate the position of the values to be found:
The value is located: There are four different modes to choose from and the information to enter depends on this choice.

WIZ_ValueMap_2

Value Map — Value Location

after the string specified below: If the value specified at the next step is located after the specified string. The search stops when the end of field character (or end of line) is found.
before the string specified below: If the value specified at the next step is located before the specified string. The search stops when the end of field character (or end of line) is found.
at the character offset specified below: If the value specified at the next step is located at the specified offset character. The parsing stops when the end of field character (or end of line) is found.
in the column number specified below: The previously selected lines contain several columns identified by a separator character. Enter the column number that should contain the value.
5.Click Next to continue.
6.If you have previously selected the after/below the string specified below or the at the character offset specified below option, you need to specify the character that marks the end of field (line) and stops the search for the value.

WIZ_ValueMap_3

Value Map — End of Field Character Selection

Select or de-select applicable character and/or enter custom character(s) in the Others field.
Indicate how quotes will be considered:
Do not interpret quotes: All applicable separators will be considered as marking the end of field and the parsing will stop even when enclosed in quotes.
Consider text in "double quotes" as a single column: Any separator found within double quotes will not be considered as an end of field character. The parsing will continue until an end of field character is found outside the double quotes, or until the end of the line is reached.
Consider text in 'single quotes' as a single column: Any separator found within single quotes will not be considered as an end of field character. The parsing will continue until an end of field character is found outside the single quotes, or until the end of the line is reached.
7.If you have previously selected the option in the column number specified below, you need to specify how columns are separated:

WIZ_ValueMap_3a

Value Map — Column Separator

Select or de-select applicable separators. For custom separators, type the character(s) one after the other in the Others field.
Indicate how consecutive separators will be considered:
Consecutive separators must be treated as a single one (useful for data separated by blank spaces): Consecutive separators are treated as a single separator.
Consecutive separators mean empty columns: Each separator is treated as an individual column separator and the column is considered empty.
Indicate how quotes will be considered:
Do not interpret quotes: All applicable separators will be considered as a column separator even when enclosed in quotes.
Consider text in "double quotes" as a single column: Values enclosed in double quotes will be considered as a single column. Any separator found within double quotes will not be considered as a column separator.
Consider text in 'single quotes' as a single column: Values enclosed in single quotes will be considered as a single column. Any separator found within single quotes will not be considered as a column separator.
8.Click Next to continue.
9.Define Status Value Map.

WIZ_ValueMap_4

Value Map —Status Value Mapping

Monitoring Studio will look for a match between the extracted value and the mapping rules status. The Status parameter of the Value Map Monitor instance will be set with the matching status. The mapping is applied from the highest alert level to the lowest (Failed, Suspicious, OK) to avoid conflicts if the same value is listed multiple times.

Enter the value(s) that you wish to map to a specific status:

These values will be mapped to '0' (OK): the retrieved value(s) will be mapped to a Status value of '0', indicating an OK status.
These values will be mapped to '1' (Suspicious): the retrieved value(s) will be mapped to a Status value of '1', indicating a Suspicious status
These values will be mapped to '2' (Failed): the retrieved value(s) will be mapped to a Status value of '2', indicating a Failed status
Any other value will be mapped to: Select an option corresponding to the status you wish to apply to any other value.

WarningA maximum of 25 values can be listed in this wizard. They should be separated by semi-colon (;).

10.Click Next to continue.
11.(Optional) Provide additional information about the extracted value. This information will be reported by the StatusInformation parameter of the Value Map Monitor instance (SEN_MS_VALUEMAP).

WIZ_ValueMap_5

Value Map — Status Information Map

(Optional) Click the Status Information Value Map:

WIZ_ValueMap_6

Value Map — Status Value Mapping

Value: Provide additional information that will be associated to each previously mapped status through the Status Information parameter. A maximum of 25 values will be displayed in this wizard.
Other values: Provide the information that will be mapped to any extracted values that cannot be mapped to provided values.
Click Accept to save your changes
Value to Retain: Select which value should be used to set the Status parameter (according to the mapping previously defined) and build the graph in the PATROL Console if several values are found in the source file. The possible values are:
the first value found: Only the first value found will be kept and mapped.
the last value found: Only the last value found will be kept and mapped.
the least critical value: Monitoring Studio will compare all values found and will only map the least critical one.
the most critical value (Default): Monitoring Studio will compare all values found and will only map the most critical one.
12.Click Accept to save your changes and then Next to continue.
13.Configure the Monitor settings.
14.Click Finish.The corresponding Value Map instance (Value Map: <Display Name>) is created in the PATROL Console. The collected parameters for Value Map Monitor are listed in the SEN_MS_VALUEMAP chapter.