> ## 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.

# Zabbix

> Connect Zabbix Monitoring with All Quiet

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

Integrate Zabbix with All Quiet in a matter of minutes. With webhooks, you can automatically send alerts from your Zabbix monitoring directly to All Quiet, streamlining your team's incident management process.

## 1. Create Zabbix 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="Zabbix_Create" src="https://mintcdn.com/allquiet/P8t56GT-09l8Ew6U/images/zabbix/01.png?fit=max&auto=format&n=P8t56GT-09l8Ew6U&q=85&s=70ebd0557de52bc71305011631275996" width="2740" height="678" data-path="images/zabbix/01.png" />

### Select Zabbix as the integration's type

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

<img className="Zabbix_Select" src="https://mintcdn.com/allquiet/P8t56GT-09l8Ew6U/images/zabbix/02.png?fit=max&auto=format&n=P8t56GT-09l8Ew6U&q=85&s=529413414b173f3c42c83813c3494559" width="2145" height="2244" data-path="images/zabbix/02.png" />

### Copy Webhook URL and Download Media Type

After creating the integration on All Quiet

1. you can view and copy the webhook URL. You will require this URL in step 2 when configuring the custom integration on Zabbix.
2. you can view the `Zabbix Media Type` file that you will need to upload in Zabbix in step 2. Download it.
   <Tip> The Media Type we provide works with Zabbix version 7.0 and newer. </Tip>

<img className="Zabbix_Get" src="https://mintcdn.com/allquiet/P8t56GT-09l8Ew6U/images/zabbix/03.png?fit=max&auto=format&n=P8t56GT-09l8Ew6U&q=85&s=71422af9ccec9c55b94f818c46a42c10" width="2152" height="1044" data-path="images/zabbix/03.png" />

## 2. Configure the Integration with Zabbix

Once you've set up an integration of type "Zabbix" with All Quiet, the next crucial steps involve configuring a Zabbix user, connecting it with All Quiet via the Media Type and Webhook and adding it to the correct user group to be able to send alerts to All Quiet.

First, you need to sign in to your Zabbix Account.

### Create Macro

We create a macro to always include the URL of the Zabbix alert in the related All Quiet incident.

