Value Map

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 statuses. To achieve this, you need to indicate to Monitoring Studio X:

• the source from which the values will be extracted
• where the values can be found
• how these values should be mapped to user-defined statuses.

When the Value Map Monitor is properly configured, the Status is displayed in TrueSight. Thresholds can then be set to have Monitoring Studio X trigger alerts in TrueSight.

Refer to the table below to know how to configure the Value Map Monitor.

Property	Description
Interpret Values in	1. Select the option corresponding to the lines that will be searched: All Lines (default): All lines of the text will be scanned. There is no need to provide further information. Line Numbers: Indicate the specific line numbers to be scanned and whether blank lines should be ignored in the line-count. Expected formats: x, y: line x and line y x-y: all lines from x to y inclusive x: only line x x-: all lines from x to the end of the file inclusive Lines Matching Regular Expression: Only the lines matching the regular expression will be searched. 2. Indicate the position of the value in the searched lines. Possible values are: Entire Line (default) to search the entire line. After the String/Before the String: Enter the corresponding string. At Character Offset: Enter the character number (Example: 7 to search for a value that starts from the seventh character in the line). In Column Number(s): Enter the column number(s) where the value should be found (Example: 1 or 1-5 or 1,5) and select the column separators to be considered. If the search applies to several columns delimited by different delimiters, including a blank space, then columns will be delimited by a blank space. Otherwise, the first delimiter saved in the configuration will be used.
Status Map	Map each possible extracted value to a Status and an associated description (optional). Note that you can specify regular expressions to match several similar values. You can also specify an empty value, which will be matched if the extracted value is an empty string.
Display Name	Name to identify the Value Map instance in TrueSight Operations Management.
Internal ID	ID to be used to store the Value Map Monitor configuration in the PATROL Agent configuration. This Internal ID is automatically generated based on the Display Name provided but can be edited if needed.
If No Value is Found	(Optional) Action to be performed by Monitoring Studio X if no value is found. By default, an error is reported in the Collection Error Count parameter of the template.
When Several Lines Contain a Value	(Optional) Action to be performed by Monitoring Studio X when several lines contain a value. By default, Monitoring Studio X keeps the most critical value.

Finally, for each parameter, you can define up to three alarm ranges (Alarm #1, Alarm #2 and Out-of-range) each with a minimum and a maximum value:

• Use the Alarm #1 and Alarm #2 options to define the range of parameter values that triggers warnings and alarms.
• Use the Out-of-range border conditions to be informed when the collected values are outside the norm (less than or greater than the defined range limits).

Refer to the Configuring Alerts for details and to Studio Value Map for more information about the parameters available and the thresholds set by default.