Integrate AppDynamics with Atlassian Jira™

AppDynamics with Atlassian Jira™ Integration is a two-way integration system that can automatically create and update Jira tickets when incidents occur. The information gathered in the Jira issue persists between AppDynamics and Jira, and can help you conduct a proper root cause analysis (RCA). You can navigate between the AppDynamics and Jira interfaces for a continuous experience. The Integration helps reduce the time in searching for specific event/incident data and consolidate tickets by following this runtime flow:

1. AppDynamics event triggers a Jira Incident. The event is a health rule violation.
2. AppDynamics event and incident data is gathered in a Jira issue.

This document contains references to Atlassian™ documentation. AppDynamics does not own any rights and assumes no responsibility for the accuracy or completeness of such third-party documentation.

Configuring Atlassian Jira Integration

You can integrate AppDynamics with SaaS Jira hosts only.

You can configure the Atlassian Jira Integration by using open authentication (OAuth 2.0). The OAuth model passes back and forth the consumer and public keys, and creates links on the Atlassian system. This is done through a wizard, where you type in the URL, create the public keys, and launch the Atlassian links you need. Once this is set up, you do not have to worry about authorization linked to the Jira system.

OAuth requires Jira administrator access.

To integrate AppDynamics with Jira:

1. Log in to the Controller UI as an administrator. 
2. Click Settings > Administration.

3. In the Administration window, click the Integration tab and then Atlassian Jira OAuth from the Integrations list.

4. Click Start Jira Integration Wizard. 

5. Follow the wizard steps:

   1. Enter your Jira host URL and click Continue. If the URL is valid, you see the JIRA URL verified message.

   2. Create an Application Link in Jira by entering the following details in your JIRA instance:

      1. Enter the Controller URL as the application URL.
      2. Enter an application name of your choice. For example, AppDynamics Controller integration test.
      3. Select the application type as Generic Application.
      4. Enter the consumer key, consumer name, and public key from the Controller UI.
      5. Select the Create incoming link check box.

   3. Authorize AppDynamics in Jira by allowing the read and write access. After authorization, you get a verification code. 

6. Copy the verification code from Jira and paste it on the Verification code from JIRA field in the Controller UI.

7. Click Atlassian JIRA OAuth from the Integrations list to view the integration details.

8. Click Save.

For more information about the Jira integration, see the following articles:

• Using OAuth to integrate JIRA with the Controller
• Link to other applications in Jira

Create a Jira Issue from AppDynamics

You can have AppDynamics automatically create a Jira issue when an incident occurs.

Create a Jira Issue with the Integration

You can define policies that, when triggered, generate Jira issues. See Jira Actions for more details. Flexible information such as event reason and error stack is inserted based on the event type and can be defined on an action-by-action basis. 

To create a Jira from configured health rules:

1. Follow the steps on Jira Actions to create a Jira action.
2. Go back to the Alert & Respond main page, and create a Health Rule. See Configure Health Rules.
3. Go back to the Alert & Respond main page, and create a Policy. See Configure Policies.
   1. Make the policy trigger based on the Health Rule Violation Events.
   2. Make the policy execute the Jira action you created earlier.

Create a Jira Issue Using CURL Commands

Create the following custom events to test the Jira integration using CURL commands:

1. ERROR
2. INFO

When an event with severity=ERROR is generated, a ticket is opened in Jira with MEDIUM priority. If you change the priority for the same event type and source and set the severity=INFO, the former opened ticket is updated and the priority is reduced to LOW.

Create a Custom Event with Severity ERROR

Use the following CURL command to create an event in the Controller and set the severity to ERROR.

Create a Custom Event with Severity INFO

Use the following CURL command to update the existing event in the Controller and set the severity to INFO.

Two different Event Types are listed on the AppDynamics Application Dashboard, Events tab. You can view the details of these events.  

View the Jira Tickets

You can view the Jira tickets created to handle the AppDynamics events in the Jira dashboard. The Jira action assigns these tickets to the signed in user. 

Disabling Atlassian Jira Integration

You can disable your Atlassian Jira Integration to disable all Jira functionality. The Atlassian Jira Integration features in the AppDynamics UI are disabled by default.

Disabling the integration from the administration settings will disable the following features:

• Jira action
• Issue Tracking widget
• Jira / War Room column in the Health Rule Violations table

Disabling these features does not delete them. You can again enable the integration to use the features and restore their original views.

Jira™ is a trademark of Atlassian