Moogsoft Docs

Zabbix Webhook

You can configure a Zabbix webhook to post data to Moogsoft AIOps when an action occurs in Zabbix.

The Zabbix webhook integration does not include authentication. The Moogsoft AIOps integration listens without requiring password information.

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.

The integration supports Zabbix deployed in Unix environments only. 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 the permissions to:

    • Add custom alert scripts 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 AIOps. For more help, see the Zabbix documentation on sending and receiving notifications.

  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 into the Zabbix UI and add a new media type with the following details. Set the other options as appropriate for your environment.

    Field

    Value

    Name

    Moogsoft AIOps

    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.

    Enable

    True

  4. Identify an existing Zabbix user to use or create a new user for this integration. The user must be an administrator or have read access to the host groups for which you will receive events.

  5. Edit the user and add media as follows:

    Field

    Value

    Type

    Select the media type you created in step 3

    Send to

    Link generated in the Moogsoft AIOps 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 selected in step 3.

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