tyler.durden/icinga2
1
0
Fork 0
mirror of https://github.com/Icinga/icinga2.git synced 2025-07-23 05:34:48 +02:00
Code Issues Packages Projects Releases Wiki Activity

Documentation: Add a note on unreachable preventing notifications being sent.

Browse Source 
Refs #4789
This commit is contained in:
Michael Friedrich 2014-05-12 19:40:02 +02:00
parent aa97c3c670
commit a86d21d4bb
1 changed files with 9 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
doc/3-monitoring-basics.md
View File

@ -502,6 +502,11 @@ Details on all available options can be found in the
Notifications for service and host problems are an integral part of your Notifications for service and host problems are an integral part of your
monitoring setup. monitoring setup.
When a host or service is in a downtime, a problem has been acknowledged or
the dependency logic determined that the host/service is unreachable, no
notirications are sent. You can configure additional type and state filters
refining the notifications being actually sent.
There are many ways of sending notifications, e.g. by e-mail, XMPP, There are many ways of sending notifications, e.g. by e-mail, XMPP,
IRC, Twitter, etc. On its own Icinga 2 does not know how to send notifications. IRC, Twitter, etc. On its own Icinga 2 does not know how to send notifications.
Instead it relies on external mechanisms such as shell scripts to notify users. Instead it relies on external mechanisms such as shell scripts to notify users.
@ -823,7 +828,8 @@ re-notify if the problem persists.
## <a id="dependencies"></a> Dependencies ## <a id="dependencies"></a> Dependencies
Icinga 2 uses host and service [Dependency](#objecttype-dependency) objects. Icinga 2 uses host and service [Dependency](#objecttype-dependency) objects
for determing their network reachability.
The `parent_host_name` and `parent_service_name` attributes are mandatory for The `parent_host_name` and `parent_service_name` attributes are mandatory for
service dependencies, `parent_host_name` is required for host dependencies. service dependencies, `parent_host_name` is required for host dependencies.
@ -833,6 +839,8 @@ as host parent relation.
When dependencies are calculated, not only the immediate parent is taken into When dependencies are calculated, not only the immediate parent is taken into
account but all parents are inherited. account but all parents are inherited.
Notifications are suppressed if a host or service becomes unreachable.
A common scenario is the Icinga 2 server behind a router. Checking internet A common scenario is the Icinga 2 server behind a router. Checking internet
access by pinging the Google DNS server `google-dns` is a common method, but access by pinging the Google DNS server `google-dns` is a common method, but
will fail in case the `dsl-router` host is down. Therefore the example below will fail in case the `dsl-router` host is down. Therefore the example below