Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Alignak - Receiver module to collecting and decoding NSCA checks

Project Description

Alignak NSCA module for the Alignak Receiver


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
cd alignak-module-nsca
sudo pip install . -e

Note: using `sudo python 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.


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 are the common way to raise an information.

Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
alignak_module_nsca-1.0.0.tar.gz (25.7 kB) Copy SHA256 Checksum SHA256 Source Sep 12, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting