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

Update 5.0 breaking changes to add more clarity

Browse source 
Fixes #6711
This commit is contained in:
Suyog Rao 2017-02-14 22:36:19 -08:00
parent 96b8293e03
commit 5cbb91a10a
1 changed files with 20 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

24
docs/static/breaking-changes.asciidoc vendored
View file

@ -144,6 +144,14 @@ bin/logstash -f my.conf -w 8 <2>
NOTE: None of the short form options have changed!
[float]
==== RSpec testing script
The `rspec` script is no longer bundled with Logstash release artifacts. This script has been used previously to
run unit tests for validating users Logstash configuration. While this was useful to some users, this mechanism assumed that Logstash users
were familiar with the RSpec framework, which is a Ruby testing framework.
[float]
=== Breaking Changes in Plugins
@ -209,10 +217,18 @@ bin/logstash-plugin install --version 4.0.1 logstash-output-kafka
The version numbers were found by checking the compatibility matrix for the individual plugins.
Specifically, for the Kafka input plugin, configs have changed a lot. Configuration `topic_id`
is replaced by `topics`. `zk_connect` is replaced by `bootstrap_servers` which are Kafka brokers. `consumer_id` is
replaced by `client_id`. Also, offsets are now stored in Kafka topics instead of Zookeeper. See <<plugins-inputs-kafka>>
for more information.
[float]
==== Kafka Input Configuration Changes
As described in the section <<plugin-versions, above>>, Kafka plugin has been updated to bring in new consumer features.
In addition, to the plugin being incompatible with 0.8.x version of Kafka broker, _most_ of the config options have
been changed to match the new consumer configurations from the Kafka Java consumer. Here's a list of important config options that have changed:
* `topic_id` is renamed to `topics` and accepts an array of topics to consume from.
* `zk_connect` has been dropped; you should use `bootstrap_servers`. There is no need for the consumer to go through ZooKeeper
* `consumer_id` is renamed to `client_id`
We recommend users of the Kafka plugin to check the documentation for the latest <<plugins-inputs-kafka, config options>>.
[float]
==== File Input