# Parny | Zabbix Integration Guide Parny supports direct integration with Zabbix alerts. Zabbix is a network and system monitoring tool that can create alarms to detect and prevent potential problems. This documentation explains how to redirect alarms created in Zabbix to a webhook using Parny. ## Parny Settings 1. Go to the Parny interface. 2. Navigate to the "Services" section of your organization. 3. Click on the "New Services" option in the upper right corner. 4. Enter the relevant service name. > **Service Name Usage**: The service name here is independent of the structure and can be chosen according to the preferences of the organization. 5. Select Zabbix from the list of integrations. 6. Click "Add". 7. After the service is created, the following screen will appear.
drawing

- You can now click on the **token** section of your service and copy your Zabbix Webhook URL. ## Zabbix Configuration In this section, we will guide you through "Adding Webhook" and "Redirecting Alarms" for two different versions of Zabbix versions below and above v6.2 ### Zabbix Setup for versions below v6.2 #### Step 1: Adding Webhook 1. Log in to the Zabbix web interface and go to the "Administration" tab. 2. Click on the "Media Types" tab and press the "Create media type" button. drawing

3. In the "Type" field, select "Webhook" and fill in the required fields. Add your Parny URL, required parameters, and the script that will send the alarm to the fields below. drawing

**Parameters List:** - `alert_message`: `{ALERT.MESSAGE}` - `eventack`: `{EVENT.ACK.STATUS}` - `eventdate`: `{EVENT.DATE}` - `eventname`: `{ALERT.SUBJECT}` - `eventupdate`: `{EVENT.UPDATE.STATUS}` - `eventvalue`: `{EVENT.VALUE}` - `event_source`: `{EVENT.SOURCE}` - `hostip`: `{HOST.IP}` - `hostname`: `{HOST.NAME}` - `parnyUrl`: `https://zabbix.parny.io/alert/` - `severity`: `{EVENT.NSEVERITY}` - `triggerdesc`: `{TRIGGER.DESCRIPTION}` - `triggerid`: `{TRIGGER.ID}` - `url`: `{$ZABBIX.URL}` ```js try { var params = JSON.parse(value), req = new CurlHttpRequest(), fields = {}, resp = ""; // Correspondence between the Parny and Zabbix severity level var severityMapping = [ "info", // Not classified "info", // Information "warning", // Warning "warning", // Average "error", // High "critical" // Disaster ]; if (!severityMapping[params.severity]) { params.severity = "0"; } if (params.eventname.length < 1) { throw 'incorrect value for variable "eventname". The value must be a non-empty string.'; } if (isNaN(parseInt(params.severity)) || params.severity < 0 || params.severity > 5) { throw 'incorrect value for variable "severity". The value must be a number 0..5.'; } req.AddHeader("Content-Type: application/json"); // Determine the event action and payload fields.payload = { summary: params.eventname, source: params.event_source === "1" ? "Discovery" : params.hostname + " : " + params.hostip, severity: severityMapping[params.severity] }; fields.payload.custom_details = { "Alert message": params.alert_message }; fields.client = "Zabbix"; fields.client_url = params.url; // Set the event action based on eventvalue if ((params.eventvalue == 1 && params.eventupdate == 0) || params.event_source !== "0") { fields.event_action = "trigger"; } else if (params.eventvalue == 1 && params.eventupdate == 1 && params.eventack == "Yes") { fields.event_action = "acknowledge"; } else if (params.eventvalue == 0) { fields.event_action = "resolve"; } else { throw "incorrect values. Update message without ack will not be sent."; } Zabbix.Log(4, "[Parny Webhook] Sending request:" + JSON.stringify(fields)); resp = req.Post(params.parnyUrl, JSON.stringify(fields)); Zabbix.Log(4, "[Parny Webhook] Receiving response:" + resp); try { resp = JSON.parse(resp); } catch (error) { throw "incorrect response. Parny returned a non-JSON object."; } if (req.Status() != 200) { if (typeof resp === "object" && typeof resp.errors === "object" && typeof resp.errors[0] === "string") { throw resp.errors[0]; } else { throw "Unknown error."; } } if (resp.status != "success") { throw "Unknown error."; } return "OK"; } catch (error) { Zabbix.Log(3, "[Parny Webhook] Notification failed: " + error); throw "Parny notification failed: " + error; } ``` 4. Press the "Save" button to save the webhook. #### Step 2: Redirecting Alarms 1. Go to the "Administration" tab and click on the "Actions" tab. Click the "Create action" button. 2. Enter a name in the "Action" field and select the "Enabled" option. 3. In the "Conditions" tab, specify the conditions under which the alarms will be triggered. 4. For example, if you want to receive an alert when a server goes offline, select the relevant server group by choosing the "Host group" option. 5. In the "Operations" tab, add a new operation by clicking the "Add" button. Select the "Send message to users" option and choose the "Webhook" option. 6. Redirect the webhook to the Parny media type you previously created and make the necessary settings. Click the "Save" button to save the operation. With these settings, your Zabbix alarms will be forwarded to Parny, allowing you to manage them alongside your other alerts within your organization's Parny interface. ### For Zabbix v6.2 and above #### Step 1: Adding Webhook 1. Log in to the Zabbix web interface and go to the "Administration" tab. 2. Click on the "Media Types" tab and press the "Create media type" button. drawing

