From: Michael Friedrich <michael.friedrich@netways.de>
Date: Mon, 4 Aug 2014 08:47:30 +0000 (+0200)
Subject: Documentation: Add section for implicit dependencies
X-Git-Tag: v2.0.2~27
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=3254cea01fc5da7d193733f4d2cc5c759d87cca8;p=icinga2

Documentation: Add section for implicit dependencies

fixes #6725
---

diff --git a/doc/3-monitoring-basics.md b/doc/3-monitoring-basics.md
index 3fe30520d..dec3087c3 100644
--- a/doc/3-monitoring-basics.md
+++ b/doc/3-monitoring-basics.md
@@ -956,6 +956,22 @@ account but all parents are inherited.
 
 Notifications are suppressed if a host or service becomes unreachable.
 
+### <a id="dependencies-implicit-host-service"></a> Implicit Dependencies for Services on Host
+
+Icinga 2 automatically adds an implicit dependency for services on their host. That way
+service notifications are suppressed when a host is `DOWN` or `UNREACHABLE`. This dependency
+does not overwrite other dependencies and implicitely sets `disable_notifications = true` and
+`states = [ Up ]` for all service objects.
+
+Service checks are still executed. If you want to prevent them from happening, you can
+apply the following dependency to all services setting their host as `parent_host_name`
+and disabling the checks. `assign where true` matches on all `Service` objects.
+
+    apply Dependency "disable-host-service-checks" to Service {
+      disable_checks = true
+      assign where true
+    }
+
 ### <a id="dependencies-network-reachability"></a> Dependencies for Network Reachability
 
 A common scenario is the Icinga 2 server behind a router. Checking internet