semvec/pypi-packages huggingface dataset:
zbx2slack 0.1.1
command-line tool for Zabbix Alert Notification to Slack.
License: MIT License

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 <https://my.slack.com/services/new/incoming-webhook>`_.


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 <me@laughk.org>