Jira

Before you start

1. To complete this procedure, you need an Atlassian account with the Create issues project permission, which enables you to create new tickets in an existing Jira project.
2. If you want to be able to use the Assignee field, you additionally need Browse users and groups global permission.
3. You must also either already have default fields set up for the Jira project you want to add as an integration. Default fields let you specify the project and the issue type for tickets created using the Jira integration. For more information, see Atlassian's page, Add, edit, and delete a field configuration.
4. Find your Jira project Key
   • Open your Jira project.
   • On the project sidebar, select Project settings > Details.
   • Note the value of Key. This is your project key.

Set up the Jira integration in Lightup

1. Add an integration, and select Jira.
2. In the Add Jira Integration dialog, supply the following information:
   • Mode:
     • Select Auto if you want to add the integration to an alerting channel so that incidents can generate tickets automatically. Note that a monitor must have the alerting channel added to it before its incidents can generate tickets automatically.
     • Select Manual to prevent the Jira integration from being added to an alerting channel. Users must manually submit a Jira ticket via the incident.
   • Name: A name for the integration
   • Jira Server: The URL of your Jira site. It should resemble https://yoursitename.atlassian.net.
   • Authentication type: Specify the authentication protocol to use.
   • Username: Your account name on Jira.
   • Password or API Token: Either your Jira password or a Jira API token.
3. Select Authenticate.
4. When authentication succeeds, select Project and choose the Jira project for the integration.
5. When you choose the project, you can then pick an Issue type. The issue type determines which fields can be collected in a ticket.
6. Under Select the fields to include, click the box to add a field. The fields you can add depend on the Issue type you set in the previous step. Click the X on a field to delete it from the box (and hence, omit it from tickets using the integration).
7. Under Defaults, you can change the default setting for any field that you added in the previous step. Initial defaults are inherited from Jira.
8. Optionally, select Create a test ticket to make sure it works as expected.
9. At the top right, select Add.

👍

You can add multiple Jira integrations to a workspace (just repeat the procedure making any needed adjustments, for example choosing a different Issue type). If there is more than one Jira integration, users can pick which one to use when they submit a ticket.

Now that your Jira integration is ready, a new command, Submit Jira Ticket, appears at the top right corner when you view an incident. Note that if more than one Jira integration is available, you'll see a list so you can select the right one.