1. IMR Help
  2. Integrations
  3. Zabbix Integration Guide
Close modal icon featuring an X formed by two crossed lines.
  1. IMR Help
  2. Integrations
  3. Zabbix Integration Guide

Zabbix Integration Guide

Zabbix is a popular open source service for monitoring IT components, like servers, networks, virtual machines and cloud services.

What can Xurrent IMR do for Zabbix users?

With Zabbix's Integration, Xurrent IMR sends new Zabbix alerts to the right team and notifies them based on on-call schedules via email, text messages(SMS), phone calls(Voice), Slack, Microsoft Teams and iOS & Android push notifications, and escalates alerts until the alert is acknowledged or closed. Xurrent IMR provides your NOC, SRE and application engineers with detailed context around the Zabbix alert along with playbooks and a complete incident command framework to triage, remediate and resolve incidents with speed.

Whenever Zabbix triggers an alert based on a predefined condition, Xurrent IMR will create an incident. When that condition goes back to normal levels, Xurrent IMR will auto-resolve the incident.

You can also use Alert Rules to custom route specific Zabbix alerts to specific users, teams or escalation policies, write suppression rules, auto add notes, responders and incident tasks.

To integrate Zabbix with Xurrent IMR, complete the following steps:

In Xurrent IMR:

  1. To add a new Zabbix integration, go to Teams on Xurrent IMR and click on the team you want to add the integration to.
  2. Next, go to Services and click on the relevant Service.
  3. Go to Integrations and then Add New Integration. Give it a name and select the application Zabbix from the dropdown menu.
  4. Go to Configure under your integrations and copy the API KEY(for below Zabbix 5.0.6 version) and API URL(for Zabbix 5.0.6 and above) generated.

Select your Zabbix version

For Zabbix v5.0.6 and above

Zabbix Setup for versions below v5.0.6

For Zabbix v5.0.6 and above

In Zabbix:

Create the Xurrent IMR media type:

  1. In Zabbix Go to the Administration tab.
  1. Under Administration, go to the Media types page and click the Create Media Type button.
  2. On the following Media Type configuration page, enter Xurrent IMR for Name, Select Webhook as Type and Mention below key value pairs in Parameters. Below Parameters are mandatory to get alert in Xurrent IMR. Additional key value pairs can be included here based on your requirement.
NameValue
problem{TRIGGER.NAME}
problem_started_at{EVENT.TIME} on {EVENT.DATE}
problem_name{TRIGGER.NAME}
host{HOST.NAME}
severity{TRIGGER.SEVERITY}
original_problem_id{TRIGGER.ID}
event_status{EVENT.STATUS}
host_ip{HOST.IP1}
message{ALERT.MESSAGE}
trigger_description{TRIGGER.DESCRIPTION}
trigger_expression{TRIGGER.EXPRESSION}
trigger_status{TRIGGER.STATUS}
trigger_url{TRIGGER.URL}
trigger_value{TRIGGER.VALUE}
url
  1. Copy the script below and paste it in the Script section.
  2. Important - For Zabbix versions below v6.2 use the script below
  1. Important - For Zabbix versions v6.2 and above use the script below]
  2. Give Timeout as 30s and write a description for Xurrent IMR Media type.
  1. In Media Type, Go to Message Template and create templates for Respective message type. Like Problem, Problem recovery etc. Minimum configure for 3 types of messages (Problem, Problem Recovery and Problem Update) as shown below.
  1. In Option Tab you can configure concurrent sessions based on your use. Give 3 as attempts and 10s as Attempt interval.

Create the Xurrent IMR user and user group for alerting:

  1. Go to the Administration tab.
  2. Under Administration, go to the Users Groups page and click the Create user group button.
  3. Enter a name in the Group name field that identifies it as part of the integration. In this guide, we use Xurrent IMR Service.
  1. Grant read permissions on Host Groups to the user group, to choose which hosts will produce Xurrent IMR notifications when they have alerts, as follows:
    1. Click to the Permissions tab.
    2. Select the Read permission level and click on the Select button.
    3. Select which Host Groups you would like the Xurrent IMR to have read access to for monitoring, then click the Select button. In this example, we grant the Xurrent IMR group read access to the Linux servers and Zabbix servers.
  1. Click on Add to save your new user group.
  2. Click on the Users tab (under Administration) and click the Create User button.
  3. Fill in the details of this new user, and call it Xurrent IMR User. The default settings for Xurrent IMR User should suffice as this user will not be logging into Zabbix.
  1. Click the Select button next to Groups.
  1. Click on the Media tab and, inside of the Media box, click the Add button.
  2. Select the media type that you have created earlier, and paste the URL that you have copied above in the Send to section.
  1. Create the alert action:
  2. Go to the Configuration tab.
  3. Under Configuration, go to the Trigger Action in the Action tab, and click on Create Action.
  4. Give the action a name such as Xurrent IMR Notifications.
  1. Go to the Operations tab, and configure as follows:
    1. Under Send to user groups and Send to users, add the User and User group that has been created for Xurrent IMR.
    2. Select the Xurrent IMR Media type that you have created in the earlier step.
  1. Repeat the above step for Recovery and Update Operations.
  1. Click the Add button at the bottom of any of the action tabs to save your action.
  2. Zabbix is now integrated with Xurrent IMR.

Zabbix Setup for versions below v5.0.6

In Zabbix:

  1. Clone this Repository
  2. git clone https://github.com/Zenduty/zabbix-zenduty-script.git
  3. Copy the Script file(zabbix_Xurrent IMR_integration.sh) and paste it into Zabbix server's AlertScriptsPath. You can see your AlertScriptsPath path from Zabbix server configuration file. Give executable permission to this file for the Zabbix user.

Create the Xurrent IMR media type:

  1. In Zabbix Go to the Administration tab.
  1. Under Administration, go to the Media types page and click the Create Media Type button.
  1. On the following Media Type configuration page, enter Xurrent IMR for Name, Select script in type and write the name of the file which you have pasted in AlertScriptPath.
  2. Click the Add link in the Script parameters box two times to create two configurable parameters for the script, and enter the following template values for the two parameters in exactly the following order:
  3. Click the Add button at the bottom to save and create the Xurrent IMR media type.

Create the Xurrent IMR user and user group for alerting:

  1. Go to the Administration tab.
  1. Under Administration, go to the Users Groups page and click the Create user group button.
  1. Enter a name in the Group name field that identifies it as part of the integration. In this guide, we use Xurrent IMR Service.
  1. Grant read permissions on Host Groups to the user group, to choose which hosts will produce Xurrent IMR notifications when they have alerts, as follows:
    1. Click to the Permissions tab.
    2. Select the Read permission level and click on the Select button.
    3. Select which Host Groups you would like the Xurrent IMR to have read access to for monitoring, then click the Select button. In this example, we grant the Xurrent IMR group read access to the Linux servers and Zabbix servers.
  1. Click on Add to save your new user group.
  2. Click on the Users tab (under Administration) and click the Create User button.
  3. Fill in the details of this new user, and call it Xurrent IMR User. The default settings for Xurrent IMR User should suffice as this user will not be logging into Zabbix.
  1. Click the Select button next to Groups.
  1. Click on the Media tab and, inside of the Media box, click the Add button.
  1. Select the type that you have created in step 7, paste the key that you have copied from Xurrent IMR in Send to.

Create the alert action:

  1. Go to the Configuration tab.
  2. Under Configuration, go to the Actions page, and click on Create Action.
  3. Give the action a Name such as Xurrent IMR Notifications.
  4. Go to the Operations tab, and configure as follows:
    1. Delete the contents of the Default message field, and insert the following:
    2. Under Operations, click New, and in the resulting operation details configuration, under Send to User groups, click Add. In the pop-up window, check the box by the Xurrent IMR service user group, click Select, and then click Add at the bottom of the Operations section.
  1. Go to the Recovery Operations tab and configure the rest of the options in the same way as in steps 1-2 in the Operations configuration (see above). For instance, the content of the Recovery message should be the same as the Default message.
  2. Go to the Acknowledgment Operations tab and configure the rest of the options in the same way as with the Operations and Recovery operations, above.
  1. Click the Add button at the bottom of any of the action tabs to save your action.
  2. Zabbix is now be integrated with Xurrent IMR.

In this article

Heading 2
Heading 3
Heading 4
Heading 5
Heading 6