1. Home
  2. Integrations
  3. Jira App Integration Guide

Jira App Integration Guide


Jira Version Required: Jira Server 7.7.0 – 8.15.1, Jira Cloud (versionless)

VictorOps Version Required: Starter, Growth, or Enterprise

Configuration in VictorOps

NOTE: Global Admin privileges are required for the VictorOps portion of the configuration.

In VictorOps, navigate to Integrations >> API.

Click the New Key button. Give the key a description. Note the resulting API key and existing API ID.

Installing the VictorOps Add-On

  1. Log in as a Jira administrator, then navigate to the Atlassian Marketplace by clicking on Jira administration gear icon > Manage apps.
  2. In the left-hand sidebar, click Find new apps under the Atlassian Marketplace header.
  3. Search for VictorOps. Locate the result Splunk > VictorOps Jira Server Integration. Click Install in the entry.

Once installation completes, click on Configure.

Configuring Application Settings

  1. Insert the API key you generated in VictorOps into the API Key field under the Connect to your VictorOps Organization section of Jira’s VictorOps for Jira Server Configuration page.
  2. In the API ID field in the same section, insert the API ID you noted in the VictorOps step above.
  3. Copy the VictorOps Org ID displayed in your VictorOps URL (e.g. https://portal.victorops.com/client/{Org_ID}) and paste it in Jira’s Organization ID field. This is appended to the incident link within Jira tickets.
  4. Once all three fields have been populated, click ConnectOn success, a new entry will appear in the Connected VictorOps Organizations section, and display a green “VALID” flag.

Configuring Jira Project Settings

The VictorOps add-on must be enabled and configured for each Jira project you wish to associate.  Note that while multiple projects can connect to the same VictorOps organization, projects cannot share the same Default Team Escalation Policy.

  1. In Jira, click Projects
  2. Navigate to Project settings of the project you wish to enable for the VictorOps add-on, then click VictorOps Settings.
  3. Click Enable VictorOps for this Project.  This will expand the page to display a list of configurable fields.

Default Incident Settings

  1. Under VictorOps Instance, select the VictorOps organization you wish to associate with this project.
  2. Under Default Team Escalation Policy, select the VictorOps Escalation Policy you would like to page when Jira issues create incidents in VictorOps.  NOTE:  Incoming VictorOps incidents assigned to this Escalation Policy will be the only ones allowed to create issues in your Jira project.
  3. Under Default User, select the Jira user you wish to designate as Reporter for issues generated by incoming VictorOps incidents.

Incoming Issue Settings

VictorOps incidents created for a project’s Default Team Escalation Policy will automatically generate Jira issues.  The default type for such issues (Bug, Epic, Story, or Task) is set by selecting the desired option from the Issue type to use for incoming VictorOps incidents dropdown.

If you wish to disable such issue creation, deselect the Allow issues to be created from incidents via the REST API checkbox.

Jira State Configuration

Defining state mapping allows Jira issues to remain synchronized as incidents move through their life cycle in VictorOps.

Creating a VictorOps Incident Within Jira

Currently, VictorOps incidents can only be created from the Jira issue view.

  1. Click More > Create VictorOps Incident.  A preview of the VictorOps incident card will display, using the project’s Default Team Escalation Policy.
    Note: For Jira Cloud, the More button is an ellipsis button.
  2. You may select a different escalation policy from the VictorOps Team Escalation Policy dropdown.  You may also use the Additional Users dropdown to optionally include additional users for response.  Note that adding users to an incident will not create a “Multi-Responder incident” in VictorOps. 
  3. Click Create Incident to generate a VictorOps incident.  This will then display a Triggered VictorOps incident card under the VictorOps section in the lower right frame of the issue view.
  4. Click the incident card’s Incident Details link to display the incident in VictorOps in a new browser tab.

Updated on May 25, 2022

Was this article helpful?

Related Articles