• Products
  • Get started
  • Documentation
  • Resources

Integrate Opsgenie with Statuspage

What does Opsgenie offer Statuspage users?

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

  1. Statuspage sends webhook notifications on incident updates. With Atlassian Statuspage Integration, every new incident creates an alert in Opsgenie, and every update of the incident gets added as a Note to the existing alert. Opsgenie 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. Opsgenie creates an incident in Atlassian Statuspage if an Opsgenie action is mapped to a create an incident or create incident and update the components'/incident's statuses according to tags Atlassian Statuspage action.

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

Functionality of the integration

  • When an incident is created in Atlassian Statuspage, an alert will be created automatically in Opsgenie.

  • When an incident is closed in Atlassian Statuspage, the related alert will be closed automatically in Opsgenie.

Action Mapping:

  • If Send Alert Updates Back to Atlassian Statuspage is enabled, actions for Atlassian Statuspage are executed in Atlassian Statuspage when the chosen action is executed in Opsgenie.

  • If Create Atlassian Statuspage Incidents for Opsgenie Alerts is enabled, actions for Atlassian Statuspage will be executed when the chosen action is executed in Opsgenie for alerts which have a source other than the Atlassian Statuspage integration.

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

  • The statuses of the components given in the tags will be changed to Operational, when applicable if a resolve incident and update components' statuses according to tags Atlassian Statuspage action is mapped to an Opsgenie action.

These action mapping features are explained in detail in the Action Mapping Feature section below.

Adding Statuspage integration in Opsgenie

You can add this integration from your team dashboard

If you're using Opsgenie's Free or Essentials plan, or if you’re using Opsgenie with Jira Service Management's Standard plan, you can only add this integration from your team dashboard as the Integrations page under Settings is not available in your plan.

Adding the integration from your team dashboard will make your team the owner of the integration. This means Opsgenie will assign the alerts received through this integration to your team only.

To do that,

  1. Go to your team’s dashboard from Teams,

  2. Select Integrations, and select Add integration.

Follow the rest of the steps to complete the integration.

  1. Go to Settings > Integrations. Search for Statuspage and select Add.

  2. Specify who is notified of Statuspage alerts using the Responders field. Auto-complete suggestions are provided as you type.

  3. Copy the URL.

  4. Select Save Integration.

Configuration in Statuspage

  1. Click Subscribers in the left sidebar of Statuspage.
    a. If using an audience-specific page, click Audience.

  2. Click the Options dropdown menu.
    b. If using an audience-specific page, click the Subscriber settings tab.

  3. Click Settings from the dropdown menu.

  4. Select the checkbox for Webhook listed under delivery types.

  5. Click Save changes.

  6. Go to the status page and click Subscribe to updates.

  7. Click the webhook tab from the subscription dropdown.

  8. Paste the URL copied from Opsgenie to the URL field.

  9. Click Subscribe to notifications.

An image that shows where to subscribe to notifications from Statuspage.

 

Opsgenie-to-Statuspage integration

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

  2. Click API info from the menu.

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

  4. Navigate back to Opsgenie and the Statuspage integration page (Teams > Relevant Team > Integrations > Statuspage).

  5. Check Send Alert Updates Back to Statuspage and/or Create Statuspage Incidents for Opsgenie Alerts

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

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

  8. Control which type of alerts are sent to Statuspage by using the Alert Filter.

  9. Save the integration.

Opsgenie attempts to verify the settings with Statuspage upon save.

Action Mapping Feature

Opsgenie allows customers to define action mappings between Opsgenie actions and Atlassian StatusPage actions.

For alerts created by Atlassian Statuspage

  • Use this section to map Opsgenie actions to Atlassian Statuspage actions when the source of the alert is Atlassian StatusPage (i.e When the alert is created by Atlassian StatusPage integration.)

  • Map different Opsgenie actions to different Atlassian Statuspage actions. For example, update the Atlassian Statuspage incident when a note is added to the Opsgenie alert. In order to do this, define If a note is added to the alert in Opsgenie, add note to the incident to the incident in Atlassian Statuspage mapping in Send Alert Updates Back to Atlassian Statuspage section.

For other Opsgenie alerts

  • Use this section to map Opsgenie actions to Atlassian Statuspage actions when the source of the alert is NOT Atlassian Statuspage (i.e When the alert is created by another integration.)

  • For this purpose, use Create Atlassian Statuspage Incidents for Opsgenie Alerts section. In order to use this functionality, map one Opsgenie action to create an incident or create an incident and update the components'/incident's statuses according to tags Atlassian Statuspage action. The Opsgenie action doesn't have to be alert is created, it can be other actions as well.

An image showing alert rules for Statuspage
  • a tag is added to the alert and a custom action is executed on alert actions differ from other actions. When one of these actions is selected, an extra field appears to enter which tags or for which custom action this mapping works.

  • Enter multiple tags by separating with a comma. If multiple tags are entered, the mapping works if the alert has one or more of the specified tags. Leave the tags field empty for the mapping to work for any tag.

  • Specify the name of the custom action for custom mappings. It cannot be left empty.

  • For mapping an Opsgenie action to multiple Statuspage actions, an error occurs except for the a tag is added to the alert and a custom action is executed on alert actions. Save multiple mappings for these actions because they will differ by the given tags and the given custom action names.

An image showing multiple mappings for Statuspage integration.

Changing Component/Incident Statuses via Alert Tags (Optional)

  • Change the statuses of the components/incident in Statuspage by adding some specially formatted tags to the alert.

  • These tags are added at the creation of the alert or can be added after creating the alert. If an Opsgenie action is mapped to create an incident and update the components'/incident's statuses according to tags Statuspage action, when an alert with specially formatted tags is created in Opsgenie, an incident will be created in Statuspage and the statuses of the components and the incident will be changed according to the specially formatted tags. Or if a tag is added to the alert Opsgenie action is mapped to an update the components'/incident's statuses according to added tags Statuspage action, when a specially formatted tag is added to the alert in Opsgenie, the statuses of the components/incident will be changed according to the added tags.

An image showing rules for changing components.
  • Format the tags as cmp_[component name]:[status] where [component name] is the name of the component to have a status change and [status] is one of the allowed statuses for the component. These allowed statuses are listed below, under the Allowed Component Statuses header.

  • Change the statuses of multiple components by adding a separate status tag for each component. Please check the examples below.

  • The statuses of the components given in tags are changed to Operational in Atlassian Statuspage if an Opsgenie action is mapped to a resolve the incident and update the components' statuses according to tags Atlassian Statuspage action.

Allowed Component Statuses

  • operational

  • degraded_performance

  • partial_outage

  • major_outage

Allowed Incident Statuses

  • investigating

  • identified

  • monitoring

  • resolved

Examples

  • cmp_API:degraded_performance

  • cmp_Database Server:partial_outage

  • cmp_Management Portal:operational

  • inc:monitoring

  • inc:identified

Sample payload sent from Statuspage

JSON

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 { "meta": { "unsubscribe": "https://opsgenietest.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" } ] } }



Additional Help