AppDynamics Integration Guide – Netenrich

In this article:

AppDynamics integration with the Resolution Intelligence benefits the user with real-time insights using application performance management and sends signals from AppDynamics into a high-level acton in the Resolution Intelligence platform for resolving production issues quickly. A successful Integration uses a custom HTTP request, policy and health rules in AppDynamics. AppDynamics sends an HTTP request to Resolution Intelligence as defined by the template. Resolution Intelligence platform process and correlates the signal data to create and maintain up-to-data actons in the platform.

Prerequisites

You must have an active account and admin privileges to configure the integration in both AppDynamics and Resolution Intelligence platform for SaaS version.

Before integrating AppDynamics with our platform, install the AppDynamic agents in your environment for seamless integration and for triggering the signals from AppDynamics to Resolution Intelligence platform where slice and dice the data to get the insights of the signals and resolve the issues.

Installing AppDynamic Agents

Follow the below procedure to install AppDynamic agents in your environment.

1. From the AppDynamic Home screen, navigate to Getting Started tab and click Getting Started Wizard.

2. In the Getting Started Wizard page, click any one of the applications (aka agents) under Applications. For Example, select Java.

3. Follow the instructions shown on the Getting Started Wizard - Java screen and for more information click See the docs on the right side of the screen.

4. After installing the required agent, you are able to see the installed agent under the Applications tab.

5. Click on the application aka agent (For example, stg-resolution-intelligence) to view the detailed statistics of the agent in the dashboard.

Enabling AppDynamics Integration

In Resolution Intelligence

From the Resolution Intelligence platform interface, navigate to Configurations --> Integrations --> AppDynamics -><-Netenrich tile and click Enable integration toggle switch.
Under the Inbound section of AppDynamics, select the Authentication type as JSON Web Token (JWT). A web URL and consumer token will be generated.

In AppDynamics

From the AppDynamics web interface, select Alert & Respond, and then on the left-hand nav bar, click HTTP Request templates. A web page appears on the screen and then click New.

2. Enter a name for the template (For example, StagAppDAutomationLabs).
3. Under Custom Templating Variables, click Add Variable. Enter Token in the variable field and API Key in the default value field.
4. Under Request URL, set the method to POST and paste in your NeAppDynamics service URL and API key in the Raw URL field using the following format.

https://ingest-test.netenrich.net/alerts-lite?token={YOUR_SERVICE_API_KEY_HERE}

5. No Authentication is required.
6. Under Custom Request Headers, click Add Header. Enter Authorization with a value of ${token} and Content-type with a value of application/json in the given fields.

7. Under PayLoad, select MIME Type as application/json and paste the following text in the given blank.

{
"id":"${latestEvent.id}",
"applicationEntityType":"${latestEvent.application.entityType}",
"applicationEntityTypeDisplayName":"${latestEvent.application.entityTypeDisplayName}",
"applicationId":"${latestEvent.application.id}",
"applicationName":"${latestEvent.application.name}",
"dbEntityType":"${latestEvent.db.entityType}",
"dbEntityTypeDisplayName":"${latestEvent.db.entityTypeDisplayName}",
"dbId":"${latestEvent.db.id}",
"dbName":"${latestEvent.db.name}",
"deepLink":"${latestEvent.deepLink}",
"displayName":"${latestEvent.displayName}",
"eventMessage":"${latestEvent.eventMessage}",
"summaryMessage":"${latestEvent.summaryMessage}",
"eventType":"${latestEvent.eventType}",
"guid":"${latestEvent.guid}",
"eventTypeKey":"${latestEvent.eventTypeKey}",
"btId" : "${bt_id}",
"btName" : "${bt_name}",
"healthRuleEntityType":"${latestEvent.healthRule.entityType}",
"healthRuleEntityTypeDisplayName":"${latestEvent.healthRule.entityTypeDisplayName}",
"healthRuleId":"${latestEvent.healthRule.id}",
"healthRuleName":"${latestEvent.healthRule.name}",
"incidentEntityType":"${latestEvent.incident.entityType}",
"incidentEntityTypeDisplayName":"${latestEvent.incident.entityTypeDisplayName}",
"incidentId":"${latestEvent.incident.id}",
"incidentName":"${latestEvent.incident.name}",
"isBTPerformanceEvent":"$latestEvent.btPerformanceEvent}",
"isHealthRuleViolationEvent":"${latestEvent.healthRuleViolationEvent}",
"nodeEntityType":"${latestEvent.node.entityType}",
"nodeEntityTypeDisplayName":"${latestEvent.node.entityTypeDisplayName}",
"nodeId":"${latestEvent.node.id}",
"nodeName":"${latestEvent.node.name}",
"severity":"${latestEvent.severity}",
"tierEntityType":"${latestEvent.tier.entityType}",
"tierEntityTypeDisplayName":"${latestEvent.tier.entityTypeDisplayName}",
"tierId":"${latestEvent.tier.id}",
"tierName":"${latestEvent.tier.name}",
"eventTime":"${latestEvent.eventTime}",
"app":"AppDynamics",
}

