Search results for "{{ search.query }}"

No results found for "{{search.query}}". 
View All Results

Status.io Integration

Status.io is a complete status platform that supplies status pages, incident tracking, subscriber notifications, etc. services. OpsGenie is an alert and notification management solution that is highly complementary to Status.io.

OpsGenie Status.io integration enables Status.io to create/close alerts in OpsGenie when an incident is created/resolved in Status.io and create/resolve incidents in Status.io when an alert is created/closed in OpsGenie.

What does OpsGenie have to offer for Status.io users?

By using OpsGenie Status.io Integration, you can forward Status.io alerts to OpsGenie and OpsGenie alerts to Status.io. OpsGenie can determine the right people to notify based on on-call schedules, using email, text messages (SMS), phone calls and iPhone & Android push notifications, and escalating alerts until the alert is acknowledged or closed.

Functionality of the integration

  • When an incident is created in Status.io, an alert is created in OpsGenie automatically through the integration.
  • When an incident is resolved in Status.io, the alert will be closed in OpsGenie automatically through the integration.
  • When an alert is created in OpsGenie, an incident is created in Status.io automatically through the integration.
  • When an incident is closed in OpsGenie, the incident will be resolved in Status.io automatically through the integration.

Add Status.io Integration in OpsGenie

  1. Please create an OpsGenie account if you haven't done already
  2. Go to OpsGenie Status.io Integration page,
  3. Specify who should be notified for Status.io alerts using the "Teams" field. Auto-complete suggestions will be provided as you type.
  4. If you would like to use create/resolve incidents in Status.io when an alert is created/closed in OpsGenie, select "Send Alerts To Status.io" option.
  5. Paste your Status.io Status Page Id to the "Status.io Status Page Id" field.
  6. Paste your Status.io API Id to the "Status.io API Id" field.
  7. Paste your Status.io API Key to the "Status.io API Key" field.
  8. You can find your Status Page Id, API Id and API Key information under API tab on the left menu by going there and clicking on "Display API Credentials" button in Status.io.
  9. Select which actions will be performed on Status.io side via "Alert Action" option. You can select create, close or both actions.
  10. Select an alert filter if you don't prefer forwarding all alerts to Status.io.
  11. Copy the Webhook URL by clicking on the copy button or selecting.
  12. Click on "Save Integration".

Configuration in Status.io

  1. In Status.io enable webhook notifications if you didn't.
  2. You can enable webhook notifications by selecting "Notifications" tab on the left menu in Status.io and then navigating to Webhook section and pressing "ON/OFF" button.
  3. In your status page click "SUBSCRIBE" button.
  4. Select "Webhook" tab from the menu on the top.
  5. Paste your Webhook URL into the first field.
  6. Type your email address to the second field.
  7. Click "Subscribe" button.

Setting Containers, Components, State and Status Information (Optional)

You can set some extra properties of the alert to inform Status.io which containers and components are affected by the incident. These extra properties can be added to the "Extra Properties" field of the alert. If you set "Containers" and "Components" extra properties, the incident will be created only for these containers and components on Status.io side. If no containers or components selected, the incident will be created for all containers and components.

Here is the list of the extra properties that can be set to change the information that will be 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.)

"Containers" and "Components" properties should be entered as Ids. To find the Ids of these containers and components follow the instructions below.

  1. In Status.io, select "Infrastructure" from the menu on the left.
  2. Click on the Modify button "(>)" of the first item in the "Components" list.
  3. Select "API" tab under the "Automatic Status Updates" section.
  4. You can find the Id of the component and the Id of the container that has the component under that tab.
  5. Repeat the instructions above for each component in the "Components" list that you would like to use.

You can also set "Current Status" and "Current State" extra properties to set the status and the state of the incident. If you don't set "Current Status" and "Current State" extra properties, the incident will be created by the default values of the "Current Status" and "Current State" which is 100. The "Current Status" and the "Current State" extra properties should be entered 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

Here is a sample screenshot from a valid alert that can be forwarded to Status.io:

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://opsgenie.status.io",
  "incident_url": "https://opsgenie.status.io/pages/incident/57c987f72d8d333607002c2d/57ca879d96a04686040000cc"
}

Sample Alert

Status.io Integration