Defining a monitoring policy
To create a monitoring policy
- Log on to the TrueSight console.
- In the navigation pane, expand Configuration and select Infrastructure Policies.
- In the Infrastructure Policies page, ensure that the Monitoring tab is selected and click Create Policy.
In the Create Monitoring Policy page, specify the monitoring policy properties:
Define the general properties.
Select PATROL Agents.
c. Specify values in at least one of the configuration tabs and click Save.
Add and configure monitor types to a monitoring solution
You can add and configure monitor types for the compatible PATROL monitoring solutions that are located in the Deployable Package Repository. For a list of monitoring solutions and monitor types that you can configure, see List of Monitoring Solutions and KMs in Operations Management. To configure custom monitoring solutions, ensure the solution is structured correctly; for details, see Developing a PATROL Knowledge Module.
- Ensure that the Monitoring tab is selected. By default, this tab is selected. If not, click it.
- Click New Monitor Configuration.
In the Add Monitoring Configuration dialog box, configure the following properties:
Property
Description
Monitoring Solution
Name of the monitoring solution. A solution can have many Knowledge Modules (KMs) under it.
Version
Version of the selected monitoring solution
Monitor Profile
Name of the monitor profile to which the monitor types that you want to enable are associated.
Each solution contains multiple monitoring profiles that help to reduce unnecessary monitoring. Each monitoring profile is associated with a group of monitor types. If a profile has monitor types that require you to enter information, they are listed in the Monitor type list, and you can configure them. If the profile has no monitor types that require input, all the monitor types are enabled by default and the Monitor Type list is disabled. To view all the monitor types that belong to a selected profile, click the Click to view Monitor Types option.
The monitor types that belong to a profile are pre-determined. You cannot add or remove them from a profile.Monitor Type
Name of the monitor type that you want to configure. You can select one from the list:
- All - All the monitor types will have default values.
- Monitor type other than All - You must configure the monitor type. The configuration options vary depending on the monitor type that you select.
To know the list of monitor types that are loaded on the Agent, click the Information icon
.
Tip: For documentation or more information about a monitor profile or monitor type, click the Help icon next to the list. The online documentation for that monitor type is displayed.
Other configuration options
Specify values for additional configuration options. These options vary depending on the monitoring solution, monitor profile, and monitor type that you selected. Tip: For information about an option, move the mouse over the option to view the tooltip.
The following figure shows the Add Monitoring Configuration dialog box with sample data. Also, you can see the tooltip that provides helpful information about the Exclude Criteria option.
- Click any of the following:
- OK and Close to exit the dialog box. The configured monitor type is added as a new row in the Monitoring tab. The selected monitor type is updated if it already exists in the Monitoring configuration.
- OK to stay on the dialog box and configure another monitor type. The configured monitor types are added or updated in the Monitoring configuration.
- Cancel to exit the dialog box without saving the changes.
- To modify the monitoring configuration, click the action menu for that configuration and select Edit. Modify the configuration and click OK. The edit option is not displayed if the Monitor Type is All.
- To delete a monitoring configuration, click the action menu for that configuration and select Delete. After you save the policy, the deleted monitor type configuration is removed from the selected PATROL Agents.
After you save or update a policy, the monitor type configurations are pushed to the selected PATROL Agents
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 restrict or allow data and events to be sent to the Infrastructure Management server. Unlike in blackout policies, when you apply filters in a monitoring policy, the data collection and event generation continues on the PATROL Agent.
You can configure the following types of filters:
- Attribute-level filter - When you apply this filter, only the instance information is sent to the TrueSight Infrastructure Management server. Information about the attributes of the instance is not sent to the TrueSight Infrastructure Management server.
Instance-level filter - When you apply this filter, information about both attributes and instances is not sent to the TrueSight Infrastructure Management server. If you have instances in a parent-child hierarchy, you must configure instance-level filters separately for each sub-node of the parent and child.
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.
Complete the following steps to configure filters:
- Click the Filtering tab.
- Select one of the following options:
- Agent Level: Filters data and events from the PATROL Agent. Select an appropriate filtering option from the list.
- Monitor Type Level: Filters information from a specific monitor type. To specify the monitor type:
- Click Add Monitor Type.
- In the Add Monitor Type dialog box, select a solution and its version.
- Select a related monitor type from the list.
- In Scope, select one of the following options:
- If you want to specifically filter data and events from an attribute, select Attribute, and then select an attribute from the Monitor Attribute list. The default value is All.
If you want to specifically filter data and events from an instance on the PATROL agent, select Instance, and then enter the instance name in the Instance SID field.
For the Instance SID field, you can also use a regular expression.
If you want to use a regular expression, select the Is a Regular Expression check box.
Select a filtering option according to the following table:
- Click any of the following:
- OK and Close to exit the dialog box. The monitor type with selected attribute and filter option is added or updated to the table in the Filtering configuration.
- OK to stay on the dialog box and configure filter option for another monitor attribute.
- Cancel to exit the dialog box without saving the changes.
- To modify the properties of an existing filter level for Monitor Type Level option, click the action menu for that filter and click Edit.
- To delete a configured monitor type level for Monitor Type Level option, click the action menu for that level and click Delete.
Configure polling intervals
Specify the time interval between two consecutive data polls. You need to specify a separate poll interval for every parameter.
- Click the Polling Intervals tab.
- Add a polling interval:
- Click Add Polling Interval.
Select values for the following options:
- Monitoring Solution
- Version
- Monitor Type
- Parameter
- Parameter Polling Interval
- Click any of the following:
- OK and Close to exit the dialog box. The monitor type with selected parameter and polling interval is added or updated to the table in the Polling Interval tab.
- OK to stay on the dialog box and configure polling interval for another monitor parameter.
- Cancel to exit the dialog box without saving the changes.
- To modify the properties of a polling interval: Click the action menu associated with that polling interval, and select Edit.
- To delete a polling interval: Click the action menu associated with that polling interval and select Delete.
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.
- Click the Agent Threshold tab.
Specify values for the following properties:
- Click any of the following:
- OK and Close to exit the dialog box. The monitor type with selected attribute and threshold options is added or updated to the table in the Agent Threshold tab.
- OK to stay on the dialog box and configure thresholds for another monitor attribute.
- Cancel to exit the dialog box without saving the changes.
Create server-level instance thresholds
You can create thresholds for the monitor instances on the Infrastructure Management server. For information about the types of thresholds, see Server-thresholds-KPIs-and-baselines.
To configure the server thresholds:
- Click the Server Threshold tab.
- Click Add Server Threshold.
Specify values for the following properties:
- Click any of the following:
- OK and Close to exit the dialog box. The monitor type with selected attribute and threshold options for a given instance is added or updated to the table in the Server Threshold tab.
- OK to stay on the dialog box and configure thresholds for another monitor attribute or instance.
- Cancel to exit the dialog box without saving the changes.
- To modify parameters of a threshold, click the action menu for that threshold and select Edit.
- 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.
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.
- Click the Agent tab.
- Specify the following properties:
Property | Description |
---|---|
Agent Default Account | |
User Name | The user name that you want to use to run the PATROL Agent. The user name must have access permissions to the PATROL Agent directory. Note: You need to provide an Agent user name and password only if they are different from what was previously configured. |
Password | Password for the specified user name |
Confirm Password | Password for the specified user name |
Restart Agent | Select this check box if you want to restart the PATROL Agent after the policy is applied. While editing a policy, if you select Restart Agent and provide the same default account information as what was provided while creating the policy, the PATROL Agent is not restarted. To restart the PATROL Agent, use the Query Agent screen. For more information, see Performing-actions-on-a-PATROL-Agent. |
| |
Tag | Tags that you want to assign to the PATROL Agent. The format of each tag is tagName:tagDescription. If the tag description contains spaces, enclose the description within double quotes. You can also provide multiple tags, separated by commas. |
Integration Service | An Integration Service or an Integration Service cluster that you want to set as the PATROL Agent phone home. The supported values are as follows:
|
Event Configuration Properties | |
Event Forwarding Destination | Destination where the events that are generated by the PATROL Agents must be sent to. The supported destinations are as follows:
|
Event Format Container | String to append to the name of the events that are generated by the PATROL Agents. The default string is BiiP3. |
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.
- Click the Server tab.
- Specify values for the following properties:
Property | Description |
---|---|
Add Agent Monitors to Group | Name of a group on the Infrastructure Management server under which you want to add the monitors that are created as a result of this policy. |
Add Associated Devices to Group | Select the check box to add all devices associated with the Agent monitors to the group specified in the Add Agent Monitors to Group field. If multiple groups are specified in the Add Agent Monitors to Group field, all the associated devices are added automatically to all the groups. |
Copy Baseline from Device | Display name of the device from which you want to copy the baseline. |
Associate Authorization Profiles with Devices | Name of the authorization profile to associate with the devices that are created as a result of the policy. Devices are associated with the specified authorization profile only if the authorization profile is available on the Presentation Server. You can provide multiple authorization profile names, separated by commas. The authorization profile names are case sensitive. If you want to disassociate the devices from the authorization profiles after a policy is disabled or deleted, use the Authorization Profiles page in the TrueSight console and remove each device from the authorization profile. |
Enables you to manually create Agent configuration rules such as Agent history retention, Agent run queue schedule settings, disabled Knowledge Modules, and so on.
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. Configuration variables that are defined on PATROL agents are retained even after disabling the policy. To delete the configuration variables, you must purge the PATROL Agent by using the following command:
pconfig +PURGE -p <port> -host <hostname>
By using this command, the configuration variable values of the PATROL Agent are restored to the default state, and the PATROL agent does not retain the previous configuration after an installation or an upgrade.
You can also remove the variables by using the Add Configuration Variable dialog box.
To import existing configuration variables
- In the Configuration Variable page, click the common action menu in the table and select Import.
- Browse for and select the configuration file (.cfg) to be imported.
- Click Open. The variables from the file are added to the table.
To add new configuration variables
- Click Add Configuration Variable.
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 the PATROL Agent.
- DELETE: Deletes the value 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.
Click any of the following:
- OK and Close to exit the dialog box. The variable is added to the table on the Configuration Variables tab.
- OK to stay on the dialog box and add multiple variables.
- Cancel to exit the dialog box without saving the changes.
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/FA4E70ECEAE09E75A744B52D2593C19FFor 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"
- 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.
- To remove a variable, click the action menu for the variable and select Delete.
Where to go from here