cd_nagios | Parameters

  • pkg_ensure (string) (defaults to: 'latest')

    which package type to choose, i.e. latest or present.

  • ng_nagios_server (string) (defaults to: "nagios.${::domain}")

    Specify the FQDN of the nagios server host. Must be a proper A-name, no CNAME i.e. on Loadbalancers. When the FQDN matches the configured value, Nagios server components will be installed and the clients will allow to be connected by that host. Impacts also firewall ports (optional).

  • ng_nagios_ext_ip (string) (defaults to: undef)

    Specify the IP address of the nagios server. Required for NRPE configuration to allow the Nagios server

  • ng_include_nrpe (boolean) (defaults to: true)

    Whether to include NRPE to allow Nagios to connect to clients

  • ng_ping_warn (string) (defaults to: '100.0,20%')

    Default value for ping warning check. Can be overridden on host level.

  • ng_ping_crit (string) (defaults to: '500.0,60%')

    Default value for ping critical check. Can be overridden on host level.

  • ng_ping_ensure (boolean) (defaults to: 'present')

    Whether to include or exclude the check. Can be overridden on host level.

  • ng_disk_warn (string) (defaults to: '20%')

    Default value for disk space warning check. Can be overridden on host level.

  • ng_disk_crit (string) (defaults to: '10%')

    Default value for disk space critical check Can be overridden on host level.

  • ng_disk_ensure (boolean) (defaults to: 'present')

    Whether to include or exclude the check. Can be overridden on host level.

  • ng_swap_warn (string) (defaults to: '20')

    Default value for swap space warning check. Can be overridden on host level.

  • ng_swap_crit (string) (defaults to: '10')

    Default value for swap space critical check. Can be overridden on host level.

  • ng_swap_ensure (boolean) (defaults to: 'present')

    Whether to include or exclude the check. Can be overridden on host level.

  • ng_users_warn (string) (defaults to: '20')

    Default value for user logins warning check. Can be overridden on host level.

  • ng_users_crit (string) (defaults to: '50')

    Default value for user logins critical check Can be overridden on host level.

  • ng_users_ensure (boolean) (defaults to: 'present')

    Whether to include or exclude the check. Can be overridden on host level.

  • ng_procs_tot_warn (string) (defaults to: '330')

    Default warning for the total processes warning check. Can be overridden on host level.

  • ng_procs_tot_crit (string) (defaults to: '400')

    Default warning for the total processes critical check. Can be overridden on host level.

  • ng_procs_tot_param (string) (defaults to: 'RDST')

    Default value for the process flags to be checked. Can be overridden on host level.

  • ng_procs_tot_ens (boolean) (defaults to: 'present')

    Whether to include or exclude the check. Can be overridden on host level.

  • ng_procs_z_warn (string) (defaults to: '10')

    Default value for the zombie processes warning check. Can be overridden on host level.

  • ng_procs_z_crit (string) (defaults to: '30')

    Default value for the zombie processess critical check. Can be overridden on host level.

  • ng_procs_z_param (string) (defaults to: 'Z')

    Default value for the zombie processes flag. Can be overridden on host level.

  • ng_procs_z_ensure (boolean) (defaults to: 'present')

    Whether to include or exclude the check. Can be overridden on host level.

  • ng_load_warn (string) (defaults to: '5.00,4.00,3.00')

    Default value for the load warning check. Can be overridden on host level.

  • ng_load_crit (string) (defaults to: '10.00,6.00,4.00')

    Default value for the load critical check. Can be overridden on host level.

  • ng_load_ensure (boolean) (defaults to: 'present')

    Whether to include or exclude the load check. Can be overridden on host level.

  • ng_include_fw (boolean) (defaults to: true)

    Whether to include firewall management. requires cd_firewall or puppetlabs-firewall module.

  • ng_fw_order (string) (defaults to: '50')

    Prefix for the port number to establish proper firewall rule ordering.

  • ng_use_https (boolean) (defaults to: true)

    Whether to use https.

  • ng_http_https_fw (boolean) (defaults to: true)

    Whether we want to forward http to https. only active if ng_use_https is set to true.

  • ng_http_port (string) (defaults to: '80')

    Specify the port to use for httpd. Used in templates and for firewall (Optional)

  • ng_https_port (string) (defaults to: '443')

    Specify the port to use for httpd. Used in templates and for firewall (Optional)

  • ng_user (string) (defaults to: 'nagios')

    The name of the Nagios service user.

  • ng_user_home (string) (defaults to: '/var/spool/nagios')

    The home directory for the Nagios service user

  • ng_user_shell (string) (defaults to: '/bin/bash')

    The shell for the Nagios service user, which never should be allowed to login.

  • ng_u_comment (string) (defaults to: 'Nagios service user')

    The comment for the Nagios service user for /etc/passwd. Shows up in email notifocations from the Nagios daemon.

  • ng_u_uid (string) (defaults to: '1004')

    The UID for the Nagios service user. Important when using shared environments like NFS.

  • ng_u_groups (string) (defaults to: undef)

    The secondary groups for the Nagios service user. Must not contain the primary group.

  • ng_context_help (string) (defaults to: '1')

    whether or not a context-sensitive help icon will be displayed for most of the CGIs.

  • ng_pending_state (string) (defaults to: '1')

    what states should be displayed in the web interface for hosts/services that have not yet been checked

  • ng_use_auth (string) (defaults to: '1')

    whether or not the CGIs will use any authentication when displaying host and service information, as well as committing commands to Nagios for processing. This should not be set to 0.

  • ng_use_ssl_auth (string) (defaults to: '0')

    allows you to use x509 cert (SSL) authentication in the CGIs. This is an advanced option and should not be enabled unless you know what you're doing.

  • ng_enable_def_user (boolean) (defaults to: false)

    Whether to enable a default user (not recommended).

  • ng_def_user_name (string) (defaults to: 'nagios_insecure')

    default user name that can access pages without authentication. This allows people within a secure domain (i.e., behind a firewall) to see the current status without authenticating. Only actuve if ng_enable_def_user is set to true

  • ng_nagios_admin (string) (defaults to: 'nagios_sec_adm')

    Specify the name of a nagios administration user here. Value will be used in cgi.cfg for all authorized commands and info,i.e. nagiosadmin. however, its stronlgly suggested to use a different name. Can be overridden per host / hostgroups to allow flexibility and increased security. You can also add a comma-separated list of people in here instead, which then would function like a group instead a single user.

  • ng_sysinfo_auth (string) (defaults to: '')

    comma-delimited list of all usernames that have access to viewing the Nagios process information as provided by the Extended Information CGI (extinfo.cgi).

  • ng_confinfo_auth (string) (defaults to: '')

    comma-delimited list of all usernames that can view ALL configuration information (hosts, commands, etc).

  • ng_command_auth (string) (defaults to: '')

    comma-delimited list of all usernames that can issue shutdown and restart commands to Nagios via the command CGI (cmd.cgi).

  • ng_hostview_auth (string) (defaults to: '')

    comma-delimited lists of all usernames that can view information for all hosts

  • ng_serviceview_auth (string) (defaults to: '')

    comma-delimited lists of all usernames that can view information for all services.

  • ng_host_cmd_auth (string) (defaults to: '')

    comma-delimited lists of all usernames that

  • ng_svc_cmd_auth (string) (defaults to: '')

    comma-delimited lists of all usernames that

  • ng_readonly_auth (string) (defaults to: '')

    comma-delimited list of usernames that have read-only rights in the CGIs.

  • ng_statusmap_img (string) (defaults to: 'smbackground.gd2')

    specify an image to be used as a background in the statusmap CGI.

  • ng_use_colormap (boolean) (defaults to: false)

    Whether to set values of background colors.

  • ng_colormap_red (string) (defaults to: '255')

    value for the red area of the color map.

  • ng_colormap_green (string) (defaults to: '255')

    value for the green area of the color map

  • ng_colormap_blue (string) (defaults to: '255')

    value for the blue area of the color map.

  • ng_statusmap_layout (string) (defaults to: '6')

    Value for the default statusmap layout.

  • ng_wrl_layout (string) (defaults to: '4')

    Value for the default statuswrl layout.

  • ng_incl_own_wrl (boolean) (defaults to: false)

    Whether to include your own objects in the generated VRML world.

  • ng_statuswrl_include (string) (defaults to: '')

    Specify your own wrl object to be included in the generated VRML world. Only active if ng_incl_own_wrl is set to true.

  • ng_ping_syntax (string) (defaults to: '/bin/ping -n -U -c 5 $HOSTADDRESS$')

    what syntax should be used when attempting to ping a host from the WAP interface

  • ng_refresh_rate (string) (defaults to: '90')

    specify the refresh rate in seconds of various CGIs

  • ng_result_limit (string) (defaults to: '100')

    specify the default number of results displayed on the status.cgi.

  • ng_escape_html (string) (defaults to: '1')

    whether HTML tags in host and service status output is escaped in the web interface. If enabled, your plugin output will not be able to contain clickable links.

  • ng_use_sound (boolean) (defaults to: false)

    whether to enable sound usage.

  • ng_host_unreachable (string) (defaults to: 'hostdown.wav')

    soundfile for host unreachable Only active if ng_use_sound is set to true.

  • ng_host_down (string) (defaults to: 'hostdown.wav')

    soundfile for host down Only active if ng_use_sound is set to true.

  • ng_svc_critical (string) (defaults to: 'critical.wav')

    soundfile for service critical. Only active if ng_use_sound is set to true.

  • ng_svc_warn (string) (defaults to: 'warning.wav')

    soundfile for service warning Only active if ng_use_sound is set to true.

  • ng_svc_unknown (string) (defaults to: 'warning.wav')

    soundfile for service unknown Only active if ng_use_sound is set to true.

  • ng_normal_sound (string) (defaults to: 'noproblem.wav')

    soundfile for normal Only active if ng_use_sound is set to true.

  • ng_action_url_target (string) (defaults to: '_blank')

    Specify target frames in which action URLs will open

  • ng_notes_url_target (string) (defaults to: '_blank')

    Specify target frames in which notes URLs will open

  • ng_lock_author_names (string) (defaults to: '1')

    whether users can change the author name when submitting comments, scheduling downtime.

  • ng_enable_splunk (boolean) (defaults to: false)

    Whether to enable splunk integration.

  • ng_splunk_url (string) (defaults to: 'http://127.0.0.1:8000/')

    the URL for your Splunk URL

  • ng_navbar_addresses (string) (defaults to: '1')

    allow navbar search queries IP addresses

  • ng_navbar_aliases (string) (defaults to: '1')

    allow navbar search for aliases

  • ng_ack_no_sticky (string) (defaults to: '0')

    Enabling ack_no_sticky will default the "Sticky Acknowledgement" to be unchecked.

  • ng_ack_no_send (string) (defaults to: '0')

    Enabling ack_no_send will default the "Send Notification" to be unchecked.

  • ng_use_selinux_tools (boolean) (defaults to: true)

    Whether to enable selinux tools and policies. only effective if selinux is enabled.

  • ng_required_hosts (string) (defaults to: '')

    String of FQDNs for hosts which should be allowed/required. Requires format 'host1.example.com host2.example.com'. If you want no restriction, chose 'all'.

  • ng_required_ips (string) (defaults to: '127.0.0.0/8')

    string of <b>_<em>Ip addresses __** for hosts which should be allowed/reqired. Requires format 'ipaddress ip address range'. If you want no restriction, choose '0.0.0.0/0'.Ip addresses _</em></b> for hosts which should be allowed/reqired. Requires format 'ipaddress ip address range'. If you want no restriction, choose '0.0.0.0/0'.

  • ng_enable_certbot (boolean) (defaults to: true)

    Whether to use certbot for automated TLS certificate management

  • ng_certbot_webroot (string) (defaults to: '/var/www/html')

    the path for certbot to place challenges for the certification process.

  • ng_mail_user (string) (defaults to: "admin@${::domain}")

    email address to receive administrative mail. used for nagios itself as well as for certbot. Mail environment must be configured separately, i.e. through cd_postfix.

  • ng_page_user (string) (defaults to: "pageadmin@${::domain}")

    pager address to be used by Nagios for notifications. Paging environment must be configured separately.

  • ng_enable_index (boolean) (defaults to: true)

    Whether to create an index file to allow httpd checks with nagios on the nagios server.

  • ng_webserver_name (string) (defaults to: "nagios.${::domain}")

    the name of the web server nagios should listen to, i.e. 'nagios.example.net'. Unlike ng_nagios_server, this should not be the FQDN of the nagios host, but a web server domain name. required for certbot and used in the web templates.

  • ng_log_file (string) (defaults to: '/var/log/nagios/nagios.log')

    main log file where service- and host events are logged.

  • ng_max_check_attempts (string) (defaults to: '10')

    maximum amount of checks done by nagios

  • ng_object_cache_file (string) (defaults to: '/var/spool/nagios/objects.cache')

    determines where object definitions are cached when # Nagios starts/restarts.

  • ng_precached_obj_file (string) (defaults to: '/var/spool/nagios/objects.precache')

    determines the location of the precached object file.

  • ng_resource_file (string) (defaults to: '/etc/nagios/private/resource.cfg')

    resource file that contains $USERx$ macro definitions.

  • ng_status_file (string) (defaults to: '/var/log/nagios/status.dat')

    where the current status of all monitored services and hosts is stored.

  • ng_status_upd_interval (string) (defaults to: '10')

    status file update interval. determines the frequency (in seconds) that # Nagios will periodically dump program, host, and # service status data.

  • ng_check_ext_commands (string) (defaults to: '1')

    allows you to specify whether or not Nagios should check # for external commands in the command file specified byng_command_file.

  • ng_command_file (string) (defaults to: '/var/spool/nagios/cmd/nagios.cmd')

    file that Nagios 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.

  • ng_enable_query_handler (boolean) (defaults to: false)

    Whether to enable the query handler for running nagios in cluster mode.

  • ng_query_socket (string) (defaults to: '/var/spool/nagios/cmd/nagios.qh')

    the socket for the query handler

  • ng_lock_file (string) (defaults to: '/var/run/nagios/nagios.pid')

    lockfile that Nagios will use to store its PID number in when it is running in daemon mode.

  • ng_temp_file (string) (defaults to: '/var/spool/nagios/nagios.tmp')

    temporary file that is used as scratch space when Nagios # updates the status log, cleans the comment file, etc.

  • ng_temp_path (string) (defaults to: '/tmp')

    path where Nagios can create temp files for service and # host check results, etc.

  • ng_event_broker_options (string) (defaults to: '-1')

    Controls what (if any) data gets sent to the event broker.

  • ng_event_broker_module (string) (defaults to: '')

    specify an event broker (including full path) module that should # by loaded by Nagios at startup. Specify multiple modules as array ['path/to/module1','/path/to/module2']

  • ng_log_rotation_method (string) (defaults to: 'h')

    Valid options: 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)

  • ng_log_archive_path (string) (defaults to: '/var/log/nagios/archives')

    directory where archived (rotated) log files should be # placed (assuming you've chosen to do log rotation).

  • ng_use_syslog (string) (defaults to: '1')

    whether to log messages to the syslog facility, as well as the Nagios log file. Valid options are 0 and 1.

  • ng_log_notifications (string) (defaults to: '1')

    Whether to log notifications in addition to regular messages. Valid options are 0 and 1.

  • ng_log_service_retries (string) (defaults to: '1')

    Whether to log service retries. Valid options are 0 and 1.

  • ng_log_host_retries (string) (defaults to: '1')

    Whether to log host retries. Valid options are 0 and 1.

  • ng_log_event_handlers (string) (defaults to: '1')

    Whether to log host and service event handlers. Valid options are 0 and 1.

  • ng_log_initial_states (string) (defaults to: '0')

    Whether to log initial states. Valid options are 0 and 1.

  • ng_log_current_states (string) (defaults to: '1')

    Whether to log all current host and service states to the main log file after log has been rotated. Valid options are 0 and 1.

  • ng_log_external_commands (string) (defaults to: '1')

    Whether to log external commands. Valid options are 0 and 1.

  • ng_log_passive_checks (string) (defaults to: '1')

    Whether to log passive checks. Valid options are 0 and 1.

  • ng_glob_host_evt_handler (string) (defaults to: '')

    Specify a global host event handler # command that is to be run for every host or service state change. The global event handler is executed immediately prior to the event handler that you have optionally specified in each host or # service definition. The command argument is the short name of a # command definition that you define in your host configuration file.

  • ng_glob_svc_evt_handler (string) (defaults to: '')

    Specify a global service event handler # command that is to be run for every host or service state change. The global event handler is executed immediately prior to the event handler that you have optionally specified in each host or # service definition. The command argument is the short name of a # command definition that you define in your host configuration file.

  • ng_svc_int_check_delay (string) (defaults to: 's')

    method that Nagios should use when initially "spreading out" service checks when it starts monitoring. Valid options: n = None - don't use any delay between checks d = Use a "dumb" delay of 1 second between checks s = Use "smart" inter-check delay calculation x.xx = Use an inter-check delay of x.xx seconds

  • ng_max_svc_check_spread (string) (defaults to: '30')

    timeframe (in minutes) from the program start time that an initial check of all services should be completed

  • ng_svc_interleave_factor (string) (defaults to: 's')

    determines how service checks are interleaved. Valid options: s = Use "smart" interleave factor calculation x = Use an interleave factor of x, where x is greater than or equal to 1.

  • ng_host_int_check_delay (string) (defaults to: 's')

    method that Nagios should use when initially "spreading out" host checks when it starts monitoring. Valid options: n = None - don't use any delay between checks d = Use a "dumb" delay of 1 second between checks s = Use "smart" inter-check delay calculation x.xx = Use an inter-check delay of x.xx seconds

  • ng_max_host_check_spread (string) (defaults to: '30')

    timeframe (in minutes) from the program start time that an initial check of all hosts should # be completed.

  • ng_max_concurrent_checks (string) (defaults to: '0')

    specify the maximum number of service checks that can be run in parallel at any given time. A value of 0 will not restrict the number of concurrent checks that are being executed.

  • ng_check_res_reaper_freq (string) (defaults to: '10')

    frequency (in seconds!) in which Nagios will process the results of host and service checks.

  • ng_max_check_res_reap_time (string) (defaults to: '30')

    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 duties.

  • ng_check_result_path (string) (defaults to: '/var/spool/nagios/checkresults')

    directory where Nagios stores the results of host and service checks that have not yet been processed.

  • ng_max_check_res_file_age (string) (defaults to: '3600')

    maximum age (in seconds) which check result files are considered to be valid.

  • ng_cached_h_check_horizon (string) (defaults to: '15')

    maximum amount of time (in seconds) that the state of a previous host check is considered current. Cached host states (from host checks that were performed more 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 performance hit for host checks. Use a value of 0 to disable host check caching.

  • ng_cached_s_check_horizon (string) (defaults to: '15')

    maximum amount of time (in seconds) that the state of a previous service check is considered current. Cached service states (from service checks that were performed more recently that the timeframe specified by this value) can immensely improve performance in regards to the service check logic. Too high of a value for this option may result in inaccurate service states being used by Nagios, while a lower value may result in a performance hit for service checks. Use a value of 0 to disable service check caching.

  • ng_pred_host_dep_checks (string) (defaults to: '1')

    Whether Nagios will attempt to execute checks of hosts when it predicts that future dependency logic test may be needed. Valid options are 0 and 1.

  • ng_pred_svc_dep_checks (string) (defaults to: '1')

    Whether Nagios will attempt to execute checks of services when it predicts that future dependency logic test may be needed. Valid options are 0 and 1.

  • ng_soft_state_dependencies (string) (defaults to: '0')

    Whether or not Nagios will use soft state information when checking host and service dependencies. Valid options are 0 and 1.

  • ng_time_change_threshold (string) (defaults to: '900')

    when Nagios will react to detected changes in system time (either forward or backwards).

  • ng_auto_reschedule_checks (string) (defaults to: '0')

    Whether Nagios will attempt to automatically reschedule active host and service checks to "smooth" them out over time. Experimental feature. Valid options are 0 and 1.

  • ng_auto_reschedule_intval (string) (defaults to: '30')

    how often (in seconds) Nagios will attempt to automatically reschedule checks. only has an effect ifng_auto_reschedule_checks is set to 1.

  • ng_auto_reschedule_window (string) (defaults to: '180')

    determines the “window” of time (in seconds) that # Nagios 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.

  • ng_service_check_timeout (string) (defaults to: '60')

    how much time Nagios will allow service check commands to execute before killing them off.

  • ng_host_check_timeout (string) (defaults to: '30')

    how much time Nagios will allow host check commands to execute before killing them off.

  • ng_event_handler_timeout (string) (defaults to: '30')

    how much time Nagios will allow event handler commands to execute before killing them off.

  • ng_notification_timeout (string) (defaults to: '30')

    how much time Nagios will allow notification commands to execute before killing them off.

  • ng_ocsp_timeout (string) (defaults to: '5')

    how much time Nagios will allow ocsp commands to execute before killing them off.

  • ng_perfdata_timeout (string) (defaults to: '5')

    how much time Nagios will allow performance data commands to execute before killing them off.

  • ng_retain_state_inf (string) (defaults to: '1')

    Whether Nagios will save state information for services and hosts before it shuts down. Upon startup Nagios will reload all saved service and host state information before starting to monitor. Valid options are 0 and 1.

  • ng_state_retention_file (string) (defaults to: '/var/spool/nagios/retention.dat')

    Where Nagios 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 ng_retain_state_inf variable is set to 1.

  • ng_retention_update_intval (string) (defaults to: '60')

    how often (in minutes) that Nagios # will automatically save retention data during normal operation. If you set this value to 0, Nagios 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.

  • ng_use_ret_program_state (string) (defaults to: '1')

    Whether Nagios will set program status variables based on the values saved in the retention file. Valid options are 0 and 1.

  • ng_use_ret_scheduling_info (string) (defaults to: '1')

    Whether Nagios will retain the scheduling info (next check time) for hosts and services based on the values saved in the retention file. Valid options are 0 and 1.

  • ng_ret_host_attr_mask (string) (defaults to: '0')

    mask determines what host attributes are not retained

  • ng_ret_service_attr_mask (string) (defaults to: '0')

    mask determines what service attributes are not retained

  • ng_ret_proc_host_attr_mask (string) (defaults to: '0')

    what host process attributes are not retained.

  • ng_ret_proc_svc_attr_mask (string) (defaults to: '0')

    what service process attributes are not retained

  • ng_ret_contact_h_attr_mask (string) (defaults to: '0')

    what host contact attributes are not retained.

  • ng_ret_contact_s_attr_mask (string) (defaults to: '0')

    what service contact attributes are not retained.

  • ng_interval_length (string) (defaults to: '60')

    seconds per unit interval as used in the host/contact/service configuration files.

  • ng_check_for_updates (string) (defaults to: '1')

    whether Nagios will automatically check to see if new updates (releases) are available. Effectively, setting $pkg_ensure to latest will have Puppet take care for that automatically though through the packages available in the yum repos. Valid options are 0 and 1.

  • ng_bare_update_check (string) (defaults to: '0')

    what data Nagios will send to api.nagios.org when it checks for updates. Valid options are 0 and 1.

  • ng_use_aggr_host_checking (string) (defaults to: '0')

    Whether to enable aggressive host checking. Read Nagios documentation for more infos aggressive host checking.

  • ng_execute_service_checks (string) (defaults to: '1')

    Whether Nagios will actively execute service checks when it initially starts. Valid options are 0 and 1.

  • ng_accept_pass_svc_checks (string) (defaults to: '1')

    Whether or not Nagios will accept passive # service checks results when it initially (re)starts. Valid options are 0 and 1.

  • ng_execute_host_checks (string) (defaults to: '1')

    whether or not Nagios will actively execute host checks when it initially starts. Valid options are 0 and 1.

  • ng_accept_pass_host_checks (string) (defaults to: '1')

    Whether or not Nagios will accept passive # host checks results when it initially (re)starts. Valid options are 0 and 1.

  • ng_enable_notifications (string) (defaults to: '1')

    Whether Nagios will sent out any host or service notifications when it is initially (re)started. Valid options are 0 and 1.

  • ng_enable_event_handlers (string) (defaults to: '1')

    Whether Nagios will run any host or service event handlers when it is initially (re)started. Valid options are 0 and 1.

  • ng_process_perf_data (string) (defaults to: '0')

    Whether Nagios will process performance data returned from service and host checks. Valid options are 0 and 1.

  • ng_host_perfdata_command (string) (defaults to: 'process-host-perfdata')

    Short name of a command definition defined in your host configuration file. Only active ifng_process_perf_data is set to 1

  • ng_svc_perfdata_command (string) (defaults to: 'process-service-perfdata')

    Short name of a command definition defined in your service configuration file. Only active ifng_process_perf_data is set to 1

  • ng_host_perfdata_file (string) (defaults to: '/var/spool/nagios/host-perfdata')

    used to store host performance data. Only active if ng_process_perf_data is set to 1

  • ng_service_perfdata_file (string) (defaults to: '/var/spool/nagios/service-perfdata')

    used to store service performance data. Only active if ng_process_perf_data is set to 1

  • ng_host_perfdata_template (string) (defaults to: '[HOSTPERFDATA]\t$TIMET$\t$HOSTNAME$\t$HOSTEXECUTIONTIME$\t$HOSTOUTPUT$\t$HOSTPERFDATA$')

    What data is written (and how) to the performance data files. The templates may contain macros, special characters (\t for tab, \r for carriage return, \n for newline) and plain text. Only active ifng_process_perf_data is set to 1

  • ng_svc_perfdata_template (string) (defaults to:'[SERVICEPERFDATA]\t$TIMET$\t$HOSTNAME$\t$SERVICEDESC$\t$SERVICEEXECUTIONTIME$\t$SERVICELATENCY$\t$SERVICEOUTPUT$\t$SERVICEPERFDATA$')

    What data is written (and how) to the performance data files. The templates may contain macros, special characters (\t for tab, \r for carriage return, \n for newline) and plain text. Only active ifng_process_perf_data is set to 1

  • ng_host_perfdata_file_mode (string) (defaults to: 'a')

    Whether the host performance data files are opened in write ("w"), append ("a") or named pipe ("p") mode. Only active ifng_process_perf_data is set to 1.

  • ng_svc_perfdata_file_mode (string) (defaults to: 'a')

    Whether the service performance data files are opened in write ("w"), append ("a") or named pipe ("p") mode. Only active ifng_process_perf_data is set to 1.

  • ng_h_perfdata_proc_intval (string) (defaults to: '0')

    How often (in seconds) the host performance data files are processed using the commands defined below. 0 indicates that the files should not be periodically processed. Only active if ng_process_perf_data is set to 1.

  • ng_s_perfdata_proc_intval (string) (defaults to: '0')

    How often (in seconds) the service performance data files are processed using the commands defined below. 0 indicates that the files should not be periodically processed. Only active if ng_process_perf_data is set to 1.

  • ng_h_perfdata_proc_cmd (string) (defaults to: 'process-host-perfdata-file')

    Commands used to periodically process the host performance data files. Only active ifng_process_perf_data is set to 1.

  • ng_s_perfdata_proc_cmd (string) (defaults to: 'process-service-perfdata-file')

    Commands used to periodically process the service performance data files. Only active ifng_process_perf_data is set to 1.

  • ng_h_perfdata_proc_e_res (string) (defaults to: '1')

    Whether the core will process empty host perfdata results. Valid options are 0 and 1. Only active if ng_process_perf_data is set to 1.

  • ng_s_perfdata_proc_e_res (string) (defaults to: '1')

    Whether the core will process empty service perfdata results. Valid options are 0 and 1. Only active if ng_process_perf_data is set to 1.

  • ng_obsess_over_services (string) (defaults to: '0')

    Whether Nagios will obsess over service checks and run the ocsp_command defined. Unless you are planning on implementing distributed monitoring, do not enable this option.

  • ng_ocsp_command (string) (defaults to: '')

    Command that is run for every service check that is processed by Nagios. This command is executed only if the ng_obsess_over_servicesoption is set to 1. The command argument is the short name of a command definition defined in your service configuration file. Read the HTML docs for # more information on implementing distributed monitoring.

  • ng_obsess_over_hosts (string) (defaults to: '0')

    Whether Nagios will obsess over host checks and run the ocsp_command defined. Unless you are planning on implementing distributed monitoring, do not enable this option.

  • ng_ochp_command (string) (defaults to: '')

    Command that is run for every service check that is processed by Nagios. This command is executed only if the ng_obsess_over_hosts option is set to 1. The command argument is the short name of a command definition defined in your host configuration file. Read the HTML docs for # more information on implementing distributed monitoring.

  • ng_translate_pass_h_checks (string) (defaults to: '0')

    Whether or not Nagios will translate # DOWN/UNREACHABLE passive host check results into their proper state for this instance of Nagios. This option is useful only if you have distributed or failover monitoring setup. Valid options are 0 and 1.

  • ng_pass_h_checks_are_soft (string) (defaults to: '0')

    Whether Nagios will treat passive host checks as being HARD or SOFT. Valid options are 0 and 1.

  • ng_check_orphaned_svc (string) (defaults to: '1')

    Whether Nagios will periodically check for orphaned service checks.Valid options are 0 and 1.

  • ng_check_orphaned_hosts (string) (defaults to: '1')

    Whether Nagios will periodically check for orphaned host checks.Valid options are 0 and 1.

  • ng_check_service_freshness (string) (defaults to: '1')

    Whether Nagios will periodically check the "freshness" of service results. Valid options are 0 and 1.

  • ng_svc_fresh_check_intval (string) (defaults to: '60')

    how often (in seconds) Nagios will check the "freshness" of service check results. Only active if ng_check_service_freshness is set to 1.

  • ng_svc_check_timeout_state (string) (defaults to: 'c')

    The state Nagios will report when a service check times out - that is does not respond within ng_service_check_timeoutseconds. Valid settings are: c - Critical (default) u - Unknown w - Warning o - OK

  • ng_check_host_freshness (string) (defaults to: '0')

    Whether Nagios will periodically check the "freshness" of host check results. Valid options are 0 and 1.

  • ng_host_fresh_check_intval (string) (defaults to: '60')

    how often (in seconds) Nagios will check the "freshness" of host check results. Only active if ng_check_service_freshness is set to 1.

  • ng_add_freshness_latency (string) (defaults to: '15')

    number of seconds that Nagios will add to any host and service freshness thresholds that it calculates (those not explicitly specified by the user).

  • ng_enable_flap_detection (string) (defaults to: '1')

    Whether or not Nagios 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 # host or service is flapping, it will temporarily suppress notifications for that host/service until it stops flapping.

  • ng_low_svc_flap_threshold (string) (defaults to: '5.0')

    Low threshold for service flapping. only active if ng_enable_flap_detection is set to 1.

  • ng_high_svc_flap_threshold (string) (defaults to: '20.0')

    High threshold for service flapping. Only active if ng_enable_flap_detection is set to 1.

  • ng_low_h_flap_threshold (string) (defaults to: '5.0')

    Low threshold for host flapping. only active if ng_enable_flap_detection is set to 1.

  • ng_high_h_flap_threshold (string) (defaults to: '20.0')

    High threshold for host flapping. Only active if ng_enable_flap_detection is set to 1.

  • ng_date_format (string) (defaults to: 'us')

    How short dates are displayed. Valid options include: us (MM-DD-YYYY HH:MM:SS) euro (DD-MM-YYYY HH:MM:SS) iso8601 (YYYY-MM-DD HH:MM:SS) strict-iso8601 (YYYY-MM-DDTHH:MM:SS)

  • ng_use_timezone_offset (boolean) (defaults to: false)

    Whether to use timezone offsets. if set to false, the system configured timezone will be used.

  • ng_use_timezone (string) (defaults to: '')

    used to override the default timezone that this # instance of Nagios runs in. If not specified, Nagios 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. It is highly recommended to configure the timezone correctly at system level anyway. Only active if ng_use_timezone_offset is set to true.

  • ng_illegal_obj_name_chars (string) (defaults to: '`~!$%^&*|\'"<>?,()=')

    specify illegal characters that cannot # be used in host names, service descriptions, or names of other object types.

  • ng_ill_macro_output_chars (string) (defaults to: '`~$&|\'"<>')

    Specify illegal characters that are stripped from macros before being used in notifications, event handlers, etc. This DOES NOT affect macros used in service or host check commands. The following macros are stripped of the characters you specify: $HOSTOUTPUT$ $HOSTPERFDATA$ $HOSTACKAUTHOR$ $HOSTACKCOMMENT$ $SERVICEOUTPUT$ $SERVICEPERFDATA$ $SERVICEACKAUTHOR$ $SERVICEACKCOMMENT$

  • ng_use_regexp_matching (string) (defaults to: '0')

    Whether regular expression matching takes place in the object config files. Regular expression matching is used to match host, hostgroup, service, and service group names/descriptions in some fields of various object types. Valid options are 0 and 1.

  • ng_true_regexp_matching (string) (defaults to: '0')

    Whether or not “true” regular expression # matching takes place in the object config files. Only active if ng_use_regexp_matchingis set to true.

  • ng_daemon_dumps_core (string) (defaults to: '0')

    Whether Nagios is allowed to create a core dump when it runs as a daemon.

  • ng_use_large_inst_tweaks (string) (defaults to: '0')

    Whether or not Nagios will take some shortcuts # which can save on memory and CPU usage in large Nagios installations. Valid options are 0 or 1.

  • ng_enable_env_macros (string) (defaults to: '0')

    Whether Nagios will make all standard macros available as environment variables when host/service checks and system commands (event handlers, notifications, etc.) are executed. Can cause performance problems in large installations if enabled. Valid options are 0 or 1.

  • ng_free_child_process_mem (string) (defaults to: '1')

    Whether Nagios should free up memory on child processes. Valid options are 0 and 1.

  • ng_child_proc_fork_twice (string) (defaults to: '1')

    ow Nagios will fork child processes. Valid options are 0 or 1.

  • ng_debug_level (string) (defaults to: '0')

    how much (if any) debugging information will be written to the debug file. Valid options are: -1 = Everything 0 = Nothing 1 = Functions 2 = Configuration 4 = Process information 8 = Scheduled events 16 = Host/service checks 32 = Notifications 64 = Event broker 128 = External commands 256 = Commands 512 = Scheduled downtime 1024 = Comments 2048 = Macros

  • ng_debug_verbosity (string) (defaults to: '1')

    How verbose the debug log out will be. Valid options: 0 = Brief output 1 = More detailed 2 = Very detailed

  • ng_debug_file (string) (defaults to: '/var/spool/nagios/nagios.debug')

    FQDN where Nagios should write debug information.

  • ng_max_debug_file_size (string) (defaults to: '1000000')

    Maximum size (in bytes) of the debug file. If 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.

  • ng_allow_empty_hostgroups (string) (defaults to: '0')

    Should we allow hostgroups to have no hosts, we default this to off since that was the old behavior.

  • ng_check_workers (string) (defaults to: '')

    Normally worker count is dynamically allocated based on 1.5 * number of cpu's with a minimum of 4 workers. This value will override the defaults.

  • ng_host_down_svc_checks (string) (defaults to: '0')

    This option will disable all service checks if the host is not in an UP state. While desirable in some environments, enabling this value can distort report values as the expected quantity of checks will not have been performed. Valid options are 0 and 1.

  • ng_enable_load_ctl_options (boolean) (defaults to: false)

    Whether to enable loadctl_options To get current defaults based on your system issue a command to the query handler. Experiemental feature and not recomended for production.

  • ng_loadctl_options (string) (defaults to: 'jobs_max=100;backoff_limit=10;rampup_change=5')

    load controlling options jobs_max - The maximum amount of jobs to run at one time jobs_min - The minimum amount of jobs to run at one time jobs_limit - The maximum amount of jobs the current load lets us run backoff_limit - The minimum backoff_change backoff_change - # of jobs to remove from jobs_limit when backing off rampup_limit - Minimum rampup_change rampup_change - # of jobs to add to jobs_limit when ramping up

  • ng_nrpe_port (string) (defaults to: '5666')

    the port for NRPE. used by firewall and in configuration file.

  • ng_enable_swap_check (boolean) (defaults to: true)

    Whether to enable the declaration of the swap check. Disabling this makes sense when you use the cd_swap Puppet module and have enabled the check declaration from there, so the Nagios check is properly aligned to the Puppet module controlling the particular item.

Leave a Reply