Skip to main content

command-line tool for Zabbix Alert Notification to Slack.

Project description

https://travis-ci.org/laughk/zbx2slack.svg?branch=master

Zabbix Alert Notification Script for Slack. by pure python.

  • Can use by “Remote command”. But can’t use by “Media type”.

  • if use by python2.6 (like CentOS6.x), install argparse module. ex,

    $  sudo yum install python-argparse
    

Screenshot

Notification example.

docs/images/screenshot1.png

Install

In your zabbix server,

$ pip install zbx2slack

or you can download directly using wget, curl.

$ wget https://raw.githubusercontent.com/laughk/zbx2slack/master/zbx2slack.py
$ chmod +x zbx2slack.py

(if necessary, use sudo. )

set this script your zabbix server.

put file and add mode to execute.

Usage

get incoming-webhook url for your slack. from incoming webhook integration.

In the WebUI of your zabbix server.

  1. [Configureation]

  2. [Action]

  3. Choose ‘Trigger’ at Event source and Create Action.

  4. if “Recovery message” checked, Uncheck the checkbox.

  5. At [Conditions] tab, add Trigger value = OK to Conditions.
    • Trigger value = OK and Trigger value = PROBLEM are in Conditions.
  6. At [Operations] tab, add Remote Command
    • Operation type : Remote Command

    • Targeta list : any host (ex. Current host)

    • Type : Custom script

    • Execute on : Zabbix server

    • Commands:

      (if directly download, replace zbx2slack to zbx2slack.py.)

      zbx2slack \
        --zabbix-server-url "http://zabbix.example.com/zabbix" \
        --slack-botname "Zabbix Alert" \
        --slack-incoming-webhook-url "https://hooks.slack.com/services/xxxxxxxxx/xxxxxxxxx/...." \
        --trigger-id "{TRIGGER.ID}" \
        --trigger-name "{TRIGGER.NAME}" \
        --trigger-status "{TRIGGER.STATUS}" \
        --trigger-severity "{TRIGGER.SEVERITY}" \
        --event-id "{EVENT.ID}" \
        --item "{HOST.NAME1}|{ITEM.NAME1}|{ITEM.KEY1}|{ITEM.VALUE1}|{ITEM.ID1}" \
        --item "{HOST.NAME2}|{ITEM.NAME2}|{ITEM.KEY2}|{ITEM.VALUE2}|{ITEM.ID2}" \
        --item "{HOST.NAME3}|{ITEM.NAME3}|{ITEM.KEY3}|{ITEM.VALUE3}|{ITEM.ID3}"
      

LICENSE

MIT

AUTHOR

Kei Iwasaki <me@laughk.org>

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
zbx2slack-0.1.1.tar.gz (4.1 kB) Copy SHA256 hash SHA256 Source None May 21, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page