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