# Healthchecks.io Integration

[Healthchecks.io](https://healthchecks.io/) is an online service designed to monitor the execution of cron jobs and other scheduled tasks. By generating unique ping URLs for each task, users can configure their jobs to send HTTP requests upon completion. If a task fails to ping within the expected timeframe, Healthchecks.io sends alerts to ilert.&#x20;

## In ilert: Create a Healthchecks.io alert source <a href="#create-alarm-source" id="create-alarm-source"></a>

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 **Healthchecks.io** in the search field, click the Healthchecks.io 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%2FSAqF3xyMscJgGnIOencm%2Fil-1.png?alt=media&#x26;token=fd0f442d-af6f-43d1-b371-19246e1bfc76" alt="" width="563"><figcaption></figcaption></figure>

## In Healthchecks.io: Create a Webhook

1. On the navigation bar, click on **INTEGRATIONS**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FmxRlnOtRd1UQhyE8EADK%2F1.png?alt=media&#x26;token=99c3143a-bacd-4088-b65d-8e4a95a3200c" alt=""><figcaption></figcaption></figure>

2. Click on the **Add Integration** button next to **Webhook**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FT2Xr1DOYDr5xqIfQ2tPE%2F2.png?alt=media&#x26;token=24ac9d73-c0c7-4be8-9a49-03faba38dc87" alt=""><figcaption></figcaption></figure>

3. Enter a Name.
4. Enter the previously in ilert generated alert source url into the **URL** fields.
5. Enter `$JSON` to both 'up' and 'down' **Request Body** fields.
6. Now enter following into both **Request Headers** fields:

```
Check-Status: $STATUS
Content-Type: application/json
```

7. Click on the **Save Integration** button 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%2FUzHs3a7MOsDBhrRNPLRA%2F3.png?alt=media&#x26;token=247fe909-3ec8-4746-944e-465412d7bf9d" alt=""><figcaption></figcaption></figure>

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

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

Yes, as soon as the Check-Status of a check in Healthchecks.io is 'up' again, corresponding alert in ilert will be resolved.
