Opsgenie

Opsgenie is a modern incident management platform. It provides, on-call schedule management, escalations and incident tracking.

Oh Dear will automatically open and close alerts at Opsgenie when we detect problems. Opsgenie will then notify the right people that are on-call through email, SMS, phone calls and iOS & Android push notifications.

Setting up Opsgenie

To set up the integration, you'll need to create an API key in Opsgenie. You can do this by going to:

1. Teams
2. Select your team from the list
3. Head over to "Integrations"
4. Click "Add integration"
5. Choose "API" from the bottom list of "All Integrations"

API key note: there are 2 kinds of API keys available in Opsgenie, there are also API keys under Settings > API key management. These are different API keys and do not allow for notications. We need the API keys as configured under the Teams menu item.

Configuring Oh Dear

Once you have your API key, you can configure the integration in Oh Dear. Go to the teams notifications page, and click the "Add configuration" button. Select "Opsgenie" from the list of options, and specify the API key you created earlier at Opsgenie.

If your Opsgenie account is hosted on the EU region, don't forget to toggle on "Use EU endpoint".

With this set up, we will create and close alerts at Opsgenie for the events you choose for all your sites.

To test out the integration, you can click open the dropdown next to the configuration, and choose "Send test notification". If everything is set up correctly, you should see a test alert appear in Opsgenie.

Site specific alerts

If you only want to create Opsgenie alerts for a specific site, head over to the site notification settings page and click the "Add configuration" button. Select "Opsgenie" from the list of options, and specify the API key you created earlier at Opsgenie.

To test out the integration, you can click open the dropdown next to the configuration, and choose "Send test notification". If everything is set up correctly, you should see a test alert appear in Opsgenie.