Zabbix Integration

You can configure the Zabbix webhook to post notifications to the Events API when events of interest occur. Read the Zabbix docs for details on Zabbix components.

Before You Begin

This integration was validated with Zabix version 5. Before you start to set up your integration, ensure you have met the following requirements:

  • You have an active Zabbix account.

  • You have the necessary permissions to create media types, message templates, and users in Zabbix.

  • Zabbix can make requests to external endpoints over port 443. This is the default.

Zabbix setup

To set up Zabbix, do the following:

Define the Moogsoft media type

To create a new media type in Zabbix, do the following:

  1. Download the following file, which defines the format of the data that Zabbix will send to Moogsoft.

    Download Zabbix media file

  2. Log in to your Zabbix instance.

  3. Choose Administration > Media Types.

  4. In the Media Types window, click Import in the top-right corner.

  5. Select the file you just downloaded, then click Import. Moogsoft media type now appears as a link in the Media Types list.

  6. Return to the Media Types page, click Moogsoft, and specify the API_KEY and URL parameters.

    To determine these fields, do the following.

    1. Go to Integrations > Events API in the Moogsoft UI.

    2. Copy and paste the API key and URL from the example curl request.

  7. The parameters are auto-defined from the data type file you imported. The check, description, service, severity, and source parameters are required.

    zabbix-parameters.png
  8. Click Update.

Specify the message templates for problem notifications

The next step is to specify the message templates to use when Zabbix sends a problem notification to Moogsoft.

  1. Return to the edit page for the Moogsoft media type.

  2. Go to the Message Templates tab.

  3. Add the default templates for Problem, Problem Recovery, and Problem Update.

    zabbix-message-templates.png
  4. Click Update. This returns you to the Media Types page.

Test the media type and message templates

You should test your media and message settings after setup. Navigate to the Moogsoft entry in the Media Types list, then click Test on the right.

You should see a "Media type test successful" message, which means that Zabbix sent a payload to Moogsoft and got a successful response.

Create a user to receive event notifications

Now you need to create a user that receives Moogsoft notifications. Do the following:

  1. Go to Administration > Users.

  2. Click Create User in the upper-right corner. Then specify the following:

    1. Alias = Moogsoft

    2. Click Select, next to Groups, and select No access to the front end.

    3. Click Password and enter any string.

      The password is required to set up the user, but a valid password is not required here. The API key you specified earlier provides the authentication needed to post requests to Moogsoft.

    4. Click Add.

  3. Specify the media type for this user:

    1. Click Media. The Media popup appears.

    2. For Type, select Moogsoft.

    3. For Send to, type "N/A".

      This field is required but the value is not needed or used for this integration.

    4. Leave the other settings at their defaults and click Add.

  4. Specify the user permissions:

    1. Click Permissions.

    2. For User Type, select Zabbix Super Admin.

    3. Click Add. Then click Update.

Define the trigger actions

Now that you have the media type and user defined, you need to define the actions that trigger problem notifications. In this case, you will define one action that sends all notifications to Moogsoft.

Do the following:

  1. Go to Configuration > Actions. Then click Create action in the top-right corner.

  2. For the Name, enter Send to Moogsoft.

  3. Optionally, you can filter the events that Zabbix sends: Click Add, under Conditions, and define the specific conditions for sending events.

  4. Click Add.

Send events to Moogsoft

To set up Zabbix to send events, do the following.

  1. Go to Configuration > Actions. Then click Create Action in the top right.

  2. In the Name field, enter Send to Moogsoft.

  3. Click Operations and specify the actions to take when an event, update, or recovery occurs.

    1. In Operations, click Add. The Operation Details popup appears.

    2. In Send to Users, click Add and select the Moogsoft user.

    3. In the "Default media type" pulldown, select Moogsoft.

    4. Click Add.

    5. Repeat the previous steps for Recovery operations and Update operations.