# OpsGenie

{% hint style="info" %}
This plugin is part of Pro and Enterprise plan only
{% endhint %}

## Installation Guide

### Setup

#### Step 1: Generate an Opsgenie API Key (official docs [here](https://support.atlassian.com/opsgenie/docs/api-key-management/)).

1. Log in to your Opsgenie account and navigate to `Settings` → `API Key Management` (if you cannot find this option in your side bar under `App Settings` you probably do not enough the necessary permissions to create one).
2. Click the `Add New API Key` button.
3. Enter a description for the API Key, for instance, "Rely.io Integration."
4. Set the API key to have `Read` and `Configuration` access, as needed for the integration.
5. Click `Create Key` and make sure to copy and store the generated API Key securely.

#### Step 2: Configure Opsgenie in Rely.io

1. Open the Rely.io application and go to `Settings` → `Data Sources`.
2. Click on the `Add Data Source` button and select `Opsgenie`.
3. A form will appear asking for details to complete the integration.
   * **Collector Name**: Assign a name for the PagerDuty data collector.
   * **App Base URL:** Copy the base url of your Opsgenie account (e.g. <https://sunsy.app.opsgenie.com>)
   * **API Key**: Paste the API Key you generated in Step 1.

Click on `Create` to establish the integration. Your plugin should now be listed in the `Active` section of your `Data Sources`.

After you submit your form, an entity discovery run will be kickstarted that can take a few minutes. By the end of this discovery run:

* New blueprints will be added to your data model
* Entities will be queries from the data-source and added to your software catalog
* These entities will be periodically updated to ensure they remain in sync with their external counter-parts


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.rely.io/plugins-and-automation/plugin-installation-guides/opsgenie.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.