OpsGenie - OpenSRE Documentation

Overview

OpenSRE queries OpsGenie for active alerts and alert details so investigations can correlate on-call incidents with infrastructure events. There is no opensre integrations setup opsgenie handler today. Configure OpsGenie with the onboarding wizard, environment variables, or the integration store, then verify with opensre integrations verify opsgenie.

Prerequisites

OpsGenie account (Atlassian or standalone)
API key with read access

Setup

Option 1: Onboarding wizard

opensre onboard

Select OpsGenie when prompted and provide your API key (and region if needed).

Option 2: Environment variables

OPSGENIE_API_KEY=your-api-key
OPSGENIE_REGION=us   # or "eu" for EU accounts

Variable	Default	Description
`OPSGENIE_API_KEY`	—	Required. OpsGenie API key
`OPSGENIE_REGION`	`us`	Region: `us` or `eu`

Option 3: Persistent store

{
  "version": 1,
  "integrations": [
    {
      "id": "opsgenie-prod",
      "service": "opsgenie",
      "status": "active",
      "credentials": {
        "api_key": "your-api-key",
        "region": "us"
      }
    }
  ]
}

Credentials

In OpsGenie, go to Settings → API key management
Click Add new API key
Name it opensre and enable Read access
Copy the key

EU accounts use a different endpoint. Set OPSGENIE_REGION=eu if your OpsGenie URL is app.eu.opsgenie.com.

Investigation tools

Tool	What it does
`opsgenie_alerts`	List and search active OpsGenie alerts
`opsgenie_alert_detail`	Fetch full detail for one alert by ID

Run opsgenie_alerts first to find an alert ID, then call opsgenie_alert_detail when you need deeper context.

Verify

opensre integrations verify opsgenie

Expected output:

Service: opsgenie
Status: passed
Detail: Connected to OpsGenie (US region); API key accepted.

Troubleshooting

Symptom	Fix
401 Unauthorized	Check the API key and confirm it has Read access
404 Not Found	Set `OPSGENIE_REGION=eu` if you use the EU instance
Rate limited	OpsGenie enforces per-minute limits — reduce query frequency
`opensre integrations setup opsgenie`	Not available — use `opensre onboard`, env vars, or the store

Security

Use a read-only API key — OpsGenie supports granular permission scopes.
Store the API key in .env or your secret manager — not in source control.

​Overview

​Prerequisites

​Setup

​Option 1: Onboarding wizard

​Option 2: Environment variables

​Option 3: Persistent store

​Credentials

​Investigation tools

​Verify

​Troubleshooting

​Security

Overview

Prerequisites

Setup

Option 1: Onboarding wizard

Option 2: Environment variables

Option 3: Persistent store

Credentials

Investigation tools

Verify

Troubleshooting

Security