There are two ways to configure policies:
- Using the Policy Setup Wizard for extremely simple policies that just send an email notification when a health rule is violated.
- Using the regular Policy Wizard for anything more complicated.
To create a simple notification policy:
If all you want to do is set up a very simple policy that sends an email message to a recipient when a health rule violation event occurs, you can click thebutton or the Policy Setup Wizard link.
Your SMTP server must be set up first. See Configure the SMTP Server.
You supply an email address and the policy is created:
You can modify the policy later, the same way you modify any other policy.
The rest of this page describes how to use the regular Policy Wizard.
Using the Policy Wizard
The Policy Wizard contains two panels:
- Trigger: Sets the events that trigger the policy, entities that are affected by the policy
- Actions: Sets the actions to take when the policy is triggered.
In either panel you can configure the policy name, enabled status, and whether to batch the actions.
To access the policy wizard:
- Click Alert & Respond in the menu bar.
- Click Policies either in the right panel or the left navigation pane.
- Select the context for the policy (specific Application, Database or Analytics) from the pulldown menu.
- Do one of the following:
- To create a new policy, click the Create Policy (+) icon.
- To edit an existing policy, select the policy and click the Edit (pencil) icon.
- To remove an existing policy, select the policy and click the Delete (-) icon.
Configure Policy Triggers
The policy trigger panel defines the events and objects generating the events that cause the policy to fire and invoke its actions.
To configure policy triggers:
- Click the plus icon to create a new policy or select an existing policy and click the pencil icon. The Policy Wizard opens.
- Enter a name for the policy in the Name field.
- To enable the policy, check the Enabled check box. To disable the policy, clear the Enabled check box.
You can also enable or disable a policy by selecting it in the policy list and clicking the Enable or Disable button.
- If you leave the Process actions in batch every minute check box clear, the policy fires its actions immediately for every triggering event. If you check this check box, the policy fires its actions once for all the triggering events that occurred in the last minute. See "Policy Actions in Batch" in Policies.
- On the left, click TRIGGER if it is not already selected.
Check the type of event that should trigger the policy. You may need to click the arrow to expose specific events within an event category.
If you check at least one health rule violation event, you can choose whether any (that is, all) health rule violations or only specific health rule violations will trigger the policy.
To designate specific health rule violations to trigger the policy, select These Health Rules, click the "+" icon, and then choose the health rules from the embedded health rule browser.
To designate specific custom events to trigger the policy, use the Custom Events panel in the lower right corner. Click the "+" icon.
Specify the custom event type. Optionally add particular properties on that event as key/value pairs. For Any, at least one property must exist and match. For All, all properties must exist and match.
When you have finished selecting the events that trigger the policy, click "any object" to configure which objects to monitor for those events to trigger the policy.
If you select Any Objects the policy will be triggered by the configured events when they occur on any object in your application.
To restrict the policy to specific objects, select Any of these specified objects and then choose the objects.
For example, the following policy fires when selected events occur on the the ECommerce Server tier. You can similarly restrict the objects to specific nodes, business transactions, and so forth.
You can restrict the affected nodes on the node name, on the type of node (Java, .NET, etc) on nodes in certain tiers, or on criteria such as meta-info, environment variables, and JVM system environment properties. Meta-info includes key value pairs for:
- key: supportsDevMode
- key: appdynamics.ip.addresses
- any key passed to the agent in the appdynamics.agent.node.metainfo system property
To trigger by Health Rule Violation Events, leave the selection at Any object. Selecting Any of these specified objects means that only non-health rule events - slow transactions, errors, and so forth - will trigger the policy.
Configure Policy Actions
The policy actions panel binds an action to the trigger. It defines which actions the policy automatically initiates when the trigger causes the policy to fire.
The actions must be created before you can create a policy that fires them. See Actions and the documentation for individual types of actions (notification actions, remediation actions, etc.) for information on creating an action.
To configure policy actions:
- If you have not already done so, open the policy wizard and edit the policy to which you want to add actions. See To access the Policy Wizard.
- On the left, click ACTIONS if it is not already selected.
- Click "+" icon. The list of existing actions appears.
You can filter the list by checking the check boxes for the types of actions you want to see.
In the list of actions, select the action that you want this policy to execute and click Select.
If you do not see an appropriate action for your needs, click Create Action. For information on creating actions, see Actions. After you have created the action select it here to assign it to the policy that you are configuring.