# Zabbix
[Zabbix](https://www.zabbix.com/) is a mature, enterprise-level platform that allows you to monitor large-scale IT environments comprising servers, networks, applications, and services.
Route detailed monitoring alerts from Zabbix to the right users in Squadcast.
### How to integrate Zabbix with Squadcast
#### In Squadcast: Using Zabbix as an Alert Source
1. Navigate to **Services** -> **Service Overview** -> select or search for your Service. Expand the accordion -> In the Alert Sources section, click **Add**.
2\. Select **Zabbix.** Copy the displayed **Webhook URL** to [configure](#in-zabbix-create-a-squadcast-webhook) it within **Zabbix.** Finish by clicking **Add Alert Source** -> **Done.**
{% hint style="warning" %}
**Important:**
When an alert source turns Active, it’ll show up under Configured Alert Sources, you can either generate a test alert from the integration or wait for a real-time alert to be generated by the Alert Source. An Alert Source is active if there is a recorded incident via that Alert Source for the Service.
{% endhint %}
#### In Zabbix: Create a Squadcast Webhook
**(1)** Navigate to Zabbix’s `AlertScriptsPath` directory. This is usually `/etc/zabbix/alert.d` or `/usr/local/share/zabbix/alertscripts`. Check your `zabbix\_server.conf` file to see how this option is configured.
**(2)** In this directory, run the following command:
```
sudo wget https://raw.githubusercontent.com/squadcastHub/squadcast-zabbix-script/master/sq-zabbix.py
```
Once the file is downloaded, ensure that it has *executable permissions for your Zabbix user*. If not then please provide the same using the following command:
```
chmod +x sq-zabbix.py
```
{% hint style="warning" %}
**Important**
The Squadcast script for Zabbix requires Python 3 to be installed on the machine running Zabbix. Any other version of Python (other than Python 3) will not support this script.
{% endhint %}
**(3)** Head over to the **Administration** tab and then click on **Media types**. Click on **Create Media type** to create a new Media Type with the following configuration
```
Name: Squadcast
AlertType: Script
Script Name: sq-zabbix.py
Script Parameters:
{ALERT.SENDTO}
{ALERT.SUBJECT}
{ALERT.MESSAGE}
```
Additionally, ensure **Enabled** checkbox is selected and then click on **Add**
**(4)** Now you can add this Media Type to any User/s of Zabbix. To do so, navigate to **Administration** tab and select **Users** from the drop-down. Here, select **Media** tab and click on **Add**
* *Type*: Either pick Squadcast or add a name, such as *Squadcast*
* *Send to*: Paste the copied Zabbix Webhook URL from Squadcast
* *When active*: Specify suitable values
* *Use if severity*: Select appropriate checkboxes
* Click on **Add** to save the Media for the User
**(5)** Make sure you click on **Update** button in the **Media** page to save these details
**(6)** Navigate to the **Configuration** tab and click on **Actions**. Click on **Create Action** and enter a meaningful name, such as **Squadcast Notifications**
**(7)** Switch to **Operations**" tab on the same page and configure the parameters as per your requirements
Copy-paste the following in the ‘Default Message’ field:
```yaml
name:{TRIGGER.NAME}
id:{TRIGGER.ID}
status:{TRIGGER.STATUS}
hostname:{HOSTNAME}
ip:{IPADDRESS}
value:{TRIGGER.VALUE}
event_id:{EVENT.ID}
severity:{TRIGGER.SEVERITY}
url:{TRIGGER.URL}
```
**(8)** Similarly, switch to **Recovery operations** tab and configure the following: Copy-paste the following in the ‘Default Message’ field:
```yaml
name:{TRIGGER.NAME}
id:{TRIGGER.ID}
status:{TRIGGER.STATUS}
hostname:{HOSTNAME}
ip:{IPADDRESS}
value:{TRIGGER.VALUE}
event_id:{EVENT.ID}
severity:{TRIGGER.SEVERITY}
url:{TRIGGER.URL}
```
**(9)** Finally click on **Add** to save **Squadcast Notifications**
That's it, our Zabbix integration is now good to go! Whenever Zabbix fires an alert, an incident is created in Squadcast for the same.
{% hint style="info" %}
**FAQ:**
Q: If an alert gets resolved in Zabbix, does Zabbix send auto-resolve signals to Squadcast?
A: Yes, Zabbix sends alert auto-resolve signals to Squadcast, thus supporting auto-resolution of incidents in Squadcast.
{% endhint %}
{% hint style="warning" %}
**Important**
The user whose **media** is configured to send alerts to Squadcast must belong to a **user-group** having read permission on the **Host Group** which needs to be monitored by Squadcast inorder to send the alerts.
{% endhint %}
*Have any questions?* [*Ask the community*](https://community.squadcast.com/view/home)*.*
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://support.squadcast.com/integrations/alert-source-integrations-native/zabbix.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.