Skip to main content

Opsgenie

Getting Started

The Blameless platform offers an integration with Opsgenie that allows you to:

  • Auto-trigger an Opsgenie alert for selected Opsgenie services with the creation of a Blameless incident by the team that owns the services.
  • Manually trigger Opsgenie alerts on-demand within an incident channel in Slack or Microsoft Teams
note

Triggering an alert manually in a Blameless incident channel in Slack or Microsoft Teams will only work with either Pagerduty or Opsgenie. Only one alert management system can be enabled at a time. You need to disable the integration with Pagerduty to be able to enable the integration with Opsgenie and allow incident responders to trigger alerts to Opsgenie from Slack or Microsoft Teams.

Credentials

First you will need to generate an API key in your Opsgenie account and enable the Opsgenie integration in Blameless using this API key.

note

The Opsgenie Standard or Enterprise subscription is required.

  1. Go to your Opsgenie account under Settings then Integrations. (https://<your_instance_name>.app.opsgenie.com/settings/integration/) to generate a new API key.
  2. Select the "Add Integration" option and then select "API".
  3. Complete the required fields.
  4. Verify the "Restrict Configuration Access" is unchecked.
  5. Make sure the other access permissions are enabled. The “suppress notification” permission is not required.
  6. Copy the generated Opsgenie API key and save the new integration.
  7. Go to the integration settings for Opsgenie in your Blameless account
  8. Paste the Opsgenie API Key
  9. If your Opsgenie account is hosted in Europe you must enter this URL: https://api.eu.opsgenie.com, otherwise enter https://api.opsgenie.com.
  10. Toggle the "Enable Opsgenie" slider to enable the integration.
  11. Click the "Save" button.
Opsgenie Settings

Configuration for Incident Types

Auto-Trigger Incidents

Blameless, upon initiating an incident, can automatically trigger an alert within Opsgenie teams.

Opsgenie Auto-Trigger
  1. Select an Incident type
  2. Scroll down and locate the "Opsgenie auto-trigger incidents" setting
  3. Toggle the "Opsgenie auto-trigger incidents" switch to enable auto-triggering
  4. Click Save.

Webhook Configuration

Customers should contact Blameless support to get their unique URL for the Opsgenie Webhook.

You will need to append the following two values to the end of the Blameless-provided URL for your Opsgenie/Blameless Integration:

  • Incident Type
  • Severity

The incident type value is case sensitive so verify your type matches your incident type label in the Blameless incident type field.

The severity field will ignore the SEV portion of SEV 0 and pick up the numeric value 0 only.

For Example:

A severity 1 incident associated with the DEFAULT incident type within Blameless will look like this:

https://example.blameless.io/webhook/v1/123abc?incident_type=DEFAULT&incident_severity=1

note

Do not forget the appending ? between the URL and Incident / Severity elements when appending the string.

Once you have confirmed the URL from Blameless, refer to the following link for further instructions: https://docs.opsgenie.com/docs/webhook-integration

Webhook Configuration

Customers should contact their Blameless customer success manager to get their unique URL for the Opsgenie Webhook.

You will need to append the following two values to the end of the Blameless-provided URL for your Opsgenie/Blameless Integration:

  • Incident Type
  • Severity

The incident type value is case sensitive so verify your type matches your incident type label in the Blameless incident type field.

The severity field will ignore the SEV portion of SEV 0 and pick up the numeric value 0 only.

For Example:

A severity 1 incident associated with the DEFAULT incident type within Blameless will look like this:

https://example.blameless.io/webhook/v1/123abc?incident_type=DEFAULT&incident_severity=1

note

Do not forget the appending "?" between the URL and Incident / Severity elements when appending the string.

Once you have confirmed the URL from Blameless, refer to the following link for further instructions:

https://docs.opsgenie.com/docs/webhook-integration

Next steps:

  1. How to manually trigger an Opsgenie alert in Slack.
  2. How to manually trigger an Opsgenie alert in Microsoft Teams.
  3. How to configure Blameless to auto-trigger Opsgenie alerts at the start of an incident.