3. In the "Type" field, select "Webhook" and fill in the required fields. Add your Parny URL, required parameters, and the script that will send the alarm to the fields below.
drawing

**Parameters List:** - `alert_message`: `{ALERT.MESSAGE}` - `eventack`: `{EVENT.ACK.STATUS}` - `eventdate`: `{EVENT.DATE}` - `eventname`: `{ALERT.SUBJECT}` - `eventupdate`: `{EVENT.UPDATE.STATUS}` - `eventvalue`: `{EVENT.VALUE}` - `event_source`: `{EVENT.SOURCE}` - `hostip`: `{HOST.IP}` - `hostname`: `{HOST.NAME}` - `parnyUrl`: `https://zabbix.parny.io/alert/` - `severity`: `{EVENT.NSEVERITY}` - `triggerdesc`: `{TRIGGER.DESCRIPTION}` - `triggerid`: `{TRIGGER.ID}` - `url`: `{$ZABBIX.URL}` 4. Copy the script below and paste it in the **Script** section. ```js try { var params = JSON.parse(value), req = new HttpRequest(), fields = {}, resp = ""; // Correspondence between the Parny and Zabbix severity level var severityMapping = [ "info", // Not classified "info", // Information "warning", // Warning "warning", // Average "error", // High "critical" // Disaster ]; if (!severityMapping[params.severity]) { params.severity = "0"; } if (params.eventname.length < 1) { throw 'incorrect value for variable "eventname". The value must be a non-empty string.'; } if (isNaN(parseInt(params.severity)) || params.severity < 0 || params.severity > 5) { throw 'incorrect value for variable "severity". The value must be a number 0..5.'; } req.addHeader('Content-Type: application/json'); // Determine the event action and payload fields.payload = { summary: params.eventname, source: params.event_source === "1" ? "Discovery" : params.hostname + " : " + params.hostip, severity: severityMapping[params.severity] }; fields.payload.custom_details = { "Alert message": params.alert_message }; fields.client = "Zabbix"; fields.client_url = params.url; // Set the event action based on eventvalue if ((params.eventvalue == 1 && params.eventupdate == 0) || params.event_source !== "0") { fields.event_action = "trigger"; } else if (params.eventvalue == 1 && params.eventupdate == 1 && params.eventack == "Yes") { fields.event_action = "acknowledge"; } else if (params.eventvalue == 0) { fields.event_action = "resolve"; } else { throw "incorrect values. Update message without ack will not be sent."; } Zabbix.Log(4, "[Parny Webhook] Sending request:" + JSON.stringify(fields)); resp = req.post(params.parnyUrl, JSON.stringify(fields)); Zabbix.Log(4, "[Parny Webhook] Receiving response:" + resp); try { resp = JSON.parse(resp); } catch (error) { throw "incorrect response. Parny returned a non-JSON object."; } if (req.getStatus() != 200) { if (typeof resp === "object" && typeof resp.errors === "object" && typeof resp.errors[0] === "string") { throw resp.errors[0]; } else { throw "Unknown error."; } } return "OK"; } catch (error) { Zabbix.Log(3, "[Parny Webhook] Notification failed: " + error); throw "Parny notification failed: " + error; } ``` 5. Press the "Save" button to save the webhook. #### Step 2: Redirecting Alarms 1. Go to the "Administration" tab and click on the "Actions" tab. Click the "Create action" button. 2. Enter a name in the "Action" field and select the "Enabled" option. 3. In the "Conditions" tab, specify the conditions under which the alarms will be triggered. 4. For example, if you want to receive an alert when a server goes offline, select the relevant server group by choosing the "Host group" option. 5. In the "Operations" tab, add a new operation by clicking the "Add" button. Select the "Send message to users" option and choose the "Webhook" option. 6. Redirect the webhook to the Parny media type you previously created and make the necessary settings. Click the "Save" button to save the operation. With these settings, your Zabbix alarms will be forwarded to Parny, allowing you to manage them alongside your other alerts within your organization's Parny interface.
> ⚠️ **Problem Recovery ( Auto Resolve Alerts)** > In the "Message Templates" section, referring to the image below,ensure that the "Problem" and "Problem recovery" templates are the same.
drawing