Metadata-Version: 2.1
Name: nagios-notification-jabber
Version: 1.0.5
Summary: Notifications via jabber Nagios plugin
Home-page: https://github.com/vint21h/nagios-notification-jabber
Author: Alexei Andrushievich
Author-email: vint21h@vint21h.pp.ua
License: GPLv3+
Download-URL: https://github.com/vint21h/nagios-notification-jabber/archive/1.0.5.tar.gz
Keywords: nagios,jabber,notification-jabber,plugin,notification-jabber-plugin
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Environment :: Plugins
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: Utilities
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
Requires-Dist: slixmpp (>=1.7.0)
Provides-Extra: test
Requires-Dist: attrs (==20.3.0) ; extra == 'test'
Requires-Dist: bandit (==1.7.0) ; extra == 'test'
Requires-Dist: black (==20.8b1) ; extra == 'test'
Requires-Dist: check-manifest (==0.46) ; extra == 'test'
Requires-Dist: check-wheel-contents (==0.2.0) ; extra == 'test'
Requires-Dist: contextlib2 (==0.6.0.post1) ; extra == 'test'
Requires-Dist: coverage (==5.5) ; extra == 'test'
Requires-Dist: coveralls (==3.0.1) ; extra == 'test'
Requires-Dist: darglint (==1.7.0) ; extra == 'test'
Requires-Dist: dodgy (==0.2.1) ; extra == 'test'
Requires-Dist: dotenv-linter (==0.2.0) ; extra == 'test'
Requires-Dist: flake8-annotations-complexity (==0.0.6) ; extra == 'test'
Requires-Dist: flake8-annotations-coverage (==0.0.5) ; extra == 'test'
Requires-Dist: flake8-bugbear (==21.3.2) ; extra == 'test'
Requires-Dist: flake8-comprehensions (==3.3.1) ; extra == 'test'
Requires-Dist: flake8-docstrings (==1.5.0) ; extra == 'test'
Requires-Dist: flake8-fixme (==1.1.1) ; extra == 'test'
Requires-Dist: flake8 (==3.9.0) ; extra == 'test'
Requires-Dist: interrogate (==1.3.2) ; extra == 'test'
Requires-Dist: isort (==5.7.0) ; extra == 'test'
Requires-Dist: mypy (==0.812) ; extra == 'test'
Requires-Dist: pep8-naming (==0.11.1) ; extra == 'test'
Requires-Dist: pre-commit-hooks (==3.4.0) ; extra == 'test'
Requires-Dist: pre-commit (==2.11.1) ; extra == 'test'
Requires-Dist: pygments (==2.8.1) ; extra == 'test'
Requires-Dist: pylint (==2.7.2) ; extra == 'test'
Requires-Dist: pyroma (==3.1) ; extra == 'test'
Requires-Dist: pytest-cov (==2.11.1) ; extra == 'test'
Requires-Dist: pytest-mock (==3.5.1) ; extra == 'test'
Requires-Dist: pytest-tldr (==0.2.4) ; extra == 'test'
Requires-Dist: pytest (==6.2.2) ; extra == 'test'
Requires-Dist: readme-renderer (==29.0) ; extra == 'test'
Requires-Dist: removestar (==1.2.2) ; extra == 'test'
Requires-Dist: seed-isort-config (==2.2.0) ; extra == 'test'
Requires-Dist: tabulate (==0.8.9) ; extra == 'test'
Requires-Dist: tox-gh-actions (==2.4.0) ; extra == 'test'
Requires-Dist: tox-pyenv (==1.1.0) ; extra == 'test'
Requires-Dist: tox (==3.23.0) ; extra == 'test'
Requires-Dist: twine (==3.4.0) ; extra == 'test'
Requires-Dist: yesqa (==1.2.2) ; extra == 'test'

.. nagios-notification-jabber
.. README.rst

A nagios-notification-jabber documentation
==========================================

|GitHub|_ |Coveralls|_ |Requires|_ |pypi-license|_ |pypi-version|_ |pypi-python-version|_ |pypi-format|_ |pypi-wheel|_ |pypi-status|_

    *nagios-notification-jabber is a Nagios-plugin that send Nagios notifications via jabber*

