Dynamic Object

This Monitor is only available from the File, Command Line, HTTP Request, WMI Query, WBEM Query, Database Query, SNMP Polling, PSL Script, and Nagios Plugin Monitors pages.

The purpose of the Dynamic Object Monitor is to dynamically create Monitor objects based on the Result generated by a parent Monitor with content and create an instance for each line found in the Result parameter.

Once the dynamic objects are created, their own Result parameter can be analyzed with the String Search, Numeric Value Extraction and Value Map Monitors. These Monitors will be instantiated for every instance created at runtime.

Additional instances will be created as soon as new lines appear in the Result parameter of the parent Monitor. Similarly, instances will be deleted (or marked as “Missing”) when the corresponding lines are no longer present in the Result parameter of the parent Monitor.

Let's take an example to show how the Dynamic Object Monitor works. Imagine that a Command Line Monitor returned the following output displayed in the Result parameter:

ID Service Name    Status
-----------------------------
@1 BucketListener  OK
@2 WinCheck        No response
@3 LnxCheck        OK

We can configure a Dynamic Object Monitor with the following settings:

  • Dynamic Instance Internal ID: %{1} (i.e. the value of the first column of each line)
  • Dynamic Instance Display Name: %{2} (%{1}) (i.e. the value of the second column, and then the value of the first column in parenthesis)
  • Column Separators: space and tab
  • Keep Lines Matching: ^@[0-9], meaning that only lines starting with the ‘@’ character and followed by a number will be kept. Any other line, like the title line, will be discarded and no dynamic instance will be created for them.

Based on the output of our command, the Dynamic Object Monitor will dynamically create these Monitors at runtime:

Instance ID Display Name Result Parameter Content
@1 BucketListener (@1) @1 BucketListenener OK
@2 WinCheck (@2) @2 WinCheck No response
@3 LnxCheck (@3) @3 LnxCheck OK

We can report the status of each service with one single Value Map Monitor, that will be instantiated for each of the three services at runtime.

Refer to the table below to know how to configure the Dynamic Object Monitor:

Property Description
Dynamic Instance Internal ID ID to be used to store the Dynamic Instance Monitor configuration in the PATROL Agent configuration. Use %{ColumnNumber} to indicate in which column(s) the instance ID can be found (Example: %{1}, %{1,5} or %{1-5}).
Dynamic Instance Display Name Object Name to be displayed in TrueSight Operations Management. Use %{ColumnNumber} to indicate in which column the object name can be found.
Column Separator Column separator to be considered by Monitoring Studio X to determine the column numbers. 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. You should also specify how adjacent separators and quotes should be considered.
Display Name Name to identify the container that will group all the dynamic objects in TrueSight Operations Management. This Display Name is automatically generated based on the Display Instance Internal ID provided but can be edited if needed.
Internal ID ID to be used to store the Dynamic Container configuration in the PATROL Agent configuration. This Internal ID is automatically generated based on the Display Name provided but can be edited if needed.
Keep Line Numbers Lines numbers to keep. Use:
  • x-y for all lines from x to y inclusive,
  • x,y for lines x and y,
  • -x for all lines from 1 to x inclusive,
  • andx- for all lines from x to EOF character inclusive.
Keep Lines Matching Regular expression to be searched for. Leave blank to consider all lines.
Exclude Lines Matching Regular expression to be searched for. Each matching line will be ignored.
If Several Lines Have the Same ID Line(s) to be kept if several lines share the same ID (the first line, the last line, or all lines). The way a line ID is built depends on the value provided in " Dynamic Instances Internal ID". If “all lines” is selected, and several lines have the same value in the column used to build the ID, the Dynamic Instance's Result parameter will contain multiple lines.
Remove Missing Dynamic Instance Specify when missing objects (Present = 0) should be automatically removed from the Console.

To force this setting and immediately remove the missing object, click the REMOVE button available in the CONSOLE > Missing Dynamic Instance page. Alternatively, you can click the RESET AND REDISCOVER button from any CONSOLE > Missing Dynamic Instance page to reset the whole list of dynamic instances and perform a rediscovery.

Report Lines With an Identical ID in Template's Collection Error Count When enabled, a new error will be logged in the Collection Error Count parameter of the Template when several lines share the same ID.

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 Dynamic Object for more information about the parameters available and the thresholds set by default.

No results.