README.md in logstash-input-kafka-5.1.11 vs README.md in logstash-input-kafka-6.0.0

- old
+ new

@@ -4,17 +4,19 @@ This is a plugin for [Logstash](https://github.com/elastic/logstash). It is fully free and fully open source. The license is Apache 2.0, meaning you are pretty much free to use it however you want in whatever way. -## Logging +## Kafka Compatibility -Kafka logs do not respect the Log4J2 root logger level and defaults to INFO, for other levels, you must explicitly set the log level in your Logstash deployment's `log4j2.properties` file, e.g.: -``` -logger.kafka.name=org.apache.kafka -logger.kafka.appenderRef.console.ref=console -logger.kafka.level=debug -``` +Here's a table that describes the compatibility matrix for Kafka Broker support. Please remember that it is good advice to upgrade brokers before consumers/producers since brokers target backwards compatibility. The 0.9 broker will work with both the 0.8 consumer and 0.9 consumer APIs but not the other way around. + +| Kafka Broker Version | Logstash Version | Input Plugin | Output Plugin | Why? | +|:---------------:|:------------------:|:--------------:|:---------------:|:------| +| 0.8 | 2.0 - 2.x | < 3.0.0 | <3.0.0 | Legacy, 0.8 is still popular | +| 0.9 | 2.0 - 2.3.x | 3.0.0 | 3.0.0 | Intermediate release before 0.10 that works with old Ruby Event API `[]` | +| 0.9 | 2.4, 5.0 | 4.0.0 | 4.0.0 | Intermediate release before 0.10 with new get/set API | +| 0.10 | 2.4, 5.0 | 5.0.0 | 5.0.0 | Track latest Kafka release. Not compatible with 0.9 broker | ## Documentation https://www.elastic.co/guide/en/logstash/current/plugins-inputs-kafka.html