# Honeybadger Integration

[Honeybadger](https://www.honeybadger.io/) is an application monitoring solution designed for developers to identify and resolve issues in real-time. It tracks errors, uptime, and performance, giving teams insight into problems before users report them. By connecting Honeybadger to ilert, users can streamline their incident management process, receiving alerts on critical errors via ilert’s flexible notification channels and escalation policies.

## In ilert: Create a Honeybadger 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 **Honeybadger** in the search field, click the Honeybadger 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%2FOJDQtB1HAogwvXLZ3zcN%2Fil-1-2.png?alt=media&#x26;token=1c39e505-52a8-4e3a-a1f0-69569a8a9d91" alt="" width="563"><figcaption></figcaption></figure>

## In Honeybadger: Create a Webhook

1. On the dashboard, click on **Settings**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FdK7KFgWaCZ9xfBG9543x%2F1.png?alt=media&#x26;token=95686a62-f6ba-4b41-b1d0-aff4936b1fb3" alt=""><figcaption></figcaption></figure>

2. Now click on **Alerts & integrations**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FxS3AFBSzYW6ZmvcQUMps%2F2.png?alt=media&#x26;token=9ebb1ed4-742c-46b9-a05d-48cb9dbc2844" alt=""><figcaption></figcaption></figure>

3. Scroll down and choose **ilert**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F4qEeCa84D4t8pv2Iqz7k%2F5.png?alt=media&#x26;token=8ed3fd42-8ed0-4662-97d2-eb33721403ca" alt=""><figcaption></figcaption></figure>

4. Enter the in ilert previous generated alert source url into the URL field.
5. Select the error-related events for which you want to receive notifications.
6. 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%2Fw3TAodutKdk4g3gb0Hrt%2F6.png?alt=media&#x26;token=affe5a02-d997-4b04-b655-6301f2cdf47e" alt=""><figcaption></figcaption></figure>

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

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

Yes, as soon as the state of a Monitor, Error or Heartbeat in Honeybadger is 'up', 'resolved' or 'check\_in\_reporting', corresponding  alert in ilert will be resolved.
