Configure a webhook in Zabbix

Configure webhook endpoints so that Zabbix can use the endpoint to communicate with Incident Response.

Before you begin

Ensure you have the super admin role for the Zabbix account.

Role required: Responder, Manager, or Administrator

About this task

To configure a webhook url in Zabbix, you must download the configuration file and then import the file to create a new media type file. You need to define the media type with the parameters and the script. Zabbix uses the media type to send alerts to Incident Response. You can then configure the users, define the hosts and set the conditions for monitoring the hosts.

The steps and the screenshots used in this topic are for Zabbix 4.4. The interface and procedure may vary for Zabbix 5.4 or any other version.

Note: While this integration with a third-party product is supported, the documentation here is based upon information provided by that third-party. More current information about the operation of that third-party’s system may be available from them directly.

Procedure

  1. Log in to the Zabbix console.
    The Zabbix console.
  2. Click the Administration tab.
  3. Click the Media types tab.
  4. To import the downloaded configuration file, click Import.
    Import the configuration file for media types.
  5. In the Import file field, click Choose file, select the downloaded configuration file, and click Open.
  6. Click Import.
    A new media file is created.
    A new media file is created from the configuration file that you have imported.

    You now need to configure Incident Response endpoint url.

  7. Click the Incident Response media type record.
    Configure webhook URL in the media types file.
  8. In the url field, enter the webhook URL and click Update.
    For more information on how to get the webhook URL, see Create a webhook endpoint for Zabbix.
    Configure the media type for the users.
  9. Click the Users tab.
    Users record where you need to configure the media type.
  10. Click the user record for which you want to configure the media type.
    User details.
  11. Click the Media tab and click Add.
    Enter details of the media for the user.
  12. In the Send to field, enter the name of the user and click Add.
  13. Click Update.
    Media details successfully added for the user.

    After you create media types, create hosts that Zabbix needs to monitor. If you already have existing hosts you can skip the following steps.

  14. Optional: Click the Configuration tab and then click the Hosts tab.
    1. Click Create host.
    2. On the Hosts page, fill in the fields.
      Table 1.
      Field Description
      Name Name for the host.
      Templates Link to existing templates to the host. All entities such as items, triggers, graphs and applications, are inherited from the template.
      DNS Host DNS name.
      IP Host IP address.
      Port TCP/UDP port number for the host.
      Monitored by The host can be monitored either by a Zabbix server or by one of Zabbix proxies. Choices are as follows:
      • (no proxy): host is monitored by Zabbix server
      • Proxy name: host is monitored by Zabbix proxy “Proxy name”
      Tags Host-level tags. All problems of this host are tagged with the values entered in this field.
    3. Click Apply.
    After creating the hosts, add conditions based on which the hosts are monitored.
  15. Click the Configuration tab and then click the Actions tab.
  16. Click Create action.
  17. In the Actions page, under the Action tab, perform the following actions and click Update:
    1. Name: Enter the name of the action.
    2. New condition: Enter the condition and click Add.
    3. Enabled: Select the check box to make the conditions active.

What to do next

To see the status of a problem, navigate to Reports > Action log. To monitor or edit any problem, navigate to Monitoring > Problems.