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
    (Don't forget to edit the file and change the custom settings)
  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.