source: nagios/nagios.cfg@ 289

Last change on this file since 289 was 202, checked in by Rick van der Zwet, 14 years ago

Nagios config files

File size: 43.8 KB
Line 
1##############################################################################
2#
3# NAGIOS.CFG - Sample Main Config File for Nagios 3.2.2
4#
5# Read the documentation for more information on this configuration
6# file. I've provided some comments here, but things may not be so
7# clear without further explanation.
8#
9# Last Modified: 12-14-2008
10#
11##############################################################################
12
13
14# LOG FILE
15# This is the main log file where service and host events are logged
16# for historical purposes. This should be the first option specified
17# in the config file!!!
18
19log_file=/var/spool/nagios/nagios.log
20
21
22
23# OBJECT CONFIGURATION FILE(S)
24# These are the object configuration files in which you define hosts,
25# host groups, contacts, contact groups, services, etc.
26# You can split your object definitions across several config files
27# if you wish (as shown below), or keep them all in a single config file.
28
29# You can specify individual object config files as shown below:
30cfg_file=/usr/local/etc/nagios/objects/commands.cfg
31cfg_file=/usr/local/etc/nagios/objects/contacts.cfg
32cfg_file=/usr/local/etc/nagios/objects/timeperiods.cfg
33cfg_file=/usr/local/etc/nagios/objects/templates.cfg
34
35# Definitions for monitoring the local (FreeBSD) host
36# cfg_file=/usr/local/etc/nagios/objects/localhost.cfg
37
38# Definitions for monitoring a Windows machine
39#cfg_file=/usr/local/etc/nagios/objects/windows.cfg
40
41# Definitions for monitoring a router/switch
42#cfg_file=/usr/local/etc/nagios/objects/switch.cfg
43
44# Definitions for monitoring a network printer
45#cfg_file=/usr/local/etc/nagios/objects/printer.cfg
46
47
48# You can also tell Nagios to process all config files (with a .cfg
49# extension) in a particular directory by using the cfg_dir
50# directive as shown below:
51
52#cfg_dir=/usr/local/etc/nagios/servers
53#cfg_dir=/usr/local/etc/nagios/printers
54#cfg_dir=/usr/local/etc/nagios/switches
55#cfg_dir=/usr/local/etc/nagios/routers
56
57# Definitions for monitoring vanderzwet.net
58cfg_file=/usr/local/etc/nagios/objects/vanderzwet.net.cfg
59
60
61
62# OBJECT CACHE FILE
63# This option determines where object definitions are cached when
64# Nagios starts/restarts. The CGIs read object definitions from
65# this cache file (rather than looking at the object config files
66# directly) in order to prevent inconsistencies that can occur
67# when the config files are modified after Nagios starts.
68
69object_cache_file=/var/spool/nagios/objects.cache
70
71
72
73# PRE-CACHED OBJECT FILE
74# This options determines the location of the precached object file.
75# If you run Nagios with the -p command line option, it will preprocess
76# your object configuration file(s) and write the cached config to this
77# file. You can then start Nagios with the -u option to have it read
78# object definitions from this precached file, rather than the standard
79# object configuration files (see the cfg_file and cfg_dir options above).
80# Using a precached object file can speed up the time needed to (re)start
81# the Nagios process if you've got a large and/or complex configuration.
82# Read the documentation section on optimizing Nagios to find our more
83# about how this feature works.
84
85precached_object_file=/var/spool/nagios/objects.precache
86
87
88
89# RESOURCE FILE
90# This is an optional resource file that contains $USERx$ macro
91# definitions. Multiple resource files can be specified by using
92# multiple resource_file definitions. The CGIs will not attempt to
93# read the contents of resource files, so information that is
94# considered to be sensitive (usernames, passwords, etc) can be
95# defined as macros in this file and restrictive permissions (600)
96# can be placed on this file.
97
98resource_file=/usr/local/etc/nagios/resource.cfg
99
100
101
102# STATUS FILE
103# This is where the current status of all monitored services and
104# hosts is stored. Its contents are read and processed by the CGIs.
105# The contents of the status file are deleted every time Nagios
106# restarts.
107
108status_file=/var/spool/nagios/status.dat
109
110
111
112# STATUS FILE UPDATE INTERVAL
113# This option determines the frequency (in seconds) that
114# Nagios will periodically dump program, host, and
115# service status data.
116
117status_update_interval=10
118
119
120
121# NAGIOS USER
122# This determines the effective user that Nagios should run as.
123# You can either supply a username or a UID.
124
125nagios_user=nagios
126
127
128
129# NAGIOS GROUP
130# This determines the effective group that Nagios should run as.
131# You can either supply a group name or a GID.
132
133nagios_group=nagios
134
135
136
137# EXTERNAL COMMAND OPTION
138# This option allows you to specify whether or not Nagios should check
139# for external commands (in the command file defined below). By default
140# Nagios will *not* check for external commands, just to be on the
141# cautious side. If you want to be able to use the CGI command interface
142# you will have to enable this.
143# Values: 0 = disable commands, 1 = enable commands
144
145check_external_commands=1
146
147
148
149# EXTERNAL COMMAND CHECK INTERVAL
150# This is the interval at which Nagios should check for external commands.
151# This value works of the interval_length you specify later. If you leave
152# that at its default value of 60 (seconds), a value of 1 here will cause
153# Nagios to check for external commands every minute. If you specify a
154# number followed by an "s" (i.e. 15s), this will be interpreted to mean
155# actual seconds rather than a multiple of the interval_length variable.
156# Note: In addition to reading the external command file at regularly
157# scheduled intervals, Nagios will also check for external commands after
158# event handlers are executed.
159# NOTE: Setting this value to -1 causes Nagios to check the external
160# command file as often as possible.
161
162#command_check_interval=15s
163command_check_interval=-1
164
165
166
167# EXTERNAL COMMAND FILE
168# This is the file that Nagios checks for external command requests.
169# It is also where the command CGI will write commands that are submitted
170# by users, so it must be writeable by the user that the web server
171# is running as (usually 'nobody'). Permissions should be set at the
172# directory level instead of on the file, as the file is deleted every
173# time its contents are processed.
174
175command_file=/var/spool/nagios/rw/nagios.cmd
176
177
178
179# EXTERNAL COMMAND BUFFER SLOTS
180# This settings is used to tweak the number of items or "slots" that
181# the Nagios daemon should allocate to the buffer that holds incoming
182# external commands before they are processed. As external commands
183# are processed by the daemon, they are removed from the buffer.
184
185external_command_buffer_slots=4096
186
187
188
189# LOCK FILE
190# This is the lockfile that Nagios will use to store its PID number
191# in when it is running in daemon mode.
192
193lock_file=/var/spool/nagios/nagios.lock
194
195
196
197# TEMP FILE
198# This is a temporary file that is used as scratch space when Nagios
199# updates the status log, cleans the comment file, etc. This file
200# is created, used, and deleted throughout the time that Nagios is
201# running.
202
203temp_file=/var/spool/nagios/nagios.tmp
204
205
206
207# TEMP PATH
208# This is path where Nagios can create temp files for service and
209# host check results, etc.
210
211temp_path=/tmp
212
213
214
215# EVENT BROKER OPTIONS
216# Controls what (if any) data gets sent to the event broker.
217# Values: 0 = Broker nothing
218# -1 = Broker everything
219# <other> = See documentation
220
221event_broker_options=-1
222
223
224
225# EVENT BROKER MODULE(S)
226# This directive is used to specify an event broker module that should
227# by loaded by Nagios at startup. Use multiple directives if you want
228# to load more than one module. Arguments that should be passed to
229# the module at startup are seperated from the module path by a space.
230#
231#!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
232# WARNING !!! WARNING !!! WARNING !!! WARNING !!! WARNING !!! WARNING
233#!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
234#
235# Do NOT overwrite modules while they are being used by Nagios or Nagios
236# will crash in a fiery display of SEGFAULT glory. This is a bug/limitation
237# either in dlopen(), the kernel, and/or the filesystem. And maybe Nagios...
238#
239# The correct/safe way of updating a module is by using one of these methods:
240# 1. Shutdown Nagios, replace the module file, restart Nagios
241# 2. Delete the original module file, move the new module file into place, restart Nagios
242#
243# Example:
244#
245# broker_module=<modulepath> [moduleargs]
246
247#broker_module=/somewhere/module1.o
248#broker_module=/somewhere/module2.o arg1 arg2=3 debug=0
249
250
251
252# LOG ROTATION METHOD
253# This is the log rotation method that Nagios should use to rotate
254# the main log file. Values are as follows..
255# n = None - don't rotate the log
256# h = Hourly rotation (top of the hour)
257# d = Daily rotation (midnight every day)
258# w = Weekly rotation (midnight on Saturday evening)
259# m = Monthly rotation (midnight last day of month)
260
261log_rotation_method=d
262
263
264
265# LOG ARCHIVE PATH
266# This is the directory where archived (rotated) log files should be
267# placed (assuming you've chosen to do log rotation).
268
269log_archive_path=/var/spool/nagios/archives
270
271
272
273# LOGGING OPTIONS
274# If you want messages logged to the syslog facility, as well as the
275# Nagios log file set this option to 1. If not, set it to 0.
276
277use_syslog=1
278
279
280
281# NOTIFICATION LOGGING OPTION
282# If you don't want notifications to be logged, set this value to 0.
283# If notifications should be logged, set the value to 1.
284
285log_notifications=1
286
287
288
289# SERVICE RETRY LOGGING OPTION
290# If you don't want service check retries to be logged, set this value
291# to 0. If retries should be logged, set the value to 1.
292
293log_service_retries=1
294
295
296
297# HOST RETRY LOGGING OPTION
298# If you don't want host check retries to be logged, set this value to
299# 0. If retries should be logged, set the value to 1.
300
301log_host_retries=1
302
303
304
305# EVENT HANDLER LOGGING OPTION
306# If you don't want host and service event handlers to be logged, set
307# this value to 0. If event handlers should be logged, set the value
308# to 1.
309
310log_event_handlers=1
311
312
313
314# INITIAL STATES LOGGING OPTION
315# If you want Nagios to log all initial host and service states to
316# the main log file (the first time the service or host is checked)
317# you can enable this option by setting this value to 1. If you
318# are not using an external application that does long term state
319# statistics reporting, you do not need to enable this option. In
320# this case, set the value to 0.
321
322log_initial_states=0
323
324
325
326# EXTERNAL COMMANDS LOGGING OPTION
327# If you don't want Nagios to log external commands, set this value
328# to 0. If external commands should be logged, set this value to 1.
329# Note: This option does not include logging of passive service
330# checks - see the option below for controlling whether or not
331# passive checks are logged.
332
333log_external_commands=1
334
335
336
337# PASSIVE CHECKS LOGGING OPTION
338# If you don't want Nagios to log passive host and service checks, set
339# this value to 0. If passive checks should be logged, set
340# this value to 1.
341
342log_passive_checks=1
343
344
345
346# GLOBAL HOST AND SERVICE EVENT HANDLERS
347# These options allow you to specify a host and service event handler
348# command that is to be run for every host or service state change.
349# The global event handler is executed immediately prior to the event
350# handler that you have optionally specified in each host or
351# service definition. The command argument is the short name of a
352# command definition that you define in your host configuration file.
353# Read the HTML docs for more information.
354
355#global_host_event_handler=somecommand
356#global_service_event_handler=somecommand
357
358
359
360# SERVICE INTER-CHECK DELAY METHOD
361# This is the method that Nagios should use when initially
362# "spreading out" service checks when it starts monitoring. The
363# default is to use smart delay calculation, which will try to
364# space all service checks out evenly to minimize CPU load.
365# Using the dumb setting will cause all checks to be scheduled
366# at the same time (with no delay between them)! This is not a
367# good thing for production, but is useful when testing the
368# parallelization functionality.
369# n = None - don't use any delay between checks
370# d = Use a "dumb" delay of 1 second between checks
371# s = Use "smart" inter-check delay calculation
372# x.xx = Use an inter-check delay of x.xx seconds
373
374service_inter_check_delay_method=s
375
376
377
378# MAXIMUM SERVICE CHECK SPREAD
379# This variable determines the timeframe (in minutes) from the
380# program start time that an initial check of all services should
381# be completed. Default is 30 minutes.
382
383max_service_check_spread=30
384
385
386
387# SERVICE CHECK INTERLEAVE FACTOR
388# This variable determines how service checks are interleaved.
389# Interleaving the service checks allows for a more even
390# distribution of service checks and reduced load on remote
391# hosts. Setting this value to 1 is equivalent to how versions
392# of Nagios previous to 0.0.5 did service checks. Set this
393# value to s (smart) for automatic calculation of the interleave
394# factor unless you have a specific reason to change it.
395# s = Use "smart" interleave factor calculation
396# x = Use an interleave factor of x, where x is a
397# number greater than or equal to 1.
398
399service_interleave_factor=s
400
401
402
403# HOST INTER-CHECK DELAY METHOD
404# This is the method that Nagios should use when initially
405# "spreading out" host checks when it starts monitoring. The
406# default is to use smart delay calculation, which will try to
407# space all host checks out evenly to minimize CPU load.
408# Using the dumb setting will cause all checks to be scheduled
409# at the same time (with no delay between them)!
410# n = None - don't use any delay between checks
411# d = Use a "dumb" delay of 1 second between checks
412# s = Use "smart" inter-check delay calculation
413# x.xx = Use an inter-check delay of x.xx seconds
414
415host_inter_check_delay_method=s
416
417
418
419# MAXIMUM HOST CHECK SPREAD
420# This variable determines the timeframe (in minutes) from the
421# program start time that an initial check of all hosts should
422# be completed. Default is 30 minutes.
423
424max_host_check_spread=30
425
426
427
428# MAXIMUM CONCURRENT SERVICE CHECKS
429# This option allows you to specify the maximum number of
430# service checks that can be run in parallel at any given time.
431# Specifying a value of 1 for this variable essentially prevents
432# any service checks from being parallelized. A value of 0
433# will not restrict the number of concurrent checks that are
434# being executed.
435
436max_concurrent_checks=0
437
438
439
440# HOST AND SERVICE CHECK REAPER FREQUENCY
441# This is the frequency (in seconds!) that Nagios will process
442# the results of host and service checks.
443
444check_result_reaper_frequency=10
445
446
447
448
449# MAX CHECK RESULT REAPER TIME
450# This is the max amount of time (in seconds) that a single
451# check result reaper event will be allowed to run before
452# returning control back to Nagios so it can perform other
453# duties.
454
455max_check_result_reaper_time=30
456
457
458
459
460# CHECK RESULT PATH
461# This is directory where Nagios stores the results of host and
462# service checks that have not yet been processed.
463#
464# Note: Make sure that only one instance of Nagios has access
465# to this directory!
466
467check_result_path=/var/spool/nagios/checkresults
468
469
470
471
472# MAX CHECK RESULT FILE AGE
473# This option determines the maximum age (in seconds) which check
474# result files are considered to be valid. Files older than this
475# threshold will be mercilessly deleted without further processing.
476
477max_check_result_file_age=3600
478
479
480
481
482# CACHED HOST CHECK HORIZON
483# This option determines the maximum amount of time (in seconds)
484# that the state of a previous host check is considered current.
485# Cached host states (from host checks that were performed more
486# recently that the timeframe specified by this value) can immensely
487# improve performance in regards to the host check logic.
488# Too high of a value for this option may result in inaccurate host
489# states being used by Nagios, while a lower value may result in a
490# performance hit for host checks. Use a value of 0 to disable host
491# check caching.
492
493cached_host_check_horizon=15
494
495
496
497# CACHED SERVICE CHECK HORIZON
498# This option determines the maximum amount of time (in seconds)
499# that the state of a previous service check is considered current.
500# Cached service states (from service checks that were performed more
501# recently that the timeframe specified by this value) can immensely
502# improve performance in regards to predictive dependency checks.
503# Use a value of 0 to disable service check caching.
504
505cached_service_check_horizon=15
506
507
508
509# ENABLE PREDICTIVE HOST DEPENDENCY CHECKS
510# This option determines whether or not Nagios will attempt to execute
511# checks of hosts when it predicts that future dependency logic test
512# may be needed. These predictive checks can help ensure that your
513# host dependency logic works well.
514# Values:
515# 0 = Disable predictive checks
516# 1 = Enable predictive checks (default)
517
518enable_predictive_host_dependency_checks=1
519
520
521
522# ENABLE PREDICTIVE SERVICE DEPENDENCY CHECKS
523# This option determines whether or not Nagios will attempt to execute
524# checks of service when it predicts that future dependency logic test
525# may be needed. These predictive checks can help ensure that your
526# service dependency logic works well.
527# Values:
528# 0 = Disable predictive checks
529# 1 = Enable predictive checks (default)
530
531enable_predictive_service_dependency_checks=1
532
533
534
535# SOFT STATE DEPENDENCIES
536# This option determines whether or not Nagios will use soft state
537# information when checking host and service dependencies. Normally
538# Nagios will only use the latest hard host or service state when
539# checking dependencies. If you want it to use the latest state (regardless
540# of whether its a soft or hard state type), enable this option.
541# Values:
542# 0 = Don't use soft state dependencies (default)
543# 1 = Use soft state dependencies
544
545soft_state_dependencies=0
546
547
548
549# TIME CHANGE ADJUSTMENT THRESHOLDS
550# These options determine when Nagios will react to detected changes
551# in system time (either forward or backwards).
552
553#time_change_threshold=900
554
555
556
557# AUTO-RESCHEDULING OPTION
558# This option determines whether or not Nagios will attempt to
559# automatically reschedule active host and service checks to
560# "smooth" them out over time. This can help balance the load on
561# the monitoring server.
562# WARNING: THIS IS AN EXPERIMENTAL FEATURE - IT CAN DEGRADE
563# PERFORMANCE, RATHER THAN INCREASE IT, IF USED IMPROPERLY
564
565auto_reschedule_checks=0
566
567
568
569# AUTO-RESCHEDULING INTERVAL
570# This option determines how often (in seconds) Nagios will
571# attempt to automatically reschedule checks. This option only
572# has an effect if the auto_reschedule_checks option is enabled.
573# Default is 30 seconds.
574# WARNING: THIS IS AN EXPERIMENTAL FEATURE - IT CAN DEGRADE
575# PERFORMANCE, RATHER THAN INCREASE IT, IF USED IMPROPERLY
576
577auto_rescheduling_interval=30
578
579
580
581# AUTO-RESCHEDULING WINDOW
582# This option determines the "window" of time (in seconds) that
583# Nagios will look at when automatically rescheduling checks.
584# Only host and service checks that occur in the next X seconds
585# (determined by this variable) will be rescheduled. This option
586# only has an effect if the auto_reschedule_checks option is
587# enabled. Default is 180 seconds (3 minutes).
588# WARNING: THIS IS AN EXPERIMENTAL FEATURE - IT CAN DEGRADE
589# PERFORMANCE, RATHER THAN INCREASE IT, IF USED IMPROPERLY
590
591auto_rescheduling_window=180
592
593
594
595# SLEEP TIME
596# This is the number of seconds to sleep between checking for system
597# events and service checks that need to be run.
598
599sleep_time=0.25
600
601
602
603# TIMEOUT VALUES
604# These options control how much time Nagios will allow various
605# types of commands to execute before killing them off. Options
606# are available for controlling maximum time allotted for
607# service checks, host checks, event handlers, notifications, the
608# ocsp command, and performance data commands. All values are in
609# seconds.
610
611service_check_timeout=60
612host_check_timeout=30
613event_handler_timeout=30
614notification_timeout=30
615ocsp_timeout=5
616perfdata_timeout=5
617
618
619
620# RETAIN STATE INFORMATION
621# This setting determines whether or not Nagios will save state
622# information for services and hosts before it shuts down. Upon
623# startup Nagios will reload all saved service and host state
624# information before starting to monitor. This is useful for
625# maintaining long-term data on state statistics, etc, but will
626# slow Nagios down a bit when it (re)starts. Since its only
627# a one-time penalty, I think its well worth the additional
628# startup delay.
629
630retain_state_information=1
631
632
633
634# STATE RETENTION FILE
635# This is the file that Nagios should use to store host and
636# service state information before it shuts down. The state
637# information in this file is also read immediately prior to
638# starting to monitor the network when Nagios is restarted.
639# This file is used only if the preserve_state_information
640# variable is set to 1.
641
642state_retention_file=/var/spool/nagios/retention.dat
643
644
645
646# RETENTION DATA UPDATE INTERVAL
647# This setting determines how often (in minutes) that Nagios
648# will automatically save retention data during normal operation.
649# If you set this value to 0, Nagios will not save retention
650# data at regular interval, but it will still save retention
651# data before shutting down or restarting. If you have disabled
652# state retention, this option has no effect.
653
654retention_update_interval=60
655
656
657
658# USE RETAINED PROGRAM STATE
659# This setting determines whether or not Nagios will set
660# program status variables based on the values saved in the
661# retention file. If you want to use retained program status
662# information, set this value to 1. If not, set this value
663# to 0.
664
665use_retained_program_state=1
666
667
668
669# USE RETAINED SCHEDULING INFO
670# This setting determines whether or not Nagios will retain
671# the scheduling info (next check time) for hosts and services
672# based on the values saved in the retention file. If you
673# If you want to use retained scheduling info, set this
674# value to 1. If not, set this value to 0.
675
676use_retained_scheduling_info=1
677
678
679
680# RETAINED ATTRIBUTE MASKS (ADVANCED FEATURE)
681# The following variables are used to specify specific host and
682# service attributes that should *not* be retained by Nagios during
683# program restarts.
684#
685# The values of the masks are bitwise ANDs of values specified
686# by the "MODATTR_" definitions found in include/common.h.
687# For example, if you do not want the current enabled/disabled state
688# of flap detection and event handlers for hosts to be retained, you
689# would use a value of 24 for the host attribute mask...
690# MODATTR_EVENT_HANDLER_ENABLED (8) + MODATTR_FLAP_DETECTION_ENABLED (16) = 24
691
692# This mask determines what host attributes are not retained
693retained_host_attribute_mask=0
694
695# This mask determines what service attributes are not retained
696retained_service_attribute_mask=0
697
698# These two masks determine what process attributes are not retained.
699# There are two masks, because some process attributes have host and service
700# options. For example, you can disable active host checks, but leave active
701# service checks enabled.
702retained_process_host_attribute_mask=0
703retained_process_service_attribute_mask=0
704
705# These two masks determine what contact attributes are not retained.
706# There are two masks, because some contact attributes have host and
707# service options. For example, you can disable host notifications for
708# a contact, but leave service notifications enabled for them.
709retained_contact_host_attribute_mask=0
710retained_contact_service_attribute_mask=0
711
712
713
714# INTERVAL LENGTH
715# This is the seconds per unit interval as used in the
716# host/contact/service configuration files. Setting this to 60 means
717# that each interval is one minute long (60 seconds). Other settings
718# have not been tested much, so your mileage is likely to vary...
719
720interval_length=60
721
722
723
724# CHECK FOR UPDATES
725# This option determines whether Nagios will automatically check to
726# see if new updates (releases) are available. It is recommend that you
727# enable this option to ensure that you stay on top of the latest critical
728# patches to Nagios. Nagios is critical to you - make sure you keep it in
729# good shape. Nagios will check once a day for new updates. Data collected
730# by Nagios Enterprises from the update check is processed in accordance
731# with our privacy policy - see http://api.nagios.org for details.
732
733check_for_updates=1
734
735
736
737# BARE UPDATE CHECK
738# This option deterines what data Nagios will send to api.nagios.org when
739# it checks for updates. By default, Nagios will send information on the
740# current version of Nagios you have installed, as well as an indicator as
741# to whether this was a new installation or not. Nagios Enterprises uses
742# this data to determine the number of users running specific version of
743# Nagios. Enable this option if you do not want this information to be sent.
744
745bare_update_check=0
746
747
748
749# AGGRESSIVE HOST CHECKING OPTION
750# If you don't want to turn on aggressive host checking features, set
751# this value to 0 (the default). Otherwise set this value to 1 to
752# enable the aggressive check option. Read the docs for more info
753# on what aggressive host check is or check out the source code in
754# base/checks.c
755
756use_aggressive_host_checking=0
757
758
759
760# SERVICE CHECK EXECUTION OPTION
761# This determines whether or not Nagios will actively execute
762# service checks when it initially starts. If this option is
763# disabled, checks are not actively made, but Nagios can still
764# receive and process passive check results that come in. Unless
765# you're implementing redundant hosts or have a special need for
766# disabling the execution of service checks, leave this enabled!
767# Values: 1 = enable checks, 0 = disable checks
768
769execute_service_checks=1
770
771
772
773# PASSIVE SERVICE CHECK ACCEPTANCE OPTION
774# This determines whether or not Nagios will accept passive
775# service checks results when it initially (re)starts.
776# Values: 1 = accept passive checks, 0 = reject passive checks
777
778accept_passive_service_checks=1
779
780
781
782# HOST CHECK EXECUTION OPTION
783# This determines whether or not Nagios will actively execute
784# host checks when it initially starts. If this option is
785# disabled, checks are not actively made, but Nagios can still
786# receive and process passive check results that come in. Unless
787# you're implementing redundant hosts or have a special need for
788# disabling the execution of host checks, leave this enabled!
789# Values: 1 = enable checks, 0 = disable checks
790
791execute_host_checks=1
792
793
794
795# PASSIVE HOST CHECK ACCEPTANCE OPTION
796# This determines whether or not Nagios will accept passive
797# host checks results when it initially (re)starts.
798# Values: 1 = accept passive checks, 0 = reject passive checks
799
800accept_passive_host_checks=1
801
802
803
804# NOTIFICATIONS OPTION
805# This determines whether or not Nagios will sent out any host or
806# service notifications when it is initially (re)started.
807# Values: 1 = enable notifications, 0 = disable notifications
808
809enable_notifications=1
810
811
812
813# EVENT HANDLER USE OPTION
814# This determines whether or not Nagios will run any host or
815# service event handlers when it is initially (re)started. Unless
816# you're implementing redundant hosts, leave this option enabled.
817# Values: 1 = enable event handlers, 0 = disable event handlers
818
819enable_event_handlers=1
820
821
822
823# PROCESS PERFORMANCE DATA OPTION
824# This determines whether or not Nagios will process performance
825# data returned from service and host checks. If this option is
826# enabled, host performance data will be processed using the
827# host_perfdata_command (defined below) and service performance
828# data will be processed using the service_perfdata_command (also
829# defined below). Read the HTML docs for more information on
830# performance data.
831# Values: 1 = process performance data, 0 = do not process performance data
832
833process_performance_data=1
834
835
836
837# HOST AND SERVICE PERFORMANCE DATA PROCESSING COMMANDS
838# These commands are run after every host and service check is
839# performed. These commands are executed only if the
840# enable_performance_data option (above) is set to 1. The command
841# argument is the short name of a command definition that you
842# define in your host configuration file. Read the HTML docs for
843# more information on performance data.
844
845host_perfdata_command=process-host-perfdata
846service_perfdata_command=process-service-perfdata
847
848# service performance data
849#
850service_perfdata_file=/var/spool/nagios/service-perfdata
851service_perfdata_file_template=DATATYPE::SERVICEPERFDATA\tTIMET::$TIMET$\tHOSTNAME::$HOSTNAME$\tSERVICEDESC::$SERVICEDESC$\tSERVICEPERFDATA::$SERVICEPERFDATA$\tSERVICECHECKCOMMAND::$SERVICECHECKCOMMAND$\tHOSTSTATE::$HOSTSTATE$\tHOSTSTATETYPE::$HOSTSTATETYPE$\tSERVICESTATE::$SERVICESTATE$\tSERVICESTATETYPE::$SERVICESTATETYPE$
852service_perfdata_file_mode=a
853service_perfdata_file_processing_interval=15
854service_perfdata_file_processing_command=process-service-perfdata-file
855
856#
857# host performance data starting with Nagios 3.0
858#
859host_perfdata_file=/var/spool/nagios/host-perfdata
860host_perfdata_file_template=DATATYPE::HOSTPERFDATA\tTIMET::$TIMET$\tHOSTNAME::$HOSTNAME$\tHOSTPERFDATA::$HOSTPERFDATA$\tHOSTCHECKCOMMAND::$HOSTCHECKCOMMAND$\tHOSTSTATE::$HOSTSTATE$\tHOSTSTATETYPE::$HOSTSTATETYPE$
861host_perfdata_file_mode=a
862host_perfdata_file_processing_interval=15
863host_perfdata_file_processing_command=process-host-perfdata-file
864
865
866
867
868# HOST AND SERVICE PERFORMANCE DATA FILES
869# These files are used to store host and service performance data.
870# Performance data is only written to these files if the
871# enable_performance_data option (above) is set to 1.
872
873#host_perfdata_file=/tmp/host-perfdata
874#service_perfdata_file=/tmp/service-perfdata
875
876
877
878# HOST AND SERVICE PERFORMANCE DATA FILE TEMPLATES
879# These options determine what data is written (and how) to the
880# performance data files. The templates may contain macros, special
881# characters (\t for tab, \r for carriage return, \n for newline)
882# and plain text. A newline is automatically added after each write
883# to the performance data file. Some examples of what you can do are
884# shown below.
885
886#host_perfdata_file_template=[HOSTPERFDATA]\t$TIMET$\t$HOSTNAME$\t$HOSTEXECUTIONTIME$\t$HOSTOUTPUT$\t$HOSTPERFDATA$
887#service_perfdata_file_template=[SERVICEPERFDATA]\t$TIMET$\t$HOSTNAME$\t$SERVICEDESC$\t$SERVICEEXECUTIONTIME$\t$SERVICELATENCY$\t$SERVICEOUTPUT$\t$SERVICEPERFDATA$
888
889
890
891# HOST AND SERVICE PERFORMANCE DATA FILE MODES
892# This option determines whether or not the host and service
893# performance data files are opened in write ("w") or append ("a")
894# mode. If you want to use named pipes, you should use the special
895# pipe ("p") mode which avoid blocking at startup, otherwise you will
896# likely want the defult append ("a") mode.
897
898#host_perfdata_file_mode=a
899#service_perfdata_file_mode=a
900
901
902
903# HOST AND SERVICE PERFORMANCE DATA FILE PROCESSING INTERVAL
904# These options determine how often (in seconds) the host and service
905# performance data files are processed using the commands defined
906# below. A value of 0 indicates the files should not be periodically
907# processed.
908
909#host_perfdata_file_processing_interval=0
910#service_perfdata_file_processing_interval=0
911
912
913
914# HOST AND SERVICE PERFORMANCE DATA FILE PROCESSING COMMANDS
915# These commands are used to periodically process the host and
916# service performance data files. The interval at which the
917# processing occurs is determined by the options above.
918
919#host_perfdata_file_processing_command=process-host-perfdata-file
920#service_perfdata_file_processing_command=process-service-perfdata-file
921
922
923
924# OBSESS OVER SERVICE CHECKS OPTION
925# This determines whether or not Nagios will obsess over service
926# checks and run the ocsp_command defined below. Unless you're
927# planning on implementing distributed monitoring, do not enable
928# this option. Read the HTML docs for more information on
929# implementing distributed monitoring.
930# Values: 1 = obsess over services, 0 = do not obsess (default)
931
932obsess_over_services=0
933
934
935
936# OBSESSIVE COMPULSIVE SERVICE PROCESSOR COMMAND
937# This is the command that is run for every service check that is
938# processed by Nagios. This command is executed only if the
939# obsess_over_services option (above) is set to 1. The command
940# argument is the short name of a command definition that you
941# define in your host configuration file. Read the HTML docs for
942# more information on implementing distributed monitoring.
943
944#ocsp_command=somecommand
945
946
947
948# OBSESS OVER HOST CHECKS OPTION
949# This determines whether or not Nagios will obsess over host
950# checks and run the ochp_command defined below. Unless you're
951# planning on implementing distributed monitoring, do not enable
952# this option. Read the HTML docs for more information on
953# implementing distributed monitoring.
954# Values: 1 = obsess over hosts, 0 = do not obsess (default)
955
956obsess_over_hosts=0
957
958
959
960# OBSESSIVE COMPULSIVE HOST PROCESSOR COMMAND
961# This is the command that is run for every host check that is
962# processed by Nagios. This command is executed only if the
963# obsess_over_hosts option (above) is set to 1. The command
964# argument is the short name of a command definition that you
965# define in your host configuration file. Read the HTML docs for
966# more information on implementing distributed monitoring.
967
968#ochp_command=somecommand
969
970
971
972# TRANSLATE PASSIVE HOST CHECKS OPTION
973# This determines whether or not Nagios will translate
974# DOWN/UNREACHABLE passive host check results into their proper
975# state for this instance of Nagios. This option is useful
976# if you have distributed or failover monitoring setup. In
977# these cases your other Nagios servers probably have a different
978# "view" of the network, with regards to the parent/child relationship
979# of hosts. If a distributed monitoring server thinks a host
980# is DOWN, it may actually be UNREACHABLE from the point of
981# this Nagios instance. Enabling this option will tell Nagios
982# to translate any DOWN or UNREACHABLE host states it receives
983# passively into the correct state from the view of this server.
984# Values: 1 = perform translation, 0 = do not translate (default)
985
986translate_passive_host_checks=0
987
988
989
990# PASSIVE HOST CHECKS ARE SOFT OPTION
991# This determines whether or not Nagios will treat passive host
992# checks as being HARD or SOFT. By default, a passive host check
993# result will put a host into a HARD state type. This can be changed
994# by enabling this option.
995# Values: 0 = passive checks are HARD, 1 = passive checks are SOFT
996
997passive_host_checks_are_soft=0
998
999
1000
1001# ORPHANED HOST/SERVICE CHECK OPTIONS
1002# These options determine whether or not Nagios will periodically
1003# check for orphaned host service checks. Since service checks are
1004# not rescheduled until the results of their previous execution
1005# instance are processed, there exists a possibility that some
1006# checks may never get rescheduled. A similar situation exists for
1007# host checks, although the exact scheduling details differ a bit
1008# from service checks. Orphaned checks seem to be a rare
1009# problem and should not happen under normal circumstances.
1010# If you have problems with service checks never getting
1011# rescheduled, make sure you have orphaned service checks enabled.
1012# Values: 1 = enable checks, 0 = disable checks
1013
1014check_for_orphaned_services=1
1015check_for_orphaned_hosts=1
1016
1017
1018
1019# SERVICE FRESHNESS CHECK OPTION
1020# This option determines whether or not Nagios will periodically
1021# check the "freshness" of service results. Enabling this option
1022# is useful for ensuring passive checks are received in a timely
1023# manner.
1024# Values: 1 = enabled freshness checking, 0 = disable freshness checking
1025
1026check_service_freshness=1
1027
1028
1029
1030# SERVICE FRESHNESS CHECK INTERVAL
1031# This setting determines how often (in seconds) Nagios will
1032# check the "freshness" of service check results. If you have
1033# disabled service freshness checking, this option has no effect.
1034
1035service_freshness_check_interval=60
1036
1037
1038
1039# HOST FRESHNESS CHECK OPTION
1040# This option determines whether or not Nagios will periodically
1041# check the "freshness" of host results. Enabling this option
1042# is useful for ensuring passive checks are received in a timely
1043# manner.
1044# Values: 1 = enabled freshness checking, 0 = disable freshness checking
1045
1046check_host_freshness=0
1047
1048
1049
1050# HOST FRESHNESS CHECK INTERVAL
1051# This setting determines how often (in seconds) Nagios will
1052# check the "freshness" of host check results. If you have
1053# disabled host freshness checking, this option has no effect.
1054
1055host_freshness_check_interval=60
1056
1057
1058
1059
1060# ADDITIONAL FRESHNESS THRESHOLD LATENCY
1061# This setting determines the number of seconds that Nagios
1062# will add to any host and service freshness thresholds that
1063# it calculates (those not explicitly specified by the user).
1064
1065additional_freshness_latency=15
1066
1067
1068
1069
1070# FLAP DETECTION OPTION
1071# This option determines whether or not Nagios will try
1072# and detect hosts and services that are "flapping".
1073# Flapping occurs when a host or service changes between
1074# states too frequently. When Nagios detects that a
1075# host or service is flapping, it will temporarily suppress
1076# notifications for that host/service until it stops
1077# flapping. Flap detection is very experimental, so read
1078# the HTML documentation before enabling this feature!
1079# Values: 1 = enable flap detection
1080# 0 = disable flap detection (default)
1081
1082enable_flap_detection=1
1083
1084
1085
1086# FLAP DETECTION THRESHOLDS FOR HOSTS AND SERVICES
1087# Read the HTML documentation on flap detection for
1088# an explanation of what this option does. This option
1089# has no effect if flap detection is disabled.
1090
1091low_service_flap_threshold=5.0
1092high_service_flap_threshold=20.0
1093low_host_flap_threshold=5.0
1094high_host_flap_threshold=20.0
1095
1096
1097
1098# DATE FORMAT OPTION
1099# This option determines how short dates are displayed. Valid options
1100# include:
1101# us (MM-DD-YYYY HH:MM:SS)
1102# euro (DD-MM-YYYY HH:MM:SS)
1103# iso8601 (YYYY-MM-DD HH:MM:SS)
1104# strict-iso8601 (YYYY-MM-DDTHH:MM:SS)
1105#
1106
1107date_format=us
1108
1109
1110
1111
1112# TIMEZONE OFFSET
1113# This option is used to override the default timezone that this
1114# instance of Nagios runs in. If not specified, Nagios will use
1115# the system configured timezone.
1116#
1117# NOTE: In order to display the correct timezone in the CGIs, you
1118# will also need to alter the Apache directives for the CGI path
1119# to include your timezone. Example:
1120#
1121# <Directory "/usr/local/nagios/sbin/">
1122# SetEnv TZ "Australia/Brisbane"
1123# ...
1124# </Directory>
1125
1126#use_timezone=US/Mountain
1127#use_timezone=Australia/Brisbane
1128
1129
1130
1131
1132# P1.PL FILE LOCATION
1133# This value determines where the p1.pl perl script (used by the
1134# embedded Perl interpreter) is located. If you didn't compile
1135# Nagios with embedded Perl support, this option has no effect.
1136
1137p1_file=/usr/local/bin/p1.pl
1138
1139
1140
1141# EMBEDDED PERL INTERPRETER OPTION
1142# This option determines whether or not the embedded Perl interpreter
1143# will be enabled during runtime. This option has no effect if Nagios
1144# has not been compiled with support for embedded Perl.
1145# Values: 0 = disable interpreter, 1 = enable interpreter
1146
1147enable_embedded_perl=1
1148
1149
1150
1151# EMBEDDED PERL USAGE OPTION
1152# This option determines whether or not Nagios will process Perl plugins
1153# and scripts with the embedded Perl interpreter if the plugins/scripts
1154# do not explicitly indicate whether or not it is okay to do so. Read
1155# the HTML documentation on the embedded Perl interpreter for more
1156# information on how this option works.
1157
1158use_embedded_perl_implicitly=1
1159
1160
1161
1162# ILLEGAL OBJECT NAME CHARACTERS
1163# This option allows you to specify illegal characters that cannot
1164# be used in host names, service descriptions, or names of other
1165# object types.
1166
1167illegal_object_name_chars=`~!$%^&*|'"<>?,()=
1168
1169
1170
1171# ILLEGAL MACRO OUTPUT CHARACTERS
1172# This option allows you to specify illegal characters that are
1173# stripped from macros before being used in notifications, event
1174# handlers, etc. This DOES NOT affect macros used in service or
1175# host check commands.
1176# The following macros are stripped of the characters you specify:
1177# $HOSTOUTPUT$
1178# $HOSTPERFDATA$
1179# $HOSTACKAUTHOR$
1180# $HOSTACKCOMMENT$
1181# $SERVICEOUTPUT$
1182# $SERVICEPERFDATA$
1183# $SERVICEACKAUTHOR$
1184# $SERVICEACKCOMMENT$
1185
1186illegal_macro_output_chars=`~$&|'"<>
1187
1188
1189
1190# REGULAR EXPRESSION MATCHING
1191# This option controls whether or not regular expression matching
1192# takes place in the object config files. Regular expression
1193# matching is used to match host, hostgroup, service, and service
1194# group names/descriptions in some fields of various object types.
1195# Values: 1 = enable regexp matching, 0 = disable regexp matching
1196
1197use_regexp_matching=0
1198
1199
1200
1201# "TRUE" REGULAR EXPRESSION MATCHING
1202# This option controls whether or not "true" regular expression
1203# matching takes place in the object config files. This option
1204# only has an effect if regular expression matching is enabled
1205# (see above). If this option is DISABLED, regular expression
1206# matching only occurs if a string contains wildcard characters
1207# (* and ?). If the option is ENABLED, regexp matching occurs
1208# all the time (which can be annoying).
1209# Values: 1 = enable true matching, 0 = disable true matching
1210
1211use_true_regexp_matching=0
1212
1213
1214
1215# ADMINISTRATOR EMAIL/PAGER ADDRESSES
1216# The email and pager address of a global administrator (likely you).
1217# Nagios never uses these values itself, but you can access them by
1218# using the $ADMINEMAIL$ and $ADMINPAGER$ macros in your notification
1219# commands.
1220
1221admin_email=nagios@localhost
1222admin_pager=pagenagios@localhost
1223
1224
1225
1226# DAEMON CORE DUMP OPTION
1227# This option determines whether or not Nagios is allowed to create
1228# a core dump when it runs as a daemon. Note that it is generally
1229# considered bad form to allow this, but it may be useful for
1230# debugging purposes. Enabling this option doesn't guarantee that
1231# a core file will be produced, but that's just life...
1232# Values: 1 - Allow core dumps
1233# 0 - Do not allow core dumps (default)
1234
1235daemon_dumps_core=0
1236
1237
1238
1239# LARGE INSTALLATION TWEAKS OPTION
1240# This option determines whether or not Nagios will take some shortcuts
1241# which can save on memory and CPU usage in large Nagios installations.
1242# Read the documentation for more information on the benefits/tradeoffs
1243# of enabling this option.
1244# Values: 1 - Enabled tweaks
1245# 0 - Disable tweaks (default)
1246
1247use_large_installation_tweaks=0
1248
1249
1250
1251# ENABLE ENVIRONMENT MACROS
1252# This option determines whether or not Nagios will make all standard
1253# macros available as environment variables when host/service checks
1254# and system commands (event handlers, notifications, etc.) are
1255# executed. Enabling this option can cause performance issues in
1256# large installations, as it will consume a bit more memory and (more
1257# importantly) consume more CPU.
1258# Values: 1 - Enable environment variable macros (default)
1259# 0 - Disable environment variable macros
1260
1261enable_environment_macros=1
1262
1263
1264
1265# CHILD PROCESS MEMORY OPTION
1266# This option determines whether or not Nagios will free memory in
1267# child processes (processed used to execute system commands and host/
1268# service checks). If you specify a value here, it will override
1269# program defaults.
1270# Value: 1 - Free memory in child processes
1271# 0 - Do not free memory in child processes
1272
1273#free_child_process_memory=1
1274
1275
1276
1277# CHILD PROCESS FORKING BEHAVIOR
1278# This option determines how Nagios will fork child processes
1279# (used to execute system commands and host/service checks). Normally
1280# child processes are fork()ed twice, which provides a very high level
1281# of isolation from problems. Fork()ing once is probably enough and will
1282# save a great deal on CPU usage (in large installs), so you might
1283# want to consider using this. If you specify a value here, it will
1284# program defaults.
1285# Value: 1 - Child processes fork() twice
1286# 0 - Child processes fork() just once
1287
1288#child_processes_fork_twice=1
1289
1290
1291
1292# DEBUG LEVEL
1293# This option determines how much (if any) debugging information will
1294# be written to the debug file. OR values together to log multiple
1295# types of information.
1296# Values:
1297# -1 = Everything
1298# 0 = Nothing
1299# 1 = Functions
1300# 2 = Configuration
1301# 4 = Process information
1302# 8 = Scheduled events
1303# 16 = Host/service checks
1304# 32 = Notifications
1305# 64 = Event broker
1306# 128 = External commands
1307# 256 = Commands
1308# 512 = Scheduled downtime
1309# 1024 = Comments
1310# 2048 = Macros
1311
1312debug_level=0
1313
1314
1315
1316# DEBUG VERBOSITY
1317# This option determines how verbose the debug log out will be.
1318# Values: 0 = Brief output
1319# 1 = More detailed
1320# 2 = Very detailed
1321
1322debug_verbosity=1
1323
1324
1325
1326# DEBUG FILE
1327# This option determines where Nagios should write debugging information.
1328
1329debug_file=/var/spool/nagios/nagios.debug
1330
1331
1332
1333# MAX DEBUG FILE SIZE
1334# This option determines the maximum size (in bytes) of the debug file. If
1335# the file grows larger than this size, it will be renamed with a .old
1336# extension. If a file already exists with a .old extension it will
1337# automatically be deleted. This helps ensure your disk space usage doesn't
1338# get out of control when debugging Nagios.
1339
1340max_debug_file_size=1000000
1341
1342
Note: See TracBrowser for help on using the repository browser.