2.3.0

This is a feature release.

Enhancements

• References librdkafka.redist 2.3.0. Refer to the librdkafka v2.3.0 release notes for more information.
• KIP-430:
  Return authorized operations in describe responses (#2021, @jainruchir).
• KIP-396: Added support for ListOffsets Admin API (#2086).
• Add Rack to the Node type, so AdminAPI calls can expose racks for brokers (currently, all Describe
  Responses) (#2021, @jainruchir).
• Added support for external JSON schemas in JsonSerializer and JsonDeserializer (#2042).
• Added compatibility methods to CachedSchemaRegistryClient (ISBronny, #2097).
• Add support for AdminAPI DescribeCluster() and DescribeTopics() (#2021, @jainruchir).

2.2.0

This is a feature release.

Enhancements

• References librdkafka.redist 2.2.0. Refer to the librdkafka v2.2.0 release notes for more information.
• KIP-339
  IncrementalAlterConfigs API (#2005).
• KIP-554:
  User SASL/SCRAM credentials alteration and description (#2070).

Fixes

• Fix backwards compatability of TopicPartitionOffset constructor. (drinehimer, #2066)
• Fix IConsumer breaking change. (ttd2089, #2071)

2.1.1

This is a maintenance release.

Enhancements

• References librdkafka.redist 2.1.1. Refer to the librdkafka v2.1.1 release notes for more information.
• Less heap allocations when calling Produce (bjornbouetsmith, #2020)

2.1.0

This is a feature release.

Enhancements

• References librdkafka.redist 2.1.0. Refer to the librdkafka v2.1.0 release notes and later ones for more information.
• Added SetSaslCredentials. This new method (on the Producer, Consumer, and AdminClient) allows modifying the stored
  SASL PLAIN/SCRAM credentials that will be used for subsequent (new) connections to a broker (#1980).
• Changed the way the _SCHEMA filed is accessed internally from reflecting the static field to accessing it from the instance (AlexeyRaga).
• KIP-320: add offset leader epoch fields to the TopicPartitionOffset,
  TopicPartitionOffsetError and ConsumeResult classes (#2027).

Fixes

• Fixed OverflowException thrown intermittently when using the ListGroup method (#2003).

2.0.2

Upgrade considerations

OpenSSL 3.0.x upgrade in librdkafka requires a major version bump, as some legacy ciphers need to be explicitly configured to continue working, but it is highly recommended NOT to use them. The rest of the API remains backward compatible.

Enhancements

• References librdkafka.redist 2.0.2. Refer to the librdkafka v2.0.0 release notes and later ones for more information.
• Upgraded NJsonSchema to v10.6.3
• Added LatestCompatibilityStrict configuration property to JsonSerializerConfig to check the compatibility with latest schema when UseLatestVersion is set to true.
• Added DeleteConsumerGroupOffset to AdminClient.
• KIP-222 Finish remaining implementation: Add Consumer Group operations to Admin API (DeleteGroups is already present).
• KIP-518 Allow listing consumer groups per state.
• KIP-396 Partially implemented: support for AlterConsumerGroupOffsets.
• As result of the above KIPs, added (#1981)
  • ListConsumerGroups Admin operation. Supports listing by state.
  • DescribeConsumerGroups Admin operation. Supports multiple groups.
  • ListConsumerGroupOffsets Admin operation. Currently, only supports
    1 group with multiple partitions. Supports the requireStable option.
  • AlterConsumerGroupOffsets Admin operation. Currently, only supports
    1 group with multiple offsets.

Fixes

• During a group rebalance, partitions are now always revoked as a side effect of a call to Consume, whether or not a partitions revoked handler has been specified. Previously, if no handler was specified, the timing of when the consumer lost ownership of partitions during a rebalance was arbitrarily, frequently resulting in an erroneous state exception when committing or storing offsets.
• Fixed 100% CPU usage with DependentAdminClientBuilder.

Note: There were no 2.0.0 and 2.0.1 releases.

1.9.3

Enhancements

• Added NormalizeSchemas configuration property to the Avro, Json and Protobuf serdes.

Fixes

• Schema Registry authentication now works with passwords that contain the ':' character (luismedel).
• Added missing librdkafka internal and broker error codes to the ErrorCode enum.

1.9.2

Enhancements

• References librdkafka.redist 1.9.2 which includes an Apple M1 librdkafka build.
• Added ACL AdminClient operations (CreateAcls, DescribeAcls, DeleteAcls) (emasab).
• Added DeleteGroups to AdminClient (3schwartz).
• Enhanced the Avro Specific Deserializer to ignore the type namespace (sergemat).
• Improved efficiency of the statistics handler (VladimirTyrin).

Fixes

• The AdminClient poll loop no longer terminates when a request results in an error (emasab).
• Upgraded Newtonsoft.Json to 13.0.1 to address a security vulnerability in 9.0.1.

v1.9.0

Enhancements

• References librdkafka.redist 1.9.0. Refer to the librdkafka release notes
  for a complete list of changes, enhancements, fixes and upgrade considerations.
• References Apache.Avro 1.11.0. Refer to the release notes for further information (JanReimerD).
• Added support for serializing and deserializing null in Avro serdes (YairHalberstadt).
• Enhanced CachedSchemaRegistryClient to allow for user-implemented authentication schemes (henrydaly).
• Reduced memory use when producing with delivery reports disabled (TrickyCat).

Fixes

• Resolved incompatibility with Apple M1 processors (dkaukov).
• No longer crashes on Alpine Linux when MUSL is installed (shurivich).
• JSON validation exception messages now properly include failing paths (drinehimer).
• Upgraded Google.Protobuf dependency to 3.15.0 (CVE-2021-22570).
• Resolved memory leak in AdminClient response handler (emasab).
• Resolved memory leak in Producer.SendOffsetsToTransaction.

Upgrade Considerations

• The earliest supported .NET Framework version is now 4.6.2, previously this was 4.5 (bjornbouetsmith).

v1.8.2

Enhancements and Fixes

• References librdkafka.redist 1.8.2. Refer to the librdkafka release notes for a complete list of changes, enhancements, fixes and upgrade considerations.
• Added the SslCaPem configuration property to specify a CA certificate using a PEM string.

v1.8.1

Enhancements

• Updated NJsonSchema to v10.5.2.