"Fossies" - the Fresh Open Source Software Archive

Member "icingaweb2-2.11.4/modules/monitoring/doc/03-Configuration.md" (26 Jan 2023, 5733 Bytes) of package /linux/www/icingaweb2-2.11.4.tar.gz:

As a special service "Fossies" has tried to format the requested source page into HTML format (assuming markdown format). Alternatively you can here view or download the uninterpreted source code file. A member file download can also be achieved by clicking within a package contents listing on the according byte size field. See also the last Fossies "Diffs" side-by-side code changes report for "03-Configuration.md": 2.10.3_vs_2.11.0.

A hint: This file contains one or more very long lines, so maybe it is better readable using the pure text view mode that shows the contents as wrapped lines within the browser window.

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).
comment_expire Optional. Check "Use Expire Time" in Comment dialog by default. Defaults to 0 (false).
hostdowntime_comment_text Optional. Set default text for "Comment" in Host Downtime dialog by default.
servicedowntime_comment_text Optional. Set default text for "Comment" in Service Downtime dialog by default.
comment_expire_time Optional. Set default value for "Expire Time" in Comment dialog, its calculated as now + this setting. Format is a PHP Dateinterval. Defaults to 1 hour (PT1H).
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).
hostdowntime_end_fixed Optional. Set default value for "End Time" in Schedule Host Downtime dialog for Fixed downtime, its calculated as now + this setting. Format is a PHP Dateinterval. Defaults to 1 hour (PT1H).
hostdowntime_end_flexible Optional. Set default value for "End Time" in Schedule Host Downtime dialog for Flexible downtime, its calculated as now + this setting. Format is a PHP Dateinterval. Defaults to 1 hour (PT1H).
hostdowntime_flexible_duration Optional. Set default value for "Flexible Duration" in Schedule Host Downtime dialog for Flexible downtime. Format is a PHP Dateinterval. Defaults to 2 hour (PT2H).
servicedowntime_end_fixed Optional. Set default value for "End Time" in Schedule Service Downtime dialog for Fixed downtime, its calculated as now + this setting. Format is a PHP Dateinterval. Defaults to 1 hour (PT1H).
servicedowntime_end_flexible Optional. Set default value for "End Time" in Schedule Service Downtime dialog for Flexible downtime, its calculated as now + this setting. Format is a PHP Dateinterval. Defaults to 1 hour (PT1H).
servicedowntime_flexible_duration Optional. Set default value for "Flexible Duration" in Schedule Service Downtime dialog for Flexible downtime. Format is a PHP Dateinterval. Defaults to 2 hour (PT2H).

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"