JIRA Integration Guide
JIRA is a project management tool that enables collaboration between teams within an organization. Integrate AlertOps’ alert management platform with JIRA to receive and respond to critical alerts through email, SMS, push notification, and phone alerts. AlertOps ensures that alerts received from JIRA always reach the correct, available team member by utilizing escalation policies and on-call schedules.
- From the main menu, click on Integrations and then select Inbound Integrations from the sub menu.
- Select API tab
- Select the 'ADD API INTEGRATION' button.
- You should now be on the API Integration Detail page. Select JIRA from the pre-built Integration Templates.
- Enter a name for the integration. Select an escalation rule to determine the integration's escalation policy. And, enter the names of recipient group(s) and recipient user(s). Click 'SAVE.' Then, click 'COPY URL' to copy the URL endpoint to be used in the JIRA configuration.
Step 1: Create a user for AlertOps within JIRA
You will need the AlertOps userid when you create the webhooks. After you have created the user, you can access the userid in the browser link for the user record:
Step 2: Ensure your user has administrator privileges
Step 3: Create a custom field for the AlertOps ID
Step 4: Create the Webhook to send Issues to AlertOps
You can customize the trigger of the webhooks within JIRA using JQL. To verify sending during creation and close, utilize the below queries:
Create Issue Webhook
JQL: Project = "[your project name]" AND "AlertOps ID" is EMPTY AND reporter != [your alertops id]
Close Issue Webhook
JQL: Project = "[your project name]" AND status = Closed AND reporter != [your alertops id]
Alert Triggering Information
AlertOps will automatically create an incident when a new alert is received from JIRA with an IncidentStatus status of “open.”
If an alert with status “open” matches an existing Open Alert, AlertOps will recognize the new alert as a duplicate and ignore the alert. The alert will be recorded in the Inbound Messages table as “Mapped Appended.”
AlertOps will automatically close the same incident when an alert with an IncidentStatus status “closed” is received.
Testing and Troubleshooting
Click here to read about Web API Testing and Troubleshooting.