NSClient++
C++ C# Python Shell CMake JavaScript Other
Permalink
Failed to load latest commit information.
build Fixed empty response on submit Jan 15, 2017
clients removed nscapi_protobuf_types (as it is not used and reorganized some… Jan 15, 2017
debian First prototype of debian packages Dec 3, 2016
docs Some more (post) cr-lf fixes Oct 17, 2016
ext Switched from rst to markdown for protobuf documentor Jan 15, 2017
files Changed cr/lf on all files locally Oct 17, 2016
include check_nscp_nrpe returns wrong status code (for unknown) fixes #359 Jan 18, 2017
installers Updated uinstaller help with new markdowns Dec 14, 2016
libs check_nscp_nrpe returns wrong status code (for unknown) fixes #359 Jan 18, 2017
modules Cleaned up some includes Jan 19, 2017
op5 Changed cr/lf on all files locally Oct 17, 2016
packages added file so packages folder is kept Dec 29, 2014
patches/gtest-1.6.0/cmake * x64 build fixes as well as improvments to build protocol buffers a… Jan 15, 2013
resources Updated documentation and added make.bat to easily build documentatio… May 21, 2013
scripts Improved the documentation script to render better documentation Jan 15, 2017
service Fixed xtostring time parsing Jan 15, 2017
tools/error_reporter Fixed accidentally replaced with wrong license before Jan 15, 2017
vagrant Added vagrant with centos 7.3 Jan 19, 2017
web Changed cr/lf on all files locally Oct 17, 2016
.gitattributes changed attributes on scripts Dec 2, 2016
.gitignore Some more (post) cr-lf fixes Oct 17, 2016
.gitmodules Switched from rst to markdown for protobuf documentor Jan 15, 2017
.travis.yml reverting as apparently you cant actually use travis new container as… Oct 26, 2015
CMakeLists.txt removed nscapi_protobuf_types (as it is not used and reorganized some… Jan 15, 2017
COPYING Fixed accidentally replaced with wrong license before Jan 15, 2017
README.md Update README.md Mar 10, 2016
changelog updated changelog (and version) Nov 29, 2016
check_deps.cmake * New experimental way to build things automagically as well as new … Aug 14, 2012
nscp.spec.in removed reports from spec file as it is not used on linux Apr 3, 2016
version.txt bumped versions Dec 14, 2016

README.md

NSClient++

Stable 0.4.4: Build Status

Master: Build Status

NSClient++ (nscp) aims to be a simple yet powerful and secure monitoring daemon. It was built for Nagios/Icinga, but nothing in the daemon is Nagios/Icinga specific and it can be used in many other scenarios where you want to receive/distribute check metrics.

The daemon has 3 main functions:

  • Allow a remote machine (monitoring server) to request commands to be run on this machine (the monitored machine) which return the status of the machine.
  • Submit the same results to a remote (monitoring server).
  • Take action and perform tasks.

NSClient++ can be found at: http://nsclient.org

Documentation can be found at: http://docs.nsclient.org

Extending NSClient++

NSClient++ is designed to be open ended and allow you to customize it in any way you design thus extensibility is a core feature.

  • ExternalScripts responds to queries and are executed by the operating system and the results are returned as-is. This is generally the simplest way to extend NSClient++ as you can utilize whatever infrastructure or skill set you already have.
  • LuaScripts are internal scripts which runs inside NSClient++ and performs various tasks and/or responds to queries. This is the best option if you want to allow the script to run on any platform with as little infrastructure as possible.
  • PythonScripts are internal scripts which runs inside NSClient++ and performs various tasks and/or responds to queries. Python is an easy and powerful language but it requires you to also install python which is often not possible on server hardware.
  • .Net modules similar to Native modules below but written on the dot-net platform. This allows you to write components on top of the large dot-net ecosystem.
  • Modules are native plugins which can extend NSClient++ in pretty much any way possible. This is probably the most complicated way but gives you the most power and control.

Talking to NSClient++

Since NSClient++ is meaningless by itself it also supports a lot of protocols to allow it to be used by a lot of monitoring solutions.

  • NRPE (Nagios Remote plugin Executor) is a Nagios centric protocol to collect remote metrics.
  • NSCA (Nagios Service Check Acceptor) is a Nagios centric protocol for submitting results.
  • NSCP is the native NSClient++ protocol (still under development)
  • dNSCP is a high performance distributed version of NSCP for high volume traffic.
  • NRDP is a replacement for NSCA.
  • check_mk is a protocol utilized by the check_mk monitoring system.
  • Syslog is a protocol primarily designed for submitting log records.
  • Graphite allows you do real-time graphing.
  • SMTP is more of a toy currently.

Supported OS/Platform

NSClient++ should run on the following operating systems:

  • Windows: From NT4 SP5 up to Windows 2012R2 and Windows 8.1
  • Linux: Debian, Centos and Ubuntu (and possibly others as well)
  • Win32, x64 as well as various Linux hardware as well.