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.
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.
In the left sidebar under “Mail” select Incoming Mail.
Under “Mail Handlers” select Add Incoming mail handler.
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.
Select the Project you want to associate this integration with, in this example we selected the “VictorOps Critical Incidents” then select Add.
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.
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.
If you have any questions please reach out to support.
This integration method utilizes a custom URL and the VictorOps Transmogrifier to generate a JIRA ticket with information from the alert automatically added.
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:
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.
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.