Receiving Opsgenie Alerts

Here's how to set up a webhook to receive Opsgenie alerts.

Once configured, you can:

  • route Opsgenie alerts to Transposit and Slack
  • create activities and run runbooks tied to Opsgenie alerts
  • trigger runbooks to run when Opsgenie alerts are received
  • trigger runbooks to run when the payload's content matches your conditions
  • trigger runbooks to run when an activity is created in response to Opsgenie alerts
  • invoke actions to remediate the underlying issues triggered by Opsgenie
  • set dynamic parameters using payloads provided by Opsgenie alerts

Follow the steps below to integrate Opsgenie alerts with Transposit.

1. Create Opsgenie Alert Webhooks in Transposit#

Go to Settings > Webhooks, and click Add webhook. Choose the Opsgenie alerts, as shown below.

Note: The optional Slack channel must already exist, create it before adding the webhook.

Click Add and then find the webhook you just added in the list. Click Click to copy to copy the URL to the clipboard or manually copy the endpoint URL.

2. Define Webhooks in Opsgenie#

In Opsgenie, navigate to Integrations list, as shown below.

Opsgenie settings left nav menu

Find “Webhook” in the list and click Add.

Integration list searching for "webhook"

In the Webhooks Settings page:

  • Set Assigned to Team to a team. You could consider setting up a “test-team” so that your initial test alerts do not get routed to where your real alerts are received.
  • Delete unnecessary actions under Opsgenie to Webhook. For example, to limit the alerts you will receive in Transposit, you could only have “if alert is created” selected. Alternatively, you could have your own custom actions on Opsgenie to invoke a Transposit webhook.
  • Paste the endpoint URL copied from Transposit above in the Webhook URL field.
  • Click Save Integration.

Webhook integration page

To test, navigate to Alerts in the left navigation. Click Create Alert on the top right corner of the page. Set Responders to the same team as above, and click Create.

3. Handle Opsgenie Alerts in Transposit#

All incoming Opsgenie alerts will always appear in the Activity Feed, as shown below.

In the optionally set Slack channel, the Opsgenie alerts will appear, too, as shown below.

When an alert is received, click Create activity to start creating a new activity, adding runbooks, and following the progress of work done by your team in response to Opsgenie alerts.

4. Troubleshooting#

If an Opsgenie API key has not been registered in Transposit, you will receive an error message or the alert will fail silently.

Go to Settings > Integrations, and click Add integration. Search for Opsgenie and add it, as shown below.

When you click Connect, either next to Team Authorization or User Authortization, a dialog appears that provides the instructions you need for creating an API key in Opsgenie and how to add the API key into the dialog, as shown below.