# Cisco ThousandEyes Integration

[ThousandEyes by Cisco](https://www.thousandeyes.com/) is a network intelligence platform that monitors the performance of internet-based networks and applications, helping businesses quickly detect and troubleshoot connectivity issues. By connecting it to ilert, users can receive real-time alerts on network disruptions, ensuring rapid response and minimal downtime for critical services.

## In ilert: Create a Cisco ThousandEyes 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 **Cisco ThousandEyes** in the search field, click the Cisco ThousandEyes 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%2FdeLohbbpXHNmkwiyS0dK%2F1.png?alt=media&#x26;token=00a207fa-ae9d-441d-8fef-9cd8d27d7aa7" alt=""><figcaption></figcaption></figure>

## In Cisco ThousandEyes: Create a Webhook

1. On the sidebar, click on **Integrations**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FHvteJyTiOKfeAERc30dj%2F2.png?alt=media&#x26;token=55394b37-27ab-4811-9893-c86b894ccb26" alt=""><figcaption></figcaption></figure>

2. Now click on the **New Integration** button.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fib0mIoRRAGPEn4s19nC2%2F3.png?alt=media&#x26;token=873c87fa-38bb-4ef7-80d1-b80ae98031d6" alt=""><figcaption></figcaption></figure>

3. Select **Custom Webhook**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fpt5gBfCRz4NTCq3EPJbB%2F4.png?alt=media&#x26;token=5716380c-bf65-43e7-b020-676a36de9aeb" alt=""><figcaption></figcaption></figure>

4. Enter a **Name** and the previously generated alert source **URL** into corresponding input fields.
5. Choose **Generic** in the **Preset Configurations** selection and click on **Test**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FyhPf8UzQSkXJMw6hIGmH%2F5.png?alt=media&#x26;token=c9ac1658-845c-4501-9ede-be07b7a09648" alt=""><figcaption></figcaption></figure>

6. To verify if the webhook is working, check the **Status**; it should show **Connected**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FzfkMkm2cYpQ2mAMkoaKW%2F6.png?alt=media&#x26;token=6c04c7a0-4e22-4d99-84a2-ac74531d3e22" alt=""><figcaption></figcaption></figure>

7. Now open the three-dot menu and click on **Manage Alert Rules**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FzCQLWQTkDfHrQQLETwTl%2F7.png?alt=media&#x26;token=d1f07ca6-0a04-4c87-9fc6-7487a14b6d04" alt=""><figcaption></figcaption></figure>

8. Select the desired **Alert Rules** from which you want to receive notifications.
9. Click on **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%2F3cx5l7vdxxbgMtVgH7Fu%2F8.png?alt=media&#x26;token=28960251-4349-46d1-ae80-ecbe31b93363" alt="" width="563"><figcaption></figcaption></figure>

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

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

Yes, as soon as Cisco ThousandEyes sends a notification with '1' status, corresponding alerts in ilert will be resolved automatically.
