diff --git a/CHANGELOG.md b/CHANGELOG.md index 5cb2cd9..fdc1120 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,6 @@ +## next + - [DOC] Added examples for using space delimited strings for `hosts` option [#154](https://github.com/logstash-plugins/logstash-input-elasticsearch/pull/154) + ## 4.9.1 - [DOC] Replaced hard-coded links with shared attributes [#143](https://github.com/logstash-plugins/logstash-input-elasticsearch/pull/143) - [DOC] Added missing quote to docinfo_fields example [#145](https://github.com/logstash-plugins/logstash-input-elasticsearch/pull/145) diff --git a/docs/index.asciidoc b/docs/index.asciidoc index 42ea523..fbdfc96 100644 --- a/docs/index.asciidoc +++ b/docs/index.asciidoc @@ -252,6 +252,16 @@ List of one or more Elasticsearch hosts to use for querying. Each host can be either IP, HOST, IP:port, or HOST:port. The port defaults to 9200. +This option can accept an environment variable containing one or more hostnames separated by whitespace. +Strings separated by whitespace are treated as separate entries. + +*Examples:* + +* `ES_HOSTS="es1.example.com es2.example.com:9201 es3.example.com:9201"` +* `ES_HOSTS="127.0.0.1:9200 127.0.0.2:9200"` +* `ES_HOSTS="http://127.0.0.1 http://127.0.0.2"` +* `ES_HOSTS="https://127.0.0.1:9200/mypath https://127.0.0.2:9200/mypath"` + [id="plugins-{type}s-{plugin}-index"] ===== `index`