Pointers

• The integration happens between a TaskCall service and Zabbix.
• This integration works for Zabbix 5.0 and above.
• Incidents will automatically resolve in TaskCall when metrics fall back within the normal threshold.
• Incidents can be acknowledged and their urgency can be updated from Zabbix to TaskCall.
• At the moment, alerts and actions can only be received from Zabbix to TaskCall.

In TaskCall

1. Go to Configurations > Services . Select the service you want to integrate with.
2. Once you are on the Service details page, go to the Integrations tab. Click on New Integration.
3. Give the integration a name.
4. From the integration types, select the top radio button indicating that you are trying to use a built-in integration.
5. From the list of built-in integrations, select Zabbix.
6. Click Save.
7. Copy the Integration Key that is issued for the integration.

In Zabbix

There are several steps that needs to be completed to set up the integration in Zabbix before alerts cab be triggered on TaskCall. Firstly, a new Global Macro has to be created if it has not been already. Then a new Media Type has to be created for TaskCall. Lastly a new user has to be created who the newly created media type has to be associated to. This user can then be assigned to Actions that will trigger alerts to TaskCall.

1. First, you need to create a new Global Macro.
2. Go to Administration > General . From the dropdown list select Macros. Click Add.
3. In the Macro field enter {$ZABBIX.URL} and enter your frontend URL for Zabbix as the value. Click Update.
   
   
   
   
4. Now, you need to create a new media type for TaskCall.
5. "Media type" in Zabbix allows you to define a channel of communication with its own script. We already have media file for Zabbix prepared. You will simply need to download it and then import it into Zabbix.
6. Go to TaskCall Zabbbix Integration repo on github and download the latest release of the TaskCall Zabbix media file. If your account is hosted in the EU region you must download the taskcall_zabbix_media.xml file. If your account is hosted in the US region, you must download the taskcall_zabbix_media_us.xml file.
7. Then go to Administration > Media types. Click Import.
   
   
   
   
8. Upload the taskcall-zabbix-media.xml file you downloaded. Click Import.
9. Once the file is imported successfully, go back to the Media types page. You should see TaskCall appear as a media type. Click on it.
10. Find the integrationkey parameter and replace its value with the Integration Key you copied over from TaskCall. Then click Update.
    
    
    
    
11. Now we are going to create a TaskCall user who actions can be assigned to.
12. Go to Administration > User groups > Create user group. Create a new user group and ensure that the group has Read-write permission.
    
    
    
    
13. Go to Administration > Users > Create user.
14. Give the user a name, associate it to the user group you created earlier and give it a password (this will not be used, but is a mandatory requirement on Zabbix).
    
    
    
    
15. Move to the Media tab on the form. Click the inner underlined Add button. A pop-up Media screen will appear. Select TaskCall as the Type. For Send to, just enter a random text (it is never used, but it is a requirement in Zabbix). Click Add.
    
    
    
    
16. Click the Add button at the bottom of the user page to save the user.
17. You are TaskCall integration is now ready. You can use this user in any Action to trigger alerts to TaskCall.

Trigger Action from Zabbix

If you have not used Zabbix before, it might be slightly time consuming to understand how triggers work since there are several steps involved. We have put together the steps here to help you get started. At first you will need to create an Action and then a Trigger on the host.

1. Go to Configuration > Actions . Click the Create action button on the top right corner.
2. Give the action a name and define the conditions that will determine it.
   
   
   
   
3. Go to the Operations tab on the form. In the Operations field click Add.
4. In the Operation details tab that pops up set the Operation type as Send message , add the TaskCall User you had created earlier in the Send to users section and select TaskCall in the Send only to section. Click Add.
   
   
   
   
5. Repeat this process for the Recovery operations and the Update operations to allow incidents in TaskCall to automatically resolve and sync up with Problems reported on Zabbix.
6. Click the blue Add button to finish creating the action.
7. Now to set up the trigger, go to Configuration > Hosts. On the host you want to create the trigger on, select Triggers.
   
   
   
   
8. Once you are on the triggers page, click the Create trigger button on the top right corner.
9. Define the trigger according to your needs. Once you are done, click Add. If you need more help then please refer to Zabbix's own documentation on Triggers.
   
   
   
   
10. That is it! You have fully set up Zabbix to direct triggers to TaskCall.