LogoLogo
Ops IntelligenceAsset IntelligenceObservabilityRobotic Data
  • Introduction
  • How it Works
  • Getting Started
  • Glossary
  • Implementer Guide
    • cfxDimensions Installation
      • Hardware and Software
      • cfxDimenions on VMware vSphere
        • Post cfxDimensions VM Installation
      • SSL Certificates Installation
      • cfxDimensions Setup & Install
        • Known Issues
      • cfxDimensions High Availability
        • GlusterFS Operations
        • Minio Operations
        • MariaDB Operations
      • cfxDimensions Start, Stop order
      • Macaw CLI
        • macaw CLI Installation
          • macaw CLI v2.1.17
        • macaw setup
        • macaw infra
        • macaw platform
        • macaw user
        • macaw application
        • macaw status
        • macaw services
        • macaw clambda
        • macaw techsupport
        • macaw backup
        • macaw restore
        • macaw reset
      • Release Notes
        • cfxDimensions v2.0.3
        • cfxDimensions v2.1.17
        • cfxDimensions v2.2.20
    • cfxDimensions Backup & Restore
    • cfxOIA Installation
    • cfxOIA Application Services
    • cfxOIA Release Notes
      • cfxOIA v5.1.5
      • cfxOIA v5.1.5.2
      • cfxOIA v5.1.5.3
      • cfxOIA v6.0.0
      • cfxOIA v6.1.0
  • KEY FEATURES GUIDE
    • Incident Management
      • Incidents Overview
      • Create Incident
      • Incident States
      • Accessing Incident
        • Stack
        • Alerts
        • Metrics & Logs
        • Insights
        • Collaboration
        • Diagnostics
        • Remediation
        • Attachments
        • Activities
      • Incident Actions
    • Alert Management
      • Alerts Overview
      • Alert Analytics
      • Alert States
      • Alert Sources
    • Advanced Alert Configuration
      • Alert Mappings
      • Alert Enrichment
      • Alert Correlation & Suppression
        • Creating and Updating Correlation Policies
        • Creating and Updating Suppression Policies
        • Correlation Recommendations
    • ML Driven Operations
    • Data Exploration
    • RDA (Robotic Data Automation)
      • Accessing UI
      • Sources Addition and Configuration
      • Check Connectivity
      • Proxy Settings
      • Explore
        • Bots
        • Pipelines
        • Schedules
        • Jobs
    • Analytics
  • UI & PORTAL FEATURES GUIDE
    • Filters Management
    • Customizing Table Views
    • Exporting Data
  • Administrator Guide
    • User Roles & RBAC
    • Collaboration
    • Projects
      • How to add Project
      • Configure Project
        • Stacks
        • Incidents
        • Alerts
        • Messages
          • Message Endpoints
            • Rest Data Consumer
            • Kafka Message Consumer
            • ServiceNow SaaS
            • Webhook with Basic Authentication
          • Message Mappings
        • Teams
        • Datasources
        • Resolution Codes
  • INTEGRATIONS GUIDE
    • Integrations Overview
    • Featured Integrations
      • AppDynamics
      • Dynatrace
      • Microsoft Teams
      • NetApp Cluster Mode
      • NetApp 7 Mode
      • Prometheus
      • ServiceNow
      • Slack
      • Splunk Enterprise
      • VMware vCenter
      • Zabbix
      • NodePing
      • Nagios XI
      • Check MK
      • VMware vRealize Operations
      • PRTG Network Monitor
      • Grafana
      • AWS Cloudwatch
      • ManageEngine OpManager
      • PagerDuty
Powered by GitBook
On this page
  • Prerequisites:
  • Configure Zabbix for Alert notifications over a Webhook:
  • Zabbix Alert Field Mappings:
  1. INTEGRATIONS GUIDE
  2. Featured Integrations

Zabbix

PreviousVMware vCenterNextNodePing

Last updated 3 years ago

Prerequisites:

This section explains on how to integrate and ingest alerts from Zabbix monitoring tool into CloudFabrix AIOPs platform.

Zabbix supports alert notifications via email, sms, script or webhook. CloudFabrix AIOPs platform uses webhook notification method from Zabbix to receive and ingest the alerts or events.

Click here for to create a Webhook URL for Zabbix alert notifications in CloudFabrix OIA application.

Configure Zabbix for Alert notifications over a Webhook:

Step 1: Login to Zabbix monitoring tool through web-browser UI

Step 2: On left menu, expand 'Administration' and click on 'Media types'

Step 3: Click on 'Create media type'

Step 4: Click on ‘Media type’, Enter name for the Webhook and select 'Type' as 'Webhook' from the drop down.

Step 5: As highlighted in the above screen, add the below parameters.

  1. Alert_Date => {EVENT.DATE}

  2. Alert_HostAddress => {HOST.IP}

  3. Alert_Hostname => {HOST.NAME}

  4. Alert_RecoveryDate => {EVENT.RECOVERY.DATE}

  5. Alert_RecoveryTime => {EVENT.RECOVERY.TIME}

  6. Alert_RecoveryName => {EVENT.RECOVERY.NAME}

  7. Alert_RecoveryTags => {EVENT.RECOVERY.TAGSJSON}

  8. Alert_ServiceDescription => {EVENT.NAME}

  9. Alert_ServiceEventId => {EVENT.ID}

  10. Alert_ServiceOutput => {EVENT.OPDATA}

  11. Alert_ServiceSeverity => {EVENT.SEVERITY}

  12. Alert_Time => {EVENT.TIME}

  13. Alert_Status => {EVENT.STATUS}

  14. Alert_Message => {ALERT.MESSAGE}

  15. Alert_HostGroup => {TRIGGER.HOSTGROUP.NAME}

  16. Alert_Tags => {EVENT.TAGSJSON}

  17. Alert_Template => {TRIGGER.TEMPLATE.NAME}

  18. Alert_WebHookURL => {ALERT.SENDTO}

