CHECK_NSCA(1)         User Contributed Perl Documentation        CHECK_NSCA(1)



cchheecckk__nnssccaa
       Check if the Nagios Service Check Acceptor is running and can
       successful submit check results to a running Nagios or Icinga instance.

SSYYNNOOPPSSIISS
       ./check_nsca [options]

        Options:

           --help
           --debug
           --version

           --send_nsca
           --send_nsca_cfg

           --nsca_send_host
           --nsca_receive_host
           --nsca_check_description
           --nsca_check_result

           --livestatus_socket
           --sleeptime
           --timeout

OOPPTTIIOONNSS
       ----hheellpp  Produces this output.

       ----ddeebbuugg Print debug output on STDERR.

       ----vveerrssiioonn
               Print current version number of this check.

       ----sseenndd__nnssccaa
               Path to the send_nsca binary (default: /usr/bin/send_nsca).

       ----sseenndd__nnssccaa__ccffgg
               Path to the send_nsca configuration file (default:
               /etc/send_nsca.cfg).

       ----nnssccaa__rreecceeiivvee__hhoosstt
               The hostname with the NSCA test definition (used in send_nsca).

       ----nnssccaa__cchheecckk__ddeessccrriippttiioonn
               The service description of the NSCA test definition (default:
               'NSCA dummy test').

       ----nnssccaa__cchheecckk__rreessuulltt
               The content of the NSCA test result (will be ignored, but might
               be useful for humans (default: 'Last test run:').

       ----sslleeeeppttiimmee
               How long in seconds to wait between the submission of the test
               result and the search for the correct value (NSCA <->
               Nagios/Icinga <-> updated result; default: 5).

       ----ttiimmeeoouutt
               Timeout in seconds for the whole script, to not hang Nagios
               (default: 60).

       ----lliivveessttaattuuss__ssoocckkeett
               The path to the livestatus socket (default:
               /var/spool/check_mk/livestatus.cmd)

DDEESSCCRRIIPPTTIIOONN
       Sometimes you wonder if your NSCA is still up and running (especially
       if you forget to define freshness values for your passive checks ;-).
       This script might help you here as it:

       +o       sends a test message to your NSCA instance

       +o       waits a few seconds (to give NSCA and Nagios/Icinga time to
               process the results)

       +o       checks if the message was delivered to Nagios/Icinga
               successfully by checking the result of the check

CCOONNFFIIGGUURRAATTIIOONN
       Write the following in your /etc/icinga or /etc/nagios configuration
       files:
        define command{
               command_name check_nsca
               command_line $USER1$/check_nsca
        }

        define service {
               use                     nsca-service-template
               hostgroup_name          nsca_dummy_check
               check_freshness         1
               freshness_threshold     93600   ; 26 hour threshold
               service_description     NSCA dummy test
               check_period            none
        }

        define service {
               use                     service-template
               hostgroup_name          check_nsca
               service_description     NSCA
               check_command           check_nrpe!check_nsca
        }

       and in /etc/nrpe.cfg (or in /etc/nrpe.d/nsca.cfg):
        command[check_nsca]=/usr/lib/nagios/plugins/check_nsca

AAUUTTHHOORRSS
       Written by Lars Vogdt <lrupp@suse.com>

SSUUPPPPOORRTT
       Please use https://bugzilla.suse.com to submit patches or suggest
       improvements.

       Include version information with all correspondence (when possible use
       output from the --version option of the plugin itself).



perl v5.10.0                      2017-12-13                     CHECK_NSCA(1)