.. contents::

Installation
------------
* Obtain your copy of source code from the git repository: ``$ git clone https://github.com/vint21h/nagios-notification-jabber.git``. Or download the latest release from https://github.com/vint21h/nagios-notification-jabber/tags/.
* Run ``$ python ./setup.py install`` from the repository source tree or unpacked archive. Or use pip: ``$ pip install nagios-notification-jabber``.

Configuration
-------------
* Read and understand Nagios documentation.
* Create Nagios commands definitions like this:

::

    # "host-notify-by-jabber" command
    define command
    {
        command_name    host-notify-by-jabber
        command_line    /usr/bin/notification_jabber.py -r $CONTACTPAGER$ -m "Host '$HOSTALIAS$' is $HOSTSTATE$ - Info: $HOSTOUTPUT$"
    }

    # "service-notify-by-jabber" command
    define command
    {
        command_name    service-notify-by-jabber
        command_line    /usr/bin/notification_jabber.py -r $CONTACTPAGER$ -m "$NOTIFICATIONTYPE$ $HOSTNAME$ $SERVICEDESC$ $SERVICESTATE$ $SERVICEOUTPUT$ $LONGDATETIME$"
    }

* Add to your contact definition option ``pager`` with your Jabber ID value and add to ``service_notification_commands`` and ``host_notification_commands`` contact definition options ``service-notify-by-jabber`` and ``host-notify-by-jabber`` values respectively.

* Copy ``/usr/share/doc/nagios-notification-jabber/notification_jabber.ini`` to ``/etc/nagios`` with your nagios bot credentials. Attention: nagios user must have ``notification_jabber.ini`` read permissions.

nagios-notification-jabber is able to send message to MUC rooms without any additional configuration, just specify MUC room ID as a notification recipient.
Also yu can specify notification resource just by adding it to JID in the config file: ``jid = nagios@example.com/bot``

Licensing
---------
nagios-notification-jabber is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
For complete license text see COPYING file.

Contacts
--------
**Project Website**: https://github.com/vint21h/nagios-notification-jabber/

**Author**: Alexei Andrushievich <vint21h@vint21h.pp.ua>

For other authors list see AUTHORS file.


.. |GitHub| image:: https://github.com/vint21h/nagios-notification-jabber/workflows/build/badge.svg
    :alt: GitHub
.. |Coveralls| image:: https://coveralls.io/repos/github/vint21h/nagios-notification-jabber/badge.svg?branch=master
    :alt: Coveralls
.. |Requires| image:: https://requires.io/github/vint21h/nagios-notification-jabber/requirements.svg?branch=master
    :alt: Requires
.. |pypi-license| image:: https://img.shields.io/pypi/l/nagios-notification-jabber
    :alt: License
.. |pypi-version| image:: https://img.shields.io/pypi/v/nagios-notification-jabber
    :alt: Version
.. |pypi-python-version| image:: https://img.shields.io/pypi/pyversions/nagios-notification-jabber
    :alt: Supported Python version
.. |pypi-format| image:: https://img.shields.io/pypi/format/nagios-notification-jabber
    :alt: Package format
.. |pypi-wheel| image:: https://img.shields.io/pypi/wheel/nagios-notification-jabber
    :alt: Python wheel support
.. |pypi-status| image:: https://img.shields.io/pypi/status/nagios-notification-jabber
    :alt: Package status
.. _GitHub: https://github.com/vint21h/nagios-notification-jabber/actions/
.. _Coveralls: https://coveralls.io/github/vint21h/nagios-notification-jabber?branch=master
.. _Requires: https://requires.io/github/vint21h/nagios-notification-jabber/requirements/?branch=master
.. _pypi-license: https://pypi.org/project/nagios-notification-jabber/
.. _pypi-version: https://pypi.org/project/nagios-notification-jabber/
.. _pypi-python-version: https://pypi.org/project/nagios-notification-jabber/
.. _pypi-format: https://pypi.org/project/nagios-notification-jabber/
.. _pypi-wheel: https://pypi.org/project/nagios-notification-jabber/
.. _pypi-status: https://pypi.org/project/nagios-notification-jabber/


