admin_email | string

Default: root@localhost

Email address used for the admin, used by $ADMINEMAIL$ in notification commands.

admin_host_notification_commands | string

Default: notify-host-by-email

This directive is used to define a list of the short names of the commands used to notify the default admin contact of a host problem or recovery. Change this or add commands if you have custom notification plugins. Multiple notification commands should be separated by commas. All notification commands are executed when the contact needs to be notified.

admin_host_notification_options | string

Default: d,r

This directive is used to define the host states for which notifications can be sent out to the default admin contact. Valid options are a combination of one or more of the following: d = notify on DOWN host states, u = notify on UNREACHABLE host states, r = notify on host recoveries (UP states), f = notify when the host starts and stops flapping, s = send notifications when host or service scheduled downtime starts and ends. If you specify n (none) as an option, the contact will not receive any type of host notifications.

admin_host_notification_period | string

Default: 24x7

This directive is used to specify the short name of the time period during which the default admin contact can be notified about host problems or recoveries. You can think of this as an "on call" time for host notifications for the contact. Read the documentation on time periods for more information on how this works and potential problems that may result from improper use.

admin_pager | string

Default: pageroot@localhost

Email address used for the admin pager, used by $ADMINPAGER$ in notification commands.

admin_service_notification_commands | string

Default: notify-service-by-email

This directive is used to define a list of the short names of the commands used to notify the default admin contact of a service problem or recovery. Change this or add commands if you have custom notification plugins. Multiple notification commands should be separated by commas. All notification commands are executed when the contact needs to be notified.

admin_service_notification_options | string

Default: w,u,c,r

This directive is used to define the service states for which notifications can be sent out to the default admin contact. Valid options are a combination of one or more of the following: w = notify on WARNING service states, u = notify on UNKNOWN service states, c = notify on CRITICAL service states, r = notify on service recoveries (OK states), f = notify when the service starts and stops flapping. If you specify n (none) as an option, the contact will not receive any type of service notifications.

admin_service_notification_period | string

Default: 24x7

This directive is used to specify the short name of the time period during which the default admin contact can be notified about service problems or recoveries. You can think of this as an "on call" time for service notifications for the contact. Read the documentation on time periods for more information on how this works and potential problems that may result from improper use.

check_external_commands | int

Default: 1

Config variable to enable checking external commands - 0 is disable, 1 is enable.

check_timeout | int

Default: 10

A number of seconds before nrpe checks timeout from not being able to connect to the client or finish execution of the command. Raise this value to combat 'CHECK_NRPE Socket timeout alerts'

command_check_interval | string

Default: -1

How often to check for external commands.

command_file | string

Default: /var/lib/nagios3/rw/nagios.cmd

File that Nagios checks for external command requests.

contactgroup-members | string

Default: root

Comma separated list of contacts to add as members of the admins group.

daemon_dumps_core | int

Option to determine if Nagios is allowed to create a core dump.

debug_file | string

Default: /var/log/nagios3/nagios.debug

Path for the debug file.

debug_level | int

Specify the debug level for nagios. See the docs for more details.

debug_verbosity | int

Default: 1

How verbose will the debug logs be - 0 is brief, 1 is more detailed and 2 is very detailed.

enable_livestatus | boolean

Config variable to enable livestatus module or not.

enable_pagerduty | boolean

Config variable to enable pagerduty notifications or not.

extraconfig | string

Any additional nagios configuration you would like to add can be set into this element. It will be placed in /etc/nagios3/conf.d/extra.cfg

flap_detection | boolean

Default: True

Enable flap detection on monitored hosts and services.

livestatus_args | string

Arguments to be passed to the livestatus module, defaults to empty.

livestatus_path | string

Default: /var/lib/nagios3/livestatus/socket

Default path to livestatus socket, if enabled via enable_livestatus

load_monitor | string

Default: 5.0!4.0!3.0!10.0!6.0!4.0

A string to pass to the Nagios load monitoring command. Default is to report warning at 5.0, 4.0 and 3.0 averages, critical at 10.0, 6.0 and 4.0.

log_archive_path | string

Default: /var/log/nagios3/archives

Path for archived log files

log_rotation_method | string

Default: d

Log rotation method that Nagios should use to rotate the main logfile.

monitor_self | boolean

Default: True

If true, enable monitoring of the nagios unit itself.

nagios_group | string

Default: nagios

The effective group that nagios will run as.

nagios_host_context | string

Default: juju

a string that will be prepended to instance name to set the host name in nagios. So for instance the hostname would be something like: juju-postgresql-0 If you're running multiple environments with the same services in them this allows you to differentiate between them.

nagios_user | string

Default: nagios

The effective user that nagios will run as.

nagiosadmin | string

Default: nagiosadmin

Username for Nagios admin user.

pagerduty_key | string

Pagerduty API key to use for notifications

pagerduty_notification_levels | string

Default: u,c,r

A string to use for the service_notification_options in the pagerduty contact configuration. Add w to page for warning events.

pagerduty_path | string

Default: /var/lib/nagios3/pagerduty

Path for Pagerduty notifications to be queued.

password | string

Password to use for Nagios administrative access. If not provided, a password will be generated (see documentation for instructions on retrieving the generated password.)

ro-password | string

Password to use for read-only Nagios access. If left blank, the nagiosro account will not be created.

send_traps_to | string

Defines the IP or Host Name to send snmp traps to. Leave blank (empty) to disable the traps functionality.

service_check_timeout | int

Default: 60

Number of seconds Nagios allows for a service check before killing it off. This ties in with service_check_timeout_state. NRPE will alert for the lower of this value or check_timeout. Also note that host_check_timeout is set to 30 seconds, and it's preferred to have service_check_timout greater than host_check_timeout.

service_check_timeout_state | string

Default: c

This setting determines the state Nagios will report when a service check times out - that is does not respond within service_check_timeout seconds. This can be useful if a machine is running at too high a load and you do not want to consider a failed service check to be critical (the default). Valid settings are: c - Critical (default) u - Unknown w - Warning o - OK

ssl | string

Default: off

Enable SSL communication for Nagios. Possible values are "on", "off", or "only". The "only" option disables All HTTP communication in favor of HTTPS - may play havok with existing nagios deployments.

ssl_cert | string

base64 encoded server certificate. If left blank, the certificate and key will be autogenerated as self-signed.

ssl_chain | string

base64 encoded chain certificates file. If ssl_cert is blank, this will be ignored.

ssl_key | string

base64 encoded server certificate key. If ssl_cert is blank, this is ignored.

use_syslog | int

Default: 1

Log messages to syslog as well as main file.

andre Ruiz Nagios