summaryrefslogtreecommitdiffstats
path: root/contrib/README.nrpe_check_control
blob: 781b961898ab9332ff36e9de15c2358f436aaa72 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
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