# LibreNMS Integration

[LibreNMS](https://www.librenms.org/) is an open-source network monitoring system that offers auto-discovery, alerting, and performance graphing for a wide range of network devices. With the ilert integration, LibreNMS can automatically send alerts to ilert to trigger incident notifications and ensure timely response from your on-call team.

## In ilert: Create a LibreNMS 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 **LibreNMS** in the search field, click the LibreNMS 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%2FP1eniagVeEfB25r4401m%2Fil-1.png?alt=media&#x26;token=eb2f738c-44df-41b0-8af8-1b0932199726" alt=""><figcaption></figcaption></figure>

## In LibreNMS: Create an Alert Transport

1. In the navigation bar, click **Alerts** **->** **Alert Transports**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FcGTZhjlJDFDox1n5fpZ9%2F1.png?alt=media&#x26;token=186d40e5-db02-4ded-8fe7-3a19c469477d" alt=""><figcaption></figcaption></figure>

2. Now click on **Create alert transport**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F051AQswjcEJRT2zFLf7S%2F2.png?alt=media&#x26;token=df0d4eca-d1fa-46ae-93ae-74100df9d29a" alt=""><figcaption></figcaption></figure>

3. Enter a **Transport name** and choose 'ilert' as **Transport type**.
4. Enter the **Integration Key** of the previously created alert source in ilert.
5. Click on Save Transport 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%2F5ZCwueVsh8zHfmg2oWCp%2F3.png?alt=media&#x26;token=667ee0dc-f4b5-4907-9cde-c3c5000d7b0b" alt=""><figcaption></figcaption></figure>

## FAQ

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

Yes, as soon as LibreNMS sends an event with the eventType of 'RESOLVE', the corresponding alert in ilert will be resolved.

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

Yes, as soon as LibreNMS sends an event with the eventType of 'ACCEPT', the corresponding alert in ilert will be resolved.
