Skip to main content
HealOps 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

Select OpsGenie when prompted and provide your API key.

Option 2: Environment variables

Add to your .env:

Option 3: Persistent store

Creating an API key

  1. In OpsGenie, go to Settings → API key management
  2. Click Add new API key
  3. Name it healops and enable Read access
  4. Copy the key
EU accounts use a different endpoint. Set OPSGENIE_REGION=eu if your OpsGenie URL is app.eu.opsgenie.com.

Verify

Expected output:

Troubleshooting

Security best practices

  • Use a read-only API key — OpsGenie supports granular permission scopes.
  • Store the API key in .env, not in source code.