Send notifications with Zabbix

ZBXsend Installation

 

  • Download the right version for your OS on our Download Page
  • Unzip the downloaded archive
  • Move the binary to your favored location
  • That's it, now ZBXsend is ready to send

On Linux and MacOS a configuration file will be stored in ~/.config/zbxsend/ by first use.

ZBXsend Zabbix Integration

 

  1. Write a script which passes all parameters from Zabbix to the ZBXsend commandline tool and place it in Zabbix alertscripts directory.
    For Linux systems you can download it from here.
  2. Create a new Media Type  in Zabbix (Administration/Media types)
    Name: ZBXalert
    • Name: ZBXalert
    • Type: Script
    • Script name: ZBXalert.sh
    • Script parameters:
      • {ALERT.SENDTO}
      • {ALERT.SUBJECT}
      • {ALERT.MESSAGE}
    • Enabled: true
  3. Create a new Action in Zabbix (Configuration/Actions)
    • Name: ZBXalert
    • Conditions: any condition you need
    • Operations:
      • Default operation step duration: <your individual duration>
      • Default subject: Problem: {TRIGGER.NAME}|eventid:{EVENT.ID}|status:{TRIGGER.VALUE}|severity:{TRIGGER.NSEVERITY}|hostname:{HOST.HOST}|hostgroup:{TRIGGER.HOSTGROUP.NAME}|hosttype:<YOURHOSTTYPE>
      • change <YOURHOSTTYPE> to desired host type
      • Default message: change the default text to what ever you want
      • create a new operation
        • Operation type: Send message
        • Send to User groups: add a group
        • Send to Users: add a user
        • Send only to: ZBXalert
    • Recovery Operations:
      * like "Operations"

Receive Acknowledges with ZBXconnect

ZBXconnect Installation

  • Download the latest release from Download Page
  • Install the rpm file with yum install ZBXconnect-1.0.0-1.el7.centos.x86_64.rpm
    This will create a system user "zbxalert" and install all necessary files
  • cd into installation directory cd /usr/local/ZBXalert/ZBXconnect
  • Start program ./ZBXconnect, this will ask for backend and zabbix data (with option "-n" zabbix will be skipped
  • ZBXconnect is running in foreground now, stop with ^c

Start ZBXconnect Service

systemctl enable ZBXconnect
systemctl start ZBXconnect

Stop ZBXconnect Service

systemctl stop ZBXconnect

Zabbix behind a proxy server

If your Zabbix instance is only reachable through a Proxy Server you can define the Proxy in configuration file.
Configuration file: /usr/local/ZBXalert/.config/zbxconnect/config.json

Example
"proxy": "http://proxy.yourdomain.com:8080"

Example with Proxy Authentication
"proxy": "http://user:password@proxy.yourdomain.com:8080"

Notes

ZBXconnect is currently available only for Linux

ZBXconnect is only working with direct outgoing internet connection.
A connection to our backend is not possible through a Proxy Server.
You can place ZBXconnect to a machine running in a DMZ with outgoing https allowed and Zabbix reachable through a Proxy Server.