# Opsgenie

## About the integration 

Opsgenie is an on-call and alert management tool. Integrating Opsgenie with Sleuth is simple using an API token.

## Setting up the integration

To add the Sleuth Opsgenie integration:

* Click **Integrations** in the sidebar.
* Click the *Incidents* tab, then **add** in the *Opsgenie* card.
* Enter your API token. Ensure the token has `Read` and `Configuration Access` scopes
* If your Opsgenie instance is in Europe, enable *My Opsgenie servers are in the EU* checkbox. Leave this unchecked if you are unsure.
* Press **Save**.

## Configuring the integration

* Click **Add incident source** and select a Sleuth project that will track Opsgenie incidents. All projects within your organization will be displayed in the dropdown.

![](https://2832637360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1bR_-Od0islbiOl4G0%2Fuploads%2F9gS1JEv2e5IkZfBK10aA%2FScreenshot%202022-01-13%20at%2009.31.29.png?alt=media\&token=7555ccb4-a4df-4910-b426-fc3906cc43f8)

* Configure impact source first by marking if Sleuth should track Opsgenie alerts or incidents.
* If impact source will be tracking incidents  (did not enable the option to track alerts), you can filter incidents by affected service.
* Configure minimum priority threshold. Any alert or incident that will have equal or higher priority will be considered a failure in Sleuth.
* Under advanced settings, you can control the historic data population. If checked Sleuth will populate all incidents that happened in the last 30 days and recalculate the project's Failure Rate and MTTR metrics.

{% hint style="info" %}
Integrations are made at the Sleuth organization level and are available for all projects within that organization. Individual settings for integration are made at the project level.
{% endhint %}

* That's it! Sleuth will now start tracking incidents or alerts affecting the selected service declared in Opsgenie.