Start building your teams, integrate your tools and create on-call schedules.
Start building your teams, integrate your tools and create on-call schedules.
Learn how to configure your profile, get notifications from Opsgenie and view on-call schedules.
Advanced Opsgenie account settings and other reference information
Learn how to receive and manage alerts, create policies and encrypt alert data.
Learn all the ways to create an integration, use Opsgenie's integration framework and check system health with Heartbeats.
Notify the right users, investigate potential causes and take preventive actions to avoid future incidents.
Manage your services, create service relationships, view the service status and report problems.
Learn all the ways to set up Opsgenie actions, create channels and execute actions.
Learn how to use Opsgenie's integration server to connect your internal and external systems.
Analyze Opsgenie activity with global and team reports.
Learn all the ways to log in Opsgenie, set password policies and administer user accounts.
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.
Opsgenie provides OEC solution for Jira On-Premise users to send Opsgenie alerts to Jira. Refer Creating Issues from Alerts in Jira blog post for more information.
Functionality of the integration
When an issue is created or reopened on Jira, an alert is created on Opsgenie automatically through the integration.
When an issue is resolved or closed or fixed on Jira, the related alert is closed on Opsgenie automatically.
When a comment is added to an issue on Jira, a note is added to related alert on Opsgenie.
If Send Alert Updates Back to Jira is enabled, actions for Jira are executed in Jira when the chosen action is executed in Opsgenie for alerts which are created by the Jira integration.
If Create Jira Issues for Opsgenie Alerts is enabled, actions for Jira are executed in Jira when the chosen action is executed in Opsgenie for alerts which have a source other than the Jira integration.
These action mapping features are explained in detail in the Action Mapping Feature section below.
Adding Jira Integration in Opsgenie
Please create an Opsgenie account if you haven't done so already.
Go to Opsgenie Jira Integration page.
Specify who is notified of Jira alerts using the Teams field. Auto-complete suggestions are provided as you type.
Copy the integration URL which includes the Opsgenie endpoint as well as the API key.
Click Save Integration.
Configuration in Jira
Log in to Jira as an administrator.
From the dashboard, open the Administration menu. Select System.
From the left, select Webhooks under "Advanced".
4. Click Create A Webhook. In the opening section, paste the URL provided by Opsgenie's Jira integration into URL input. Click Create.
Now that the webhook is configured, Jira will notify Opsgenie when changes are made to issues. Opsgenie then creates alerts and track them.
If you are using SSO to login to Jira, you need to generate an API token and use this token as the password in the integration settings password field. View these instructions to generate an API token in Jira.
After generating your new token, copy and paste it to the password field of the Jira integration in Opsgenie. Save the integration.
Action Mapping Feature
Opsgenie allows customers to define action mappings between Opsgenie actions and Jira actions.
To use the Action Mappings feature, provide some information to the integration which are listed below:
Issue Type: The issue types defined in Jira e.g. Task, Bug or any other custom defined type. Make sure you write the issue type syntax error-free.
URL: This is the domain name of your Jira Software e.g. https://testops.atlassian.net
Username: The e-mail address you use to login to Jira.
Password/API Token: The password or API token you use to login to Jira.
Project Key: The key of the project you want to create alerts from e.g. OT, OPS, SIT. The project key is usually in capital letters so make sure you write it in the right form.
For alerts created by Jira
Use this section to map Opsgenie actions to Jira actions when the source of the alert is Jira (i.e When the alert is created by Jira integration.)
Map different Opsgenie actions to different Jira actions. For example, add comments to Jira issue, when the alert is acknowledged. In order to do this, define If alert is acknowledged in Opsgenie, add it as a comment to issue in Jira. mapping in Send Alert Updates Back to Jira section.
For other Opsgenie alerts
Use this section to map Opsgenie actions to Jira actions when the source of the alert is NOT Jira (i.e When the alert is created by another integration.)
For this purpose, use Create Jira Issues for Opsgenie Alerts section. In order to use this functionality, map one Opsgenie action to create an issue Jira action. The Opsgenie action doesn't have to be alert is created, it can be other actions as well.
a tag is added to the alert and a custom action is executed on alert actions differ from other actions. When one of these actions is selected, an extra field appears to enter for which tags or for which custom action this mapping works.
Enter multiple tags by separating the tags with a comma. If multiple tags are entered, the mapping works if the alert has one or more of the specified tags. Leave the tags field empty to have the mapping to work for any tag.
If an Opsgenie action is mapped to multiple Jira actions, an error occurs except for the a tag is added to the alert and a custom action is executed on alert actions. Save multiple mappings for these actions because they differ by the given tags and the given custom action names.
Opsgenie Jira Integration allows the status of the issue to be set to IN PROGRESS, RESOLVED, DONE or CLOSED in Jira. However, if the workflow of the project does not allow any of the transitions, the transition cannot be set using Opsgenie too.
Sample payload sent from Jira
Integration via OEC (for Jira Software Server & Data Center Usage)
Use Opsgenie's OEC and the Jira Software Server & Data Center script to update issues on Jira Software Server & Data Center. This enables the deployment of your own scripts/ability to modify the ones provided and execute customized actions on Jira Software Server & Data Center.
To use the Jira Software Server & Data Center integration package, follow the steps in the sections below through the end.
Download the latest version of OEC
To download the latest version of Jira package, please use readme file of oec-scripts repository.
For Red Hat Based Distributions
Run following command : rpm -i opsgenie-jira-<your_version>.rpm
For Debian Based Distributions
Run following command : dpkg -i opsgenie-jira-<your_version>.deb
Unzip opsgenie integration zip file which contains OEC package into a directory (C:\opsgenie is the preferred path.) Follow the instructions here to install OEC on Windows.
In order to learn more about how to run OEC you can refer to the Running OEC documentation.
Configuring Jira Software Integration for OEC
In order to use OEC utility for your Jira Software integration, enable Send Via OEC in your integration settings.
Other configurations regarding Jira Software can be done either via the integration settings page or the OEC configuration file. Configuration on the integration page precedes the configuration file.
To be able to execute actions in Jira Software, OEC gets the configuration parameters from the configuration file.
apiKey – Copy the API key from the Jira integration you've created above.
issueTypeName – Type of the issue which can be "Task", "Bug", "Story" or your custom issue type ("Epic" is not supported!).
url – Your Jira url where the issues will be created, resolved, closed etc.
username – Your username for your Jira account.
password – Your password for your Jira account
projectKey – The issues will be created for this project
The package that you downloaded also includes OEC utility which is located under /usr/local/bin and the script that is needed to be run by OEC which is under /home/opsgenie/oec/scripts. After the configuration of OEC is done, you need to run it. In order to learn more about how to run OEC, you can refer to the Running OEC documentation.
Sample parameters sent to OEC
If a mandatory custom field is set for creating an issue in Jira, a Jira issue cannot be created from an Opsgenie alert. However, by using OEC and configuring the script, the creation of Jira ticket can be achieved.
If a comment cannot be added to an issue by performing an action on an alert, please look at the Logs page first. If the URL does not contain the issue key it means there is no issue on Jira which is populated from that alert. Thus it could not add a comment to a non-existing issue.
Opsgenie's Jira Integration allows users to set the status of the issue to In Progress, Resolved, Done or Closed in Jira. However, if the workflow of the project does not allow any of the transitions, you cannot set that transition using Opsgenie too.
Opsgenie checks the transaction names case-sensitively. Transaction names in Jira should be exactly the same. (I.e. In Progress, Resolved, Done and Closed)
4. Jira does not support non-ASCII characters. Having non-ASCII characters on payload to be sent to Jira may cause 400 Bad Request Error.
5. If the Jira integration is assigned to a team, in order to create issues in Jira from alerts created in Opsgenie, the other integrations must also be assigned to the same team, or, no team must be assigned for both the Jira integration, and the other Opsgenie integrations.
Was this helpful?