# Catchpoint Integration

[Catchpoint](https://www.catchpoint.com) is a comprehensive platform offering a suite of internet performance monitoring tools designed to provide complete, actionable insights and visibility into an organization's entire digital ecosystem.

With ilert integration for Catchpoin, you can enable multi-channel alerting for Catchpoint issues, assign them to specific team members, and use on-call schedules for uninterrupted observation of your system.

## In ilert: Create a Catchpoint alert source

1. Go to **Alert sources** --> **Alert sources** and click on **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 **Catchpoint** in the search field, click on the Catchpoint tile and click on **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 you [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 show additional settings such as customer alert templates or notification prioritiy. Click on **Finish setup** for now.
7. On the final page, an API key and / or webhook URL will be generated that you will need later in this guide.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fi3TIOBvNYBQfDtNpmm0A%2FScreenshot%202023-08-28%20at%2011.47.34.png?alt=media&#x26;token=6cae965a-e448-4443-8c20-37cf501c43b2" alt=""><figcaption></figcaption></figure>

## In Catchpoint: Add an alert webhook

1. In the sidebar click on **Settings** -> **API**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FB0EAp5VxqagL14606Fl6%2Fcatchpoint-1-new.png?alt=media&#x26;token=ece39324-f567-4823-81a2-e4feae9d8e11" alt="" width="262"><figcaption></figcaption></figure>

2. Enable **Alert Webhook**.
3. Enter a **Name** and the previous generated alert source **URL** into the fields.
4. Select Template as **Format**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FMQEVkUP0pqaWtrkQ4bvo%2Fcatchpoint-2-new.png?alt=media&#x26;token=c81c8517-fbcc-4c1b-a8ac-b7c6c39f2f01" alt=""><figcaption></figcaption></figure>

5. Add a new template.
6. Enter a **Name** for the template.
7. Select JSON as **Format**.
8. Copy and paste following payload into the **Template** field:

```
{
    "eventType": "${switch(${notificationLevelId},'0','ALERT','1','ALERT','3','RESOLVE')}",
    "alertKey": "${alertInitialTriggerDateUtcEpoch}_${AlertType}_${divisionName}_${productName}_${testName}",
    "summary": "Catchpoint ${AlertType} in ${divisionName} - ${testName} ${if(${AlertTypeId} != '7', - [${nodeDetails(${nodePageFailureErrorCode})}] - ${nodeDetails(${nodePageFailureErrorCodeDesc})})}",
    "details": "There is an ${InitialNotificationlevelText} Catchpoint ${AlertType} in\nDivision: ${divisionName}\nProduct: ${productName}\nTestName: ${testName}\nStatus: ${switch('${notificationLevelId}','0','WARNING','1','CRITICAL','3','IMPROVED')}\n Scatterplot: ${scatterplotChartURL}",
    "scatterPlotUrl": "${scatterplotChartURL}",
    "priority": "${switch(${notificationLevelId},'0','LOW','1','HIGH','')}"
}
```

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FXat1Jpp76lLx3BUY4Uh6%2Fcatchpoint-3-new.png?alt=media&#x26;token=14ba2983-88e1-4bdf-9f73-7a8e0b4680ab" alt=""><figcaption></figcaption></figure>

9. Save the alert webhook.

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

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

Yes, as soon as a test or an alert in Catchpoint is resolved, the associated alert in ilert will be resolved automatically.&#x20;