Documentation: Add freshness check changes.

fixes #4759

diff --git a/doc/6-advanced-topics.md b/doc/6-advanced-topics.md
index 32f112465561e55e71a55737531c234974e4bf7e..f47acee27529ba4b5719e8e34431b208ae70d26d 100644 (file)
--- a/doc/6-advanced-topics.md
+++ b/doc/6-advanced-topics.md
@@ -20,9 +20,19 @@ TODO
 
 TODO
 
-## Check Freshness
+## Check Result Freshness
 
-TODO
+In Icinga 2 active check freshness is enabled by default. It is determined by the
+`check_interval` attribute and no incoming check results in that period of time.
+
+    threshold = last check execution time + check interval
+
+Passive check freshness is calculated from the `check_interval` attribute if set.
+
+    threshold = last check result time + check interval
+
+If the freshness checks are invalid, a new check is executed defined by the
+`check_command` attribute.
 
 ## Check Flapping
 

diff --git a/doc/8-differences-between-icinga-1x-and-2.md b/doc/8-differences-between-icinga-1x-and-2.md
index 012c9b66357df3f5495e967c7d786915cb3852b6..ab4348ff65cd668b145b74a2193cbffe2ebc87d2 100644 (file)
--- a/doc/8-differences-between-icinga-1x-and-2.md
+++ b/doc/8-differences-between-icinga-1x-and-2.md
@@ -495,6 +495,19 @@ The algorithm used in Icinga 2 does not store the past states but calculcates th
 threshold from a single value based on counters and half-life values. Icinga 2 compares
 the value with a single flapping threshold configuration attribute.
 
+## Check Result Freshness
+
+Freshness of check results must be explicitely enabled in Icinga 1.x. The attribute
+`freshness_treshold` defines the threshold in seconds. Once the threshold is triggered, an
+active freshness check is executed defined by the `check_command` attribute. Both check
+methods (active and passive) use the same freshness check method.
+
+In Icinga 2 active check freshness is determined by the `check_interval` attribute and no
+incoming check results in that period of time (last check + check interval). Passive check
+freshness is calculated from the `check_interval` attribute if set. There is no extra
+`freshness_threshold` attribute in Icinga 2. If the freshness checks are invalid, a new
+service check is forced.
+
 ## State Retention
 
 Icinga 1.x uses the `retention.dat` file to save its state in order to be able