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.2. 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

The Zabbix integration has been validated with Zabbix v3.4 . Configure the Zabbix integration in Moogsoft AIOps as follows:

  1. Navigate to the Integrations tab.
  2. Click Zabbix in the Monitoring section.
  3. Follow the instructions to create an integration name.

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 script's location.
  2. Grant the user running the Zabbix server read access to the script .
  3. Log into the Zabbix UI and add a new m edia 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 m edia 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 o perations, 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 o peration 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.