logstash-output-elasticsearch 10.5.0-java → 10.5.1-java
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +3 -0
- data/docs/index.asciidoc +24 -40
- data/logstash-output-elasticsearch.gemspec +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: cefa6633e4a89765721857efffd49144e84f4fd76a2b6625664478076f4623bd
|
4
|
+
data.tar.gz: d774499e956fdf0a2920a27e38830f47f7b479f313666874d447319db8736de6
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 142fdc58605911159a51bdd825bdb22e78f182a61084babc31f6827bf5965aea00dbfb6c9b5c58d55f26e6a9b09ca32b2b48e5a39b887afd400e3793f0d6044c
|
7
|
+
data.tar.gz: 3d98fa8506b2bba7a631f536e025aa5f6f3c50da862ee53509136df3430ce685f0d5adfefcd8bc14a97fdde874bd8e3e220842beaa8772663324e9a7571c145c
|
data/CHANGELOG.md
CHANGED
@@ -1,3 +1,6 @@
|
|
1
|
+
## 10.5.1
|
2
|
+
- [DOC] Removed outdated compatibility notices, reworked cloud notice, and fixed formatting for `hosts` examples [#938](https://github.com/logstash-plugins/logstash-output-elasticsearch/pull/938)
|
3
|
+
|
1
4
|
## 10.5.0
|
2
5
|
- Added api_key support [#934](https://github.com/logstash-plugins/logstash-output-elasticsearch/pull/934)
|
3
6
|
|
data/docs/index.asciidoc
CHANGED
@@ -21,6 +21,21 @@ include::{include_path}/plugin_header.asciidoc[]
|
|
21
21
|
|
22
22
|
==== Description
|
23
23
|
|
24
|
+
If you plan to use the Kibana web interface to analyze data transformed by
|
25
|
+
Logstash, use the Elasticsearch output plugin to get your data into
|
26
|
+
Elasticsearch.
|
27
|
+
|
28
|
+
This output only speaks the HTTP protocol as it is the preferred protocol for
|
29
|
+
interacting with Elasticsearch. In previous versions it was possible to
|
30
|
+
communicate with Elasticsearch through the transport protocol, which is now
|
31
|
+
reserved for internal cluster communication between nodes
|
32
|
+
https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-transport.html[communication between nodes].
|
33
|
+
Using the https://www.elastic.co/guide/en/elasticsearch/reference/current/java-clients.html[transport protocol]
|
34
|
+
to communicate with the cluster has been deprecated in Elasticsearch 7.0.0 and
|
35
|
+
will be removed in 8.0.0
|
36
|
+
|
37
|
+
You can learn more about Elasticsearch at <https://www.elastic.co/products/elasticsearch>
|
38
|
+
|
24
39
|
.Compatibility Note
|
25
40
|
[NOTE]
|
26
41
|
================================================================================
|
@@ -36,47 +51,12 @@ ensure your template uses the `_doc` document-type before
|
|
36
51
|
connecting to Elasticsearch 7.x.
|
37
52
|
================================================================================
|
38
53
|
|
39
|
-
|
40
|
-
[NOTE]
|
41
|
-
================================================================================
|
42
|
-
Starting with Elasticsearch 5.3, there's an {ref}/modules-http.html[HTTP setting]
|
43
|
-
called `http.content_type.required`. If this option is set to `true`, and you
|
44
|
-
are using Logstash 2.4 through 5.2, you need to update the Elasticsearch output
|
45
|
-
plugin to version 6.2.5 or higher.
|
46
|
-
|
47
|
-
================================================================================
|
48
|
-
|
49
|
-
If you plan to use the Kibana web
|
50
|
-
interface, use the Elasticsearch output plugin to get your log data into
|
51
|
-
Elasticsearch.
|
54
|
+
===== Hosted {es} Service on Elastic Cloud
|
52
55
|
|
53
|
-
|
56
|
+
You can run Elasticsearch on your own hardware, or use our
|
54
57
|
https://www.elastic.co/cloud/elasticsearch-service[hosted {es} Service] on
|
55
|
-
Elastic Cloud. The Elasticsearch Service is available on
|
56
|
-
{ess-trial}[Try the {es} Service for free].
|
57
|
-
|
58
|
-
This output only speaks the HTTP protocol. HTTP is the preferred protocol for interacting with Elasticsearch as of Logstash 2.0.
|
59
|
-
We strongly encourage the use of HTTP over the node protocol for a number of reasons. HTTP is only marginally slower,
|
60
|
-
yet far easier to administer and work with. When using the HTTP protocol one may upgrade Elasticsearch versions without having
|
61
|
-
to upgrade Logstash in lock-step.
|
62
|
-
|
63
|
-
You can learn more about Elasticsearch at <https://www.elastic.co/products/elasticsearch>
|
64
|
-
|
65
|
-
==== Template management for Elasticsearch 5.x
|
66
|
-
|
67
|
-
Index template for this version (Logstash 5.0) has been changed to reflect Elasticsearch's mapping changes in version 5.0.
|
68
|
-
Most importantly, the subfield for string multi-fields has changed from `.raw` to `.keyword` to match ES default
|
69
|
-
behavior.
|
70
|
-
|
71
|
-
**Users installing ES 5.x and LS 5.x**
|
72
|
-
|
73
|
-
This change will not affect you and you will continue to use the ES defaults.
|
74
|
-
|
75
|
-
**Users upgrading from LS 2.x to LS 5.x with ES 5.x**
|
76
|
-
|
77
|
-
LS will not force upgrade the template, if `logstash` template already exists. This means you will still use
|
78
|
-
`.raw` for sub-fields coming from 2.x. If you choose to use the new template, you will have to reindex your data after
|
79
|
-
the new template is installed.
|
58
|
+
Elastic Cloud. The Elasticsearch Service is available on AWS, Google Cloud
|
59
|
+
Platform, and Microsoft Azure. {ess-trial}[Try the {es} Service for free].
|
80
60
|
|
81
61
|
==== Writing to different indices: best practices
|
82
62
|
|
@@ -87,7 +67,7 @@ when using `ilm_rollover_alias`.
|
|
87
67
|
|
88
68
|
================================================================================
|
89
69
|
|
90
|
-
If you're sending events to the same Elasticsearch cluster but you're targeting different indices you can:
|
70
|
+
If you're sending events to the same Elasticsearch cluster, but you're targeting different indices you can:
|
91
71
|
|
92
72
|
* use different Elasticsearch outputs, each one with a different value for the `index` parameter
|
93
73
|
* use one Elasticsearch output and use the dynamic variable substitution for the `index` parameter
|
@@ -453,11 +433,15 @@ If you have custom firewall rules you may need to change this
|
|
453
433
|
|
454
434
|
Sets the host(s) of the remote instance. If given an array it will load balance requests across the hosts specified in the `hosts` parameter.
|
455
435
|
Remember the `http` protocol uses the http://www.elastic.co/guide/en/elasticsearch/reference/current/modules-http.html#modules-http[http] address (eg. 9200, not 9300).
|
436
|
+
|
437
|
+
Examples:
|
438
|
+
|
456
439
|
`"127.0.0.1"`
|
457
440
|
`["127.0.0.1:9200","127.0.0.2:9200"]`
|
458
441
|
`["http://127.0.0.1"]`
|
459
442
|
`["https://127.0.0.1:9200"]`
|
460
443
|
`["https://127.0.0.1:9200/mypath"]` (If using a proxy on a subpath)
|
444
|
+
|
461
445
|
It is important to exclude http://www.elastic.co/guide/en/elasticsearch/reference/current/modules-node.html[dedicated master nodes] from the `hosts` list
|
462
446
|
to prevent LS from sending bulk requests to the master nodes. So this parameter should only reference either data or client nodes in Elasticsearch.
|
463
447
|
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: logstash-output-elasticsearch
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 10.5.
|
4
|
+
version: 10.5.1
|
5
5
|
platform: java
|
6
6
|
authors:
|
7
7
|
- Elastic
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2020-04-
|
11
|
+
date: 2020-04-30 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
requirement: !ruby/object:Gem::Requirement
|