modules/nagios/templates/nrpe.cfg.erb

   1 ##
   2 ## THIS FILE IS UNDER PUPPET CONTROL. DON'T EDIT IT HERE.
   3 ## USE: git clone git+ssh://$USER@puppet.debian.org/srv/puppet.debian.org/git/dsa-puppet.git
   4 ##
   5 #############################################################################
   6 # Sample NRPE Config File
   7 # Written by: Ethan Galstad (nagios@nagios.org)
   8 #
   9 # Last Modified: 11-23-2007
  10 #
  11 # NOTES:
  12 # This is a sample configuration file for the NRPE daemon.  It needs to be
  13 # located on the remote host that is running the NRPE daemon, not the host
  14 # from which the check_nrpe client is being executed.
  15 #############################################################################
  16
  17
  18 # LOG FACILITY
  19 # The syslog facility that should be used for logging purposes.
  20
  21 log_facility=daemon
  22
  23
  24
  25 # PID FILE
  26 # The name of the file in which the NRPE daemon should write it's process ID
  27 # number.  The file is only written if the NRPE daemon is started by the root
  28 # user and is running in standalone mode.
  29
  30 <% unless lsbdistcodename == 'lenny' %>
  31 pid_file=/var/run/nagios/nrpe.pid
  32 <% else %>
  33 pid_file=/var/run/nrpe.pid
  34 <% end %>
  35
  36
  37 # PORT NUMBER
  38 # Port number we should wait for connections on.
  39 # NOTE: This must be a non-priviledged port (i.e. > 1024).
  40 # NOTE: This option is ignored if NRPE is running under either inetd or xinetd
  41
  42 server_port=5666
  43
  44
  45
  46 # SERVER ADDRESS
  47 # Address that nrpe should bind to in case there are more than one interface
  48 # and you do not want nrpe to bind on all interfaces.
  49 # NOTE: This option is ignored if NRPE is running under either inetd or xinetd
  50
  51 #server_address=127.0.0.1
  52
  53
  54
  55 # NRPE USER
  56 # This determines the effective user that the NRPE daemon should run as.
  57 # You can either supply a username or a UID.
  58 #
  59 # NOTE: This option is ignored if NRPE is running under either inetd or xinetd
  60
  61 nrpe_user=nagios
  62
  63
  64
  65 # NRPE GROUP
  66 # This determines the effective group that the NRPE daemon should run as.
  67 # You can either supply a group name or a GID.
  68 #
  69 # NOTE: This option is ignored if NRPE is running under either inetd or xinetd
  70
  71 nrpe_group=nagios
  72
  73
  74
  75 # ALLOWED HOST ADDRESSES
  76 # This is an optional comma-delimited list of IP address or hostnames
  77 # that are allowed to talk to the NRPE daemon.
  78 #
  79 # Note: The daemon only does rudimentary checking of the client's IP
  80 # address.  I would highly recommend adding entries in your /etc/hosts.allow
  81 # file to allow only the specified host to connect to the port
  82 # you are running this daemon on.
  83 #
  84 # NOTE: This option is ignored if NRPE is running under either inetd or xinetd
  85
  86 allowed_hosts=127.0.0.1
  87
  88
  89
  90 # COMMAND ARGUMENT PROCESSING
  91 # This option determines whether or not the NRPE daemon will allow clients
  92 # to specify arguments to commands that are executed.  This option only works
  93 # if the daemon was configured with the --enable-command-args configure script
  94 # option.
  95 #
  96 # *** ENABLING THIS OPTION IS A SECURITY RISK! ***
  97 # Read the SECURITY file for information on some of the security implications
  98 # of enabling this variable.
  99 #
 100 # Values: 0=do not allow arguments, 1=allow command arguments
 101
 102 dont_blame_nrpe=0
 103
 104
 105
 106 # COMMAND PREFIX
 107 # This option allows you to prefix all commands with a user-defined string.
 108 # A space is automatically added between the specified prefix string and the
 109 # command line from the command definition.
 110 #
 111 # *** THIS EXAMPLE MAY POSE A POTENTIAL SECURITY RISK, SO USE WITH CAUTION! ***
 112 # Usage scenario:
 113 # Execute restricted commmands using sudo.  For this to work, you need to add
 114 # the nagios user to your /etc/sudoers.  An example entry for alllowing
 115 # execution of the plugins from might be:
 116 #
 117 # nagios          ALL=(ALL) NOPASSWD: /usr/lib/nagios/plugins/
 118 #
 119 # This lets the nagios user run all commands in that directory (and only them)
 120 # without asking for a password.  If you do this, make sure you don't give
 121 # random users write access to that directory or its contents!
 122
 123 # command_prefix=/usr/bin/sudo
 124
 125
 126
 127 # DEBUGGING OPTION
 128 # This option determines whether or not debugging messages are logged to the
 129 # syslog facility.
 130 # Values: 0=debugging off, 1=debugging on
 131
 132 debug=0
 133
 134
 135
 136 # COMMAND TIMEOUT
 137 # This specifies the maximum number of seconds that the NRPE daemon will
 138 # allow plugins to finish executing before killing them off.
 139
 140 command_timeout=60
 141
 142
 143
 144 # CONNECTION TIMEOUT
 145 # This specifies the maximum number of seconds that the NRPE daemon will
 146 # wait for a connection to be established before exiting. This is sometimes
 147 # seen where a network problem stops the SSL being established even though
 148 # all network sessions are connected. This causes the nrpe daemons to
 149 # accumulate, eating system resources. Do not set this too low.
 150
 151 connection_timeout=300
 152
 153
 154
 155 # WEEK RANDOM SEED OPTION
 156 # This directive allows you to use SSL even if your system does not have
 157 # a /dev/random or /dev/urandom (on purpose or because the necessary patches
 158 # were not applied). The random number generator will be seeded from a file
 159 # which is either a file pointed to by the environment valiable $RANDFILE
 160 # or $HOME/.rnd. If neither exists, the pseudo random number generator will
 161 # be initialized and a warning will be issued.
 162 # Values: 0=only seed from /dev/[u]random, 1=also seed from weak randomness
 163
 164 #allow_weak_random_seed=1
 165
 166
 167
 168 # INCLUDE CONFIG FILE
 169 # This directive allows you to include definitions from an external config file.
 170
 171 #include=<somefile.cfg>
 172
 173
 174
 175 # INCLUDE CONFIG DIRECTORY
 176 # This directive allows you to include definitions from config files (with a
 177 # .cfg extension) in one or more directories (with recursion).
 178
 179 #include_dir=<somedirectory>
 180 #include_dir=<someotherdirectory>
 181
 182
 183
 184 # COMMAND DEFINITIONS
 185 # Command definitions that this daemon will run.  Definitions
 186 # are in the following format:
 187 #
 188 # command[<command_name>]=<command_line>
 189 #
 190 # When the daemon receives a request to return the results of <command_name>
 191 # it will execute the command specified by the <command_line> argument.
 192 #
 193 # Unlike Nagios, the command line cannot contain macros - it must be
 194 # typed exactly as it should be executed.
 195 #
 196 # Note: Any plugins that are used in the command lines must reside
 197 # on the machine that this daemon is running on!  The examples below
 198 # assume that you have plugins installed in a /usr/local/nagios/libexec
 199 # directory.  Also note that you will have to modify the definitions below
 200 # to match the argument format the plugins expect.  Remember, these are
 201 # examples only!
 202
 203
 204 # The following examples use hardcoded command arguments...
 205
 206 command[check_users]=/usr/lib/nagios/plugins/check_users -w 5 -c 10
 207 command[check_load]=/usr/lib/nagios/plugins/check_load -w 15,10,5 -c 30,25,20
 208 command[check_hda1]=/usr/lib/nagios/plugins/check_disk -w 20% -c 10% -p /dev/hda1
 209 command[check_zombie_procs]=/usr/lib/nagios/plugins/check_procs -w 5 -c 10 -s Z
 210 command[check_total_procs]=/usr/lib/nagios/plugins/check_procs -w 150 -c 200
 211
 212
 213 # The following examples allow user-supplied arguments and can
 214 # only be used if the NRPE daemon was compiled with support for
 215 # command arguments *AND* the dont_blame_nrpe directive in this
 216 # config file is set to '1'.  This poses a potential security risk, so
 217 # make sure you read the SECURITY file before doing this.
 218
 219 #command[check_users]=/usr/lib/nagios/plugins/check_users -w $ARG1$ -c $ARG2$
 220 #command[check_load]=/usr/lib/nagios/plugins/check_load -w $ARG1$ -c $ARG2$
 221 #command[check_disk]=/usr/lib/nagios/plugins/check_disk -w $ARG1$ -c $ARG2$ -p $ARG3$
 222 #command[check_procs]=/usr/lib/nagios/plugins/check_procs -w $ARG1$ -c $ARG2$ -s $ARG3$
 223
 224 #
 225 # local configuration:
 226 #       if you'd prefer, you can instead place directives here
 227 include=/etc/nagios/nrpe_local.cfg
 228
 229 #
 230 # you can place your config snipplets into nrpe.d/
 231 include_dir=/etc/nagios/nrpe.d/
 232
 233