# Azure DevOps deployment pipeline

The [Azure DevOps](https://azure.microsoft.com/en-gb/products/devops) deployment integration enables you to forward release and pipeline deployment events to ilert, creating a richer incident timeline that reflects code pushes, releases, and environment changes. Deployment pipelines organize your Azure DevOps events and connect them to alert sources – offering clear context that accelerates root cause analysis and supports change accountability.

## Setting up

### Creating your deployment pipeline in ilert

In any way, a pipeline is required, which will also generate a new `integrationKey` required to route deployment events when they occur. Head to your ilert account and navigate to **Alert sources -> Deployment events.**

<figure><img src="/files/hVN7pLmMiQbUSidJ8ekk" alt=""><figcaption></figcaption></figure>

Head over to the deployment pipelines tab and click on **Create new pipeline.**

<figure><img src="/files/6NtTGB1HfaMrIZq5bWFk" alt=""><figcaption></figcaption></figure>

Provide a name for your pipeline.

<figure><img src="/files/Y53HILncgJOZmlaEgPtm" alt=""><figcaption></figcaption></figure>

**Optional**: If you are going to manage branch-specific deployments, choose the branches in the branch filter section for which you would like to create deployment events in ilert.

<figure><img src="/files/Rn3uiVaLLq3GhjQ5BiwT" alt=""><figcaption></figcaption></figure>

In any way, by clicking on Create, you should end up on the detail view of your Azure DevOps deployment pipeline.

<figure><img src="/files/cUza4jhp8RvHp9fZJlFG" alt=""><figcaption></figcaption></figure>

Providing you with a freshly generated `integrationKey` and copy & pastable **URL** ready for your webhook setup.

### Creating a service hook in Azure DevOps

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

<figure><img src="/files/iapnrJc7VVmitwoJF06i" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/dpurqhTO21FGnjC4WxeF" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/ly1r1NSckGgGc4MkDSmD" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/duGreApgwrhr0s1jnBim" alt=""><figcaption></figcaption></figure>

In **URL**, paste the ilert **Integration URL** you created earlier.

Click **Finish** to save the subscription.

<figure><img src="/files/8vnjStpj8jnsNMMNFPkK" alt=""><figcaption></figcaption></figure>

You are now all set and should see deployment events coming into your ilert account.


---

# 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.ilert.com/integrations/deployment-integrations/azuredevops.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.