From: Peter Palfrader Date: Wed, 19 Dec 2012 12:32:37 +0000 (+0100) Subject: icinga config X-Git-Url: https://git.adam-barratt.org.uk/?a=commitdiff_plain;h=00d52e5f7fb4da2eb1373491e59f90e173880821;p=mirror%2Fdsa-nagios.git icinga config --- diff --git a/config/static/cgi.cfg b/config/static/cgi.cfg index 176499b..1a71ba9 100644 --- a/config/static/cgi.cfg +++ b/config/static/cgi.cfg @@ -1,12 +1,6 @@ -############################################################################# -## THIS FILE IS COPIED TO THE FINAL LOCATION USING PUPPET -## ITS AUTHORITATIVE HOME IS THE DSA-NAGIOS CONFIGURATION GIT -############################################################################# - - ################################################################# # -# CGI.CFG - Sample CGI Configuration File for Nagios +# CGI.CFG - Sample CGI Configuration File for Icinga # ################################################################# @@ -16,38 +10,86 @@ # The CGIs will read the main and host config files for any other # data they might need. -main_config_file=/etc/nagios3/nagios.cfg +main_config_file=/etc/icinga/icinga.cfg + + +# ATTRIBUTE BASED AUTHORIZATION FILE +# This option will include a file defining authroization based on +# attributes. +#authorization_config_file=/etc/icinga/cgiauth.cfg # PHYSICAL HTML PATH -# This is the path where the HTML files for Nagios reside. This +# This is the path where the HTML files for Icinga reside. This # value is used to locate the logo images needed by the statusmap # and statuswrl CGIs. -physical_html_path=/usr/share/nagios3/htdocs +physical_html_path=/usr/share/icinga/htdocs # URL HTML PATH # This is the path portion of the URL that corresponds to the -# physical location of the Nagios HTML files (as defined above). +# physical location of the Icinga HTML files (as defined above). # This value is used by the CGIs to locate the online documentation -# and graphics. If you access the Nagios pages with an URL like -# http://www.myhost.com/nagios, this value should be '/nagios' +# and graphics. If you access the Icinga pages with an URL like +# http://www.myhost.com/icinga, this value should be '/icinga' # (without the quotes). -url_html_path=/nagios3 +url_html_path=/icinga + + + +# URL STYLESHEETS PATH +# This option allows to define an url stylesheet path other than the +# default ($url_html_path/stylesheets). This will be useful when +# adding custom stylesheets in another location. +# If not set, the default location will be used. + +url_stylesheets_path=/icinga/stylesheets +# HTTP CHARSET +# This defines charset that is sent with HTTP headers. + +http_charset=utf-8 + +# NAGIOS PROCESS CHECK COMMAND +# This is the full path and filename of the program used to check +# the status of the Nagios process. It is used only by the CGIs +# and is completely optional. However, if you don't use it, you'll +# see warning messages in the CGIs about the Nagios process +# not running and you won't be able to execute any commands from +# the web interface. The program should follow the same rules +# as plugins; the return codes are the same as for the plugins, +# it should have timeout protection, it should output something +# to STDIO, etc. +# +# Note: The command line for the check_nagios plugin below may +# have to be tweaked a bit, as different versions of the plugin +# use different command line arguments/syntaxes. + +icinga_check_command=/usr/lib/nagios/plugins/check_nagios /var/lib/icinga/status.dat 5 '/usr/sbin/icinga' + # CONTEXT-SENSITIVE HELP # This option determines whether or not a context-sensitive # help icon will be displayed for most of the CGIs. # Values: 0 = disables context-sensitive help # 1 = enables context-sensitive help -show_context_help=1 +show_context_help=0 + + + +# HIGHLIGHT TABLE ROWS +# This option allows you to define if table rows in status.cgi +# will be highlighted or not. +# Values: 0 = disables row highlighting +# 1 = enables row highlighting + +highlight_table_rows=1 @@ -59,19 +101,70 @@ show_context_help=1 use_pending_states=1 -nagios_check_command=/usr/lib/nagios/plugins/check_nagios /var/cache/nagios3/status.dat 5 '/usr/sbin/nagios3' + +# Logging + +# USE LOGGING +# If you want to log information from cgi's (e.g. all submitted commands) +# then set this option to 1, default is 0 (off). +# WARNING: +# This log is highly experimental and changes may occure without notice. Use at your own risk!! + +use_logging=0 + + +# CGI LOG FILE +# This is the cgi log file for information about what users are doing. +# At the moment only submitted commands from cmd.cgi will be logged. + +cgi_log_file=/usr/share/icinga/htdocs/log/icinga-cgi.log + + +# CGI LOG ROTATION METHOD +# This is the log rotation method that should be used to rotate +# the cgi log file. Values are as follows.. +# n = None - don't rotate the log +# h = Hourly rotation (top of the hour) +# d = Daily rotation (midnight every day) +# w = Weekly rotation (midnight on Saturday evening) +# m = Monthly rotation (midnight last day of month) + +cgi_log_rotation_method=d + + +# CGI LOG ARCHIVE PATH +# This is the directory where archived (rotated) cgi log files should be +# placed (assuming you've chosen to do log rotation). + +cgi_log_archive_path=/usr/share/icinga/htdocs/log + + +# FORCE COMMENT +# This option forces the users of to comment every action they perform. +# The comments get logged into cgi log file. This option only has effect +# if logging is switched on. See option "use_logging" +# Default is 0 (off), to activate it set it to 1 (on). + +enforce_comments_on_actions=0 + + +# FIRST DAY OF WEEK +# Here you can set if your week starts on sunday or monday. +# Default is 0 (Sunday), set it to 1 if your week start monday. + +first_day_of_week=0 # AUTHENTICATION USAGE -# This option controls whether or not the CGIs will use any +# This option controls whether or not the CGIs will use any # authentication when displaying host and service information, as -# well as committing commands to Nagios for processing. +# well as committing commands to Icinga for processing. # # Read the HTML documentation to learn how the authorization works! # # NOTE: It is a really *bad* idea to disable authorization, unless # you plan on removing the command CGI (cmd.cgi)! Failure to do -# so will leave you wide open to kiddies messing with Nagios and +# so will leave you wide open to kiddies messing with Icinga and # possibly hitting you with a denial of service attack by filling up # your drive by continuously writing to your command file! # @@ -107,21 +200,23 @@ use_ssl_authentication=0 # access to the CGIs has been authenticated in some manner! If you # define this variable, anyone who has not authenticated to the web # server will inherit all rights you assign to this user! - + #default_user_name=guest # SYSTEM/PROCESS INFORMATION ACCESS # This option is a comma-delimited list of all usernames that -# have access to viewing the Nagios process information as +# have access to viewing the Icinga process information as # provided by the Extended Information CGI (extinfo.cgi). By # default, *no one* has access to this unless you choose to # not use authorization. You may use an asterisk (*) to # authorize any user who has authenticated to the web server. +# Alternatively you can specify contactgroups too, starting +# with Icinga 1.5.0 -authorized_for_system_information=nagiosadmin - +authorized_for_system_information=icingaadmin +#authorized_contactgroup_for_system_information= # CONFIGURATION INFORMATION ACCESS @@ -131,22 +226,39 @@ authorized_for_system_information=nagiosadmin # for the hosts and services they are contacts for. You may use # an asterisk (*) to authorize any user who has authenticated # to the web server. +# Alternatively you can specify contactgroups too, starting +# with Icinga 1.5.0 -authorized_for_configuration_information=nagiosadmin +authorized_for_configuration_information=icingaadmin +#authorized_contactgroup_for_configuration_information= +# RAW COMMANDLINE CONFIGURATION INFORMATION ACCESS +# This option is a comma-delimited list of all usernames that +# can view a command in config command expander as icinga would +# execute it. To resolve all MACROS it is necessary to allow +# read access to the web server for resource.cfg . +# CAUTION: $USERXX$ vars and custom vars can contain sensitive +# data. +# Alternatively you can specify contactgroups too. + +authorized_for_full_command_resolution=icingaadmin +#authorized_contactgroup_for_full_command_resolution= + # SYSTEM/PROCESS COMMAND ACCESS # This option is a comma-delimited list of all usernames that -# can issue shutdown and restart commands to Nagios via the +# can issue shutdown and restart commands to Icinga via the # command CGI (cmd.cgi). Users in this list can also change # the program mode to active or standby. By default, *no one* # has access to this unless you choose to not use authorization. # You may use an asterisk (*) to authorize any user who has # authenticated to the web server. +# Alternatively you can specify contactgroups too, starting +# with Icinga 1.5.0 -authorized_for_system_commands=nagiosadmin - +authorized_for_system_commands=icingaadmin +#authorized_contactgroup_for_system_commands= # GLOBAL HOST/SERVICE VIEW ACCESS @@ -156,32 +268,71 @@ authorized_for_system_commands=nagiosadmin # for hosts or services that they are contacts for (unless you # you choose to not use authorization). You may use an asterisk (*) # to authorize any user who has authenticated to the web server. +# Alternatively you can specify contactgroups too, starting +# with Icinga 1.5.0 -authorized_for_all_services=dsa-guest,nagiosadmin -authorized_for_all_hosts=dsa-guest,nagiosadmin - +authorized_for_all_services=dsa-guest,icingaadmin +authorized_for_all_hosts=dsa-guest,icingaadmin +#authorized_contactgroup_for_all_services= +#authorized_contactgroup_for_all_hosts= # GLOBAL HOST/SERVICE COMMAND ACCESS # These two options are comma-delimited lists of all usernames that # can issue host or service related commands via the command -# CGI (cmd.cgi) for all hosts and services that are being monitored. -# By default, users can only issue commands for hosts or services -# that they are contacts for (unless you you choose to not use +# CGI (cmd.cgi) for all hosts and services that are being monitored. +# By default, users can only issue commands for hosts or services +# that they are contacts for (unless you you choose to not use # authorization). You may use an asterisk (*) to authorize any # user who has authenticated to the web server. +# Alternatively you can specify contactgroups too, starting +# with Icinga 1.5.0 + +authorized_for_all_service_commands=icingaadmin +authorized_for_all_host_commands=icingaadmin +#authorized_contactgroup_for_all_service_commands= +#authorized_contactgroup_for_all_host_commands= + + +# READ-ONLY USERS +# A comma-delimited list of usernames that have read-only rights in +# the CGIs. This will block any service or host commands normally shown +# on the extinfo CGI pages. It will also block comments from being shown +# to read-only users. +# Alternatively you can specify contactgroups too, starting +# with Icinga 1.5.0 -authorized_for_all_service_commands=nagiosadmin -authorized_for_all_host_commands=nagiosadmin +#authorized_for_read_only=user1,user2 +#authorized_contactgroup_for_read_only= +# SHOW ALL SERVICES THE HOST IS AUTHORIZED FOR +# By default, a user can see all services on a host, if the user is +# authorized as contact for the host only. By disabling this option, +# the user must be an authorized contact for the service too in order +# to view it. +# Values: 0 - disabled, user must be authorized for services too +# 1 - enabled, user can view all services on authorized host + +show_all_services_host_is_authorized_for=1 + + +# SHOW PARTIAL HOSTGROUPS +# By default, a user only sees a hostgroup and the hosts within it if +# they are an authorized contact for all of the hosts of the group. By +# enabling this option hostgroups will show a partial listing of hosts +# the user is an authorized contact for in the hostgroups. +# Values: 0 - disabled, user only sees full hostgroups (default) +# 1 - enabled, user sees partial hostgroups + +show_partial_hostgroups=0 # STATUSMAP BACKGROUND IMAGE -# This option allows you to specify an image to be used as a +# This option allows you to specify an image to be used as a # background in the statusmap CGI. It is assumed that the image -# resides in the HTML images path (i.e. /usr/local/nagios/share/images). +# resides in the HTML images path (i.e. /usr/local/icinga/share/images). # This path is automatically determined by appending "/images" # to the path specified by the 'physical_html_path' directive. # Note: The image file may be in GIF, PNG, JPEG, or GD2 format. @@ -193,6 +344,20 @@ authorized_for_all_host_commands=nagiosadmin + +# STATUSMAP TRANSPARENCY INDEX COLOR +# These options set the r,g,b values of the background color used the statusmap CGI, +# so normal browsers that can't show real png transparency set the desired color as +# a background color instead (to make it look pretty). +# Defaults to white: (R,G,B) = (255,255,255). + +#color_transparency_index_r=255 +#color_transparency_index_g=255 +#color_transparency_index_b=255 + + + + # DEFAULT STATUSMAP LAYOUT METHOD # This option allows you to specify the default layout method # the statusmap CGI should use for drawing hosts. If you do @@ -224,9 +389,9 @@ default_statuswrl_layout=4 # STATUSWRL INCLUDE -# This option allows you to include your own objects in the +# This option allows you to include your own objects in the # generated VRML world. It is assumed that the file -# resides in the HTML path (i.e. /usr/local/nagios/share). +# resides in the HTML path (i.e. /usr/local/icinga/share). #statuswrl_include=myworld.wrl @@ -250,11 +415,19 @@ ping_syntax=/bin/ping -n -U -c 5 $HOSTADDRESS$ # REFRESH RATE # This option allows you to specify the refresh rate in seconds -# of various CGIs (status, statusmap, extinfo, and outages). +# of various CGIs (extinfo, outages, status, statusmap and tac). refresh_rate=90 +# REFRESH TYPE +# This option determines what type of refresh should be used. +# You can choose between http header and javascript. By +# default javascript (1) is activated. If you have trouble +# using javascript then try refresh via http header (0). + +refresh_type=1 + # ESCAPE HTML TAGS # This option determines whether HTML tags in host and service @@ -265,6 +438,13 @@ escape_html_tags=1 +# PERSISTENT ACKNOWLEDGEMENT COMMENTS +# This options determines whether the initial state of the +# checkbox "Persistent Comment:" for service and host problem +# acknowledgements is checked or unchecked + +persistent_ack_comments=0 + # SOUND OPTIONS # These options allow you to specify an optional audio file @@ -281,7 +461,7 @@ escape_html_tags=1 # = # # Note: All audio files must be placed in the /media subdirectory -# under the HTML path (i.e. /usr/local/nagios/share/media/). +# under the HTML path (i.e. /usr/local/icinga/share/media/). #host_unreachable_sound=hostdown.wav #host_down_sound=hostdown.wav @@ -293,19 +473,21 @@ escape_html_tags=1 # URL TARGET FRAMES -# These options determine the target frames in which notes and -# action URLs will open. +# These options determine the target frames in which notes and +# action URLs will open. Default is main frame. -action_url_target=_blank -notes_url_target=_blank +action_url_target=main +notes_url_target=main +#action_url_target=_blank +#notes_url_target=_blank # LOCK AUTHOR NAMES OPTION -# This option determines whether users can change the author name -# when submitting comments, scheduling downtime. If disabled, the -# author names will be locked into their contact name, as defined in Nagios. +# This option determines whether users can change the author name +# when submitting comments, scheduling downtime. If disabled, the +# author names will be locked into their contact name, as defined in Icinga. # Values: 0 = allow editing author names # 1 = lock author names (disallow editing) @@ -313,6 +495,183 @@ lock_author_names=1 +# DEFAULT DOWNTIME DURATION +# This option defines the default duration (in seconds) of fixed and +# flexible downtimes. Default is 7200 seconds (2 hours). + +default_downtime_duration=7200 + + + +# DEFAULT EXPIRING ACKNOWLEDGEMENT DURATION +# This option defines the default duration (in seconds) of a expiring +# acknowledgement. Default is 86400 seconds (1 day). + +default_expiring_acknowledgement_duration=86400 + + + +# SHOW LONG PLUGIN OUTPUT IN STATUS OPTION +# This option allows you to specify the length of status information +# in output of status.cgi. If you set the value to 1 it shows the +# full plugin output instead of the first line only. +# Default value is 0. + +status_show_long_plugin_output=0 + + + +# DISPLAY STATUS TOTAL +# This option allows you to specify if the +# Host Status Totals and Service Status Totals +# should be displayed. +# Default value is 0. + +display_status_totals=0 + + + +# SHOW ONLY HARD STATES IN TAC OPTION +# This options allows you to specify if the tactical overview +# should only show hard states on hosts and services. +# By default disabled, all states will be shown. + +tac_show_only_hard_state=0 + + + +# SHOW CHILD HOSTS IN EXTINFO OPTION +# This Option allows you to specify if the extended host information +# cgi will show child hosts for the selected host. +# 0 = disabled +# 1 = only show immediate child hosts +# 2 = show immediate and all child hosts +# NOTE: Option 2 could be a real performance killer in +# large installations, so use with care. +# By default disabled, as this could be a performance killer. + +extinfo_show_child_hosts=0 + + + +# SUPPRESS MAINTENANCE DOWNTIME +# This options suppresses the state coloring of hosts and services +# that are in a scheduled downtime. It sets their coloring to gray, +# so they no longer draw extra attention to themselves, making it +# so only actual problems are the ones that stand out. +# By default it is disabled. + +suppress_maintenance_downtime=0 + + +# SHOW TAC INFORMATION IN TOP FRAME +# This options places tactical overview information in +# the top frame similar to the view that's in icinga-web. +# By default it is enabled. + +show_tac_header=1 + + +# SHOW PENDING IN TAC HEADER +# This options enables the display of pending counts in +# the tac header. If your display is less than 1024x768 +# and this is enabled, the tactical information may not +# fit well in the top frame. +# By default it is enabled. + +show_tac_header_pending=1 + + + +# SHOW INITIAL STATES IN SHOWLOG OPTION +# This options allows you to specify if initial states +# of hosts and services should be shown in showlog.cgi +# Note: This Option only works if the option +# "log_initial_states" in icinga.cfg is set to 1. +# By default it's enabled. Default is 0. + +#showlog_initial_states=0 + + + +# SHOW CURRENT STATES IN SHOWLOG OPTION +# This options allows you to specify if current states +# of hosts and services should be shown in showlog.cgi +# Note: This Option only works if the option +# "log_current_states" in icinga.cfg is set to 1. +# By default it's enabled. Default is 0. + +#showlog_current_states=0 + + + +# DEFAULT NUM DISPLAYED LOG ENTRIES OPTION +# This options specifies the number of log entries +# displayed by default in showlog.cgi. To display +# all log entries by default set this value to 0. +# Default is 10000. + +#default_num_displayed_log_entries=10000 + + + +# CSV DELIMITER +# This option determines the character which should act as +# delimiter. Default is ";". + +#csv_delimiter=; + + + +# CSV DATA ENCLOSURE +# This option determines the character which should act as +# data enclosure to wrap in the data. Default is "'". + +#csv_data_enclosure=' + + + +# TAB-FRIENDLY S +# Activating this option changes the <title> of status.cgi +# and extinfo.cgi when they refer to a single host, service, +# or group. They will then read: +# [Host] +# {HostGroup} +# ServiceDesc @ Host +# (ServiceGroup) +# These are easier to read and find if you use (many) tabs +# in your browser. +# Default is enabled. 0=disabled, 1=enabled + +tab_friendly_titles=1 + + +# SERVICE STATES TO ANNOTATE WITH CURRENT NOTIFICATION NO. +# Set this to an OR of the service state identifiers for +# which status.cgi should not only report "Attempts" (e.g., +# "3/3" for a HARD non-OK state with max_check_attempts=3) +# but also the current notification number ("(#0)" if no +# problem notification has been sent yet, etc.). This is +# helpful to identify services which switched between +# different non-OK states a lot, or services which have a +# first_notification_delay set and are "not yet officially" +# considered in trouble. +# Relevant values from include/statusdata.h (look them up +# *there* if you want to be *really* sure): +# #define SERVICE_PENDING 1 +# #define SERVICE_OK 2 +# #define SERVICE_WARNING 4 +# #define SERVICE_UNKNOWN 8 +# #define SERVICE_CRITICAL 16 +# You'll likely want to use add_notif_num_hard=0 (default) +# or add_notif_num_hard=28 (warn+crit+unknown). There's an +# add_notif_num_soft affecting services in a SOFT state +# for sake of completeness, too. + +#add_notif_num_hard=28 +#add_notif_num_soft=0 + + # SPLUNK INTEGRATION OPTIONS # These options allow you to enable integration with Splunk @@ -334,3 +693,4 @@ lock_author_names=1 #splunk_url=http://127.0.0.1:8000/ + diff --git a/config/static/icinga.cfg b/config/static/icinga.cfg index 9de2952..f58420d 100644 --- a/config/static/icinga.cfg +++ b/config/static/icinga.cfg @@ -1,93 +1,71 @@ -############################################################################# -## THIS FILE IS COPIED TO THE FINAL LOCATION USING PUPPET -## ITS AUTHORITATIVE HOME IS THE DSA-NAGIOS CONFIGURATION GIT -############################################################################# - ############################################################################## # -# NAGIOS.CFG - Sample Main Config File for Nagios +# ICINGA.CFG - Sample Main Config File for Icinga # +# Read the documentation for more information on this configuration +# file. I've provided some comments here, but things may not be so +# clear without further explanation. # ############################################################################## # LOG FILE # This is the main log file where service and host events are logged -# for historical purposes. This should be the first option specified +# for historical purposes. This should be the first option specified # in the config file!!! -log_file=/var/log/nagios3/nagios.log +log_file=/var/log/icinga/icinga.log # Commands definitions -cfg_file=/etc/nagios3/commands.cfg +cfg_file=/etc/icinga/commands.cfg # Debian also defaults to using the check commands defined by the debian # nagios-plugins package cfg_dir=/etc/nagios-plugins/config -# Debian uses by default a configuration directory where nagios3-common, -# other packages and the local admin can dump or link configuration -# files into. -cfg_dir=/etc/nagios3/puppetconf.d - # OBJECT CONFIGURATION FILE(S) # These are the object configuration files in which you define hosts, # host groups, contacts, contact groups, services, etc. -# You can split your object definitions across several config files -# if you wish (as shown below), or keep them all in a single config file. - -# You can specify individual object config files as shown below: -#cfg_file=/etc/nagios3/objects/commands.cfg -#cfg_file=/etc/nagios3/objects/contacts.cfg -#cfg_file=/etc/nagios3/objects/timeperiods.cfg -#cfg_file=/etc/nagios3/objects/templates.cfg - -# Definitions for monitoring a Windows machine -#cfg_file=/etc/nagios3/objects/windows.cfg - -# Definitions for monitoring a router/switch -#cfg_file=/etc/nagios3/objects/switch.cfg - -# Definitions for monitoring a network printer -#cfg_file=/etc/nagios3/objects/printer.cfg - +# Hint: Check the docs/wiki on how to monitor remote hosts with different +# transport methods and plugins -# You can also tell Nagios to process all config files (with a .cfg -# extension) in a particular directory by using the cfg_dir -# directive as shown below: +# Debian uses by default a configuration directory where icinga-common, +# other packages and the local admin can dump or link configuration +# files into. +cfg_dir=/etc/icinga/objects/ -#cfg_dir=/etc/nagios3/servers -#cfg_dir=/etc/nagios3/printers -#cfg_dir=/etc/nagios3/switches -#cfg_dir=/etc/nagios3/routers +# Definitions for ido2db process checks +#cfg_file=/etc/icinga/objects/ido2db_check_proc.cfg +# Definitions for broker modules like idoutils.cfg +cfg_dir=/etc/icinga/modules # OBJECT CACHE FILE # This option determines where object definitions are cached when -# Nagios starts/restarts. The CGIs read object definitions from +# Icinga starts/restarts. The CGIs read object definitions from # this cache file (rather than looking at the object config files # directly) in order to prevent inconsistencies that can occur -# when the config files are modified after Nagios starts. +# when the config files are modified after Icinga starts. -object_cache_file=/var/cache/nagios3/objects.cache +object_cache_file=/var/cache/icinga/objects.cache # PRE-CACHED OBJECT FILE # This options determines the location of the precached object file. -# If you run Nagios with the -p command line option, it will preprocess +# If you run Icinga with the -p command line option, it will preprocess # your object configuration file(s) and write the cached config to this -# file. You can then start Nagios with the -u option to have it read +# file. You can then start Icinga with the -u option to have it read # object definitions from this precached file, rather than the standard # object configuration files (see the cfg_file and cfg_dir options above). -# Using a precached object file can speed up the time needed to (re)start -# the Nagios process if you've got a large and/or complex configuration. -# Read the documentation section on optimizing Nagios to find our more +# Using a precached object file can speed up the time needed to (re)start +# the Icinga process if you've got a large and/or complex configuration. +# Read the documentation section on optimizing Icinga to find our more # about how this feature works. -precached_object_file=/var/lib/nagios3/objects.precache +precached_object_file=/var/cache/icinga/objects.precache @@ -100,68 +78,70 @@ precached_object_file=/var/lib/nagios3/objects.precache # defined as macros in this file and restrictive permissions (600) # can be placed on this file. -resource_file=/etc/nagios3/resource.cfg +resource_file=/etc/icinga/resource.cfg # STATUS FILE # This is where the current status of all monitored services and # hosts is stored. Its contents are read and processed by the CGIs. -# The contents of the status file are deleted every time Nagios +# The contents of the status file are deleted every time Icinga # restarts. -status_file=/var/cache/nagios3/status.dat +status_file=/var/lib/icinga/status.dat # STATUS FILE UPDATE INTERVAL # This option determines the frequency (in seconds) that -# Nagios will periodically dump program, host, and +# Icinga will periodically dump program, host, and # service status data. +# Increase the value, if you don't require it that often. +#status_update_interval=30 status_update_interval=10 -# NAGIOS USER -# This determines the effective user that Nagios should run as. +# ICINGA USER +# This determines the effective user that Icinga should run as. # You can either supply a username or a UID. -nagios_user=nagios +icinga_user=nagios -# NAGIOS GROUP -# This determines the effective group that Nagios should run as. +# ICINGA GROUP +# This determines the effective group that Icinga should run as. # You can either supply a group name or a GID. -nagios_group=nagios +icinga_group=nagios # EXTERNAL COMMAND OPTION -# This option allows you to specify whether or not Nagios should check +# This option allows you to specify whether or not Icinga should check # for external commands (in the command file defined below). By default -# Nagios will *not* check for external commands, just to be on the +# Icinga will *not* check for external commands, just to be on the # cautious side. If you want to be able to use the CGI command interface # you will have to enable this. # Values: 0 = disable commands, 1 = enable commands -check_external_commands=1 +check_external_commands=0 # EXTERNAL COMMAND CHECK INTERVAL -# This is the interval at which Nagios should check for external commands. +# This is the interval at which Icinga should check for external commands. # This value works of the interval_length you specify later. If you leave # that at its default value of 60 (seconds), a value of 1 here will cause -# Nagios to check for external commands every minute. If you specify a +# Icinga to check for external commands every minute. If you specify a # number followed by an "s" (i.e. 15s), this will be interpreted to mean # actual seconds rather than a multiple of the interval_length variable. # Note: In addition to reading the external command file at regularly -# scheduled intervals, Nagios will also check for external commands after +# scheduled intervals, Icinga will also check for external commands after # event handlers are executed. -# NOTE: Setting this value to -1 causes Nagios to check the external +# NOTE: Setting this value to -1 causes Icinga to check the external # command file as often as possible. #command_check_interval=15s @@ -170,7 +150,7 @@ command_check_interval=-1 # EXTERNAL COMMAND FILE -# This is the file that Nagios checks for external command requests. +# This is the file that Icinga checks for external command requests. # It is also where the command CGI will write commands that are submitted # by users, so it must be writeable by the user that the web server # is running as (usually 'nobody'). Permissions should be set at the @@ -179,40 +159,43 @@ command_check_interval=-1 # Debian Users: In case you didn't read README.Debian yet, _NOW_ is the # time to do it. -command_file=/var/lib/nagios3/rw/nagios.cmd +command_file=/var/lib/icinga/rw/icinga.cmd # EXTERNAL COMMAND BUFFER SLOTS # This settings is used to tweak the number of items or "slots" that -# the Nagios daemon should allocate to the buffer that holds incoming -# external commands before they are processed. As external commands -# are processed by the daemon, they are removed from the buffer. +# the Icinga daemon should allocate to the buffer that holds incoming +# external commands before they are processed. As external commands +# are processed by the daemon, they are removed from the buffer. +# Increase the value, if you are using addons like check_mk supplying +# more external commands (passive check results) than usual. +#external_command_buffer_slots=32768 external_command_buffer_slots=4096 # LOCK FILE -# This is the lockfile that Nagios will use to store its PID number +# This is the lockfile that Icinga will use to store its PID number # in when it is running in daemon mode. -lock_file=/var/run/nagios3/nagios3.pid +lock_file=/var/run/icinga/icinga.pid # TEMP FILE -# This is a temporary file that is used as scratch space when Nagios +# This is a temporary file that is used as scratch space when Icinga # updates the status log, cleans the comment file, etc. This file -# is created, used, and deleted throughout the time that Nagios is +# is created, used, and deleted throughout the time that Icinga is # running. -temp_file=/var/cache/nagios3/nagios.tmp +temp_file=/var/cache/icinga/icinga.tmp # TEMP PATH -# This is path where Nagios can create temp files for service and +# This is path where Icinga can create temp files for service and # host check results, etc. temp_path=/tmp @@ -230,34 +213,49 @@ event_broker_options=-1 # EVENT BROKER MODULE(S) -# This directive is used to specify an event broker module that should -# by loaded by Nagios at startup. Use multiple directives if you want +# ----> use the new *module definition* instead: +# ----> http://docs.icinga.org/latest/en/objectdefinitions.html +# +# This directive can be used to specify an event broker module that should +# by loaded by Icinga at startup. Use multiple directives if you want # to load more than one module. Arguments that should be passed to # the module at startup are seperated from the module path by a space. # #!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! # WARNING !!! WARNING !!! WARNING !!! WARNING !!! WARNING !!! WARNING #!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -# -# Do NOT overwrite modules while they are being used by Nagios or Nagios -# will crash in a fiery display of SEGFAULT glory. This is a bug/limitation -# either in dlopen(), the kernel, and/or the filesystem. And maybe Nagios... +# Do NOT overwrite modules while they are being used by Icinga or Icinga +# will crash in a fiery display of SEGFAULT glory. # # The correct/safe way of updating a module is by using one of these methods: -# 1. Shutdown Nagios, replace the module file, restart Nagios -# 2. Delete the original module file, move the new module file into place, restart Nagios +# 1. Shutdown Icinga, replace the module file, restart Icinga +# 2. Delete the original module file, move the new module file into place, restart Icinga # -# Example: +#!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +# WARNING !!! WARNING !!! WARNING !!! WARNING !!! WARNING !!! WARNING +#!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +# +# IDOUtils idomod.so should be enabled using the module definition, +# i.e. using a package. First check that, and if not, you can +# enable it here. # +# ATTENTION: DO NOT load the same module here AND as a module definition. +# This can lead into problems with races on ressources. +# +# Example: # broker_module=<modulepath> [moduleargs] -#broker_module=/somewhere/module1.o -#broker_module=/somewhere/module2.o arg1 arg2=3 debug=0 +# Enabling idoutils in icinga.cfg is not recommended. If you want to +# enable idoutils in Debian install icinga-idoutils and copy +# /usr/share/doc/icinga-idoutils/examples/idoutils.cfg-sample to +# /etc/icinga/modules/idoutils.cfg. +# Don't forget to also enable the daemon in /etc/default/icinga +#broker_module=/usr/lib/icinga/idomod.so config_file=/etc/icinga/idomod.cfg # LOG ROTATION METHOD -# This is the log rotation method that Nagios should use to rotate +# This is the log rotation method that Icinga should use to rotate # the main log file. Values are as follows.. # n = None - don't rotate the log # h = Hourly rotation (top of the hour) @@ -273,18 +271,42 @@ log_rotation_method=d # This is the directory where archived (rotated) log files should be # placed (assuming you've chosen to do log rotation). -log_archive_path=/var/log/nagios3/archives +log_archive_path=/var/log/icinga/archives + + + +# LOGGING OPTIONS FOR DAEMON +# If you want messages logged to the daemon log file (usually icinga.log). +# Default option is 1 (yes), the other valid option is 0 (no) +use_daemon_log=1 -# LOGGING OPTIONS + +# LOGGING OPTIONS FOR SYSLOG # If you want messages logged to the syslog facility, as well as the -# Nagios log file set this option to 1. If not, set it to 0. +# Icinga log file set this option to 1. If not, set it to 0. use_syslog=1 +# SYSLOG FACILITY +# If you enabled use_syslog you can set icinga to use a local facility +# instead of the default.To enable set this option to 1, if not, set it to 0. + +use_syslog_local_facility=0 + + + +# SYSLOG LOCAL FACILITY +# If you specified the use_syslog_local_facility you can chose which +# local facility to use. Valid values are from 0 to 7 + +syslog_local_facility=5 + + + # NOTIFICATION LOGGING OPTION # If you don't want notifications to be logged, set this value to 0. # If notifications should be logged, set the value to 1. @@ -319,7 +341,7 @@ log_event_handlers=1 # INITIAL STATES LOGGING OPTION -# If you want Nagios to log all initial host and service states to +# If you want Icinga to log all initial host and service states to # the main log file (the first time the service or host is checked) # you can enable this option by setting this value to 1. If you # are not using an external application that does long term state @@ -330,8 +352,17 @@ log_initial_states=0 +# CURRENT STATES LOGGING OPTION +# If you don't want Icinga to log all current host and service states +# after log has been rotated to the main log file, you can disable this +# option by setting this value to 0. Default value is 1. + +log_current_states=1 + + + # EXTERNAL COMMANDS LOGGING OPTION -# If you don't want Nagios to log external commands, set this value +# If you don't want Icinga to log external commands, set this value # to 0. If external commands should be logged, set this value to 1. # Note: This option does not include logging of passive service # checks - see the option below for controlling whether or not @@ -342,7 +373,7 @@ log_external_commands=1 # PASSIVE CHECKS LOGGING OPTION -# If you don't want Nagios to log passive host and service checks, set +# If you don't want Icinga to log passive host and service checks, set # this value to 0. If passive checks should be logged, set # this value to 1. @@ -350,6 +381,15 @@ log_passive_checks=1 +# LONG PLUGIN OUTPUT LOGGING OPTION +# If you want Icinga to log the complete text of the plugin output +# to the log instead of only the first line then set this value to 1. +# Default value is 0. + +log_long_plugin_output=0 + + + # GLOBAL HOST AND SERVICE EVENT HANDLERS # These options allow you to specify a host and service event handler # command that is to be run for every host or service state change. @@ -365,7 +405,7 @@ log_passive_checks=1 # SERVICE INTER-CHECK DELAY METHOD -# This is the method that Nagios should use when initially +# This is the method that Icinga should use when initially # "spreading out" service checks when it starts monitoring. The # default is to use smart delay calculation, which will try to # space all service checks out evenly to minimize CPU load. @@ -396,7 +436,7 @@ max_service_check_spread=30 # Interleaving the service checks allows for a more even # distribution of service checks and reduced load on remote # hosts. Setting this value to 1 is equivalent to how versions -# of Nagios previous to 0.0.5 did service checks. Set this +# of Icinga previous to 0.0.5 did service checks. Set this # value to s (smart) for automatic calculation of the interleave # factor unless you have a specific reason to change it. # s = Use "smart" interleave factor calculation @@ -408,7 +448,7 @@ service_interleave_factor=s # HOST INTER-CHECK DELAY METHOD -# This is the method that Nagios should use when initially +# This is the method that Icinga should use when initially # "spreading out" host checks when it starts monitoring. The # default is to use smart delay calculation, which will try to # space all host checks out evenly to minimize CPU load. @@ -445,9 +485,12 @@ max_concurrent_checks=0 # HOST AND SERVICE CHECK REAPER FREQUENCY -# This is the frequency (in seconds!) that Nagios will process +# This is the frequency (in seconds!) that Icinga will process # the results of host and service checks. +# Lower this value in larger environments to allow faster +# check result processing (requires more cpu power). +#check_result_reaper_frequency=1 check_result_reaper_frequency=10 @@ -456,7 +499,7 @@ check_result_reaper_frequency=10 # MAX CHECK RESULT REAPER TIME # This is the max amount of time (in seconds) that a single # check result reaper event will be allowed to run before -# returning control back to Nagios so it can perform other +# returning control back to Icinga so it can perform other # duties. max_check_result_reaper_time=30 @@ -465,13 +508,13 @@ max_check_result_reaper_time=30 # CHECK RESULT PATH -# This is directory where Nagios stores the results of host and +# This is directory where Icinga stores the results of host and # service checks that have not yet been processed. # -# Note: Make sure that only one instance of Nagios has access +# Note: Make sure that only one instance of Icinga has access # to this directory! -check_result_path=/var/lib/nagios3/spool/checkresults +check_result_path=/var/lib/icinga/spool/checkresults @@ -493,7 +536,7 @@ max_check_result_file_age=3600 # recently that the timeframe specified by this value) can immensely # improve performance in regards to the host check logic. # Too high of a value for this option may result in inaccurate host -# states being used by Nagios, while a lower value may result in a +# states being used by Icinga, while a lower value may result in a # performance hit for host checks. Use a value of 0 to disable host # check caching. @@ -514,7 +557,7 @@ cached_service_check_horizon=15 # ENABLE PREDICTIVE HOST DEPENDENCY CHECKS -# This option determines whether or not Nagios will attempt to execute +# This option determines whether or not Icinga will attempt to execute # checks of hosts when it predicts that future dependency logic test # may be needed. These predictive checks can help ensure that your # host dependency logic works well. @@ -527,7 +570,7 @@ enable_predictive_host_dependency_checks=1 # ENABLE PREDICTIVE SERVICE DEPENDENCY CHECKS -# This option determines whether or not Nagios will attempt to execute +# This option determines whether or not Icinga will attempt to execute # checks of service when it predicts that future dependency logic test # may be needed. These predictive checks can help ensure that your # service dependency logic works well. @@ -540,9 +583,9 @@ enable_predictive_service_dependency_checks=1 # SOFT STATE DEPENDENCIES -# This option determines whether or not Nagios will use soft state +# This option determines whether or not Icinga will use soft state # information when checking host and service dependencies. Normally -# Nagios will only use the latest hard host or service state when +# Icinga will only use the latest hard host or service state when # checking dependencies. If you want it to use the latest state (regardless # of whether its a soft or hard state type), enable this option. # Values: @@ -554,7 +597,7 @@ soft_state_dependencies=0 # TIME CHANGE ADJUSTMENT THRESHOLDS -# These options determine when Nagios will react to detected changes +# These options determine when Icinga will react to detected changes # in system time (either forward or backwards). #time_change_threshold=900 @@ -562,7 +605,7 @@ soft_state_dependencies=0 # AUTO-RESCHEDULING OPTION -# This option determines whether or not Nagios will attempt to +# This option determines whether or not Icinga will attempt to # automatically reschedule active host and service checks to # "smooth" them out over time. This can help balance the load on # the monitoring server. @@ -574,7 +617,7 @@ auto_reschedule_checks=0 # AUTO-RESCHEDULING INTERVAL -# This option determines how often (in seconds) Nagios will +# This option determines how often (in seconds) Icinga will # attempt to automatically reschedule checks. This option only # has an effect if the auto_reschedule_checks option is enabled. # Default is 30 seconds. @@ -587,7 +630,7 @@ auto_rescheduling_interval=30 # AUTO-RESCHEDULING WINDOW # This option determines the "window" of time (in seconds) that -# Nagios will look at when automatically rescheduling checks. +# Icinga will look at when automatically rescheduling checks. # Only host and service checks that occur in the next X seconds # (determined by this variable) will be rescheduled. This option # only has an effect if the auto_reschedule_checks option is @@ -608,13 +651,18 @@ sleep_time=0.25 # TIMEOUT VALUES -# These options control how much time Nagios will allow various +# These options control how much time Icinga will allow various # types of commands to execute before killing them off. Options # are available for controlling maximum time allotted for # service checks, host checks, event handlers, notifications, the # ocsp command, and performance data commands. All values are in # seconds. +# Increase the timeout values in case you are experiencing a lot +# of check timeouts. Addons like e.g. check_mk will perform +# one combined active servicecheck which could take longer than +# the default of 60sec. +#service_check_timeout=120 service_check_timeout=60 host_check_timeout=30 event_handler_timeout=30 @@ -625,12 +673,12 @@ perfdata_timeout=5 # RETAIN STATE INFORMATION -# This setting determines whether or not Nagios will save state +# This setting determines whether or not Icinga will save state # information for services and hosts before it shuts down. Upon -# startup Nagios will reload all saved service and host state +# startup Icinga will reload all saved service and host state # information before starting to monitor. This is useful for # maintaining long-term data on state statistics, etc, but will -# slow Nagios down a bit when it (re)starts. Since its only +# slow Icinga down a bit when it (re)starts. Since its only # a one-time penalty, I think its well worth the additional # startup delay. @@ -639,21 +687,47 @@ retain_state_information=1 # STATE RETENTION FILE -# This is the file that Nagios should use to store host and +# This is the file that Icinga should use to store host and # service state information before it shuts down. The state # information in this file is also read immediately prior to -# starting to monitor the network when Nagios is restarted. -# This file is used only if the preserve_state_information +# starting to monitor the network when Icinga is restarted. +# This file is used only if the retain_state_information # variable is set to 1. -state_retention_file=/var/lib/nagios3/retention.dat +state_retention_file=/var/cache/icinga/retention.dat + + + +# SYNC FILE +# This is an advanced facility to pass a subset of retention +# information into Icinga on a running system. This is similar +# to the state retention file with the following difference: +# +# - if the last_check value is less than the current last_check, +# then the state information is ignored (this must be specified +# immediately after the object identifiers) +# +# - downtimes and comments are not identified by an id number, but +# by other "similar characteristics". This is required to work in +# a distributed Nagios environment +# * downtimes: hostname, servicename (if appropriate), author, +# comment, start_time, end_time, fixed, duration +# * comments: hostname, servicename, author, comment +# +# If this variable is set, then on Icinga startup, the sync file +# will be read after the retention file has been processed. If the +# file is read successfully, it will be removed. +# If the file does not exist, no error will appear. +# There is also an API that will force a read of the sync file. + +#sync_retention_file=/var/cache/icinga/sync.dat # RETENTION DATA UPDATE INTERVAL -# This setting determines how often (in minutes) that Nagios +# This setting determines how often (in minutes) that Icinga # will automatically save retention data during normal operation. -# If you set this value to 0, Nagios will not save retention +# If you set this value to 0, Icinga will not save retention # data at regular interval, but it will still save retention # data before shutting down or restarting. If you have disabled # state retention, this option has no effect. @@ -663,7 +737,7 @@ retention_update_interval=60 # USE RETAINED PROGRAM STATE -# This setting determines whether or not Nagios will set +# This setting determines whether or not Icinga will set # program status variables based on the values saved in the # retention file. If you want to use retained program status # information, set this value to 1. If not, set this value @@ -672,9 +746,18 @@ retention_update_interval=60 use_retained_program_state=1 +# DUMP RETAINED HOST SERVICE STATES TO NEB +# This setting determines wether or not Icinga will dump host +# and service states based on the values saved in the retention +# file to the neb modules. If you don't want that, use at your +# own risk and disable it + +dump_retained_host_service_states_to_neb=1 + + # USE RETAINED SCHEDULING INFO -# This setting determines whether or not Nagios will retain +# This setting determines whether or not Icinga will retain # the scheduling info (next check time) for hosts and services # based on the values saved in the retention file. If you # If you want to use retained scheduling info, set this @@ -686,7 +769,7 @@ use_retained_scheduling_info=1 # RETAINED ATTRIBUTE MASKS (ADVANCED FEATURE) # The following variables are used to specify specific host and -# service attributes that should *not* be retained by Nagios during +# service attributes that should *not* be retained by Icinga during # program restarts. # # The values of the masks are bitwise ANDs of values specified @@ -740,9 +823,9 @@ use_aggressive_host_checking=0 # SERVICE CHECK EXECUTION OPTION -# This determines whether or not Nagios will actively execute +# This determines whether or not Icinga will actively execute # service checks when it initially starts. If this option is -# disabled, checks are not actively made, but Nagios can still +# disabled, checks are not actively made, but Icinga can still # receive and process passive check results that come in. Unless # you're implementing redundant hosts or have a special need for # disabling the execution of service checks, leave this enabled! @@ -753,7 +836,7 @@ execute_service_checks=1 # PASSIVE SERVICE CHECK ACCEPTANCE OPTION -# This determines whether or not Nagios will accept passive +# This determines whether or not Icinga will accept passive # service checks results when it initially (re)starts. # Values: 1 = accept passive checks, 0 = reject passive checks @@ -762,9 +845,9 @@ accept_passive_service_checks=1 # HOST CHECK EXECUTION OPTION -# This determines whether or not Nagios will actively execute +# This determines whether or not Icinga will actively execute # host checks when it initially starts. If this option is -# disabled, checks are not actively made, but Nagios can still +# disabled, checks are not actively made, but Icinga can still # receive and process passive check results that come in. Unless # you're implementing redundant hosts or have a special need for # disabling the execution of host checks, leave this enabled! @@ -775,7 +858,7 @@ execute_host_checks=1 # PASSIVE HOST CHECK ACCEPTANCE OPTION -# This determines whether or not Nagios will accept passive +# This determines whether or not Icinga will accept passive # host checks results when it initially (re)starts. # Values: 1 = accept passive checks, 0 = reject passive checks @@ -784,7 +867,7 @@ accept_passive_host_checks=1 # NOTIFICATIONS OPTION -# This determines whether or not Nagios will sent out any host or +# This determines whether or not Icinga will sent out any host or # service notifications when it is initially (re)started. # Values: 1 = enable notifications, 0 = disable notifications @@ -793,7 +876,7 @@ enable_notifications=1 # EVENT HANDLER USE OPTION -# This determines whether or not Nagios will run any host or +# This determines whether or not Icinga will run any host or # service event handlers when it is initially (re)started. Unless # you're implementing redundant hosts, leave this option enabled. # Values: 1 = enable event handlers, 0 = disable event handlers @@ -803,7 +886,7 @@ enable_event_handlers=1 # PROCESS PERFORMANCE DATA OPTION -# This determines whether or not Nagios will process performance +# This determines whether or not Icinga will process performance # data returned from service and host checks. If this option is # enabled, host performance data will be processed using the # host_perfdata_command (defined below) and service performance @@ -819,8 +902,8 @@ process_performance_data=0 # HOST AND SERVICE PERFORMANCE DATA PROCESSING COMMANDS # These commands are run after every host and service check is # performed. These commands are executed only if the -# enable_performance_data option (above) is set to 1. The command -# argument is the short name of a command definition that you +# process_performance_data option (above) is set to 1. The command +# argument is the short name of a command definition that you # define in your host configuration file. Read the HTML docs for # more information on performance data. @@ -832,7 +915,7 @@ process_performance_data=0 # HOST AND SERVICE PERFORMANCE DATA FILES # These files are used to store host and service performance data. # Performance data is only written to these files if the -# enable_performance_data option (above) is set to 1. +# process_performance_data option (above) is set to 1. #host_perfdata_file=/tmp/host-perfdata #service_perfdata_file=/tmp/service-perfdata @@ -884,9 +967,38 @@ process_performance_data=0 #service_perfdata_file_processing_command=process-service-perfdata-file +# HOST AND SERVICE PERFORMANCE DATA PROCESS EMPTY RESULTS +# THese options determine wether the core will process empty perfdata +# results or not. This is needed for distributed monitoring, and intentionally +# turned on by default. +# If you don't require empty perfdata - saving some cpu cycles +# on unwanted macro calculation - you can turn that off. Be careful! +# Values: 1 = enable, 0 = disable + +#host_perfdata_process_empty_results=1 +#service_perfdata_process_empty_results=1 + + + +# ALLOW EMPTY HOSTGROUP ASSIGMENT FOR SERVICES +# This boolean option determines whether services assigned to empty +# host groups (host groups with no host members) will cause Icinga to +# exit with error on start up (or during a configuration check) or not. +# It's useful to be able to assign services to empty hostgroups when +# configuration files or pre-cached object files are distributed to +# various pollers, or when the process of generating Icinga config is +# automated, or when a set of services is slowly being phased out but +# should be kept around. +# The default behavior if the option is not present in the main +# configuration file is for Icinga to exit with error if services are +# associated with host groups that have no hosts associated with them. + +#allow_empty_hostgroup_assignment=0 + + # OBSESS OVER SERVICE CHECKS OPTION -# This determines whether or not Nagios will obsess over service +# This determines whether or not Icinga will obsess over service # checks and run the ocsp_command defined below. Unless you're # planning on implementing distributed monitoring, do not enable # this option. Read the HTML docs for more information on @@ -899,7 +1011,7 @@ obsess_over_services=0 # OBSESSIVE COMPULSIVE SERVICE PROCESSOR COMMAND # This is the command that is run for every service check that is -# processed by Nagios. This command is executed only if the +# processed by Icinga. This command is executed only if the # obsess_over_services option (above) is set to 1. The command # argument is the short name of a command definition that you # define in your host configuration file. Read the HTML docs for @@ -910,7 +1022,7 @@ obsess_over_services=0 # OBSESS OVER HOST CHECKS OPTION -# This determines whether or not Nagios will obsess over host +# This determines whether or not Icinga will obsess over host # checks and run the ochp_command defined below. Unless you're # planning on implementing distributed monitoring, do not enable # this option. Read the HTML docs for more information on @@ -923,7 +1035,7 @@ obsess_over_hosts=0 # OBSESSIVE COMPULSIVE HOST PROCESSOR COMMAND # This is the command that is run for every host check that is -# processed by Nagios. This command is executed only if the +# processed by Icinga. This command is executed only if the # obsess_over_hosts option (above) is set to 1. The command # argument is the short name of a command definition that you # define in your host configuration file. Read the HTML docs for @@ -934,15 +1046,15 @@ obsess_over_hosts=0 # TRANSLATE PASSIVE HOST CHECKS OPTION -# This determines whether or not Nagios will translate +# This determines whether or not Icinga will translate # DOWN/UNREACHABLE passive host check results into their proper -# state for this instance of Nagios. This option is useful +# state for this instance of Icinga. This option is useful # if you have distributed or failover monitoring setup. In -# these cases your other Nagios servers probably have a different +# these cases your other Icinga servers probably have a different # "view" of the network, with regards to the parent/child relationship # of hosts. If a distributed monitoring server thinks a host # is DOWN, it may actually be UNREACHABLE from the point of -# this Nagios instance. Enabling this option will tell Nagios +# this Icinga instance. Enabling this option will tell Icinga # to translate any DOWN or UNREACHABLE host states it receives # passively into the correct state from the view of this server. # Values: 1 = perform translation, 0 = do not translate (default) @@ -952,7 +1064,7 @@ translate_passive_host_checks=0 # PASSIVE HOST CHECKS ARE SOFT OPTION -# This determines whether or not Nagios will treat passive host +# This determines whether or not Icinga will treat passive host # checks as being HARD or SOFT. By default, a passive host check # result will put a host into a HARD state type. This can be changed # by enabling this option. @@ -963,7 +1075,7 @@ passive_host_checks_are_soft=0 # ORPHANED HOST/SERVICE CHECK OPTIONS -# These options determine whether or not Nagios will periodically +# These options determine whether or not Icinga will periodically # check for orphaned host service checks. Since service checks are # not rescheduled until the results of their previous execution # instance are processed, there exists a possibility that some @@ -980,8 +1092,23 @@ check_for_orphaned_hosts=1 +# SERVICE CHECK TIMEOUT STATE +# This setting determines the state Icinga will report when a +# service check times out meaning it does not respond within +# service_check_timeout seconds. The default is set to Unknown +# and not Critical. +# Valid settings are: +# c - Critical +# u - Unknown (default) +# w - Warning +# o - OK + +service_check_timeout_state=u + + + # SERVICE FRESHNESS CHECK OPTION -# This option determines whether or not Nagios will periodically +# This option determines whether or not Icinga will periodically # check the "freshness" of service results. Enabling this option # is useful for ensuring passive checks are received in a timely # manner. @@ -992,7 +1119,7 @@ check_service_freshness=1 # SERVICE FRESHNESS CHECK INTERVAL -# This setting determines how often (in seconds) Nagios will +# This setting determines how often (in seconds) Icinga will # check the "freshness" of service check results. If you have # disabled service freshness checking, this option has no effect. @@ -1001,7 +1128,7 @@ service_freshness_check_interval=60 # HOST FRESHNESS CHECK OPTION -# This option determines whether or not Nagios will periodically +# This option determines whether or not Icinga will periodically # check the "freshness" of host results. Enabling this option # is useful for ensuring passive checks are received in a timely # manner. @@ -1012,7 +1139,7 @@ check_host_freshness=0 # HOST FRESHNESS CHECK INTERVAL -# This setting determines how often (in seconds) Nagios will +# This setting determines how often (in seconds) Icinga will # check the "freshness" of host check results. If you have # disabled host freshness checking, this option has no effect. @@ -1022,7 +1149,7 @@ host_freshness_check_interval=60 # ADDITIONAL FRESHNESS THRESHOLD LATENCY -# This setting determines the number of seconds that Nagios +# This setting determines the number of seconds that Icinga # will add to any host and service freshness thresholds that # it calculates (those not explicitly specified by the user). @@ -1032,10 +1159,10 @@ additional_freshness_latency=15 # FLAP DETECTION OPTION -# This option determines whether or not Nagios will try +# This option determines whether or not Icinga will try # and detect hosts and services that are "flapping". # Flapping occurs when a host or service changes between -# states too frequently. When Nagios detects that a +# states too frequently. When Icinga detects that a # host or service is flapping, it will temporarily suppress # notifications for that host/service until it stops # flapping. Flap detection is very experimental, so read @@ -1075,14 +1202,14 @@ date_format=iso8601 # TIMEZONE OFFSET # This option is used to override the default timezone that this -# instance of Nagios runs in. If not specified, Nagios will use +# instance of Icinga runs in. If not specified, Icinga will use # the system configured timezone. # # NOTE: In order to display the correct timezone in the CGIs, you # will also need to alter the Apache directives for the CGI path # to include your timezone. Example: # -# <Directory "/usr/local/nagios/sbin/"> +# <Directory "/usr/local/icinga/sbin/"> # SetEnv TZ "Australia/Brisbane" # ... # </Directory> @@ -1096,16 +1223,20 @@ date_format=iso8601 # P1.PL FILE LOCATION # This value determines where the p1.pl perl script (used by the # embedded Perl interpreter) is located. If you didn't compile -# Nagios with embedded Perl support, this option has no effect. +# Icinga with embedded Perl support, this option has no effect. -p1_file=/usr/lib/nagios3/p1.pl +p1_file=/usr/lib/icinga/p1.pl # EMBEDDED PERL INTERPRETER OPTION # This option determines whether or not the embedded Perl interpreter -# will be enabled during runtime. This option has no effect if Nagios +# will be enabled during runtime. This option has no effect if Icinga # has not been compiled with support for embedded Perl. +# This option is intentionally disabled by default, because embedded +# perl can cause memory leaks and make Icinga unstable if not properly +# used. +# Only enable this setting when you really know what you are doing! # Values: 0 = disable interpreter, 1 = enable interpreter enable_embedded_perl=1 @@ -1113,7 +1244,7 @@ enable_embedded_perl=1 # EMBEDDED PERL USAGE OPTION -# This option determines whether or not Nagios will process Perl plugins +# This option determines whether or not Icinga will process Perl plugins # and scripts with the embedded Perl interpreter if the plugins/scripts # do not explicitly indicate whether or not it is okay to do so. Read # the HTML documentation on the embedded Perl interpreter for more @@ -1123,6 +1254,27 @@ use_embedded_perl_implicitly=1 +# EVENT HANDLERS FOR STALKED HOSTS/SERVICES +# Allow running event handlers for stalked hosts/services in order +# to forward to external systems. +# Values: 0 = disabled (default), 1 = enabled + +stalking_event_handlers_for_hosts=0 +stalking_event_handlers_for_services=0 + + + +# NOTIFICATIONS FOR STALKED HOSTS/SERVICES +# Allow notifications for stalked hosts/services globally +# for all contacts in order to notify about a stalking +# alert. +# Values: 0 = disabled (default), 1 = enabled + +stalking_notifications_for_hosts=0 +stalking_notifications_for_services=0 + + + # ILLEGAL OBJECT NAME CHARACTERS # This option allows you to specify illegal characters that cannot # be used in host names, service descriptions, or names of other @@ -1178,7 +1330,7 @@ use_true_regexp_matching=0 # ADMINISTRATOR EMAIL/PAGER ADDRESSES # The email and pager address of a global administrator (likely you). -# Nagios never uses these values itself, but you can access them by +# Icinga never uses these values itself, but you can access them by # using the $ADMINEMAIL$ and $ADMINPAGER$ macros in your notification # commands. @@ -1188,7 +1340,7 @@ admin_pager=pageroot@localhost # DAEMON CORE DUMP OPTION -# This option determines whether or not Nagios is allowed to create +# This option determines whether or not Icinga is allowed to create # a core dump when it runs as a daemon. Note that it is generally # considered bad form to allow this, but it may be useful for # debugging purposes. Enabling this option doesn't guarantee that @@ -1201,33 +1353,35 @@ daemon_dumps_core=0 # LARGE INSTALLATION TWEAKS OPTION -# This option determines whether or not Nagios will take some shortcuts -# which can save on memory and CPU usage in large Nagios installations. +# This option determines whether or not Icinga will take some shortcuts +# which can save on memory and CPU usage in large Icinga installations. # Read the documentation for more information on the benefits/tradeoffs # of enabling this option. # Values: 1 - Enabled tweaks # 0 - Disable tweaks (default) -use_large_installation_tweaks=1 +use_large_installation_tweaks=0 # ENABLE ENVIRONMENT MACROS -# This option determines whether or not Nagios will make all standard +# This option determines whether or not Icinga will make all standard # macros available as environment variables when host/service checks # and system commands (event handlers, notifications, etc.) are -# executed. Enabling this option can cause performance issues in +# executed. Enabling this option can cause performance issues in # large installations, as it will consume a bit more memory and (more # importantly) consume more CPU. -# Values: 1 - Enable environment variable macros (default) -# 0 - Disable environment variable macros +# Keep in mind that various addons/plugins will require this setting +# to be enabled (e.g. check_oracle_health) for special usage. +# Values: 1 - Enable environment variable macros +# 0 - Disable environment variable macros (default) enable_environment_macros=1 # CHILD PROCESS MEMORY OPTION -# This option determines whether or not Nagios will free memory in +# This option determines whether or not Icinga will free memory in # child processes (processed used to execute system commands and host/ # service checks). If you specify a value here, it will override # program defaults. @@ -1239,7 +1393,7 @@ enable_environment_macros=1 # CHILD PROCESS FORKING BEHAVIOR -# This option determines how Nagios will fork child processes +# This option determines how Icinga will fork child processes # (used to execute system commands and host/service checks). Normally # child processes are fork()ed twice, which provides a very high level # of isolation from problems. Fork()ing once is probably enough and will @@ -1249,7 +1403,7 @@ enable_environment_macros=1 # Value: 1 - Child processes fork() twice # 0 - Child processes fork() just once -child_processes_fork_twice=0 +#child_processes_fork_twice=1 @@ -1283,14 +1437,14 @@ debug_level=0 # 1 = More detailed # 2 = Very detailed -debug_verbosity=1 +debug_verbosity=2 # DEBUG FILE -# This option determines where Nagios should write debugging information. +# This option determines where Icinga should write debugging information. -debug_file=/var/lib/nagios3/nagios.debug +debug_file=/var/log/icinga/icinga.debug @@ -1299,8 +1453,17 @@ debug_file=/var/lib/nagios3/nagios.debug # the file grows larger than this size, it will be renamed with a .old # extension. If a file already exists with a .old extension it will # automatically be deleted. This helps ensure your disk space usage doesn't -# get out of control when debugging Nagios. +# get out of control when debugging Icinga. + +# 100M +max_debug_file_size=100000000 + -max_debug_file_size=1000000 +# EVENT PROFILING +# This option enables or disables event profiling for stats of event counts +# and time taken for events. Option can't be used on Solaris with gcc3. +# Values: 0 - disabled +# 1 - enabled +event_profiling_enabled=0