# Ekara integration

Connecting [Ekara](https://ip-label.com/) to ilert helps you turn synthetic checks into actionable alerts and incidents. By sending Ekara alerts to ilert, you keep responders informed about availability and performance events – improving visibility, accelerating root cause analysis, and reducing MTTR.

## In ilert: Create a Ekara alert source&#x20;

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 **Ekara** in the search field, click the Ekara 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%2FwIDOq8d8WaSIEki7Q5LZ%2F4.png?alt=media&#x26;token=1f768d31-3ca4-40fe-810b-8a8c82f5ce8d" alt=""><figcaption></figcaption></figure>

## In Ekara: Create a webhook

1. In Ekara, open the **Management** menu.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F8c4pahTvEZIDMSSjeOCk%2F1.png?alt=media&#x26;token=36f17d4b-ad72-4584-8927-cd5a8037b1b0" alt=""><figcaption></figcaption></figure>

2. In the sidebar, click **Webhooks**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FRIhhTB16iZIwDMRDQWGM%2F2.png?alt=media&#x26;token=b12240f6-9f83-46bf-bf2e-83023f32bb28" alt=""><figcaption></figcaption></figure>

3. Click **Add a webhook**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FWkIWfZw0QUuFk1k94WtQ%2F3.png?alt=media&#x26;token=bca655ee-8b9a-4ecb-bb66-74d22ce7fae5" alt=""><figcaption></figcaption></figure>

4. Enter a **Name** and paste the ilert **Integration URL** into the **URL** field.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FimVvkRNR0mYDhEK3Karc%2FIlert_webhook_ekara_new.png?alt=media&#x26;token=6f636231-32e8-41af-a0ba-1a03d781329e" alt=""><figcaption></figcaption></figure>

5. Save the webhook.

## In Ekara: Create an alert

1. Navigate to **Settings**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FQtybC5aCqxtuKj5Hynyf%2F6.png?alt=media&#x26;token=0908158f-e6b3-4a36-8ab2-fa6e2a795136" alt=""><figcaption></figcaption></figure>

2. In the sidebar, select **Alerts** and click **Add an alert**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F3XIRmbRDIAq9SGVHO6eo%2F7.png?alt=media&#x26;token=63faf77a-e8a0-4757-bda1-9849468c92d4" alt=""><figcaption></figcaption></figure>

3. Enter a **Name** for the alert.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FgjXvT36nuskhU7dCbLV5%2F8.png?alt=media&#x26;token=59c0cc3e-c2d2-4aee-a2d1-dc22cd5a725a" alt=""><figcaption></figcaption></figure>

3. In the **Channel** section, choose **Webhook** and select the previously created webhook as the receiver.
4. Click **Save** to finish the setup.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FdFbGiqi0cHK5ChX8j8aI%2F9.png?alt=media&#x26;token=e04aecb6-cc04-4ab3-8b8e-65940365bed7" alt=""><figcaption></figcaption></figure>

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

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

Yes, as soon as Ekara sends a notification with the alertStatus "End", corresponding alerts in ilert will be resolved automatically.
