Defining a monitoring policy

Configure filters to include or exclude data and events

After you configure the monitor types in the PATROL Agents, they send the collected data and the generated events to the Infrastructure Management server. You can configure filters to control the data and events that are sent to the Infrastructure Management server per parameter. 

You can filter the data either from a specific Agent or from a specific monitor type. The supported filtering options are as follows:

• Send events only
• Send trended performance data only
• Send trended performance data and events
• Send no trended performance data and no events

Note: A PATROL Agent applies a filtering policy during the next scheduled discovery or collection of a PATROL object (monitor type or attribute). That is, filtering is applied when the first collection occurs on the PATROL object after filtering rules are applied. Due to this behavior, there might be a delay in the deployment of the filtering rules on the PATROL object.

1. Click the Filtering tab.
2. Select one of the following options:
   • Agent Level: Filters data and events from the PATROL Agent. Select an appropriate filtering option from the list. The default option is  No Filtering (send all data and events).
   • Monitor Type Level: Filters information from a specific monitor type. To specify the monitor type:
     
     1. Click Add Monitor Type.
     2. In the Add Monitor Type dialog box, select a solution and its version.
     3. Select a related monitor type from the list.
     4. If you want to specifically filter data and events from an attribute, select an attribute from the list. The default value is All.

     5. Select one of the following filtering option:

        • No Filtering (send all data and events)
        • Filter out data (send no data, send all events) - Default option
          
        • Filter out events (send no events, send all data)
        • Filter out data and events (send no data, send no events)

         

     6. Click OK . The selected monitor type row is added to the table in the Filtering page.
        T o add multiple monitor types for filtering data and events, repeat the previous steps.
3. To modify the properties of an existing filter level, click the action menu for that filter and click Edit.
4. To delete a configured monitor type level, click the action menu for that level and click Delete.

Back to top

Configure polling intervals

Specify the time interval between two consecutive data polls. You need to specify a separate poll interval for every parameter. 

1. Click the Polling Intervals tab. 
2. Add a polling interval:
   1. Click Add Polling Interval.

   2. Select values for the following options:

      - Monitoring Solution   - Version - Monitor Type - Parameter - Parameter Polling Interval

   3. Click OK. The polling interval is added to the table in the Polling Interval page.
3. To add more polling intervals, repeat the previous step. 
4. To modify the properties of a polling interval: Click the action menu associated with that polling interval, and select Edit.
5. To delete a polling interval: Click the action menu associated with that polling interval and select Delete.

Back to top

Define thresholds on PATROL Agents

Configure range-based thresholds for attributes of a monitor type on the PATROL Agents. You can specify whether the thresholds apply to a monitor type or to an instance of a monitor type.

1. Click the Agent Threshold tab.

2. Click Add Agent Threshold.    

   The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
   This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.
   

3. Click OK. The threshold is added to the table on the Agent Threshold page.

Back to top

Create server-level thresholds

You can create thresholds for the monitor instances on the Infrastructure Management server.  For information about the types of thresholds, see Thresholds, KPIs, and baselines .

  
To configure the server thresholds:

1. Click the Server Threshold tab.
2. Click Add Server Threshold.        

3. Specify values for the following properties:

   The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
   This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.
   

4. Click OK.  
5. To modify parameters of a threshold, click the action menu for that threshold and select Edit.
6. To remove a threshold, click the action menu for that threshold and select Delete. After you save the policy, the deleted threshold configurations are removed from the selected PATROL Agents.
   After you save or update a policy, the new threshold configurations are pushed to the selected PATROL Agents.

Back to top

Configure PATROL Agents

You can configure the properties of a PATROL Agent and specify the action that the Agent must perform when the policy is applied.

For more information, see Specifying objects in an authorization profile.

1. Click the Agent tab.
2. Specify the following properties:

Back to top

Configure actions performed by Infrastructure Management server

Specify actions to be performed on the Infrastructure Management server when the policy is applied. The actions apply to all devices that are associated with the PATROL Agent and all the monitor instances that the Agent monitors.

1. Click the Server tab.
2. Specify values for the following properties:

Back to top

Define and manage configuration variables

You can define individual configuration variables or import them from a ruleset file (.cfg).

The PATROL Agent configuration is saved in a set of configuration variables that are stored in the Agent's configuration database. You can control the PATROL Agent configuration by changing the values of these configuration variables. Also, you can define a configuration variable, and the definitions are set on PATROL Agent when the policy is applied.

• To import existing configuration variables
• To add new configuration variables

To import existing configuration variables

1. In the Configuration Variable page, click the common action menu in the table and select Import.
   
2. Browse for and select the configuration file (.cfg) to be imported.
3. Click Open. The variables from the file are added to the table.

To add new configuration variables

1. Click Add Configuration Variable.

2. In the Add Configuration Variable dialog box, specify values for the following properties and click OK:

   Property	Description
   Variable	Name for the configuration variable. Important: The variable names are case sensitive and must start with slash (/). You must enter the complete path for the variable, not just the name. If the intermediate variables do not exist, the variables are created.
   Operation	Operation that you want to perform on the configuration variable. The supported operations are as follows: REPLACE: Replaces the current value of the variable on the PATROL Agent if the variable already exists. Otherwise, a new variable is created with the specified value. DELVAR: Deletes the variable from PATROL Agent. DELETE: Deletes all the values of the variable, and the variable remains empty.
   Value	Value that you want to configure for the variable and click OK. The configuration variable is added as a new row in the Configuration Variables table.

3. To add another configuration variable, repeat the earlier steps.

   
   Notes: For the defaultAccount configuration variable, specify the value in the userName/password format. Note that the password can be a plain text or a PATROL Agent-encrypted string.
   Examples:

   patrol/patAdm1n
   patrol/FA4E70ECEAE09E75A744B52D2593C19F

   For the SecureStore configuration variable, specify the value in the context/data format. Note that the context and data can be a plain text or a PATROL Agent-encrypted string.
   

   Examples:

   MY_KM1;MY_KM2;MY_KM3/mysecretdata

   “EDC10278901F8CB04CF927C82828595B62D25EC355D0AF38589CE4235A246F8C63F24575073E4ECD”

   where “EDC10278901F8CB04CF927C82828595B62D25EC355D0AF38589CE4235A246F8C63F24575073E4ECD” is the encrypted form of "MY_KM1;MY_KM2;MY_KM3/mysecretdata"

4. To modify any value in a variable, click the action menu for the variable and select Edit.
   
   In the Edit Configuration Variable dialog box,  modify the properties and click OK.
5. To remove a variable, click the action menu for the variable and select Delete.

Back to top