AppDynamics

Introduction

AppDynamics is an application performance management (APM) and IT Operations Analytics (ITOA) tool. Integration allows OpsRamp to accept alerts from AppDynamics. After successful integration you can view AppDynamics alerts in OpsRamp. Integration is performed using Basic or Webhook Authentication.

Integration is tested on AppDynamics version: 4.5.16

OpsRamp configuration

To configure OpsRamp for AppDynamics integration:

1. Go to Setup > Integrations > Integrations and select a client.
   The installed and available integrations of the selected client appear.
2. From Available Integrations, go to Monitoring > AppDynamics.
3. On the AppDynamics Integration screen, click Install.
4. Select authentication type as BASIC or WEBHOOK and click Save.
5. Make a note of the details. These details are used while creating an HTTP Request template during AppDynamics configuration.
   • If WEBHOOK is selected, copy the Tenant ID, Token and Webhook URL.
   • If BASIC is selected, copy the Tenant Id and Token.
6. Expand the Map attributes section and perform the following:
   • Enter details to map the Status field.
   • Select OpsRamp Entity Alert and OpsRamp Property Status from the drop-down menu.
7. Click the + button to define mappings.

The following table shows the property mappings.

AppDynamics configuration for Webhook-based authentication

Configuration for webhook-based authentication involves:

1. Creating HTTP request templates
2. Creating actions
3. Creating policies

Step 1: Create HTTP request template

An HTTP request action sends an HTTP request in response to an event. These type of actions allows you to integrate AppDynamics policies with third-party HTTP APIs. When you create an HTTP request action using an HTTP request template, the template describes the HTTP request that is when the policy initiates the action. These templates are reusable by different HTTP request actions within an AppDynamics account.

The following HTTP request templates must be created to send Critical, Warning, and Recovery alerts to OpsRamp. Only the Name and Payload are different for these templates.

To create individual HTTP request templates for Critical, Warning, and Recovery alerts:

1. Log into AppDynamics.
2. Click Alert & Respond, click HTTP Request Templates on the left pane.
3. Click New to create an HTTP request template and provide the template values (as shown in the following table).
4. Click Save.

The following table shows template fields and descriptions.

HTTP request templates for alert status - critical

Name: Critical alert HTTP request template. Payload:

{
	"serviceName": "${latestEvent.affectedEntities[0].entityTypeDisplayName}",
	"device": {
		"hostName": "${latestEvent.node.name}"
	},
	"subject": "${latestEvent.summaryMessage}",
	"alertTime": "${latestEvent.eventTime.getYear()}-${latestEvent.eventTime.getMonth()}-${latestEvent.eventTime.getDate()} ${latestEvent.eventTime.getHours()}:${latestEvent.eventTime.getMinutes()}:${latestEvent.eventTime.getSeconds()}",
	"currentState": "CRITICAL",
	"app": "APPDYNAMICS",
	"alertType": "",
	"component": "",
	"description": "${latestEvent.eventMessage}",
	"monitorName": "${latestEvent.affectedEntities[0].entityTypeDisplayName}"
}

HTTP request templates for alert status - warning

Name: Warning alert HTTP request template Payload:

{
	"serviceName": "${latestEvent.affectedEntities[0].entityTypeDisplayName}",
	"device": {
		"hostName": "${latestEvent.node.name}"
	},
	"subject": "${latestEvent.summaryMessage}",
	"alertTime": "${latestEvent.eventTime.getYear()}-${latestEvent.eventTime.getMonth()}-${latestEvent.eventTime.getDate()} ${latestEvent.eventTime.getHours()}:${latestEvent.eventTime.getMinutes()}:${latestEvent.eventTime.getSeconds()}",
	"currentState": "WARNING",
	"app": "APPDYNAMICS",
	"alertType": "",
	"component": "",
	"description": "${latestEvent.eventMessage}",
	"monitorName": "${latestEvent.affectedEntities[0].entityTypeDisplayName}"
}

HTTP request templates for alert status - recovery or self heal

Name: Self heal alert HTTP request template Payload:

{
	"serviceName": "${latestEvent.affectedEntities[0].entityTypeDisplayName}",
	"device": {
		"hostName": "${latestEvent.node.name}"
	},
	"subject": "${latestEvent.summaryMessage}",
	"alertTime": "${latestEvent.eventTime.getYear()}-${latestEvent.eventTime.getMonth()}-${latestEvent.eventTime.getDate()} ${latestEvent.eventTime.getHours()}:${latestEvent.eventTime.getMinutes()}:${latestEvent.eventTime.getSeconds()}",
	"currentState": "OK",
	"app": "APPDYNAMICS",
	"alertType": "",
	"component": "",
	"description": "${latestEvent.eventMessage}",
	"monitorName": "${latestEvent.affectedEntities[0].entityTypeDisplayName}"
}

Step 2: Create action

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 define how a specific action is triggered for an event when you configure policies. HTTP Request is one of the actions.

You need to create three Actions to send Critical, Warning and Recovery alerts to OpsRamp. The only difference while creating is the Name and selection of HTTP Request Template. Critical alerts action - Name: Critical alerts action - HTTP Request Template: Select ‘Critical alert HTTP request template’ option Warning alerts action - Name: Warning alerts action - HTTP Request Template: Select ‘Warning alert HTTP request template’ option Recovery or Self Heal alerts action - Name: Self heal alerts action - HTTP Request Template: Select ‘Self heal alert HTTP request template’ option

To create individual actions for Critical, Warning and Recovery alerts:

