Zabbix Integration Guide

Send events to Squadcast from Zabbix

Follow the steps below to configure a service so as to extract its related alert data from Zabbix. Squadcast will then process this information to create incidents for this service as per your preferences.

On the Sidebar, click on "Services".

You can either navigate to an existing service or make a new one by clicking on “Add Service”.

Check the service details like name, description, and the associated escalation policy for this service and make sure it is correctly entered.

From the integration types drop down select the integration type as “Zabbix”. You will be shown your Zabbix Webhook URL.

Go to the your Zabbix’s AlertScriptsPath directory. This is usually /etc/zabbix/alert.dor /usr/local/share/zabbix/alertscripts but it can be changed. Check your zabbix_server.conf file to see how this option is configured.

Once inside the directory run the following command:

sudo wget https://raw.githubusercontent.com/squadcastHQ/squadcast-zabbix-script/master/send-data-to-squadcast.sh

Once the file is downloaded please make sure that the file has execute permissions for your Zabbix user. If not then please provide the same using the following command:

chmod +x send-data-to-squadcast.sh

Go to "Administration" tab and then click on "Media types". Click on "Create Media type" and create a new media type with the following configuration.

Name: Squadcast
AlertType: ScriptScript
Name: send-data-to-squadcast.shScript
Parameters: {ALERT.SENDTO}{ALERT.SUBJECT}{ALERT.MESSAGE}

Before clicking "Add" make sure that the media type is enabled.

Now you can add this media type to any user you want. For example, click on "Users" tab under the "Administration" tab and select the user you want to add this media type to.

Under "Media" tab click on "Add" and enter the following details:

Type: Squadcast Alert
Send To: The Webhook URL you obtained above

Finally click on "Add" to save the media for the user and make sure you click on "Update" button on the "Media" page to save the details.

Now go to the "Configuration" tab and click on "Actions" tab. Click on "Create Action" to create a new action.

Enter the name as "Squadcast Notifications".

Click on "Operations" tab and configure it as per your requirements. In the Default Message field enter the following:

{
"name": "{TRIGGER.NAME}",
"host": "{HOST.NAME}",
"severity": "{TRIGGER.SEVERITY}",
"id": "{EVENT.ID}",
"status":"{EVENT.STATUS}"
}

Similarly configure the "Recovery operations". Make sure that you enter the following in the Default Message field:

{
"name": "{TRIGGER.NAME}",
"host": "{HOST.NAME}",
"severity": "{TRIGGER.SEVERITY}",
"id": "{EVENT.ID}",
"status":"{EVENT.STATUS}"
}

Finally click on "Add" to save "Squadcast Notifications".

That's it! Your Zabbix integration is now good to go.