Jira Server

Use xMatters to keep track of your important issues in Jira Server, and automatically notify the right people whenever an issue needs attention. This closed-loop integration lets you target xMatters users or groups from Jira issues and automatically assigns the issue to the user who acknowledges the event. Event information is added to the Comments tab in Jira, and you can use the Engage with xMatters feature to call in assistance from multiple users and groups and create ad-hoc conference bridges to get to a solution quickly, all from within Jira.

This integration is built specifically for your self-hosted Jira Server. If you're using Jira Cloud, you'll want to use this integration.

How to set up a Jira configuration

Give your configuration a name and description to help you differentiate it from any other Jira Server configurations. Add a name for the integration to use when sending alerts (so you can easily tell which configuration or integration the alerts are from).

Enter your Jira Server endpoint URL (for example, https://acmeco.com/Jira). This URL needs to be accessible from the cloud. If it isn't, you can convert to this configuration to a communication plan and use an xMatters Agent.

Enter your Jira Server username and password. We recommend that you create a user in Jira specific to xMatters.

Set whether you want to update the Comments tab for the Jira issue with updates when the event is created or updated and notifications are delivered to users devices.

Finally, add the default recipients for this configuration. These recipients are targeted if xMatters can't match the assignee in Jira with an xMatters user. See How issue assignment works for details.

Once you save the configuration, xMatters displays the URLs you need to complete the setup in Jira:

You can now install and configure the xMatters add-on in Jira Server.

How to use your integration

To use the integration, create a new issue or incident in Jira that matches the rules contained within the webhooks. Jira builds a payload and sends it to xMatters. xMatters automatically sends a notification to the recipients you defined in the configuration settings.

A note about comments...

By default, all event changes (event creation, status updates, device delivery updates) are posted to the Comments tab in Jira, and are viewable by all users. You can use the configuration page in xMatters to turn on/off comments. (If you want more granular control of what gets posted, you can also convert your integration to a communication plan and enable/disable the outbound integrations).

Check out the screenshots at the top of this page to see what the notifications would look like in the xMatters mobile app.

Extending your integration

Looking to do more with xMatters and Jira Server? Check out our guide on how to extend your integration for information on issue assignment, troubleshooting tips, using the integration with an xMatters Agent, and converting your integration to a communication plan.