Step 6: Edit the 'Script' field and add the below Java script

var params = JSON.parse(value),
req = new CurlHttpRequest(),
resp;
req.AddHeader('Content-Type: application/json');
//req.AddHeader('Authorization: Basic <base64encoded - username:password>');
//Below example when HTTP Basic authentication is used for Webhook, 
//Username: cfxuser, Password: cfxuser
//req.AddHeader('Authorization: Basic Y2Z4dXNlcjpjZnh1c2Vy');

var params = JSON.parse(value);
payload = {};
payload.Alert_ServiceEventId = params.Alert_ServiceEventId;
payload.Alert_HostName = params.Alert_HostName;
payload.Alert_HostAddress = params.Alert_HostAddress;
payload.Alert_Date = params.Alert_Date;
payload.Alert_Time = params.Alert_Time;
payload.Alert_ServiceSeverity = params.Alert_ServiceSeverity;
payload.Alert_ServiceDescription = params.Alert_ServiceDescription;
payload.Alert_ServiceOutput = params.Alert_ServiceOutput;
payload.Alert_Message = params.Alert_Message;
payload.Alert_RecoveryDate = params.Alert_RecoveryDate;
payload.Alert_RecoveryTime = params.Alert_RecoveryTime;
payload.Alert_RecoveryName = params.Alert_RecoveryName;
payload.Alert_RecoveryTags = params.Alert_RecoveryTags;
payload.Alert_Status = params.Alert_Status;
payload.Alert_HostGroup = params.Alert_HostGroup;
payload.Alert_Tags = params.Alert_Tags;
payload.Alert_Template = params.Alert_Template;
resp = req.Post(params.Alert_WebHookURL,
JSON.stringify(payload)
    );
return resp;

Step 7: Click on 'Apply' to save the Script

Step 8: Make sure 'Enabled' is check-box is checked.

Step 9: Click on 'Message Templates' tab and click on 'Add' as show in the below screen

Step 10: From 'Message Type' drop down menu, select 'Problem', Enter Subject as 'Problem: {EVENT.NAME}, leave 'Message' as blank and click on 'Add'

Step 11: Click on 'Add' to add another Message Template. From 'Message Type' drop down menu, select 'Problem recovery', Enter Subject as 'Resolved in {EVENT.DURATION}: {EVENT.NAME}, leave 'Message' as blank and click on 'Add'

Step 12: Click on 'Add' to save the Webhook Media Type.

Step 13: On left menu, expand 'Administration' and click on 'User groups' to add a new user group with read-only permissions.

Step 14: Click on 'Create user group'

Step 15: Click on 'User group' tab, enter 'Group name' as 'cfx_notifications_group'

Step 16: Click on 'Permissions' tab, and click on 'Select' to select all groups

Step 17: Select all 'Host Groups' as shown below and click 'Select'.

Step 18: Select 'Read' permission, select 'Include subgroups' check-box and click on 'Add' button.

Step 19: On left menu, expand 'Administration' and click on 'Users' to add a new user with Read-only permissions.

Step 20: Click on 'Create user'.

Step 21: Click on 'User' tab, enter Alias as 'cfx_notification_user'. Click on 'Select' to select the 'cfx_notifications_group' that was create above (Step 15). Enter user password.

Step 22: Click on 'Media' tab and click on 'Add' button as show in the below screen to add Webhook details.

Step 23: Click 'Add' button to complete in adding the Webhook notification in Zabbix.

Testing the Webhook notification: Under 'Media Type' section of the menu, select the Webhook that was created above and click on 'Test'

Note: If there is a test failure with error message 'cannot get URL: Couln't resolve hostname, httprequest.c.323 internal', edit the Webhook media type and enter the Webhook URL as a value for 'Alert_WebHookURL' attribute, save it and try the 'Test' connection again.

Zabbix Triggers: Please make sure to select 'PROBLEM event generation mode' as 'single' for sending Alert notifications to CloudFabrix AIOPs system. When 'multiple' option is selected, Zabbix generates a new event ID everytime it evaluates the condition of the trigger. CloudFabrix AIOps system uses the event ID to track the lifecycle of an event from open to closure. Below is the same screen for a reference.

Zabbix Alert Field Mappings:

Zabbix Field

CFX OIA Field

Mandatory

Alert_ServiceEventId

key

Yes

Alert_ServiceDescription /

Alert_ServiceOutput

message

Yes

Alert_HostName

assetName

Yes

Alert_HostAddress

assetIpAddress

Yes

Alert_Status

status

(=OPEN if PROBLEM

else CLEARED)

Yes

Alert_Date /

Alert_Time

raisedAt

Yes

Alert_RecoveryDate /

Alert_RecoveryTime

clearedAt

Yes

Alert_Tags /

Alert_RecoveryTags

Tags

(additional attributes)

No

Alert_Template

alertType

Yes

Alert_HostGroup

Customer_name

(for enrichment)

No

Alert_ServiceState

severity

Yes

Step 23: Select 'CloudFabrix-Webhook' that was created in one of the step above (Step 4), and for 'Send to' field add the Webhook URL (created under section), leave the rest of fields as shown in below screen and Click 'Add'

Alert Sources
Alert Sources