1. Home
  2. Integrations
  3. VictorOps: JIRA Integration

VictorOps: JIRA Integration

JIRA Software offer flexible issue and project tracking for software teams. VictorOps has two integrations with JIRA, one for each direction. The first will allow you to create a new JIRA ticket for any incident that comes into VictorOps. The second one below allows you to create VictorOps incidents whenever a new issue is added to your JIRA project.

VictorOps =>JIRA (Email Endpoint)

This integration requires that you setup JIRA email that creates and updates Issues. This is only available with JIRA Service Desk. For more information see the documentation HERE.

In JIRA

The first step is to setup an “Incoming mail handler” for the project you want to receive issues from VictorOps. To do so select Settings (gear icon) and then System.

jira1

In the left sidebar under “Mail” select Incoming Mail.

jira2

Under “Mail Handlers” select Add Incoming mail handler.

jira3

Give it a name and select the appropriate handler you want to use for this integration (We suggest the “Create a new issue or add a comment to an existing issue” option), then hit Next.

jira4

Select the Project you want to associate this integration with, in this example we selected the “VictorOps Critical Incidents” then select Add.

jira5

Next, retrieve the email address associated to the project. To do this go into your projects administration page and select Email requests. Copy the email you want to use to your clipboard.

jira6

In VictorOps

We will use the JIRA email address as part of a team’s escalation policy so that when an alert is routed to that team, a ticket is created. This gives you two options:

1) Create JIRA issues from specific VictorOps incidents by re-routing incidents to a “New JIRA Ticket” team that has a single escalation step to send an email to the JIRA email address.
2) Create JIRA issues from every VictorOps incident that goes to a team by adding the JIRA email address to the first step of that teams escalation policy.

The following will walk you through the first option.

In the VictorOps web portal select Settings then Schedules and then Add Team.

Add your JIRA Email address to the first step of the escalation policy.

 

And that’s it! Now any time you want to create a JIRA issue from any VictorOps incident all you need to do is re-route that incident to the “New JIRA Ticket” team.

 

jira10

If you have any questions please reach out to support.

VictorOps =>JIRA (Custom URL)

This integration method utilizes a custom URL and the VictorOps Transmogrifier to generate a JIRA ticket with information from the alert automatically added.

In VictorOps

From the web portal select Settings -> Alert Behavior -> Transmogrifier.

Add a new rule. Set it to match on the alerts you would want to create JIRA tickets from. In the below example we have set it to match on any alert containing a host_name.

Next add an Annotation and select the URL type. Give it a name and then build a custom create JIRA ticket using documentation from Atlassian here:

Altassian Documentation

You can use Variable Expansion within the transmogrifier to build the URL in a way that pulls in information for the ticket dynamically. Below is an example where we set the Description, Summary and Label fields.

https://YOUR_DOMAIN_HERE.atlassian.net/secure/CreateIssueDetails!init.jspa?pid=10506&issuetype=1&description=${{state_message}}&summary=${{entity_id}}l&labels=${{labels}}

Now whenever the rule matches on an alert, you will have a one touch option to create a JIRA ticket that already has information pulled directly from the VictorOps alert.

jira12

jira13

And that’s it, if you have any questions please reach out to the VictorOps support team.

Updated on November 15, 2018

Was this article helpful?

Related Articles