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.

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. A subscription to Opsgenie Standard or Enterprise is required.

1. Create API Key
   1. Go to your Opsgenie account (https://<your_instance_name>.app.opsgenie.com/settings/integration/) and select Settings → Integrations.
   2. Select Add Integration → API and complete all required fields.
   3. Verify that Restrict Configuration Access is unchecked.
   4. Ensure that other access permissions are enabled.
      1. Note: The Suppress Notification permission is not required.
   5. Ensure that all Access Rights permissions are enabled (Read, Create/Update, Delete, Configuration Access) - Click on Edit to verify and set those permissions.
   6. Copy the generated Opsgenie API key and save the new integration.
2. Enable the integration in Blameless
   1. In Blameless, select Settings → Integrations → Alerting and, in the Opsgenie row, select Manage.
   2. In the Enable Opsgenie field, enable the slider.
   3. In the Opsgenie Instance URL field, enter the full URL of your Opsgenie instance (e.g. https://<your_instance_name>.app.opsgenie.com/).
   4. In the Opsgenie API Key field, paste the API key.
   5. Select Save.

Configuration for Incident Types​

Auto-Trigger Incidents​

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

1. In Blameless, select Settings → Incident Workflows → Incident Types, then select an incident type.
2. In the Opsgenie Auto-Trigger Incidents field, enable the slider.
3. 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 that your type matches the 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.

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

After confirming the URL with Blameless support, review Integrate Opsgenie with Webhook for detailed instructions.

Related Topics

• How to manually trigger an Opsgenie alert in Slack.
• How to manually trigger an Opsgenie alert in Microsoft Teams.