Use case scenarios to create a shared policy

agentSelectionCriteria

Set of conditions based on which the agents are identified to apply the policy

The syntax is  "agentIdentifier operator \"value\""

where,

• agentIdentifier refers to the agent attributes, based on which the agent is identified. The supported identifiers are as follows:
  
  • agentName—Host name of the computer on which the BMC PATROL Agent is installed
  • agentPort—Port number through which the Integration Service connects with the agent
  • agentVersion—Version of the BMC PATROL Agent
  • agentOS—Operating system of the computer on which the BMC PATROL Agent is installed
  • agentIP—IP address of the computer on which the BMC PATROL Agent is installed
  • agentTag—Tag name of the BMC PATROL Agent
  • integrationService—Display name of the Integration Service
  • childServer—Host name of the Child Server that is registered with Central Monitoring Administration

• operator refers to the condition that relates the agent identifier and its value. The supported operators vary according to the agent identifiers. For the list of the supported operators, see Supported-operators-for-the-agentSelectionCriteria-parameter.
• value refers to the string value to search

precedence

Priority for the policy. The supported values are numbers between 0 and 999 with 999 being the lowest priority and 0 being the top priority. 

The default value is 999.

tenant

Details of the tenant who owns the policy. You can either provide name or the id of the tenant.

name

Name of the tenant who owns the policy. The supported values are as follows:

• <nameOfTenant>—Indicates that the policy is applicable to the specified tenant
• GLOBAL—Indicates that the policy is applicable to all agents
• PROVIDER—Indicates that the policy is applicable to the cloud service provider and also to the agents that do not have any tenants

enabled

Indicates whether the policy is enabled. The default value is true.

name

Name of the policy

type

Type of the policy. The supported types are as follows:

• blackout
• monitoring

description

Brief description about the policy

timeframe

Details of the time frame. The time frame specifies the time period for the blackout policy to be active.

name

Name of the time frame

scope

Scope of the blackout policy. The supported scopes are as follows:

• completeAgent—Indicates that the policy is applied to all the monitors associated with the agent
• monitorTypesAndInstances—Indicates that the policy is applied only to the specified monitors

blackoutTypes

Type of the blackout policy. The supported types are as follows:

• data—Indicates that the policy is applicable only for the performance data
• events—Indicates that the policy is applicable only for the event data
• recoveryActions—Indicates that the policy is applicable only for the agent actions

monitorConfigList

List of monitors for which you want to create the blackout policy

monitorTypeSpecification

Specifies the details about the monitors

monitorType

Type of the monitor

You can use the solutions API to know the supported monitor types. For information about the solutions API, see Listing-the-available-monitor-solutions.

solutionName

Name of the monitoring solutions

solutionVersion

Version of the specified monitoring solutions

scope

Scope of the policy based on the monitor type. The supported options are as follows:

• type—Indicates that the policy is applied to all the monitor instances of the specified monitor type
• instances—Indicates that the policy is applied only to the specified monitor instances

monitorInstances

Specifies the details about the monitor instances for which you want to create the policy

monitorInstance

Specifies the details about a monitor instance

shared

Supports two values:

• true - the policy can be shared among users of specific user group
• false - the policy cannot be shared with anybody

associatedUserGroup