Skip to content

Monitoring Module Configuration

Overview

The module specific configuration is stored in /etc/icingaweb2/modules/monitoring.

File/Directory Description
config.ini Security settings (e.g. protected custom vars) for the monitoring module
backends.ini Data backend (e.g. the IDO database resource name).
commandtransports.ini Command transports for specific Icinga instances

General Configuration

Navigate into Configuration -> Modules -> Monitoring. This allows you to see the provided permissions and restrictions by this module.

Default Settings

Option Description
acknowledge_expire Optional. Check “Use Expire Time” in Acknowledgement dialog by default. Defaults to 0 (false).
acknowledge_expire_time Optional. Set default value for “Expire Time” in Acknowledgement dialog, its calculated as now + this setting. Format is a PHP Dateinterval. Defaults to 1 hour (PT1H).
acknowledge_notify Optional. Check “Send Notification” in Acknowledgement dialog by default. Defaults to 1 (true).
acknowledge_persistent Optional. Check “Persistent Comment” in Acknowledgement dialog by default. Defaults to 0 (false).
acknowledge_sticky Optional. Check “Sticky Acknowledgement” in Acknowledgement dialog by default. Defaults to 0 (false).
custom_notification_forced Optional. Check “Forced” in Custom Notification dialog by default. Defaults to 0 (false).
hostcheck_all_services Optional. Check “All Services” in Schedule Host Check dialog by default. Defaults to 0 (false).
hostdowntime_all_services Optional. Check “All Services” in Schedule Host Downtime dialog by default. Defaults to 0 (false).

Example for having acknowledgements with 2 hours expire time by default.

# vim /etc/icingaweb2/modules/monitoring/config.ini

[settings]
acknowledge_expire = 1
acknowledge_expire_time = PT2H

Security Configuration

Option Description
protected_customvars Optional. Comma separated list of string patterns for custom variables which should be excluded from user’s view.

Example for custom variable names which match *pw* or *pass* or community.

# vim /etc/icingaweb2/modules/monitoring/config.ini

[security]
protected_customvars = "*pw*,*pass*,community"