{"id":16156292,"url":"https://github.com/weiss/nsca-ng","last_synced_at":"2025-06-24T19:37:20.500Z","repository":{"id":7227377,"uuid":"8535452","full_name":"weiss/nsca-ng","owner":"weiss","description":"NSCA-ng is an add-on for transferring check results (and other commands) to Nagios or Icinga.","archived":false,"fork":false,"pushed_at":"2023-07-24T19:57:17.000Z","size":499,"stargazers_count":23,"open_issues_count":2,"forks_count":5,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-02-28T12:05:59.372Z","etag":null,"topics":["c","distributed","monitoring"],"latest_commit_sha":null,"homepage":"https://nsca-ng.org","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/weiss.png","metadata":{"files":{"readme":"README","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null}},"created_at":"2013-03-03T11:38:55.000Z","updated_at":"2022-12-12T12:13:44.000Z","dependencies_parsed_at":"2024-04-16T20:57:53.775Z","dependency_job_id":"d12d810c-a6b1-4774-8b1a-794bf5f523ad","html_url":"https://github.com/weiss/nsca-ng","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weiss%2Fnsca-ng","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weiss%2Fnsca-ng/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weiss%2Fnsca-ng/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weiss%2Fnsca-ng/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/weiss","download_url":"https://codeload.github.com/weiss/nsca-ng/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243949775,"owners_count":20373651,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["c","distributed","monitoring"],"created_at":"2024-10-10T01:44:33.566Z","updated_at":"2025-03-18T20:30:37.355Z","avatar_url":"https://github.com/weiss.png","language":"C","funding_links":[],"categories":["Nagios Monitoring"],"sub_categories":["Nagios Monitoring Addons"],"readme":"Welcome to NSCA-ng!\n===================\n\nThe NSCA-ng package provides a client-server pair which makes the \"Nagios\ncommand file\" accessible to remote systems.  This allows for submitting\npassive check results, downtimes, and many other [commands][1] to Nagios (or\ncompatible monitoring solutions).\n\nNSCA-ng supports TLS encryption and shared-secret authentication with\nclient-specific passwords (based on [RFC 4279][2]), as well as fine-grained\nauthorization control.\n\nPrerequisites\n-------------\n\n1.  [OpenSSL][3] 1.0.0 or newer is required for building NSCA-ng (as older\n    releases don't support pre-shared key authentication).  This is the only\n    hard dependency of the NSCA-ng client.  If the OpenSSL version provided\n    by your operating system vendor is too old, you might want to build a\n    private copy of OpenSSL and embed it into NSCA-ng.  This could be done\n    by running the `./build-aux/make-openssl` script, which downloads the\n    most recent OpenSSL version and installs it into the NSCA-ng source\n    tree.  The `./configure` script (see below) will then pick that up\n    automatically.\n\n2.  The NSCA-ng *server* also requires [libConfuse][4] 2.6 or newer.  In\n    order to embed a private copy of libConfuse into NSCA-ng, the\n    `./build-aux/make-confuse` script could be run before calling\n    `./configure`.\n\n3.  If [libev][5] 4.00 or newer is available and found by the `./configure`\n    script, NSCA-ng will (by default) use it.  Otherwise, a bundled copy of\n    libev is embedded into NSCA-ng, so this dependency is optional.\n\n4.  Optional [systemd][6] integration code is added to the NSCA-ng *server*\n    if systemd's `sd-daemon(3)` library is found.  This can be disabled by\n    specifying the `--without-systemd` option on the `./configure` command\n    line.\n\nInstallation\n------------\n\nIf only the client should be built, issuing the following three commands in\nNSCA-ng's source directory should do the trick:\n\n    $ ./configure\n    $ make\n    $ su root -c 'make install'\n\nThis installs the NSCA-ng client into appropriate subdirectories of\n`/usr/local`.\n\nThe installation process can be customized by setting environment variables\nand/or passing options to the `./configure` script.  Some of the more\nfrequently used `./configure` options include:\n\n* `--enable-server`\n\n    Build and install the NSCA-ng server (in addition to the client, unless\n    `--disable-client` is specified).\n\n* `--disable-client`\n\n    Don't build and install the NSCA-ng client.\n\n* `--disable-posix-aio`\n\n    Don't use the POSIX AIO API.  By default, the NSCA-ng server will use\n    the POSIX AIO API if available.\n\n* `--prefix=PATH`\n\n    Install NSCA-ng into subdirectories of `PATH` instead of `/usr/local`.\n\n* `--with-confuse=PATH`\n\n    Search for the libConfuse header files in `PATH/include`, and search for\n    the libConfuse library files in `PATH/lib`.  If this option isn't\n    specified, `./configure` will look for libConfuse in a few typical\n    locations.\n\n* `--with-ev=PATH`\n\n    Search for the libev header files in `PATH/include`, and search for the\n    libev library files in `PATH/lib`.  If this option isn't specified,\n    `./configure` will look for libev in a few typical locations; and if no\n    usable version is found, a bundled copy of libev will be embedded into\n    NSCA-ng.  In order to force usage of the included copy,\n    `--with-ev=embedded` can be specified; while `--with-ev=external` would\n    disallow falling back to the bundled libev code.\n\n* `--with-openssl=PATH`\n\n    Search for the OpenSSL header files in `PATH/include`, and search for\n    the OpenSSL library files in `PATH/lib`.  If this option isn't\n    specified, `./configure` will look for OpenSSL in a few typical\n    locations.\n\nFor a full list of available options and environment variables, run\n`./configure --help`.  See the file `INSTALL` for detailed installation\ninstructions.\n\nConfiguration\n-------------\n\nThe NSCA-ng client is configured using the `send_nsca.cfg(5)` file, the\nNSCA-ng server uses the `nsca-ng.cfg(5)` file.  Examples of these files are\ninstalled if they don't already exist.\n\n\u003e **Important:**  Please set the permissions of the configuration files\n\u003e appropriately to make sure that only authorized users can access them.\n\nA script such as `nsca-ng.init` (as provided in the `contrib` directory of\nthis package) could be used to start and stop the NSCA-ng server.\n\nUsage\n-----\n\nPlease see the scripts in the `contrib` directory for various usage\nexamples.\n\nNSCA Compatibility\n------------------\n\nThe NSCA-ng client (`send_nsca`) is a drop-in replacement for the\n`send_nsca` binary provided with the original NSCA 2.x package in the sense\nthat NSCA-ng's `send_nsca` accepts all input, command line arguments, and\nconfiguration files accepted by the original `send_nsca`.  NSCA-ng clients\ncannot talk to NSCA servers (nor vice versa), but NSCA and NSCA-ng servers\ncan happily run side by side, and they use different ports by default.\n\nDocumentation\n-------------\n\nDetailed information regarding the build and installation process can be\nfound in the file `INSTALL`.\n\nThe NSCA-ng usage and configuration is documented in the `nsca-ng(8)`,\n`send_nsca(8)`, `nsca-ng.cfg(5)`, and `send_nsca.cfg(5)` manual pages.  The\ncommands `send_nsca -h` and `nsca-ng -h` spit out short summaries of the\navailable command line options.\n\nFor each release, noteworthy changes are listed in the file `NEWS`.  Feature\nadditions which are planned for future releases are added to the `TODO`\nfile.\n\nFor copyright and license information, see the file `COPYING`.\n\nSupport\n-------\n\nBug reports and patches can be sent to the \u003cdevelopers@nsca-ng.org\u003e list (no\nsubscription required).  For usage support, please subscribe to the\n\u003cusers@nsca-ng.org\u003e list.  See the [NSCA-ng][7] website for details.\n\n[1]: http://www.nagios.org/developerinfo/externalcommands/\n[2]: http://tools.ietf.org/html/rfc4279\n[3]: http://www.openssl.org/\n[4]: https://github.com/libconfuse/libconfuse\n[5]: http://libev.schmorp.de/\n[6]: http://www.freedesktop.org/wiki/Software/systemd/\n[7]: http://www.nsca-ng.org/\n\n\u003c!-- vim:set filetype=markdown textwidth=76 joinspaces: --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweiss%2Fnsca-ng","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fweiss%2Fnsca-ng","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweiss%2Fnsca-ng/lists"}