From: Michael Friedrich Date: Wed, 12 Sep 2018 15:08:32 +0000 (+0200) Subject: Update notification and upgrading docs for recovery/acknowledgement handling X-Git-Tag: v2.10.0~34^2 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=354e3c9093c154d3e2c704fd51149a3dd0b84c3c;p=icinga2 Update notification and upgrading docs for recovery/acknowledgement handling refs #6047 --- diff --git a/doc/03-monitoring-basics.md b/doc/03-monitoring-basics.md index 627423e62..a4775c69f 100644 --- a/doc/03-monitoring-basics.md +++ b/doc/03-monitoring-basics.md @@ -1553,6 +1553,14 @@ send notifications to all group members. > Only users who have been notified of a problem before (`Warning`, `Critical`, `Unknown` states for services, `Down` for hosts) will receive `Recovery` notifications. +Icinga 2 v2.10 allows you to configure `Acknowledgement` and/or `Recovery` +without a `Problem` notification. These notifications will be sent without +any problem notifications beforehand, and can be used for e.g. ticket systems. + +``` + types = [ Acknowledgement, Recovery ] +``` + ### Notifications: Users from Host/Service A common pattern is to store the users and user groups diff --git a/doc/16-upgrading-icinga-2.md b/doc/16-upgrading-icinga-2.md index 9c8d79a23..8bf58bc13 100644 --- a/doc/16-upgrading-icinga-2.md +++ b/doc/16-upgrading-icinga-2.md @@ -62,6 +62,31 @@ are counted as connected endpoints. A similar change is there for the performanc The attribute `child_options` was previously accepting 0,1,2 for specific child downtime settings. This behaviour stays intact, but the new proposed way are specific constants as values (`DowntimeNoChildren`, `DowntimeTriggeredChildren`, `DowntimeNonTriggeredChildren`). +### Notifications: Recovery and Acknowledgement + +When a user should be notified on `Problem` and `Acknowledgement`, v2.10 now checks during +the `Acknowledgement` notification event whether this user has been notified about a problem before. + +``` + types = [ Problem, Acknowledgement, Recovery ] +``` + +If **no** `Problem` notification was sent, and the types filter includes problems for this user, +the `Acknowledgement` notification is **not** sent. + +In contrast to that, the following configuration always sends `Acknowledgement` notifications. + +``` + types = [ Acknowledgement, Recovery ] +``` + +This change also restores the old behaviour for `Recovery` notifications. The above configuration +leaving out the `Problem` type can be used to only receive recovery notifications. If `Problem` +is added to the types again, Icinga 2 checks whether it has notified a user of a problem when +sending the recovery notification. + +More details can be found in [this PR](https://github.com/Icinga/icinga2/pull/6527). + ## Upgrading to v2.9 ### Deprecation and Removal Notes