Metadata-Version: 1.1
Name: alignak_module_nsca
Version: 0.3.3
Summary: Alignak - Receiver module to collecting and decoding NSCA checks
Home-page: https://github.com/Alignak-monitoring-contrib/alignak-modules-nsca
Author: Frédéric Mohier
Author-email: frederic.mohier@alignak.net
License: GNU Affero General Public License, version 3
Description: Alignak NSCA receiver Module
        ============================
        
        *Alignak NSCA module for the Alignak Receiver*
        
        .. image:: https://landscape.io/github/Alignak-monitoring-contrib/alignak-module-nsca/develop/landscape.svg?style=flat
            :target: https://landscape.io/github/Alignak-monitoring-contrib/alignak-module-nsca/develop
            :alt: Development code static analysis
        
        .. image:: https://coveralls.io/repos/Alignak-monitoring-contrib/alignak-module-nsca/badge.svg?branch=develop
            :target: https://coveralls.io/r/Alignak-monitoring-contrib/alignak-module-nsca
            :alt: Development code tests coverage
        
        .. image:: https://badge.fury.io/py/alignak_module_nsca.svg
            :target: https://badge.fury.io/py/alignak-module-nsca
            :alt: Most recent PyPi version
        
        .. image:: https://img.shields.io/badge/IRC-%23alignak-1e72ff.svg?style=flat
            :target: http://webchat.freenode.net/?channels=%23alignak
            :alt: Join the chat #alignak on freenode.net
        
        .. image:: https://img.shields.io/badge/License-AGPL%20v3-blue.svg
            :target: http://www.gnu.org/licenses/agpl-3.0
            :alt: License AGPL v3
        
        Installation
        ------------
        
        The installation of this module will copy some configuration files in the Alignak default configuration directory (eg. */usr/local/etc/alignak*). The copied files are located in the default sub-directory used for the modules (eg. *arbiter/modules*).
        
        From PyPI
        ~~~~~~~~~
        To install the module from PyPI:
        ::
        
           sudo pip install alignak-module-nsca
        
        
        From source files
        ~~~~~~~~~~~~~~~~~
        To install the module from the source files (for developing purpose):
        ::
        
           git clone https://github.com/Alignak-monitoring-contrib/alignak-module-nsca
           cd alignak-module-nsca
           sudo pip install . -e
        
        **Note:** *using `sudo python setup.py install` will not correctly manage the package configuration files! The recommended way is really to use `pip`;)*
        
        
        Short description
        -----------------
        
        This module for Alignak receiver reads and decodes NSCA passive notifications to dispatch them into the Alignak framework.
        
        
        Features / Known limitations
        ----------------------------
        
        Handles NSCA version 3 protocol
        
        Check the NSCA packet timestamp for staled data (older than a certain amount of time) or 'future' data (future timestamp).
        
        Consider the `host_check` service received data as a passive host check. Useful if your NSCA client does not handle correctly the passive host check syntax ;)
        
        The NSCA module implementation is currently limited to the "xor" obfuscation/encryption.
        
        
        Configuration
        -------------
        
        Once installed, this module has its own configuration file in the */usr/local/etc/alignak/arbiter_cfg/modules* directory.
        The default configuration file is *mod-nsca.cfg*. This file is commented to help configure all the parameters.
        
        The default configuration is convenient for 'recent' NSCA client implementing NSCA version 3.
        
        This configuration has been tested with Linux send_nsca 2.9.1 and Windows NSClient most recent versions (from 0.4.1).
        
        **Note:**  Received NSCA packets which are not containing version 3 information are dropped by the module!
        
        To configure Alignak receiver to use this module:
        
        - edit your receiver daemon configuration file
        - add the `module_alias` parameter value (`nsca`) to the `modules` parameter of the daemon
        
        To set up several NSCA listeners:
        
        - copy the default configuration to another file,
        - change the module alias parameter (`nsca_bis`)
        - change the listening port
        - edit your receiver daemon configuration file
        - add the new `module_alias` parameter value (`nsca_bis`) to the `modules` parameter of the daemon
        
        
        Bugs, issues and contributing
        -----------------------------
        
        Contributions to this project are welcome and encouraged ... `issues in the project repository <https://github.com/alignak-monitoring-contrib/alignak-module-nsca/issues>`_ are the common way to raise an information.
        
Keywords: a,l,i,g,n,a,k, ,m,o,n,i,t,o,r,i,n,g, ,m,o,d,u,l,e, ,p,a,s,s,i,v,e
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: System :: Systems Administration
