tyler.durden/icinga2
1
0
Fork 0
mirror of https://github.com/Icinga/icinga2.git synced 2025-07-25 22:54:57 +02:00
Code Issues Packages Projects Releases Wiki Activity

Documentation: Add a note on host and service checks.

Browse Source 
Fixes #6361
This commit is contained in:
Michael Friedrich 2014-06-02 14:39:42 +02:00
parent 26f0ef7657
commit bef81e6881
2 changed files with 20 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
doc/2-getting-started.md
View File

@ -197,7 +197,8 @@ The `conf.d/localhost.conf` file contains our first host definition:
This defines the host `localhost`. The `import` keyword is used to import This defines the host `localhost`. The `import` keyword is used to import
the `generic-host` template which takes care of setting up the host check the `generic-host` template which takes care of setting up the host check
command. command to `hostalive`. If you require a different check command, you can
override it in the object definition.
The `vars` attribute can be used to define custom attributes which are available The `vars` attribute can be used to define custom attributes which are available
for check and notification commands. Most of the templates in the Icinga for check and notification commands. Most of the templates in the Icinga

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

@ -40,7 +40,7 @@ host `my-server1`.
It also specifies that the host should perform its own check using the `hostalive` It also specifies that the host should perform its own check using the `hostalive`
check command. check command.
The `address` custom attribute is used by check commands to determine which network The `address` attribute is used by check commands to determine which network
address is associated with the host object. address is associated with the host object.
Details on troubleshooting check problems can be found [here](#troubleshooting). Details on troubleshooting check problems can be found [here](#troubleshooting).
@ -80,7 +80,24 @@ state the host/service switches to a `HARD` state and notifications are sent.
HARD | The host/service's state hasn't recently changed. HARD | The host/service's state hasn't recently changed.
SOFT | The host/service has recently changed state and is being re-checked. SOFT | The host/service has recently changed state and is being re-checked.
### <a id="host-service-checks"></a> Host and Service Checks
Hosts and Services determine their state from a check result returned from a check
execution to the Icinga 2 application. By default the `generic-host` example template
will define `hostalive` as host check. If your host is unreachable for ping, you should
consider using a different check command, for instance the `http` check command, or if
there is no check available, the `dummy` check command.
object Host "uncheckable-host" {
check_command = "dummy"
vars.dummy_state = 1
vars.dummy_text = "Pretending to be OK."
}
Service checks could also use a `dummy` check, but the common strategy is to
[integrate an existing plugin](#command-plugin-integration) as
[check command](#check-commands) and [reference](#command-passing-parameters)
that in your [Service](#objecttype-service) object definition.
## <a id="configuration-best-practice"></a> Configuration Best Practice ## <a id="configuration-best-practice"></a> Configuration Best Practice