Add documentation for `Apply For` services
This commit is contained in:
parent
e7bd4343b5
commit
b5e984e0e5
|
@ -0,0 +1,42 @@
|
|||
<a id="Service-apply-for-example"></a>Working with Apply for rules - tcp ports example
|
||||
==============================================
|
||||
|
||||
This example wants to show you how to make use of `Apply For` rule for services.
|
||||
|
||||
First you need to define a `tcp_ports` data field of type `Array` assigned to a `Host Template`.
|
||||
Refer to [Working with fields](14-Fields-example-interfaces-array.md) section to setup a data field.
|
||||
You also need to define a `tcp_port` data field of type `String`, we will associate it to a
|
||||
`Service Template` later.
|
||||
|
||||
Then, please got to the `Dashboard` and choose the `Monitored services` dashlet:
|
||||
|
||||
![Dashboard - Monitored services](screenshot/director/15_apply-for-services/151_monitored_services.png)
|
||||
|
||||
Then create a new `Service template` with check command `tcp`:
|
||||
|
||||
![Define service template - tcp](screenshot/director/15_apply-for-services/152_add_service_template.png)
|
||||
|
||||
Then associate the data field `tcp_port` to this `Service template`:
|
||||
|
||||
![Associate field to service template - tcp_port](screenshot/director/15_apply-for-services/153_add_service_template_field.png)
|
||||
|
||||
Then create a new `apply-rule` for the `Service template`:
|
||||
|
||||
![Define apply rule](screenshot/director/15_apply-for-services/154_create_apply_rule.png)
|
||||
|
||||
Now define the `Apply For` property, select the previously defined field `tcp_ports` associated to
|
||||
the host template. `Apply For` rule define a variable `value` that can be used as `$$value$$`, it
|
||||
corresponds to the item of the array it will iterate on. Set the `Tcp port` property to `$$value$$`:
|
||||
|
||||
![Add field to template](screenshot/director/15_apply-for-services/155_configure_apply_for.png)
|
||||
|
||||
(Side note: if you can't see your `tcp_ports` property in `Apply For` dropdown, try to create one
|
||||
host with a non-empty `tcp_ports` value.)
|
||||
|
||||
That's it, now all your hosts defining a `tcp_ports` variable will be assigned the `Tcp Check`
|
||||
service.
|
||||
|
||||
Have a look at the config preview, it will show you how `Apply For` services will look like once
|
||||
deployed:
|
||||
|
||||
![Host config preview with Array](screenshot/director/15_apply-for-services/156_config_preview.png)
|
Binary file not shown.
After Width: | Height: | Size: 57 KiB |
Binary file not shown.
After Width: | Height: | Size: 32 KiB |
Binary file not shown.
After Width: | Height: | Size: 52 KiB |
Binary file not shown.
After Width: | Height: | Size: 14 KiB |
Binary file not shown.
After Width: | Height: | Size: 35 KiB |
Binary file not shown.
After Width: | Height: | Size: 30 KiB |
Loading…
Reference in New Issue