https://github.com/laughk/zbx2slack

Zabbix Alert Notification Script for Slack. by pure python.
https://github.com/laughk/zbx2slack

Last synced: 2 months ago
JSON representation

Zabbix Alert Notification Script for Slack. by pure python.

• Host: GitHub
• URL: https://github.com/laughk/zbx2slack
• Owner: laughk
• License: mit
• Created: 2016-03-20T18:01:59.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2016-05-21T03:12:28.000Z (over 8 years ago)
• Last Synced: 2024-08-17T02:16:19.618Z (4 months ago)
• Language: Python
• Homepage: https://pypi.python.org/pypi/zbx2slack
• Size: 47.9 KB
• Stars: 4
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
zbx2slack

================================

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

    :target: https://travis-ci.org/laughk/zbx2slack

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, 

  .. sourcecode:: sh

     $  sudo yum install python-argparse

Screenshot

------------------

Notification example.

.. image:: docs/images/screenshot1.png

Install

-----------------------

In your zabbix server,

.. sourcecode:: sh

    $ pip install zbx2slack

or you can download directly using ``wget``, ``curl``.

.. sourcecode:: sh

    $ 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``.)

      .. sourcecode:: sh

        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