• Products
  • Get started
  • Documentation
  • Resources

The integration framework

The new integration framework is only available for Jira Software Cloud and Jira Service Management Cloud at this moment.

An Opsgenie integration is a connection between your Opsgenie account and other apps in your IT environment. When connected, Opsgenie gets alerts from your IT apps, centralizes all alerts inside Opsgenie, and creates an alert bucket.

For each integration you can create custom automation rules to update and edit data or take custom actions by triggering the connected apps.

Creating the integration

To create an integration, you must first select Add integration by going to Settings > Integrations. Here you’ll get Opsgenie’s current integrations. Learn Opsgenie’s integration types. Currently, Opsgenie’s new integration framework is only available for Jira Software Cloud and Jira Service Management Cloud, which are highlighted with New tag.

Select the app to start setting the integration.

  • Integration name: Add a name for your integration.

  • Assigned to team: Opsgenie will set this team as an alert responder. This means that integration will send the alert notifications according to this team’s rules.

  • Connection: This is your connected Jira site. Opsgenie can automatically detect your connected sites. Also, you can manually connect Jira sites. Learn how to connect Opsgenie with a Jira Software Cloud

  • Project: The integration will be triggered with the issues of the selected project. You can select projects from the connected Atlassian sites.

  • Suppress notifications: This mutes the notifications. When you mute alert notifications, the responders won’t receive email, SMS or voice notifications.

Saving the settings redirects you to the main integration page where you can set the rules and enable the integration.

Opsgenie offers two rule sets; Incoming automation rules and Outgoing automation rules.

Incoming automation rules

Incoming automation rules define how Opsgenie behave when it receives data from Jira. In other words, it’s a way to automate the behavior of new or existing alerts when they are triggered by a Jira action. You can acknowledge or update an alert, add a note, close, or create a new alert through Jira issues.

There are five action types to an incoming automation rule. You can set the integration based on these actions and design the alert fields depending on your requirements. Alert fields vary according to the capability of each action. Learn more about dynamic fields.

The action types to the incoming automation rules are:

Ignore alert: Overrides the rules for the selected conditions. Select this option for the actions that you don’t want to receive an alert for.

Create alert: Creates an alert each time your pre-defined action occurs in your Jira project. For example, you can have an alert created for a new issue created in Jira, or when the status of an issue changes. For each action, you can customize the alert Opsgenie creates. Learn more about action filters.

Close alert: Closes the alert each time your pre-defined action occurs in your Jira.

Acknowledge alert: Acknowledges the alert each time your pre-defined action occurs in your Jira.

Add note to alert: Adds note to the alert each time your pre-defined action occurs in your Jira.

When you first create the integration we’ll provide some default rules. Unless if you disable or delete them, they’ll start working when you enable the integration. These rules are:

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

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

  • Acknowledge Alert: Opsgenie acknowledges the alert whenever the Jira issue that created the alert is updated to Work In Progress or Pending.

  • Add Note To Alert: Opsgenie adds a note to the alert whenever the Jira issue that created the alert receives a comment.

You can edit the default rules or add more rules to an incoming automation. Once you set your rules and enable the integration, Opsgenie will apply the rule from top to bottom, in its set order. This means that, if your first rule is for “Ignore” action and second is “Create alert”, and, if the data you receive from Jira matches the conditions of both rules, Opsgenie will stop at the first match – the “Ignore” action. It won’t create an alert.

Outgoing automation rules

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

Send alert updates to Jira

Choose this rule type to update a Jira issue when the alert triggered by that issue gets an update in Opsgenie. When an alert is created with an Incoming Automation rule, through issue created in Jira, and when that alert gets an update, Opsgenie sends this update information back to Jira and updates the issue. With Send alert updates to Jira rule, you can define how to update the Jira issue according to the rules.

Here, we provide the alert actions and their corresponding Jira actions in a sentence structure. Some actions, such as “a tag is added to alert” might require user input to perform properly. If you leave the input field empty, the rule will apply to all values. If you want to limit the input, enter the values manually, then press Enter. Similar to how you add tags to an alert.

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

Similar to the previous rule type, you can choose this rule type to trigger a Jira issue with an alert. However, with this option, you’re triggering Jira issues with alerts you received from your other integrated tools.

To define this rule type, first create a filter to choose which alerts you wish to apply this rule for. Then, define properties of the issue you want to trigger. The fields you can edit change depending on the issue type. Later, you can define the actions you want to take for the issue. Later, when Opsgenie receives an alert matching your filter, it will trigger your Jira to take your chosen action (adding a comment, changing the issue status…etc.). You can enable and disable each of these rules at anytime, even when the integration is enabled.

Similar to incoming automation rules, Opsgenie will apply the rule from top to bottom and stop once it matches with a rule. So, how you order the rules matter. Unlike incoming automation rules, you can order these rule by dragging and dropping.

When you’re done with setting all the rules, enable the integration from top of the page.

Additional Help