This page applies to an earlier version of the AppDynamics App IQ Platform.
See the latest version of the documentation.

Skip to end of metadata
Go to start of metadata

An action is a predefined, reusable, automated response to an event. You can use actions to automate your runbooks.

A policy can trigger an action in response to any event. You configure which actions are triggered by which events when you configure policies. See Policies.

Types of Actions

You can create the following types of actions:

  • Notifications
  • Diagnostics
  • Remediation
  • HTTP Request
  • Custom Actions
  • Cloud Auto-Scaling

Not all actions are applicable to all application environments or to all situations. Below are some general guidelines concerning different types of actions. For more details, see the pages on the specific actions before you assign an action to a policy.

  • The diagnostic thread dump actions can be performed only on nodes running a Java agent.
  • The diagnostic session actions can be triggered only by violations of business transaction performance health rules or slow or stalled transaction events, since these are the events that produce a view into transaction snapshots.
  • Remediation actions run a local script in a node and are available on nodes running on machines that have an installed machine agent. See Install the Standalone Machine Agent.
  • Custom Actions require a dedicated controller, deployed using either the on-premises or SaaS option. This feature is not supported for accounts on multi-tenant SaaS controllers.
  • Cloud Auto-Scaling actions require a previously created workflow. You will not see an entry for these types of actions unless you have checked Show Automation Features in your personal preferences. See Cloud Auto-Scaling

Actions Limits

The Controller limits the actions invoked based on the number of triggering events per event type. There is a maximum of ten events for any single event type that can trigger actions in a given minute. If the number of triggering events per type exceeds the limit, the actions that would have been triggered by the excess events are not started. You will not see a visual indication that these actions are not being started.

For example, your application can have up to ten Health Violation Started events triggering actions and up to ten Resource Pool Limit Reached events triggering actions within the same minute. But if you have eleven Health Violation Started events firing, the action that would be triggered by the eleventh event is not started.

To reduce unnecessary actions, there is a limit on the number of diagnostic and remediation actions that AppDynamics will invoke. The default limit is five actions per minute per machine for each type of action.

If, for example, a policy is configured on all the nodes where there are 100 nodes triggering actions, AppDynamics randomly selects five of the actions to execute.

To avoid exceeding the limits, design your policies so that they do not trigger an excessive number of actions for any particular event. You can generate fewer events by configuring the affected entities of your health rules at the tier level. See Entities Affected by a Health Rule by Health Rule Type in Health Rules.

Actions Requiring Approval

For actions that take thread dumps or run a local script, you can optionally require email approval to run the action whenever it is triggered. If you check this option, human intervention is required before the "automated" action actually starts.

If you specify the approval required option when you configure the action, when the action is triggered an email containing a link is sent to the configured email address. The link presents a login screen (if the user is not already logged in to AppDynamics) and after the user logs in, a dialog requesting approval to take the thread dump or run the script. The user can click in this dialog to approve and start the action or cancel the action.

If you do not check the Require approval option before executing the Action check box, the action will start automatically with no human intervention.

Create and Modify Actions

To access the actions configuration screens:
  1. Click Alert & Respond in the menu bar.
  2. Click Actions either in the right panel or the left navigation pane.
  3. Select the context for the action (Application, User Experience Browser App, Databases, Servers, Analytics) from the pulldown menu.
    The list of configured actions is displayed.
    You can filter the types of actions displayed in the actions list by checking the type in the pulldown filter. If no action types are checked there is no filtering, but if at least one type is checked, then only actions of that type are displayed.
  4. Do one of the following:
    • To create a new action, click the Create Action (+) icon.
      After you have clicked Create Action, the instructions depend on the type of action you are creating. See the topics for the action type you have selected.
    • To edit an existing action, select the action and click the Edit (pencil) icon.
    • To remove an existing action, select the action and click the Delete (-) icon.

View Actions

While actions are being triggered by events, you can get a summary of their execution in the Actions column in the Events list. You can access the events list from the Events tab of the application, tier or node dashboard.

An icon in the Actions column indicates that an action was triggered for this event, the type of the icon indicating the type of action. If the action icon is grayed out, the action is either still executing or failed to complete; the tooltip indicates which. If the icon is fully displayed, the action executed successfully.

Action Suppression

You can prevent policies from firing actions for a configurable time period. See Action Suppression.