nagios-nrpe/contrib/README.nrpe_check_control

65 lines
1.7 KiB
Plaintext

NOTES:
------
The service definition below assumes you have a command called "check_tcp" already setup
in your config files.
The command definition below assumes that the $USER1$ macro is used to define the location
of your Nagios plugins (i.e. "/usr/local/nagios/libexec") and that the nrpe_check_control
service is located in that directory.
SAMPLE CONFIG FILE SNIPPETS:
----------------------------
define service {
host_name <host name goes here>
description NRPE
...
event_handler nrpe_check_control
check_command check_tcp!-p 5666
}
define command {
command_name nrpe_check_control
command_line $USER1$/nrpe_check_control $SERVICESTATE$ $SERVICESTATETYPE$ $SERVICEATTEMPT$ "$HOSTNAME$"
}
ORIGINAL EMAIL SNIPPET:
-----------------------
Date sent: Fri, 30 Mar 2001 18:51:48 -0500
From: adam.bowen@<>
Subject: Event Handler
To: [nagios@nagios.org]
I am attaching the source code for an event handler I wrote to
control checks using nrpe. I add the following check to all remote hosts
using nrpe:
<see example above>
I added this line to the commands.cfg file:
<see example above>
When the NRPE service check listed above has 3 failed connection
attempts, it will run the nrpe_check_control which will search the
services file for all services for $HOSTNAME$ that use the check_nrpe.
It will then request that all these services be disabled. When the
NRPE check returns to the OK state, it will request that all services
using check_nrpe be re-enabled. This will prevent unnecessary e-mail
when there is a problem with the NRPE daemon. This does require
that external commands be enabled.
(See attached file: nrpe_check_control.c)
I thought some other [Nagios] users might find this useful.
Adam G. Bowen