mirror of
https://github.com/Icinga/icinga2.git
synced 2025-07-24 22:24:44 +02:00
Documentation for tags fuctionality in ElasticSearchWriter
This commit is contained in:
parent
7d12c1a524
commit
a848d360ac
@ -1181,7 +1181,7 @@ Configuration Attributes:
|
||||
|
||||
### ElasticsearchWriter <a id="objecttype-elasticsearchwriter"></a>
|
||||
|
||||
Writes check result metrics and performance data to an Elasticsearch instance.
|
||||
Writes check result metrics and performance data to an Elasticsearch or OpenSearch instance.
|
||||
This configuration object is available as [elasticsearch feature](14-features.md#elasticsearch-writer).
|
||||
|
||||
Example:
|
||||
@ -1194,6 +1194,10 @@ object ElasticsearchWriter "elasticsearch" {
|
||||
|
||||
enable_send_perfdata = true
|
||||
|
||||
host_tags_template = {
|
||||
os_name = "$host.vars.os$"
|
||||
}
|
||||
|
||||
flush_threshold = 1024
|
||||
flush_interval = 10
|
||||
}
|
||||
@ -1215,6 +1219,8 @@ Configuration Attributes:
|
||||
password | String | **Optional.** Basic auth password if Elasticsearch is hidden behind an HTTP proxy.
|
||||
enable\_tls | Boolean | **Optional.** Whether to use a TLS stream. Defaults to `false`. Requires an HTTP proxy.
|
||||
insecure\_noverify | Boolean | **Optional.** Disable TLS peer verification.
|
||||
host\_tags\_template | Dictionary | **Optional.** Allows to apply additional tags to the Elasticsearch host entries.
|
||||
service\_tags\_template | Dictionary | **Optional.** Allows to apply additional tags to the Elasticsearch service entries.
|
||||
ca\_path | String | **Optional.** Path to CA certificate to validate the remote host. Requires `enable_tls` set to `true`.
|
||||
cert\_path | String | **Optional.** Path to host certificate to present to the remote host for mutual verification. Requires `enable_tls` set to `true`.
|
||||
key\_path | String | **Optional.** Path to host key to accompany the cert\_path. Requires `enable_tls` set to `true`.
|
||||
|
@ -398,6 +398,28 @@ check_result.perfdata.<perfdata-label>.warn
|
||||
check_result.perfdata.<perfdata-label>.crit
|
||||
```
|
||||
|
||||
Additionaly it is possible to configure custom tags that are applied to the metrics via `host_tags_template` or `service_tags_template`.
|
||||
Depending on whether the write event was triggered on a service or host object, additional tags are added to the ElasticSearch entries.
|
||||
|
||||
A host metrics entry configured with the following `host_tags_template`:
|
||||
|
||||
```
|
||||
host_tags_template = {
|
||||
|
||||
os_name = "$host.vars.os$"
|
||||
custom_label = "A Custom Label"
|
||||
list = [ "$host.groups$", "$host.vars.foo$" ]
|
||||
}
|
||||
```
|
||||
|
||||
Will in addition to the above mentioned lines also contain:
|
||||
|
||||
```
|
||||
os_name = "Linux"
|
||||
custom_label = "A Custom Label"
|
||||
list = [ "group-A;linux-servers", "bar" ]
|
||||
```
|
||||
|
||||
#### Elasticsearch in Cluster HA Zones <a id="elasticsearch-writer-cluster-ha"></a>
|
||||
|
||||
The Elasticsearch feature supports [high availability](06-distributed-monitoring.md#distributed-monitoring-high-availability-features)
|
||||
|
Loading…
x
Reference in New Issue
Block a user