1. Open `Administration`
2. `Macros`
3. Add Macro for \{\$ZABBIX.URL}. As `Value`, enter your Zabbix frontend URL (https\://...)
4. Click `Update` to save the macro.

<img className="Zabbix_Macro" src="https://mintcdn.com/allquiet/omd7ZCTO_U3iC7ur/images/zabbix/04.png?fit=max&auto=format&n=omd7ZCTO_U3iC7ur&q=85&s=0947e1a90a487db1c2e45acc93950633" width="3056" height="1500" data-path="images/zabbix/04.png" />

### Add All Quiet Media Type

Now, we add the All Quiet Media Type.

1. Open `Alerts`
2. `Media Types`
3. Select `Import`

<img className="Zabbix_MediaType01" src="https://mintcdn.com/allquiet/omd7ZCTO_U3iC7ur/images/zabbix/05.png?fit=max&auto=format&n=omd7ZCTO_U3iC7ur&q=85&s=6f5d8a23aa34f5d96ccaceb93a2ab435" width="2950" height="1262" data-path="images/zabbix/05.png" />

1. Select the media type file you downloaded in [step 1](/integrations/inbound/zabbix#copy-webhook-url-and-download-media-type).
2. Click `Import`

<img className="Zabbix_Zabbix_MediaType02" src="https://mintcdn.com/allquiet/omd7ZCTO_U3iC7ur/images/zabbix/06.png?fit=max&auto=format&n=omd7ZCTO_U3iC7ur&q=85&s=41cff8036894a549524db1e180068bc6" width="1476" height="508" data-path="images/zabbix/06.png" />

You successfully added the media type.
<Tip>You can [customize the fields](/integrations/inbound/zabbix#optional:-extend-the-zabbix-media-type-xml-file) of this Media Type at any time. Note that testing the Media Type will not work as Zabbix is not substituting variables in the Test cases. To test your Zabbix integration with All Quiet, follow & finish this setup guide.</Tip>

#### Optional: extend the Zabbix Media Type XML File

If you notice that important information is missing in All Quiet, you can adjust the Zabbix **Media Type XML** to include additional parameters/macros, and then map them in All Quiet.

**1. Add parameters to the Zabbix 7.0 media type XML**

For example, you may want to add the host group to the payload. Add this parameter inside the `<parameters>` section of the Media Type:

```xml theme={null}
<parameter>
  <name>TRIGGER.HOSTGROUP.NAME</name>
  <value>{TRIGGER.HOSTGROUP.NAME}</value>
</parameter>
```

For Zabbix **7.0**, the correct built-in macro name is **`{TRIGGER.HOSTGROUP.NAME}`** for trigger notifications/webhooks.

**2. Map it in All Quiet via payload mapping**

Once Zabbix starts sending it, the inbound webhook JSON will contain:

`jsonBody["TRIGGER.HOSTGROUP.NAME"]`

In All Quiet’s mapping UI, map it using this JSONPath:

`$.jsonBody['TRIGGER.HOSTGROUP.NAME']`

You can map this into any All Quiet attribute you want to populate (for example a custom attribute you use for routing), without changing backend defaults.

### Create All Quiet User

Now, it's time to create the All Quiet user.

1. Select section `Users`
2. Again, `Users`
3. Click `Create User`

<img className="Zabbix_User01" src="https://mintcdn.com/allquiet/omd7ZCTO_U3iC7ur/images/zabbix/07.png?fit=max&auto=format&n=omd7ZCTO_U3iC7ur&q=85&s=8fca3acab95b74aba2c25e6c7ba819a0" width="2930" height="1386" data-path="images/zabbix/07.png" />

1. Add a `Username`, e.g. "All Quiet" and create a password.
2. Add the User to one of your User Groups have that read permissions for the host(s) you want to connect with All Quiet. We will show you how to do this [later](/integrations/inbound/zabbix#ensure-user-has-sufficient-permissions)
3. Switch to Tab `Media`

<img className="Zabbix_User02" src="https://mintcdn.com/allquiet/omd7ZCTO_U3iC7ur/images/zabbix/08.png?fit=max&auto=format&n=omd7ZCTO_U3iC7ur&q=85&s=c734f65b229f6a48fac15af6cb1a2508" width="2586" height="1250" data-path="images/zabbix/08.png" />

In Tab `Media`, click add Media. This opens an overlay.

1. Select Media Type `All Quiet` to use the Media Type we configured [earlier](/integrations/inbound/zabbix#add-all-quiet-media-type).
2. As "Send to", paste in the All Quiet webhook URL you've obtained in step [Copy Webhook URL](/integrations/inbound/zabbix#copy-webhook-url-and-download-media-type).
3. Click `Add`.

Afterwards, click `Update` to create the user.

<img className="Zabbix_Get" src="https://mintcdn.com/allquiet/omd7ZCTO_U3iC7ur/images/zabbix/09.png?fit=max&auto=format&n=omd7ZCTO_U3iC7ur&q=85&s=4d5d1c1f2dc24ecf6522dfbf5530b2e8" width="1880" height="992" data-path="images/zabbix/09.png" />

#### Ensure User Has Sufficient Permissions

As said earlier, we need to ensure that the user has sufficient permissions in order to be able to forward incidents to All Quiet.

1. We can check the user's permissions by opening the `Permissions` tab.
2. The user should have at least `Read` permissions for the hosts that should be forwarded.

If your user does not have these permissions, they can be changed on group level.

<img className="Zabbix_Get" src="https://mintcdn.com/allquiet/omd7ZCTO_U3iC7ur/images/zabbix/10.png?fit=max&auto=format&n=omd7ZCTO_U3iC7ur&q=85&s=7fd513cb8de494dcc98ee201d410d129" width="1740" height="758" data-path="images/zabbix/10.png" />

To update the permissions of your All Quiet user, edit the related user group(s).

1. Open `Users > User groups`.
2. Open the tab `Host Permissions`
3. You can add / remove hosts
4. Make sure that the permissions are at least on `Read` and click `Update` to save your changes.

<img className="Zabbix_Get" src="https://mintcdn.com/allquiet/omd7ZCTO_U3iC7ur/images/zabbix/11.png?fit=max&auto=format&n=omd7ZCTO_U3iC7ur&q=85&s=a8806087a5a0e71ceac89e91350ba883" width="2550" height="1084" data-path="images/zabbix/11.png" />

### Create Trigger Action

Now it's time to create a trigger to connect Zabbix alerts with All Quiet, using the user we just created.

1. Open `Alerts > Actions`
2. Select \`Trigger Actions\`\`
3. Create `Action`

<img className="Zabbix_Get" src="https://mintcdn.com/allquiet/omd7ZCTO_U3iC7ur/images/zabbix/12.png?fit=max&auto=format&n=omd7ZCTO_U3iC7ur&q=85&s=687bbdc15c243431f0418d04643a16ea" width="2936" height="994" data-path="images/zabbix/12.png" />

After giving your action a name,

1. open the tab `Operations` and click `Add`
2. in the overlay, make sure to select the `User Group` that you added the All Quiet user to [earlier](/integrations/inbound/zabbix#create-all-quiet-user)
3. As `Media Type`, select "All Quiet".
4. Click `Add`.

<img className="Zabbix_Get" src="https://mintcdn.com/allquiet/omd7ZCTO_U3iC7ur/images/zabbix/13.png?fit=max&auto=format&n=omd7ZCTO_U3iC7ur&q=85&s=3e91558ff5049c1b6ef79cc600b229a1" width="2230" height="1176" data-path="images/zabbix/13.png" />

Repeat the steps from `Operations` above for `Recovery operations` (1) and `Update operations` (2). Click `Update` to save.

<img className="Zabbix_Get" src="https://mintcdn.com/allquiet/omd7ZCTO_U3iC7ur/images/zabbix/14.png?fit=max&auto=format&n=omd7ZCTO_U3iC7ur&q=85&s=efa6870add8b9a789c37f12925f65528" width="2218" height="1196" data-path="images/zabbix/14.png" />

<Check> You're ready to go. If you set up your integration this way, Zabbix will send alerts to All Quiet.</Check>

Incidents created from Zabbix alerts will show up in your Incidents overview.

<img className="Zabbix_Get" src="https://mintcdn.com/allquiet/SODHUkB7O5dYfUbS/images/zabbix/15.png?fit=max&auto=format&n=SODHUkB7O5dYfUbS&q=85&s=ad80c76f8d1223509cdec195376538ec" width="4017" height="527" data-path="images/zabbix/15.png" />

### 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/Zabbix.tf) the default mapping of the `allquiet_integration_mapping` resource for the Zabbix integration. Simply copy the syntax to your .tf file and tailor the resource to your team's needs!</Tip>