1. Click Alert & Respond, click Actions on the left pane.
2. Select an application or database from the Actions drop-down and click Create.
3. From Create Action, select Make HTTP Request and click OK.
4. From Create HTTP Request Action, provide name for the action, select an HTTP template from the drop-down and click Save.
   • Name: Give name for the action (for example, self heal alerts action)
   • HTTP Request Template: Select the HTTP request template created for integration and the HTTP request template detail is automatically displayed upon selection of the template.

After successful creation of an action, create a policy where you can specify actions to trigger when certain events occur.

Step 3: Create policy

Policies provide a mechanism for automating monitoring and problem remediation. Instead of continually scanning metrics and events for the many conditions that could suggest problems, you can proactively define the events that are of the greatest concern for keeping your applications running smoothly and then create policies that specify actions to start automatically when those events occur.

Individual policies must be created to send Critical, Warning, and Recovery alerts to OpsRamp. These policies differ only for Name, trigger health rule violation events, and respective actions.

To create individual policies for Critical, Warning and Recovery alerts:

1. Click Alert & Respond, click Policies on the left pane.
2. Select context from the Policies drop-down menu and click Create.
3. From Create Policy, click Trigger, select the health rule violation events (as shown in the following table) and click Next.
4. On the left pane, click Actions and select an action for event.
5. From the Action page appears, select the appropriate action and click Select.
6. Click Save.

AppDynamics configuration for Basic authentication

Configuration for Basic authentication involves:

1. Creating HTTP request templates
2. Creating actions
3. Creating policies

OpsRamp integrates AppDynamics alerts through HTTP APIs, hence you are required to configure the action Make HTTP Request in AppDynamics. A HTTP request template describes the alert data that will be sent to OpsRamp.

Step 1: Create HTTP request template

To create individual HTTP request templates for Critical, Warning and Recovery alerts.

1. Log into AppDynamics.
2. Go to Alert & Respond > HTTP Request Templates and click New.
3. Provide HTTP request template values.

Payload for critical alert status

This provides the payload for a HTTP request template with an alert status of critical.

Name: Critical alert HTTP request template

Payload:

{
    "serviceName": "${latestEvent.affectedEntities[0].entityTypeDisplayName}",
	"device": {
		"hostName": "${latestEvent.node.name}"
	},
	"subject": "${latestEvent.summaryMessage}",
	"alertTime": "${latestEvent.eventTime.getYear()}-${latestEvent.eventTime.getMonth()}-${latestEvent.eventTime.getDate()} ${latestEvent.eventTime.getHours()}:${latestEvent.eventTime.getMinutes()}:${latestEvent.eventTime.getSeconds()}",
	"currentState": "CRITICAL",
	"app": "APPDYNAMICS",
	"alertType": "",
	"component": "",
	"description": "${latestEvent.eventMessage}",
	"monitorName": "${latestEvent.affectedEntities[0].entityTypeDisplayName}"
}

Payload for warning alert status

This provides the payload for a HTTP request template with an alert status of warning.

Name: Warning alert HTTP request template

Payload:

{
	"serviceName": "${latestEvent.affectedEntities[0].entityTypeDisplayName}",
	"device": {
		"hostName": "${latestEvent.node.name}"
	},
	"subject": "${latestEvent.summaryMessage}",
	"alertTime": "${latestEvent.eventTime.getYear()}-${latestEvent.eventTime.getMonth()}-${latestEvent.eventTime.getDate()} ${latestEvent.eventTime.getHours()}:${latestEvent.eventTime.getMinutes()}:${latestEvent.eventTime.getSeconds()}",
	"currentState": "WARNING",
	"app": "APPDYNAMICS",
	"alertType": "",
	"component": "",
	"description": "${latestEvent.eventMessage}",
	"monitorName": "${latestEvent.affectedEntities[0].entityTypeDisplayName}"
}

Payload for recovery alert status

This provides the payload for a HTTP request template with an alert status of recovery or _self heal>. HTTP Request Template for Alert Status- Recovery or Self Heal

Name: Self heal alert HTTP request template

Payload:

{
	"serviceName": "${latestEvent.affectedEntities[0].entityTypeDisplayName}",
	"device": {
		"hostName": "${latestEvent.node.name}"
	},
	"subject": "${latestEvent.summaryMessage}",
	"alertTime": "${latestEvent.eventTime.getYear()}-${latestEvent.eventTime.getMonth()}-${latestEvent.eventTime.getDate()} ${latestEvent.eventTime.getHours()}:${latestEvent.eventTime.getMinutes()}:${latestEvent.eventTime.getSeconds()}",
	"currentState": "OK",
	"app": "APPDYNAMICS",
	"alertType": "",
	"component": "",
	"description": "${latestEvent.eventMessage}",
	"monitorName": "${latestEvent.affectedEntities[0].entityTypeDisplayName}"
}

Step 2: Create action

To create individual actions for critical, warning, and recovery** alerts:

1. Go to Alert & Respond > Actions, select the context from the Actions drop-down menu and click Create.
2. Select Make HTTP Request and click OK.
3. Provide a name for the action, select a HTTP template from the drop-down, and click Save. Template details appear automatically upon selection of the template.

Step 3: Create policy

To create individual policies for critical, warning, and recovery** alerts:

1. Go to Alert & Respond > Policies, select the context from the Policies drop-down menu and click Create.

   

2. Select Trigger, select the health rule violations, and Save.
3. Go to Actions > Select Action, select the appropriate action and click Select.

The following tables describes the policy triggers for alerts.