1 #############################################################################
2 # Sample NRPE Config File
3 # Written by: Ethan Galstad (nagios@nagios.org)
5 # Last Modified: 11-23-2007
8 # This is a sample configuration file for the NRPE daemon. It needs to be
9 # located on the remote host that is running the NRPE daemon, not the host
10 # from which the check_nrpe client is being executed.
11 #############################################################################
15 # The syslog facility that should be used for logging purposes.
22 # The name of the file in which the NRPE daemon should write it's process ID
23 # number. The file is only written if the NRPE daemon is started by the root
24 # user and is running in standalone mode.
26 pid_file=/var/run/nrpe.pid
31 # Port number we should wait for connections on.
32 # NOTE: This must be a non-priviledged port (i.e. > 1024).
33 # NOTE: This option is ignored if NRPE is running under either inetd or xinetd
40 # Address that nrpe should bind to in case there are more than one interface
41 # and you do not want nrpe to bind on all interfaces.
42 # NOTE: This option is ignored if NRPE is running under either inetd or xinetd
44 #server_address=127.0.0.1
49 # This determines the effective user that the NRPE daemon should run as.
50 # You can either supply a username or a UID.
52 # NOTE: This option is ignored if NRPE is running under either inetd or xinetd
59 # This determines the effective group that the NRPE daemon should run as.
60 # You can either supply a group name or a GID.
62 # NOTE: This option is ignored if NRPE is running under either inetd or xinetd
68 # ALLOWED HOST ADDRESSES
69 # This is an optional comma-delimited list of IP address or hostnames
70 # that are allowed to talk to the NRPE daemon.
72 # Note: The daemon only does rudimentary checking of the client's IP
73 # address. I would highly recommend adding entries in your /etc/hosts.allow
74 # file to allow only the specified host to connect to the port
75 # you are running this daemon on.
77 # NOTE: This option is ignored if NRPE is running under either inetd or xinetd
79 allowed_hosts=127.0.0.1
83 # COMMAND ARGUMENT PROCESSING
84 # This option determines whether or not the NRPE daemon will allow clients
85 # to specify arguments to commands that are executed. This option only works
86 # if the daemon was configured with the --enable-command-args configure script
89 # *** ENABLING THIS OPTION IS A SECURITY RISK! ***
90 # Read the SECURITY file for information on some of the security implications
91 # of enabling this variable.
93 # Values: 0=do not allow arguments, 1=allow command arguments
100 # This option allows you to prefix all commands with a user-defined string.
101 # A space is automatically added between the specified prefix string and the
102 # command line from the command definition.
104 # *** THIS EXAMPLE MAY POSE A POTENTIAL SECURITY RISK, SO USE WITH CAUTION! ***
106 # Execute restricted commmands using sudo. For this to work, you need to add
107 # the nagios user to your /etc/sudoers. An example entry for alllowing
108 # execution of the plugins from might be:
110 # nagios ALL=(ALL) NOPASSWD: /usr/lib/nagios/plugins/
112 # This lets the nagios user run all commands in that directory (and only them)
113 # without asking for a password. If you do this, make sure you don't give
114 # random users write access to that directory or its contents!
116 # command_prefix=/usr/bin/sudo
121 # This option determines whether or not debugging messages are logged to the
123 # Values: 0=debugging off, 1=debugging on
130 # This specifies the maximum number of seconds that the NRPE daemon will
131 # allow plugins to finish executing before killing them off.
138 # This specifies the maximum number of seconds that the NRPE daemon will
139 # wait for a connection to be established before exiting. This is sometimes
140 # seen where a network problem stops the SSL being established even though
141 # all network sessions are connected. This causes the nrpe daemons to
142 # accumulate, eating system resources. Do not set this too low.
144 connection_timeout=300
148 # WEEK RANDOM SEED OPTION
149 # This directive allows you to use SSL even if your system does not have
150 # a /dev/random or /dev/urandom (on purpose or because the necessary patches
151 # were not applied). The random number generator will be seeded from a file
152 # which is either a file pointed to by the environment valiable $RANDFILE
153 # or $HOME/.rnd. If neither exists, the pseudo random number generator will
154 # be initialized and a warning will be issued.
155 # Values: 0=only seed from /dev/[u]random, 1=also seed from weak randomness
157 #allow_weak_random_seed=1
161 # INCLUDE CONFIG FILE
162 # This directive allows you to include definitions from an external config file.
164 #include=<somefile.cfg>
168 # INCLUDE CONFIG DIRECTORY
169 # This directive allows you to include definitions from config files (with a
170 # .cfg extension) in one or more directories (with recursion).
172 #include_dir=<somedirectory>
173 #include_dir=<someotherdirectory>
177 # COMMAND DEFINITIONS
178 # Command definitions that this daemon will run. Definitions
179 # are in the following format:
181 # command[<command_name>]=<command_line>
183 # When the daemon receives a request to return the results of <command_name>
184 # it will execute the command specified by the <command_line> argument.
186 # Unlike Nagios, the command line cannot contain macros - it must be
187 # typed exactly as it should be executed.
189 # Note: Any plugins that are used in the command lines must reside
190 # on the machine that this daemon is running on! The examples below
191 # assume that you have plugins installed in a /usr/local/nagios/libexec
192 # directory. Also note that you will have to modify the definitions below
193 # to match the argument format the plugins expect. Remember, these are
197 # The following examples use hardcoded command arguments...
199 command[check_users]=/usr/lib/nagios/plugins/check_users -w 5 -c 10
200 command[check_load]=/usr/lib/nagios/plugins/check_load -w 15,10,5 -c 30,25,20
201 command[check_hda1]=/usr/lib/nagios/plugins/check_disk -w 20% -c 10% -p /dev/hda1
202 command[check_zombie_procs]=/usr/lib/nagios/plugins/check_procs -w 5 -c 10 -s Z
203 command[check_total_procs]=/usr/lib/nagios/plugins/check_procs -w 150 -c 200
206 # The following examples allow user-supplied arguments and can
207 # only be used if the NRPE daemon was compiled with support for
208 # command arguments *AND* the dont_blame_nrpe directive in this
209 # config file is set to '1'. This poses a potential security risk, so
210 # make sure you read the SECURITY file before doing this.
212 #command[check_users]=/usr/lib/nagios/plugins/check_users -w $ARG1$ -c $ARG2$
213 #command[check_load]=/usr/lib/nagios/plugins/check_load -w $ARG1$ -c $ARG2$
214 #command[check_disk]=/usr/lib/nagios/plugins/check_disk -w $ARG1$ -c $ARG2$ -p $ARG3$
215 #command[check_procs]=/usr/lib/nagios/plugins/check_procs -w $ARG1$ -c $ARG2$ -s $ARG3$
218 # local configuration:
219 # if you'd prefer, you can instead place directives here
220 include=/etc/nagios/nrpe_local.cfg
223 # you can place your config snipplets into nrpe.d/
224 include_dir=/etc/nagios/nrpe.d/