Set up a Jira Service Management integration

This integration is available for Jira Service Management Cloud, Jira Service Management Server, and Jira Service Management Data Center. The app is unintended for use with Audience-specific page types.

Looking for the Jira Software integration instead? See this documentation.

Before you begin

Downtime can result in your support team getting flooded by repetitive support tickets asking why your website or app is down. Our Jira Service Management (JSM) Integration helps you prevent these unnecessary support tickets by surfacing relevant status information in your service project.

General features of this integration:

  • When there's an active incident on your status page, a notice will surface on your JSM customer portal.

  • When there's an active maintenance on your status page, a notice will surface on your JSM customer portal.

  • If a component is degraded, a notice will surface on your customer portal.

  • If more than two of the above events are active at a given time, a generic notice will surface on your JSM customer portal.

  • No messages are displayed when everything is operational i.e, there are no incidents or maintenances to communicate.

Set up a Jira Service Management integration

  1. Log in to Jira Service Management.

  2. Select Apps from the top navigation.

  3. Select Manage your apps.

  4. Select Find new apps from the left side menu.

  5. Search for Statuspage and select the Statuspage for Jira Service Management app when it appears in your results.

  6. Get app then select Get it now to add it to your service project. A success flag appears when your app is added.

  7. Select Configure in the success flag that appears.

  8. Select which Jira Service Management project to configure with the Statuspage app from the dropdown menu.

  9. Enter the page ID and the API key for your status page.

    1. To find this information in Statuspage you must be a site admin. Go to Statuspage, select your avatar in the bottom left of the screen, and select API Info. Your API keys and Page IDs are listed there. If you’re not the side admin for Statuspage, you’ll be shown who to contact to obtain API key information.

  10. Select Add.

Setup complete! If you want to test to see if your app is configured correctly, you can create an incident in Statuspage. Then go into your web portal channel in JSM, where a message is displayed letting your customers know of an incident.

To update your Statuspage app’s configuration:

  1. In Jira Service Management, select Apps from the top navigation.

  2. Select Manage your apps.

  3. Select Statuspage for Jira Service Management under the User-installed app section to open the app’s options.

  4. Select Configure to update your app’s configuration. This is also where you can Uninstall the app.

To see where incident messages are displayed:

  1. In Jira Service Management, go to Projects and select the project you configured with the Statuspage app.

  2. Select Channels in the next side menu (or Ticket Channels depending on setup). One of the options to appear is Help Center.

  3. Select Open under Help Center, which brings you to the form an end-user fills out to create a ticket.

If there is an incident entered in Statuspage, the incident update message is displayed on that form. The form won’t show anything there if there’s no ongoing incident.

A Jira Service Management Help form that shows the incident message at the top of the form
Last modified on Nov 10, 2020
Cached at 8:27 AM on Nov 25, 2020 |

Additional Help

Ask the Community