4b6817381b
CI (OpenClaw E2E) / openclaw test (push) Has been cancelled
CI / coverage-report (push) Has been cancelled
CI / test-kubernetes (push) Has been cancelled
CI / should-run-thorough (push) Has been cancelled
CI / test-thorough (cloudwatch-demo) (push) Has been cancelled
CI / test-thorough (flink-ecs) (push) Has been cancelled
CI / test-thorough (upstream-lambda) (push) Has been cancelled
CI / test-thorough (prefect-ecs-fargate) (push) Has been cancelled
Release / build-binaries (zip, opensre.exe, onefile, windows-latest, windows-x64) (push) Has been cancelled
Benchmark image — build + push to ECR (any adapter) / build + push (push) Has been cancelled
CI / quality (ubuntu-latest) (push) Has been cancelled
CI / test (tools-runtime) (push) Has been cancelled
CI / test (e2e-general) (push) Has been cancelled
CI / test (cli-runtime) (push) Has been cancelled
CI / test (e2e-provider-and-openclaw) (push) Has been cancelled
CI / test (integrations-and-misc) (push) Has been cancelled
Release / verify (push) Has been cancelled
Release / build-python-dist (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, macos-15-intel, darwin-x64) (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, macos-latest, darwin-arm64) (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, ubuntu-22.04, linux-x64) (push) Has been cancelled
Release / publish-release (push) Has been cancelled
Release / publish-main-release (push) Has been cancelled
Interactive Shell Live (PR + post-merge) / turn-checks (no-LLM) (push) Has been cancelled
CodeQL / Analyze (python) (push) Has been cancelled
Interactive Shell Live (PR + post-merge) / turn-live shard ${{ matrix.shard_index }} (push) Has been cancelled
Release / prepare (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, ubuntu-22.04-arm, linux-arm64) (push) Has been cancelled
Synthetic Deterministic Tests / Synthetic offline (deterministic) (push) Has been cancelled
93 lines
2.0 KiB
Plaintext
93 lines
2.0 KiB
Plaintext
---
|
|
title: "OpsGenie"
|
|
description: "Connect OpsGenie so OpenSRE can read active alerts and incident context during investigations"
|
|
---
|
|
|
|
OpenSRE queries OpsGenie to retrieve active alerts and their details — correlating on-call incidents with infrastructure events and investigation findings.
|
|
|
|
## Prerequisites
|
|
|
|
- OpsGenie account (Atlassian or standalone)
|
|
- API key with read access
|
|
|
|
## Setup
|
|
|
|
### Option 1: Interactive CLI
|
|
|
|
```bash
|
|
opensre integrations setup
|
|
```
|
|
|
|
Select **OpsGenie** when prompted and provide your API key.
|
|
|
|
### Option 2: Environment variables
|
|
|
|
Add to your `.env`:
|
|
|
|
```bash
|
|
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
|
|
|
|
```json
|
|
{
|
|
"version": 1,
|
|
"integrations": [
|
|
{
|
|
"id": "opsgenie-prod",
|
|
"service": "opsgenie",
|
|
"status": "active",
|
|
"credentials": {
|
|
"api_key": "your-api-key",
|
|
"region": "us"
|
|
}
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
## Creating an API key
|
|
|
|
1. In OpsGenie, go to **Settings** → **API key management**
|
|
2. Click **Add new API key**
|
|
3. Name it `opensre` and enable **Read** access
|
|
4. Copy the key
|
|
|
|
<Info>
|
|
EU accounts use a different endpoint. Set `OPSGENIE_REGION=eu` if your OpsGenie URL is `app.eu.opsgenie.com`.
|
|
</Info>
|
|
|
|
## Verify
|
|
|
|
```bash
|
|
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 — ensure it has Read access |
|
|
| **404 Not Found** | Try setting `OPSGENIE_REGION=eu` if you're on the EU instance |
|
|
| **Rate limited** | OpsGenie enforces per-minute rate limits; reduce query frequency |
|
|
|
|
## Security best practices
|
|
|
|
- Use a **read-only API key** — OpsGenie supports granular permission scopes.
|
|
- Store the API key in `.env`, not in source code.
|