tyler.durden
/
icinga2
mirror of https://github.com/Icinga/icinga2.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Update doc anchors

This commit is contained in:
Michael Friedrich 2018-08-09 12:22:55 +02:00
parent eb02d9041d
commit cd94b7731e
1 changed files with 11 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
doc/06-distributed-monitoring.md
View File

@ -116,7 +116,8 @@ you still need a [Host](09-object-types.md#objecttype-host) object.
In case you are using the CLI commands later, you don't have to write
this configuration from scratch in a text editor.
The [ApiListener] object is used to load the SSL certificates and specify restrictions, e.g.
The [ApiListener](09-object-types.md#objecttype-apilistener) object is
used to load the TLS certificates and specify restrictions, e.g.
for accepting configuration commands.
It is also used for the [Icinga 2 REST API](12-icinga2-api.md#icinga2-api) which shares
@ -2795,12 +2796,14 @@ Add the global zone `global-templates` in case it did not exist.
## Using Multiple Environments <a id="distributed-monitoring-environments"></a>
In some cases it might be useful to run multiple Icinga instance on the same host. Two potential scenarios include:
In some cases it can be desired to run multiple Icinga instances on the same host.
Two potential scenarios include:
* running different versions of the same monitoring configuration (e.g. production and testing)
* running disparate sets of checks for entirely unrelated monitoring environments (e.g. infrastructure and applications)
* Different versions of the same monitoring configuration (e.g. production and testing)
* Disparate sets of checks for entirely unrelated monitoring environments (e.g. infrastructure and applications)
Configuration is controlled via constants and attributes of the [ApiListener].
The configuration is done with global constants and attributes of the
[ApiListener](09-object-types.md#objecttype-apilistener) object.
Constant | Attribute
---------------|----------
@ -2808,10 +2811,10 @@ ApiEnvironment | environment
ApiBindHost | bind_host
ApiBindPort | bind_port
In any case the constant is default value for the attribute, so that a direct configuration in the [ApiListener] object
has more precedence. The constants have been created to allow the values to be set from the command line on startup.
In any case the constant is default value for the attribute and the direct configuration in the ApiListener object
has more precedence. The constants have been added to allow the values being set from the CLI on startup.
When Icinga establishes a TLS connection to another cluster instance it automatically uses the [SNI extension]
When Icinga establishes a TLS connection to another cluster instance it automatically uses the [SNI extension](https://en.wikipedia.org/wiki/Server_Name_Indication)
to signal which endpoint it is attempting to connect to. On its own this can already be used to position multiple
Icinga instances behind a load balancer.
@ -2825,6 +2828,3 @@ Middleware like loadbalancers or TLS proxies can read the SNI header and route t
I.e., it uses a single externally-visible TCP port (usually 5665) and forwards connections to one or more Icinga
instances which are bound to a local TCP port. It does so by inspecting the environment name that is sent as part of the
SNI extension.
[ApiListener]: 09-object-types.md#objecttype-apilistener
[SNI Extension]: https://en.wikipedia.org/wiki/Server_Name_Indication