• Products
  • Get started
  • Documentation
  • Resources

Integrate Opsgenie with Jira Software Cloud

This document describes integrating Jira Software Cloud with Opsgenie’s new integration framework. This framework is currently in the Early Access Program. Contact the Support Team to join the Early Access Program and use the new framework to integrate Jira Software Cloud.

Go to Integrate Opsgenie with Jira to set up Jira Software Cloud integration using the old framework.

What does Opsgenie offer to Jira users?

Opsgenie has a specific update set that allows a bi-directional integration between Opsgenie and Jira. Use the integration to have Jira send issues to Opsgenie with detailed information. Opsgenie forwards alerts as issues to Jira. Opsgenie determines the right people to notify based on on-call schedules– notifies via email, text messages (SMS), phone calls and iOS & Android push notifications, and escalates alerts until the alert is acknowledged or closed.

What can you do with this integration?

  • When a Jira issue is created or re-opened in Jira, the integration automatically creates an alert in Opsgenie.

  • When an issue is resolved, closed, or fixed in Jira, the integration automatically closes the related alert in Opsgenie.

  • When the Jira issue receives a comment, the integration automatically adds a note to the related alert in Opsgenie.

  • When Send alert updates to Jira is selected, the integration executes a Jira action in the user's Jira account with the designated Opsgenie alert action. Alert must be created by Jira previously. 

  • When Create and update Jira issues with Opsgenie alerts that are created by other integrations is selected, the integration executes a Jira action in the user's Jira account with the designated Opsgenie alert action. Alert must be created by a third-party tool.

Add a new Jira Software Cloud integration

To create a new integration;

  1. Go to Settings → Integrations.

  2. Select Add integration

  3. Select Jira Software Cloud.

  4. On the create screen, enter an Integration name.

  5. If you want a specific team to receive alerts from that integration, select Assigned to team. Otherwise, leave empty.

  6. If you have a connected Atlassian site, we’ll show it in the Connection field.

  7. Select the Jira project you want to integrate with Opsgenie. If you’re going to integrate Opsgenie with multiple projects, create another integration.

  8. Select Save.

Did you know that you can also add this integration from your team dashboard? 

If you want your team to be the owner of this integration, add it from your team dashboard. Opsgenie will assign the alerts received through this integration to your team only.

To do that;

  1. Go to Teams,

  2. Find your team and select it to go to your team dashboard,

  3. From your team navigation, select Integrations,

  4. Select Add integration.

Now that your base settings are done, you can start creating rules for this integration. Opsgenie offers two rule sets;

Incoming automation rules are used for automating new or existing alerts when triggered by the Jira integration. You can acknowledge or update an alert, add a note, close, or create a new alert through Jira issues. By default;

  • Opsgenie creates a new alert whenever a Jira issue is created in your selected project.

  • Opsgenie closes the alert whenever the Jira issue that created the alert is updated to Resolved, Closed, or Done.

  • Opsgenie adds a new note to the alert whenever a comment is added to the Jira issue.

You can add multiple rules for each action. Additionally, you can add rules to acknowledge alerts or select the type of alerts to ignore this integration.

Outgoing automation rules define how Opsgenie alerts affect your Jira. There are two types of rule you can create for an outgoing automation;

  • Send alert updates to Jira to update a Jira issue when the alert triggered by that issue is updated in Opsgenie. This means that if an issue created in Jira triggered an alert in Opsgenie, with an incoming automation rule, and if that alert gets an update, Opsgenie sends this update information to Jira and updates the issue.

  • Create and update Jira issues with Opsgenie alerts that are created by other integrations is also for triggering a Jira issue with an alert. However, you can trigger Jira issues with alerts you received from your other tools with this option.

Add an incoming automation rule

To create an incoming automation rule;

  1. Go to Settings → Integrations.

  2. Select an integration to view the detail.

  3. Under Incoming automation rules, select Add rule.

  4. Enter Rule name.

  5. Select Rule type. This is the action Opsgenie will take for the alerts you’ll define in the following steps.

  6. Start adding conditions to select which alerts you’d like to apply to this rule. Learn more about action filters. At this point, Opsgenie knows what action to take for which alerts. In the following steps, you can customize the alert detail.

  7. In Alert properties, drag dynamic fields into the relevant alert fields. Select Show all fields to see all alert fields.

  8. If you’d like to enable this rule now, select Enable now checkbox.

  9. Select Save to add the rule.

Add an outgoing automation rule

We have two options for outgoing automation rules;

Send alert updates to Jira

If you receive an alert triggered by the incoming automation rule of a Jira integration, you can update the Jira issue simultaneously when the alert gets an update. To do that;

  1. Go to Settings → Integrations.

  2. Select an integration to view the detail.

  3. Under Outgoing automation rules, select Send alert updates back to Jira.

  4. Select Add update rule.

  5. We’ll add a configurable row to create the rule. First, select an action, then select the update type.

  6. Add as many rules you need, then select Save.

You can disable the rule set by unselecting the checkbox. We’ll keep the rules, but we won’t apply them until you enable them again.

Create and update Jira issues with Opsgenie alerts that are created by other integrations

Select this option to trigger Jira issues with an alert you receive from one of your tools.

  1. Go to Settings → Integrations.

  2. Select an integration to view the detail.

  3. Under Outgoing automation rules, select Create and update Jira issues with Opsgenie alerts that are created by other integrations.

  4. Select Add issue creation rule.

  5. Enter a Rule name.

  6. Start adding conditions in the Filter alerts to select which alerts you’d like to apply this rule. Learn more about action filters.

  7. Select which alert action should trigger creating this issue. Remember, we’ll apply the alert action only for the type of alerts you’ve selected in the previous step.

  8. In Issue properties, select an Issue type.

  9. Select Customize the issue details to edit the fields of the issue this rule will create.

  10. Drag dynamic fields to customize, then select Apply.

  11. At this point, Opsgenie knows when and how to create an issue in Jira with an alert.

  12. Set issue update actions to define how to update the issue. Select Add new action.

  13. We’ll add a configurable row to create the rule. First, select an action, then select the update type.

  14. If you’d like to enable this rule now, select Enable now checkbox.

  15. Add as many rules you need, then select Save.

When you add all the rules, select Enable integration from the top of the page.

Last modified on Jun 18, 2021
Cached at 11:42 PM on Oct 20, 2021 |

Additional Help