# HetrixTools Integration

[HetrixTools](https://hetrixtools.com/) is a platform that provides uptime monitoring, server monitoring, and blacklist monitoring to ensure optimal performance and security of IT infrastructure. This article provides step-by-step instructions on how to connect your HetrixTools monitoring with ilert.

## In ilert: Create a HetrixTools 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 **HetrixTools** in the search field, click the HetrixTools 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%2F6mxxVm7DjZYf0AbSPvvu%2Fil.png?alt=media&#x26;token=c7466158-052a-4fdd-9236-9b503bf692ba" alt=""><figcaption></figcaption></figure>

## In HetrixTools: Create a Contact Webhook

1. On the sidebar, click on **Contact Lists**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FoSM9qTefAAlKv9j249OJ%2F1.png?alt=media&#x26;token=871283ca-6480-4bb0-a064-c7d7f074e671" alt="" width="359"><figcaption></figcaption></figure>

2. Now click on **Add new Contact List**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F0NzWLcnjmZSMjo7YpDt5%2F2.png?alt=media&#x26;token=38a26b80-fa59-4761-8149-03d807b314cd" alt="" width="563"><figcaption></figcaption></figure>

3. Enter a **Contact List Name** and expand the **ilert** section.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fzchk2AMPIVeKPRGARJB6%2F1-1.png?alt=media&#x26;token=6b5c9eab-e167-45c0-a6f3-d68616c87c14" alt="" width="563"><figcaption></figcaption></figure>

4. Enter the previously created alert source api key into the **ilert API Key** field.
5. Optional: Click on the **Send test notification** to test the integration.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FZPE0UgdyKn3TIqy1zG4m%2F1-2.png?alt=media&#x26;token=7c8ffdcd-37d7-4af2-a739-3bf871c7f43a" alt="" width="563"><figcaption></figcaption></figure>

6. Now navigate to the monitor you want to receive an alert from.
7. Click on **\[No Contact List]** to select a contact list.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FxUTR5sMrFRPhFyhryP4a%2F7.png?alt=media&#x26;token=8030ab77-cd3b-419c-af56-04f441cebbda" alt="" width="563"><figcaption></figcaption></figure>

8. Select the contact list that was created in Step 3.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F0lGH9QH6ImieYpEJY6az%2F8.png?alt=media&#x26;token=629958db-cfe5-47ac-8e59-730f6f2b52fb" alt="" width="459"><figcaption></figcaption></figure>

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

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

Yes, partially. As soon as the HetrixTools sends a notification with 'online' status, the corresponding alerts in ilert will be resolved automatically. Note that this will only apply to Uptime Monitors.
