Zabbix Webhook

You can install the Zabbix integration to enable Moogsoft Enterprise to receive event data from Zabbix alertscripts.

When you use the integrations UI, you can only configure the visible properties. If you want to implement a more complex Zabbix webhook LAM with custom settings, see Configure the Zabbix Webhook LAM.

This integration only supports Zabbix deployments in Unix environments.

See the Zabbix documentation for details on Zabbix components.

Before You Begin

The Zabbix integration has been validated with Zabbix v3.4. Before you start to set up your integration, ensure you have met the following requirements:

  • You have an active Zabbix account with permissions to:

    • Add custom alertscripts to the Zabbix server.

    • Create new users, media types, and actions.

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

Configure the Zabbix Integration

To configure the Zabbix integration:

  1. Navigate to the Integrations tab.

  2. Click Zabbix in the Monitoring section.

  3. Provide a unique integration name. You can use the default name or customize the name according to your needs.

Configure Zabbix

Create a Zabbix media type and action to send event data to Moogsoft Enterprise. For more help, see the Zabbix documentation.

  1. Download the Moogsoft Zabbix Webhook script to your Zabbix server. Refer to the Zabbix documentation to identify the location of the script.

  2. Grant the user running the Zabbix server read access to the script.

  3. Log in to the Zabbix UI and add a new Media Type with the following details. Configure the other options as appropriate for your environment:

    Field

    Value

    Name

    Moogsoft Enterprise

    Type

    Script

    Script name

    moogsoftZabbixWebhook-1.0.sh

    Script parameters

    Add two parameters in the following order:

    {ALERT.SENDTO}

    {ALERT.MESSAGE}

    Concurrent sessions

    Set to a custom value appropriate for your environment.

    Enabled

    True

  4. Configure either an existing Zabbix user a new user for this integration. This user must have read access to the host groups you receive events for.

  5. Edit the user and add the following Media:

    Field

    Value

    Type

    Select the Media Type you created in step 3

    Send to

    Link generates in the Moogsoft Enterprise UI

    Enabled

    True

  6. Identify the action to use or create a new action for this integration.

  7. Configure the operations, recovery operations and acknowledgement operations within the action as follows:

    • Set the default message to:

      {
         "event_id": "{EVENT.ID}", 
         "trigger_status": "{TRIGGER.STATUS}", 
         "host_host": "{HOST.HOST}", 
         "trigger_id": "{TRIGGER.ID}", 
         "trigger_expression": "{TRIGGER.EXPRESSION}", 
         "trigger_name": "{TRIGGER.NAME}", 
         "trigger_nseverity": "{TRIGGER.NSEVERITY}", 
         "trigger_description": "{TRIGGER.DESCRIPTION}", 
         "event_tags": "{EVENT.TAGS}"
      }
    • Add an operation with the following details. Set the other options as appropriate for your environment:

      Field

      Value

      Operation type

      Send message

      Send to Users or Send to User Groups

      Select the user you created in step 4 or a group that contains the user.

      Send only to

      Select the media type you added in step 3.

After you complete the Zabbix configuration, Zabbix forwards events matching the action to Moogsoft Enterprise.