> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allquiet.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Netdata

> Connect Netdata Monitoring with All Quiet

<Info>Setup time: 2 Min</Info>

Easily integrate Netdata with All Quiet. With webhooks, you can automatically send alerts from your Netdata monitoring directly to All Quiet, streamlining your incident management.

## 1. Create Netdata Integration on All Quiet

Sign in to your All Quiet account.

### Create Integration

1. Click on the `Inbound Integrations` tab.
2. Click on `+ Create`.

<img className="Netdata_Create" src="https://mintcdn.com/allquiet/LprUf3XBqV5kYbwv/images/netdata/01.png?fit=max&auto=format&n=LprUf3XBqV5kYbwv&q=85&s=3cf885f231b15949129f999ec5ed8cce" width="2740" height="678" data-path="images/netdata/01.png" />

### Select Netdata as the integration's type

1. Enter a `Display Name` for your integration, e.g. "Netdata".
2. Select a `Team`.
3. Select `Netdata` as the integration's type.
4. Click `Create Inbound Integration`.

<img className="Netdata_Select" src="https://mintcdn.com/allquiet/LprUf3XBqV5kYbwv/images/netdata/02.png?fit=max&auto=format&n=LprUf3XBqV5kYbwv&q=85&s=d7bf99f9b74f2174f7e1878a6805fee3" width="2120" height="2225" data-path="images/netdata/02.png" />

### Webhook URL and Netdata Challenge Secret

After creating the integration on All Quiet, you can view

1. the `Webhook URL`.
2. the `Netdata Challenge Secret`.

You will require both, the URL and the Challenge Secret in step 2 when configuring the custom integration on Netdata.

<img className="Netdata_Get" src="https://mintcdn.com/allquiet/LprUf3XBqV5kYbwv/images/netdata/03.png?fit=max&auto=format&n=LprUf3XBqV5kYbwv&q=85&s=3b418890d94fa1acd5de047258c2cf9a" width="2152" height="1134" data-path="images/netdata/03.png" />

## 2. Configure a custom integration with Netdata

Once you've set up an integration of type "Netdata" with All Quiet, the next crucial steps involve configuring your Netdata account. This is essential for ensuring that your monitoring setup can effectively send incidents to the All Quiet webhook. In this part of the guide, we will walk you through the process of linking Netdata with All Quiet via webhook.

First, you need to sign in to your Netdata Account and open `Settings`

<img className="Netdata_settings" src="https://mintcdn.com/allquiet/dWgOx2f9emOOtoOO/images/netdata/04.png?fit=max&auto=format&n=dWgOx2f9emOOtoOO&q=85&s=33381395aa409df601b093bedda81579" width="1383" height="649" data-path="images/netdata/04.png" />

1. Select `Alerts & Notifications`
2. Click `+ Add configuration`

<img className="Netdata_add_integrations" src="https://mintcdn.com/allquiet/dWgOx2f9emOOtoOO/images/netdata/05.png?fit=max&auto=format&n=dWgOx2f9emOOtoOO&q=85&s=7d2490e89989260121aebe74fdb8818a" width="1368" height="477" data-path="images/netdata/05.png" />

Add `Webhook`

<img className="Netdata_add_webhook" src="https://mintcdn.com/allquiet/dWgOx2f9emOOtoOO/images/netdata/06.png?fit=max&auto=format&n=dWgOx2f9emOOtoOO&q=85&s=534380d0f42a893ecb4b43ea8033441f" width="1110" height="631" data-path="images/netdata/06.png" />

Now, it's time to set up the integration.

1. Select a `Configuration name`, e.g. "All Quiet".
2. Select the `Rooms` from which you would like to forward alerts to All Quiet.
3. Select the type of `Notifications` you would like to forward.
4. As `Webhook URL`, paste in the All Quiet Webhook URL you've obtained in step [Webhook URL and Netdata Challenge Secret](/integrations/inbound/netdata#webhook-url-and-netdata-challenge-secret).
5. As `Authentification details`, select "No Authentification".
6. As `Challenge secret`, paste in the Netdata Challenge Secret you've obtained in step [Webhook URL and Netdata Challenge Secret](/integrations/inbound/netdata#webhook-url-and-netdata-challenge-secret).
7. Click `OK` to save your settings. You can also test them, first (see 2nd Screenshot below).

<img className="Netdata_configure_integration" src="https://mintcdn.com/allquiet/dWgOx2f9emOOtoOO/images/netdata/07.png?fit=max&auto=format&n=dWgOx2f9emOOtoOO&q=85&s=cd5c2a5bb0da948d17a5d487dd5259b7" width="580" height="697" data-path="images/netdata/07.png" />

If test is successful, you will receive a test payload from Netdata that can be found in the "Payload Mapping" tab of your All Quiet Netdata Integration.

1. The payload is there.
2. We **cannot map the test notification** as it missing some required attributes that we need to create incidents. Howewer, our **predefined mapping** engine will be able to **create incidents from real Netdata alerts**. Use our mapping engine to add further data to All Quiet incidents.

<img className="Netdata_test_payload" src="https://mintcdn.com/allquiet/LprUf3XBqV5kYbwv/images/netdata/08.png?fit=max&auto=format&n=LprUf3XBqV5kYbwv&q=85&s=f867f3b41df102daed9fc1faefb0940f" width="2174" height="2376" data-path="images/netdata/08.png" />

<Check>All Quiet will now create incidents based on your Netdata monitoring.</Check>

### Adjust Payload Mapping

Looking to customize the fields of your incidents by adjusting the pre-built payload mapping? Simply head over to the “Payload” tab within your integration and make the necessary edits to the mapping. For detailed guidance, you may check out our [payload mapping documentation](/essentials/inbound#how-does-attribute-mapping-work).

<Tip>Using our Terraform provider? [Download](https://allquiet.app/api/integrations/terraform/default/Netdata.tf) the default mapping of the `allquiet_integration_mapping` resource for the Netdata integration. Simply copy the syntax to your .tf file and tailor the resource to your team's needs!</Tip>
