Integrate with Status.io

1 Overview
- 1.1 What does the integration offer?
- 1.2 How does the integration work?
2 Set up the integration
- 2.1 Add Status.io integration
- 2.2 Configure the integration in Status.io

Overview

What does the integration offer?

Use the Status.io integration to forward Status.io alerts to Jira Service Management and Jira Service Management alerts to Status.io. Jira Service Management determines the right people to notify based on on-call schedules– notifies via email, text messages (SMS), phone calls, and iPhone & Android push notifications, and escalates alerts until the alert is acknowledged or closed.

How does the integration work?

When an incident is created in Status.io, an alert is created in Jira Service Management automatically through the integration.
When an incident is resolved in Status.io, the alert will automatically be closed in Jira Service Management through the integration.
When an alert is created in Jira Service Management, an incident is created in Status.io automatically through the integration.
When an incident is closed in Jira Service Management, the incident will be resolved in Status.io through integration.

Set up the integration

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

Add a Status.io integration in Jira Service Management
Map alert actions
Configure the integration in Status.io

Add Status.io integration

If you're using the Free or Standard plan in Jira Service Management, you can only add this integration from your team’s operations page. To access the feature through Settings (gear icon) > Products (under JIRA SETTINGS) > OPERATIONS, you need to be on Premium or Enterprise plan.

Adding an integration from your team’s operations page makes your team the owner of the integration. This means Jira Service Management only assigns the alerts received through this integration to your team.

To add a Status.io integration in Jira Service Management:

Go to your team’s operations page.
On the left navigation panel, select Integrations and then Add integration.
Run a search and select “Status.io”.
On the next screen, enter a name for the integration.
Optional: Select a team in Assignee team if you want a specific team to receive alerts from the integration.
Select Continue.
The integration is saved at this point.
Paste the Status.io Status Page ID into Status Page Id.
Paste the Status.io API ID into Status.io API Id.
Paste the Status.io API Key into Status.io API Key.
Find the Status Page ID, API ID, and API Key information under API tab on the left menu by navigating there and selecting "Display API Credentials" in Status.io.
Select which actions to perform on the Status.io side via the "Alert Action" option.
Select create, close, or both actions.
Select an alert filter to specify which alerts to forward to Status.io.
Expand the Steps to configure the integration section and copy the Webhook URL.
You will use this URL while configuring the integration in Status.io later.
To create/resolve incidents in Status.io when an alert is created/closed in Jira Service Management, select the Send Alerts To Status.io option.
Select Turn on integration.
The rules you create for the integration will work only if you turn on the integration.

Configure the integration in Status.io

In Status.io, enable webhook notifications if not already enabled.
Open the "Notifications" tab on the left menu, navigate to the Webhook section, and select ON/OFF.
On the Status page, select SUBSCRIBE.
Open the "Webhook" tab from the menu at the top.
Paste the URL you copied while adding the integration in Jira Service Management into the first field.
Enter an email address in the second field.
Select Subscribe.

This step is optional.

Set extra properties of the alert to inform Status.io which containers and components are affected by the incident. These extra properties are added to the "Extra Properties" field of the alert. If "Containers" and "Components" are set as extra properties, an incident is created only for these containers and components on the Status.io side. If no containers or components are selected, the incident is created for all containers and components.

Here is a list of the extra properties that can be set to change the information that is sent to Status.io:

Containers (containers that are affected by the incident)
Components (components that are affected by the incident)
Current Status (current status of the incident)
Current State (current state of the incident)

Enter the "Containers" and "Components" properties as IDs. To find the Ids of these containers and components, complete the following steps:

In Status.io, select Infrastructure from the left menu.
Select the Modify button "(>)" of the first item in the Components list.
Select the API tab under the Automatic Status Updates section.
Find the ID of the component and the ID of the container that has the component under that tab.
Repeat the instructions above for each component in the "Components" list to use.

Set the "Current Status" and "Current State" extra properties to set the status and the state of the incident. If "Current Status" and "Current State" extra properties are not set, the incident is created by the default values of the "Current Status" and "Current State", which is 100. Enter the "Current Status" and the "Current State" extra properties as Status Codes.

Incident Status Codes

100 - Operational
300 - Degraded Performance
400 - Partial Service Disruption
500 - Service Disruption
600 - Security Event

Incident State Codes

100 - Investigating
200 - Identified
300 - Monitoring

Sample payload sent from Status.io

{
  "id": "57ca879d96a04686040000cc",
  "datetime": "2016-09-03T08:19:41.459Z",
  "current_status": "Degraded Performance",
  "current_state": "Investigating",
  "previous_status": "Security Issue",
  "previous_state": "Monitoring",
  "components": [
    {
      "name": "WebSite2",
      "_id": "57ca82dca530225c6d000085"
    },
    {
      "name": "Website",
      "_id": "57c987f72d8d333607002c3d"
    }
  ],
  "containers":[
    {
      "name": "Container1",
      "_id": "57ca82d0db69d71f40000083"
    },
    {
      "name": "Primary Data Center",
      "_id": "57c987f72d8d333607002c3c"
    }
  ],
  "details": "Details",
  "status_page_url": " https://jsm.status.io",
  "incident_url": "https://jsm.status.io/pages/incident/57c987f72d8d333607002c2d/57ca879d96a04686040000cc"
}

Operations Help