AppDynamics

1. Log in to your AppDynamics controller and navigate to Alert & Respond > HTTP Request Templates.
2. Click New to create a new template, then name the new template xMatters.
3. In the Request URL section, set the Method to POST.

   

4. Paste the trigger URL you copied from Flow Designer into the Raw URL field.
5. Add the target names of any recipients you want to notify when the alert fires.
   • For URL authentication, use an ampersand to attach recipients. For example, if you want to notify Emma Pearson and the on-call members in the group responsible for the Antares service, you'd add &recipients=epearson,antares to the end of the URL.
   • For other authentication types, use a question mark to attach recipients. For example, if you want to notify Barry Gull and the on-call members in the group responsible for the Cassiopeia service, you'd add ?recipients=bgull,cassiopeia to the end of the URL.
   • You must URL-encode any special characters or spaces in the target names.
6. In the Payload section, set the MIME Type to application/json.
7. Paste the following Configuration Payload into the Payload field.
   Copy

   {
   "account_name": "${account.name}",
   "policy_name": "${policy.name}",
   "latest_disp_name":"${latestEvent.displayName}",
   "latest_app_name":"${latestEvent.application.name}",
   "latest_time":"${latestEvent.eventTime}",
   "latest_tier_name":"${latestEvent.tier.name}",
   "latest_severity":"${latestEvent.severity}",
   "latest_node_name":"${latestEvent.node.name}",
   "events": [
   #foreach( $event in $fullEventList )
   {
   "event_name": "$event.displayName",
   "event_message": "$event.eventMessage",
   "event_node_name": "$event.node.name",
   "event_tier_name": "$event.tier.name",
   "event_time": "$event.eventTime",
   "event_link": "$event.deepLink",
   "event_severity_image": "$event.severityImage.deepLink"
    }#if( $foreach.hasNext ),#end
    #end
    ],
   "top_severity": "${topSeverity}",
   "controller_url": "${controllerUrl}",
   "action_name": "${action.name}",
   "action_trigger_time": "${action.triggerTime}"
   }

8. If you want to receive an alert for each new event detected, enable the One Request Per Event check box.

   

9. Save the template.

Next you'll need to create an action and append it to a policy.

1. From the left-hand menu, select Policies.

   

2. Select an existing policy from the drop-down menu or create a new policy by clicking Create.

   

3. In an existing policy, go to the Actions tab.
4. Click the plus sign to add a new action.

   

5. In the Select Action window, click Create.

   

6. In the Create Action window, select the Make an HTTP Request radio button and click OK.

   

7. Give the HTTP Action a unique name and then select the HTTP request template you created from the list. The Edit HTTP Action window gives you a preview of the action you just created.
8. Click Save.

If your implementation requires Tier / Node information, set it in AppDynamics:

1. Go to the Alert & Respond menu and select Health Rules.

   

2. Click Affected Entities and select one of the three available Tier / Node options.

   

3. Click Save to apply the Tier / Node changes.

You're ready to use the webhook to trigger automated flows, including steps such as sending alerts and initiating incidents, though we always recommend testing before putting things into use.

The person responding to the notification has the following response options:

• Acknowledge: Acknowledges the notifications and stops escalations.
• Escalate: Immediately escalates the alert to the next on-call resolver in a targeted group.
• Close: Ends the xMatters alert and stops notifying all targeted recipients.
• Initiate Incident: Initiates an incident in xMatters.

AppDynamics delivers application performance management solutions to help teams analyze and optimize digital business performance in real time. When events meet predetermined criteria, this integration with xMatters relays critical AppDynamics insight data to the correct people and systems to help coordinate and resolve incidents faster.

Do more with this integration

Incorporate this integration into your orchestrated incident resolution workflows with Flow Designer. After you create a configuration, the Flows tab appears. From there, you can build your flows — add new response options, connect to other apps, or even create new xMatters alerts based on activities in the flow — enriching the information injected by this integration along the way.

Get all your questions on integrating with AppDynamics answered — take a live, online workshop led by one of our xPerts.

Get started with AppDynamics

 

How to set up an AppDynamics integration

After you give your integration a name and description, type a name to use when sending alerts (so you can easily tell which integration the alerts are from), and add all of the users and groups you want to be notified (see the help for information on setting up users and groups).

Once you save your configuration, xMatters displays the URL and payload you need to configure AppDynamics.

Create a new HTTP Response Template in your AppDynamics instance that targets this URL with a POST request and includes the payload in json format.

Use your integration

The integration uses the HTTP request template you created to inject signals into xMatters when they match the criteria you set in your AppDynamics alerting policies.

Extending your integration

Looking to do more with xMatters and AppDynamics? If you want to tailor the settings and notifications for the integration, you can convert it to a custom workflow.