# Azure DevOps Integration

Connecting [Azure DevOps](https://azure.microsoft.com/en-gb/products/devops) to ilert helps your team turn critical DevOps signals into actionable alerts. With service hooks, you can trigger ilert alerts from events like work item changes, code pushes, builds, and releases – reducing MTTA by notifying the right on-call responders instantly. 

## In ilert: Create a Azure DevOps alert source 

1. Go to **Alert sources** -> **Alert sources** and click **Create new alert source**.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FjX0cS4q7woTXKajZmc1W%2FScreenshot%202023-08-28%20at%2010.21.10.png?alt=media&#x26;token=8ef3666b-84eb-4b51-abee-f07303313941" alt=""><figcaption></figcaption></figure>
2. Search for **Azure DevOps** in the search field, click the Azure DevOps tile, and then **Next**.&#x20;

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FlXzQlJpaTFSR49AZk0xA%2FScreenshot%202023-08-28%20at%2010.24.23.png?alt=media&#x26;token=cffeacb4-57b9-47d4-827d-b0f6b1afd914" alt=""><figcaption></figcaption></figure>
3. Give your alert source a name, optionally assign teams, and click **Next**.
4. Select an **escalation policy** by creating a new one or assigning an existing one.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FNnuZqONaIhbOf6fn4OkZ%2FScreenshot%202023-08-28%20at%2011.37.47.png?alt=media&#x26;token=8a74f7b5-5bd2-4eea-97fa-1c1dbb041333" alt=""><figcaption></figcaption></figure>
5. Select your [Alert grouping](https://docs.ilert.com/alerting/configure-alerting/alert-sources#alert-grouping) preference and click **Continue setup**. You may click **Do not group alerts** for now and change it later.&#x20;

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FueugN4JgHn1c90ggFA6u%2FScreenshot%202023-08-28%20at%2011.38.24.png?alt=media&#x26;token=b8009daf-3ca8-4264-a6fa-e42ef7333205" alt=""><figcaption></figcaption></figure>
6. The next page shows additional settings, such as customer alert templates or notification priority. Click **Finish setup** for now.
7. On the final page, an API key and/or webhook URL will be generated. You will need it later.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fgo8oPq8oHpa9eTvRo42f%2Fil-1.png?alt=media&#x26;token=d3dda157-74cc-4275-aa0a-4cdf9ace74be" alt=""><figcaption></figcaption></figure>

## In Azure DevOps: Create a Service Hook

1. In your Azure DevOps project, open **Project settings**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FyTN89Ah7juAc4TosQrPk%2F1.png?alt=media&#x26;token=97255f6b-8eb8-4a29-a3c3-e309094cd305" alt=""><figcaption></figcaption></figure>

2. In the sidebar, select **Service hooks** and click **Create subscription**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FQeMrJUNT2tMEp0pQFZKN%2F2.png?alt=media&#x26;token=701efe40-b52f-4df0-95fb-0a253de7f5ee" alt=""><figcaption></figcaption></figure>

3. Choose **Web Hooks** and click **Next**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FoXlIAvDUlTIqEmRhyoVS%2F3.png?alt=media&#x26;token=2b7d6d9e-2a27-466b-bc95-e35a10a81417" alt=""><figcaption></figcaption></figure>

4. Select the **Trigger** (for example, *Work item updated*, *Build completed*, *Code pushed*) and configure **Filters** to reduce noise.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FuyMI7L35jnk17F1F9y6d%2F4.png?alt=media&#x26;token=64681696-26dd-4df3-b319-d84be478ad3b" alt=""><figcaption></figcaption></figure>

5. In **URL**, paste the ilert **Integration URL** you created earlier.
6. Click **Finish** to save the subscription.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FdwrkWaWdu0nZA18z8Qxo%2F5.png?alt=media&#x26;token=8ded22ad-688d-4e8a-b9e8-f578ba813abf" alt=""><figcaption></figcaption></figure>

## FAQ <a href="#faq" id="faq"></a>

**Will alerts in ilert be resolved automatically?**

Yes, as soon as Azure DevOps sends a notification with the type "succeeded", corresponding alerts in ilert will be resolved automatically.