You might be aware that you can export follow-ups to Jira but did you know that you can automatically create tickets representing an incident too?
Often it can be hard to keep track of which tickets or follow-ups relate to which incident, or have a central place in your project tracking where you can add comments and extra information.
By having a single incident ticket created automatically you can attach, link, and refer back easily back to this one ticket. We will also keep fields and variables in sync and update the ticket with the latest information.
You can also use templates and conditions to create different tickets in different projects depending on custom fields, and incident types within incident.io.
Getting started
To get this set up, follow the setup process and once integrated click "Configure" on Jira in the integration settings page.
In the configuration page, you can now enable the automatic sync by clicking the "Sync incidents with Jira" toggle and saving.
Please note: you may not have a default template - before you can save you will need to add a template and potentially any conditions you wish to match against.
Creating and editing templates
When we sync information about an incident with Jira we will need to know what project, issue type, and any required fields to use when we create it.
By filling out the template you can specify any required and optional fields along with the ticket description itself using either static text or fields powered by our variables.
This gives you the flexibility to show more or less in the description for certain incidents. For example you might want a completely different set of information for a maintenance event vs a cricitcal incident.
You can create multiple templates (depending on your billing plan) and use conditions to select which one to use in certain circumstances. This will allow you to route your tickets to different Jira projects based on incident conditions.
Using conditions
If there are no conditions specified we will use the first template in the list and create a ticket for all incidents.
If you only wish to create a ticket for certain incidents, or create tickets in different projects then you'll need to set up some conditions.
For example, if we wanted to use a security template for security type issues we can create the following condition:
And once saved see how it will affect the creation of tickets:
We will warn you if a template is unused by any condition - but you don't have to use them all!
By default if you have a created at least condition we will not create a ticket if there is no match.
You can edit this no match fallback behaviour to enable always creating a ticket, for example here we fallback to our default template:
Private incidents
If you do wish to create tickets for private incidents you can enable this with the checkbox.
However be aware that anyone with access to the chosen Jira project will be able to see them, so take care.