StatusDrift integrates with Opsgenie to route monitoring alerts through your incident management workflows. This guide explains how to configure the Opsgenie integration to create alerts when your services experience issues.
What This Integration Does
The Opsgenie integration creates alerts in your Opsgenie account when:
- A monitored service goes down or becomes degraded
- A service recovers and returns to normal status
- SSL certificates are approaching expiration
- Performance thresholds are exceeded
When services recover, StatusDrift automatically closes the corresponding Opsgenie alert.
Prerequisites
Before configuring the Opsgenie integration, ensure you have:
- A StatusDrift account with at least one monitor configured
- An Opsgenie account (Standard or Enterprise plan)
- Permission to create API integrations in Opsgenie
Step 1: Create an Opsgenie API Integration
First, create an API integration in Opsgenie to get your API key:
- Log in to your Opsgenie account
- Navigate to Settings then Integrations
- Click Add integration
- Search for and select API
- Give the integration a name (e.g., “StatusDrift”)
- Assign the integration to a team
- Click Save Integration
- Copy the API Key that is displayed
Step 2: Add the Opsgenie Channel in StatusDrift
Now configure the integration in your StatusDrift dashboard:
- Log in to your StatusDrift account at app.statusdrift.com
- Navigate to Notification Channels in the sidebar
- Click Add Channel
- Select Opsgenie from the integration type dropdown
- Enter a descriptive name for this channel
- Paste the API Key from Opsgenie
- Select your Opsgenie region (US or EU)
- Click Save to create the channel
Step 3: Assign to Monitors
Connect the notification channel to your monitors:
- Go to Monitors in the sidebar
- Select the monitor you want to receive Opsgenie alerts
- Scroll to the Notification Channels section
- Check the box next to your Opsgenie channel
- Save the monitor configuration
Testing the Integration
Verify your Opsgenie integration is working:
- Go to Notification Channels
- Find your Opsgenie channel in the list
- Click the Test button
- Check your Opsgenie account for the test alert
Remember to close the test alert in Opsgenie after verification.
Configuration Options
The Opsgenie integration supports these configuration options:
| Field | Required | Description |
|---|---|---|
| API Key | Yes | The API key from your Opsgenie integration |
| Region | Yes | Your Opsgenie instance region (US or EU) |
| Priority | No | Default alert priority (P1-P5) |
| Tags | No | Tags to add to alerts for filtering |
Troubleshooting
Alerts not being created
- Verify the API key is correct and has not been revoked
- Check that the correct region is selected (US or EU)
- Ensure the integration is enabled in Opsgenie
- Verify the notification channel is assigned to your monitors
Alerts not auto-closing
- Ensure StatusDrift has permission to close alerts via the API
- Check that the alert was not manually acknowledged or closed