Page Comparison

...

Overview

What does the integration offer?

Statuspage lets service providers add a component for each separate infrastructure or functional part of their service. Jira Service Management has a powerful two-way integration with Statuspage. The integration is used as follows:

1. Statuspage sends webhook notifications on incident updates. With Statuspage Integration, every new incident creates an alert in Jira Service Management, and every update of the incident gets added as a Note to the existing alert. Jira Service Management acts as a dispatcher for these alerts, determines the right people to notify based on on-call schedules– notifying them using email, text messages (SMS), phone calls, and iOS & Android push notifications, and escalates alerts until the alert is acknowledged or closed.

2. Jira Service Management creates an incident in Statuspage if a Jira Service Management action is mapped to a create an incident or create incident and update the components'/incident's statuses according to tags Statuspage action.

3. Jira Service Management resolves incidents in Statuspage if a Jira Service Management action is mapped to a resolve the incident or resolve the incident and update the components' statuses according to tags Statuspage action. Jira Service Management updates the incident in Statuspage if a Jira Service Management action is mapped to an add note to the incident Statuspage action.

How does the integration work?

• When an incident is created in Statuspage, an alert will be created automatically in Jira Service Management.

• When an incident is closed in Statuspage, the related alert will be closed automatically in Jira Service Management.

Set up the integration

Statuspage is a bidirectional integration. Setting it up involves the following steps:

• Add a Statuspage integration in Jira Service Management

• Map alert actions

• Configure the integration in Statuspage

Add Statuspage integration

To add a Statuspage integration in Jira Service Management:

1. Go to your team’s operations page.

2. On the left navigation panel, select Integrations and then Add integration.

3. Run a search and select “Statuspage”.

4. On the next screen, enter aname for the integration.

5. Optional: Select a team in Assignee team if you want a specific team to receive alerts from the integration.

6. Select Continue.
   The integration is saved at this point.

7. Expand the Steps to configure the integration section and copy the URL.
   You will use this URL while configuring the integration in Statuspage later.

8. Select Turn on integration.
   The rules you create for the integration will work only if you turn on the integration.

Configure the integration in Statuspage

1. In the Subscribers interface, select Options > Settings.

2. On the Subscriber Notification Settings modal, select “Webhook” for Delivery types.

3. Select Save Changes.

4. Go to your status page and select Subscribe To Updates.

5. Select webhook tab from the subscription dropdown.

6. Paste the URL you copied while adding the integration in Jira Service Management into URL.

7. Enter your email address to receive emails when the API endpoint fails.

8. Select Subscribe To Notifications.

Configure the integration to update Statuspage

1. Select your avatar in the bottom left of your Statuspage screen.

2. Select API info from the menu.

3. Copy the page ID for the page you want the integration to work for.

4. Navigate back to Jira Service Management and go to the Statuspage integration page.

5. Select Send Alert Updates Back to Statuspage or Create Statuspage Incidents for Jira Service Management Alerts checkbox as needed.

6. Paste the page ID into Statuspage Page Id field.

7. In Statuspage, copy the API key and paste it into the Statuspage API Key field.

8. Control what type of alerts is sent to Statuspage by using the Alert Filter.

9. Save the integration.

Jira Service Management attempts to verify the settings with Statuspage upon saving.

Map alert actions

Jira Service Management allows you to define action mappings between Jira Service Management actions and StatusPage actions.

• If Send alert updates back to Statuspage is selected, actions for Statuspage are run in Statuspage when the chosen action is run in Jira Service Management.

• If Create Statuspage Incidents for Jira Service Management alerts is selected, actions for Statuspage are run when the chosen action is run in Jira Service Management for alerts with a source other than the Statuspage integration.

• When a specially formatted tag is added to the alert, the statuses of the components/incident in Statuspage are changed to the given status, if an update components'/incident's statuses according to added tags Statuspage action is mapped to a tag is added to the alert Jira Service Management action.

• The statuses of the components given in the tags are changed to Operational when applicable if a resolve incident and update components' statuses according to tags Statuspage action is mapped to a Jira Service Management action.

Sample payload sent from Statuspage

{
  "meta":
  {
    "unsubscribe": "https://jsmtest.statuspage.io/?unsubscribe=8rx45n6txwh3",
    "documentation": "http://doers.statuspage.io/customer-notifications/webhooks/"
  },
  "page":
  {
    "id": "1k9dvd5q1qlv",
    "status_indicator": "none",
    "status_description": "All Systems Operational"
  },
  "incident":
  {
    "name": "incident1",
    "status": "investigating",
    "created_at": "2015-10-08T13:13:53.303Z",
    "updated_at": "2015-10-08T13:13:53.558Z",
    "monitoring_at": null,
    "resolved_at": null,
    "impact": "none",
    "shortlink": "http://stspg.io/1Z1G",
    "postmortem_ignored": false,
    "postmortem_body": null,
    "postmortem_body_last_updated_at": null,
    "postmortem_published_at": null,
    "postmortem_notified_subscribers": false,
    "postmortem_notified_twitter": false,
    "backfilled": false,
    "scheduled_for": null,
    "scheduled_until": null,
    "scheduled_remind_prior": false,
    "scheduled_reminded_at": null,
    "impact_override": null,
    "scheduled_auto_in_progress": false,
    "scheduled_auto_completed": false,
    "id": "hk801ps7x9x4",
    "page_id": "1k9dvd5q1qlv",
    "incident_updates":
    [
      {
        "status": "investigating",
        "body": "this is a test incident",
        "created_at": "2015-10-08T13:13:53.556Z",
        "wants_twitter_update": false,
        "twitter_updated_at": null,
        "updated_at": "2015-10-08T13:13:53.556Z",
        "display_at": "2015-10-08T13:13:53.556Z",
        "id": "7m0y35xlqh8j",
        "incident_id": "hk801ps7x9x4"
      }
    ]
  }
}

...

See also

Explore integration types

Explore integration actions

Add integration rules