docs: Mention field mapping issue with ElasticsearchWriter

This commit is contained in:
Markus Opolka 2025-07-22 17:04:27 +02:00
parent aeb2550ccb
commit e86dd0d28e
2 changed files with 7 additions and 1 deletions

View File

@ -1229,6 +1229,11 @@ Configuration Attributes:
Note: If `flush_threshold` is set too low, this will force the feature to flush all data to Elasticsearch too often.
Experiment with the setting, if you are processing more than 1024 metrics per second or similar.
> **Note**
>
> Be aware that `enable_send_perfdata` will create a new field mapping in the index for each performance data metric in a check plugin.
> Elasticsearch/OpenSearch have a maximum number of fields in an index. The default value is usually 1000 fields. See [mapping settings limit](https://www.elastic.co/guide/en/elasticsearch/reference/8.18/mapping-settings-limit.html)
Basic auth is supported with the `username` and `password` attributes. This requires an
HTTP proxy (Nginx, etc.) in front of the Elasticsearch instance. Check [this blogpost](https://blog.netways.de/2017/09/14/secure-elasticsearch-and-kibana-with-an-nginx-http-proxy/)
for an example.

View File

@ -364,7 +364,8 @@ The following event types are written to Elasticsearch:
* icinga2.event.notification
Performance data metrics must be explicitly enabled with the `enable_send_perfdata`
attribute.
attribute. Be aware that this will create a new field mapping in the index for each performance data metric in a check plugin.
See: [ElasticsearchWriter](09-object-types.md#objecttype-elasticsearchwriter)
Metric values are stored like this: