Jira
You can integrate Jira with Lightup to enable Jira ticket creation from inside your Lightup workspaces.
Prepare in Jira
Before anyone can add a Jira integration, a suitable Jira project must be prepared.
To complete this procedure, you need an Atlassian account with the Create issues project permission. If you want to use the Assignee field, you additionally need Browse users and groups global permission.
- Select the Jira project you want to use.
- Set up any default fields you want to use. 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.
- Make note 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, which is needed whenever someone adds the Jira integration to a workspace.
Add a Jira integration to a workspace
- Select the workspace where you want to add an integration, and then select Integrations on the left panel.
- Select Create Integration +.
- In the list that appears, select Jira.
- 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
. - Username: Your account name on Jira.
- API Token: Enter your Jira API token.
- Select Authenticate.
- When authentication succeeds, select Project and choose the Jira project for the integration.
- When you choose the project, you can then pick an Issue type. The issue type determines which fields can be collected in a ticket.
- 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).
- Under Defaults, you can change the default setting for any field that you added in the previous step. Initial defaults are inherited from Jira.
- Optionally, select Create a test ticket to make sure it works as expected.
- At the top right, select Add.
You can add multiple Jira integrations to a workspace— just repeat the procedure with any needed adjustments. If there is more than one Jira integration, users can pick which one to use when they submit a ticket.
Updated 3 months ago