# Opsgenie

## OpsGenie + Multitudes Integration Benefits

* See [`Mean Time To Recovery`](/metrics-and-definitions/process-metrics/quality-of-work/mean-time-to-recovery.md) for OpsGenie incidents

## How it works

Incident-related events from OpsGenie (such as an incident being triggered, assigned, acknowledged, and resolved) will be sent to Multitudes. This data is then processed by our data pipelines and shown in the Multitudes app.

## Requirements

In order to install this integration, you must have both:

* Owner or Manager level [permissions](/configuration-and-setup/permissions-and-roles.md) on Multitudes, and
* Account owner or Global Admin access to generate the API key in OpsGenie 

## How to install

* In the Multitudes app, go to [Settings > Integrations](https://app.multitudes.co/teamSettings/integrations) and click on the connect Opsgenie card. This should direct you to your Opsgenie instance (otherwise click [here](https://app.opsgenie.com/alert/list))
* On Opsgenie navigate to settings > API key management > add a new API key

  <figure><img src="https://cdn.prod.website-files.com/610c8a14b4df1ae46b1a13a3/6406b307a039e57dd4334233_OpsGenie.png" alt=""><figcaption></figcaption></figure>
* Once you click add a new API key, you should get a pop-up. Proceed to do 3 things in the pop-up

<figure><img src="https://cdn.prod.website-files.com/610c8a14b4df1ae46b1a13a3/6406b3073e750f7044e6d14e_image%20(1).png" alt=""><figcaption></figcaption></figure>

1. Select both the "Read" and “Configuration access” access scopes
2. Copy the key - we also recommend you store this API access key in a secure location
3. Click  "Add API Key" to finalize

* Back on Multitudes, paste the previously-copied API key into the text field and click save
* You will be prompted to link Opsgenie users with Multitudes users. This will determine whose Opsgenie data we know to show in Multitudes, so it's important to complete this step. [Learn more about user linking](/configuration-and-setup/user-linking.md).
* All done! Multitudes will now start to track your incidents and calculate `Mean Time to Restore`

{% hint style="warning" %}
Multitudes tracks MTTR by looking at your Opsgenie `incidents`. It does **not** look at Opsgenie `alerts`. The Opsgenie `incidents` feature is only available to paying Opsgenie customers.
{% endhint %}


---

# 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.multitudes.com/integrations/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.