github-mirrors/logstash
1
0
Fork 0
mirror of https://github.com/elastic/logstash.git synced 2025-04-24 06:37:19 -04:00
Code Issues Projects Releases Packages Wiki Activity

Updates to include feedback.

Browse source 
Fixes #4039
This commit is contained in:
Paul Echeverri 2015-10-15 18:38:14 -07:00 • committed by Jordan Sissel
parent 6dbc0ea501
commit 1af2873c8d
1 changed files with 27 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

29
docs/asciidoc/static/breaking-changes.asciidoc
View file

@ -11,15 +11,32 @@ Starting with the 2.0 release of Logstash, the default Logstash output for Elast
`transport` protocols, download the {logstash}plugins-outputs-elasticsearch_java.html[Elasticsearch Java plugin]. The
Logstash HTTP output to Elasticsearch now supports sniffing.
NOTE: The `elasticsearch_java` plugin has two versions specific to the version of the underlying Elasticsearch cluster.
Be sure to specify the correct value for the `--version` option during installation:
* For Elasticsearch versions before 2.0, use the command
`bin/plugin install --version 1.5.x logstash-output-elasticsearch_java`
* For Elasticsearch versions 2.0 and after, use the command
`bin/plugin install --version 2.0.0.beta5 logstash-output-elasticsearch_java`
==== Configuration Changes
The Elasticsearch output plugin configuration has the following changes:
* The `host` configuration option is now `hosts`
* New options: `bind_host`, `bind_port`, `cluster`, `embedded`, `embedded_http_port`, `port`, `sniffing_delay
* The `host` configuration option is now `hosts`, allowing you to specify multiple hosts and associated ports in the
`myhost:9200` format
* New options: `bind_host`, `bind_port`, `cluster`, `embedded`, `embedded_http_port`, `port`, `sniffing_delay`
* The `max_inflight_requests` option, which was deprecated in the 1.5 release, is now removed
* Since the `hosts` option allows specification of ports for the hosts, the redundant `port` option is now removed
* The `node_name` and `protocol` options have been moved to the `elasticsearch_java` plugin
The following deprecated configuration settings are removed in this release:
* input plugin configuration settings: `debug`, `format`, `charset`, `message_format`
* output plugin configuration settings: `type`, `tags`, `exclude_tags`.
* filter plugin configuration settings: `type`, `tags`, `exclude_tags`.
Configuration files with these settings present are invalid and prevent Logstash from starting.
[float]
=== Kafka Output Configuration Changes
@ -28,3 +45,11 @@ Please compare the documentation pages for the
https://www.elastic.co/guide/en/logstash/1.5/plugins-outputs-kafka.html[Logstash 1.5] and
https://www.elastic.co/guide/en/logstash/2.0/plugins-outputs-kafka.html[Logstash 2.0] versions of the Kafka output plugin
and update your configuration files accordingly.
[float]
=== Filter Worker Default Change
Starting with the 2.0 release of Logstash, the default value of the `filter_workers` configuration option for filter
plugins is half of the available CPU cores, instead of 1. This change increases parallelism in filter execution for
resource-intensive filtering operations. You can continue to use the `-w` flag to manually set the value for this option,
as in previous releases.