Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
4,256,357
Community Members
 
Community Events
164
Community Groups

How to configure the integration between Jira and Opsgenie

Hi there, I'm Pedro and I work as a Support Engineer for the Jira Service Management team in AMER. Since Opsgenie was released bundled with JSM we started receiving cases where the customers were having a hard time performing the integration between these products.

It can be a little tricky to configure the integration between those two products, but when configured it can be a powerful tool. It’s possible to integrate them for when a ticket is created in Jira it will create an alert in Opsgenie, when this alert is acknowledged a comment can be added to the Jira ticket, when the alert is closed it’s possible to close the ticket directly in Jira.

That being said, let’s cover the steps necessary to complete this integration.

Requirements:

  • JSM/Opsgenie access;

  • API Token;

Steps:

  1. Integration setup in Opsgenie;

  2. Webhook configuration in Jira;

Configuring the Integration in Opsgenie

  1. In Opsgenie, go to Teams and select your team - If you are on JSM Premium, you can find this under Settings > Integration List as well;

  2. On the left sidebar go to Integrations;

  3. Add Integration > Select either Jira Software or Jira Service Management (both will work, however, I personally recommend using the Jira Software integration even if your project is a Service Management, it has more filter options);

  4. Copy the URL to use it on the Jira Webhook;
    url.png

  5. Name the integration, assign it to a Team and enable it;

  6. Enable the two options below to create this back and forth communication between the products;
    3.png

  7. For the next step, you will need to configure your API Token, for that, follow the steps here.

  8. On the section below, you need to paste the Issue Type exactly as it is displayed in Jira, your site URL, the email of the user who configured the API Token, the API Token itself, and the project key.
    (After you save the integration, the API Token will be displayed empty as below, this is expected);
    4.png

  9. Under the Alert Fields section, you can configure the fields that will be displayed in the alert and select the user who will be added as responsible for the notes;

  10. Save the integration;

Configure the Webhook in Jira

Webhooks are user-defined HTTP POST callbacks. They provide a lightweight mechanism for letting remote applications receive push notifications from Jira, without requiring polling. For example, you may want any changes in Jira bugs to be pushed to a test management system so that they can be retested.

  1. Log in as a user with the Administer Jira global permission;

  2. Choose  > System. Under Advanced, select WebHooks;

  3. Create a new Webhook filtering by the issues that you want to pass it over to Opsgenie, for example:
    1.png

  4. Don’t forget to select issue and comments events at least;

  5. Paste the URL you copied from the Opsgenie integration:
    2.png

  6. Create;

That’s it, the integration is configured and should be working as expected now. You can now create an alert to see if it will create a ticket in the Jira project configured.

Make sure you don’t have mandatory fields during the Jira issue creation that could block the process.

Let me know if you have questions.

8 comments

Hi Gary,

Yes, but only for projects in the new ITSM templates. Old project templates don't have the Incident Management section in the project settings.

Pedro. Ah gotcha. Thank you for clarifying.

Pedro,

In step 5, it says "Copy the URL, this will be used in the Opsgenie integration." However, where is this URL defined? We can't find it in Jira or in OpsGenie.

Hi @James Halpin

I have updated the steps. You will copy the URL from the Jira Software or Jira Service Management integration in Opsgenie and will paste it on the Webhook in Jira. 

Step 4 on the first section and step 5 on the second section.

Thanks for your feedback! 

Hi, 

For Opsgenie to JIRA,  I have created API token and configured the remaining fields under Opsgenie to Jira Service Management, but getting below error in Activity Log. Kindly suggest.

 

Reason: Cannot get transition id. Reason: 404 Not Found: [{"errorMessages":["Issue does not exist or you do not have permission to see it."],"errors":{}}]

Hi @balajisk 

The user associated to the API Token you created for Opsgenie needs to have permission to create/transition/comment on issues in Jira. The error leads me to believe that your account in Opsgenie doesn't have these permissions in Jira.

If necessary, please raise a ticket with our support.

Comment

Log in or Sign up to comment
TAGS
Community showcase
Published in Jira Service Management

Safe customer notifications in Jira Service Management for compliance and privacy needs

Announcing safe customer notifications in Jira Service Management as a building block for compliance and privacy needs At Atlassian, we understand the increasing need to be assured that your data i...

302 views 1 14
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you