github-mirrors/logstash
1
0
Fork 0
mirror of https://github.com/elastic/logstash.git synced 2025-04-23 22:27:21 -04:00
Code Issues Projects Releases Packages Wiki Activity

Adds Breaking Changes section.

Browse source 
Fixes #4039
This commit is contained in:
Paul Echeverri 2015-10-14 17:09:01 -07:00 • committed by Jordan Sissel
parent 6218cde793
commit 6dbc0ea501
1 changed files with 30 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

30
docs/asciidoc/static/breaking-changes.asciidoc Normal file
View file

@ -0,0 +1,30 @@
[[breaking-changes]]
== Breaking changes
Version 2.0 of Logstash has some changes that are incompatible with previous versions of Logstash. This section discusses
what you need to be aware of when migrating to this version.
[float]
=== Elasticsearch Output Default
Starting with the 2.0 release of Logstash, the default Logstash output for Elasticsearch is HTTP. To use the `node` or
`transport` protocols, download the {logstash}plugins-outputs-elasticsearch_java.html[Elasticsearch Java plugin]. The
Logstash HTTP output to Elasticsearch now supports sniffing.
==== 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 `max_inflight_requests` option, which was deprecated in the 1.5 release, is now removed
* The `node_name` and `protocol` options have been moved to the `elasticsearch_java` plugin
[float]
=== Kafka Output Configuration Changes
The 2.0 release of Logstash includes a new version of the Kafka output plugin with significant configuration changes.
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.