8. No Response Handling Criteria is required.
9. At the bottom of the page, make any changes to the settings you would like and then select Save and Test.

10. In the HTTP Action Template Testwindow, add an Event Type Trigger with a count of 1 during testing and click Run Test.

11. Verify under Resolutions --> ActOns in Resolution Intelligence to make sure you get the associated signal.

Configuring Actions for the Template

After enabling an HTTP Request Template, it is mandatory to assign the template to an action to create a signal with respect to the template. For more information on Configuring Actions, refer here.

The following steps allow you to assign the template to an action.

From the AppDynamics web interface, select Alert & Respond, and then on the left nav bar, click Actions.
In the Actions screen, select the Applications (For Example, stg-resolution-intelligence) from the drop-down and then click Create +.

3. In the Create Action window, under HTTP Request, select Make an HTTP Request and then click OK.

4. In the Create HTTP Action window, give a name for the action field and select the HTTP Request Template (For example, StagAppDAutomationLabs) from the drop-down and then, click Save.
An Action will be created for the agent.

Configuring Health Rules

After configuring an action, you will need to enable health rules to set up threshold limits for the assets that you wish to monitor. When an asset crosses a certain threshold limit, AppDynamics will trigger a signal and this signal will be sent to our Resolution Intelligence. For more information on Configuring Health Rules, refer here.

From the AppDynamics web interface, select Alert & Respond, and then on the left-hand nav bar, click Health Rules.
In the Health Rules screen, select the Applications (For Example, stg-resolution-intelligence) from the drop-down and then click +.

3. In the Create Health Rule window under the Overview tab, give a name for the rule and select the parameters as you required.

4. Under the Affected Entities tab, select the Health Rule Type from the drop-down. By default, it should be Overall Application Performance (load, response time, num slow calls, etc).

5. Under the Critical Criteria tab, click + Add Condition and select the parameters as shown in the illustration below.

6. Under Warning Criteria tab, click + Add Condition and select the parameters as described in the below illustration and then, click Save.

Configuring Policies

Configuring a policy allows triggering an action which is based on one or more events. Use the policies to automate, monitor, signal and resolve issues in the production environment. A policy can be triggered when at least one of the specified triggering events occurs on at least one of the specified objects.

For more information on Configuring Policies, refer to this documentation.

1. From the AppDynamics web interface, select Alert & Respond, and then either in the right panel or the left-hand nav bar, click Policies.

2. In the Policies screen, select the Applications (For Example, stg-resolution-intelligence) from the drop-down and then click Create +.

3. In Create Policy screen under the Trigger tab, enable Health Rule Events and other events if required.

4. Under the Health Rule tab, Select Health Rules and click+ to add health rules if you want the policy to be triggered by a violation of any health rule.

5. Under the Object Scope tab, select Any Object or These Specified Objects if you wish to restrict to specific objects and then select the objects.

6. Under the Actions tab, click + to add the Actions from the existing list. The available actions vary depending on the product area selected for the policy, such as Applications, Servers, Databases and so on.

7. In the list of actions, select the action that you want this policy to execute and click Select.

Note: You can create an Action as described in Configuring Actions for the template.

8. Click Save.