# 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