-
TBD
- Use GitHub Actions instead of Travis CI
- Added Elixir example
- Rename DEFAULT_TIMEOUT macro in public brod.hrl to BROD_DEFAULT_TIMEOUT.
-
3.15.0
- Fix unknown types
- Build on OTP-23
-
3.14.0 NOTE: This release changes internal states of brod worker processes in a way that cannot by applied on a running system. brod application and all brod workers should be shot down for the time of the upgrade.
-
Introduced a new optional terminate/2 callback to brod_topic_subscriber and brod_group_subscriber_v2 behaviors
-
Introduced new API functions for starting topic subscribers: brod_topic_subscriber:start_link/1 and brod:start_link_topic_subscriber/1 Old APIs
- brod:start_link_topic_subscriber/5,
- brod:start_link_topic_subscriber/6
- brod:start_link_topic_subscriber/7
- brod_topic_subscriber:start_link/6
- brod_topic_subscriber:start_link/7
- brod_topic_subscriber:start_link/8 are deprecated and will be removed in the next major release
-
-
3.13.0
- Update supervisor3 dependency to 1.1.11
- brod_group_subscriber_v2 behavior handles worker crashes
- Makefile fix for hex publishing
- Reverse Changelog order
- Fix typos and dialyzer warnings
-
3.12.0
- Enable passing custom timeout to resolve_offset
-
3.11.0
- Improve compatibility with EventHub
-
3.10.0
- Stop supporting erlang.mk
- Stop supporting rebar
- Update kafka_protocol dependency to 2.3.6
- Add new brod_group_coordinator:update_topics API
-
3.9.5
- Bump kafka_protocol dependency to 2.3.3
-
3.9.4
- Handle undefined fetcher in fold loop exception
-
3.9.3
- Remove vsn-check dependency from default Makefile target This enables using brod with erlang.mk + hex
- Bump kafka_protocol dependency to 2.3.2
-
3.9.2
- Fix corrupted package published to hex
-
3.9.1
- Receive pending acks after assignments_revoked is invoked
-
3.9.0
- Updated kafka_protocol dependency to 2.3.1
- (Experimental) Added group_subscriber_v2 behavior
- Added API for topic deletion and creation
-
3.8.1
- Handle the case when high_watermark < last_stable_offset in fetch resp
-
3.8.0
- Bump to kafka_protocol 2.2.9 (allow
atom()hostname) - Add
brod:fold/8. This API spawns a process to fetch-ahead while folding the previously fetched batch.brod-cli'sfetchcommand is updated to call thisfoldAPI for better performance. - Add callbacks to allow
brod_client:stop_producerandbrod_client:stop_consumerto remove the stopped child references from the supervisor and clean up the client ets table to allow later restart. - Support scram SASL authentication in brod-cli
- Made possible to start-link or supervise
brod_consumerin user apps, instead of always underbrod_client'sbrod_consumers_sup
- Bump to kafka_protocol 2.2.9 (allow
-
3.7.11
- Fix a bug when dropping aborted transactions for compacted topics
-
3.7.10
- Compare begin_offset with last stable offset before advancing to next offset in case empty
batch is received. Prior to this version, fetch attempts on unstable messages (messages
belong to open transactions (transactions which are neigher committed nor aborted),
may result in an empty message set, then
brod_consumerorbrod_utils:fetchjumps to the next offset (if it is less than high-watermark offset).
- Compare begin_offset with last stable offset before advancing to next offset in case empty
batch is received. Prior to this version, fetch attempts on unstable messages (messages
belong to open transactions (transactions which are neigher committed nor aborted),
may result in an empty message set, then
-
3.7.9
- Fix brod-cli escript include apps
- Fix brod-cli sub-record formatting crash
- Upgrade to kafka_protocol 2.2.8 to discard replica_not_available error code in metadata response
- Fix empty responses field in fetch response #323
-
3.7.8
- Drop batches in aborted transactions (and all control batches) also improve offset fast-forwarding when empty batches are received
-
3.7.7
- Fix
badrecordrace: message-set is delivered tobrod_group_subscriberafter unsubscribed frombrod_consumer.
- Fix
-
3.7.6
- Fix produce message input type spec to make it backward compatible (bug introduced in 3.7.3)
-
3.7.5
- Bump kafka_protocol version to 2.2.7
- Fix empty assignment handling. In case a group member has no partition assigned,
member_assignmentdata field in group sync response can either benull(kafka 0.10) or a struct having emptytopic_partitions(kafka 0.11 or later). The later case was not handled properly inbrodbefore this fix.
-
3.7.4
- Add callback to make user_data in group join request
-
3.7.3
- Bump kafka_protocol version to 2.2.3
- Discard stale async-ack messages to group subscriber
-
3.7.2
- Pr #298: Subscriber now automatically reconnects to Kafka on topic rebalances where the previous partition leader no longer holds the partition at all.
- Pr #299: Fix topic subscriber returning partition offsets from callback module's init.
-
3.7.1
- Fix brod_topic_subscriber and brod_group_subscriber re-subscribe behaviour to avoid fetching duplicated messages.
- Add 'random' and 'hash' partitioner for produce APIs
- Allow
brod_group_subscrber:assign_partitions/3to return an updated cb_state brod_client:get_connectionis back- Make it possible to run tests on both mac and linux
- Position group leader member at the head of members list when assigning partitions
-
3.7.0
- Add
brod_group_subscriber:ack/5andbrod_group_subscriber:commit/4to let group subscribers commit offsets asynchronously - Pr #284: In compacted topics, Kafka may return a MessageSet which contains only messages before the desired offset. Just keep reading forward in this case.
- Issue #285
brod_consumerno longer restart onleader_not_availbleandnot_leader_for_partitionerror codes received in fetch response. It resets connection and rediscover leader after delay.
- Add
-
3.6.2
- Allow
brod_topic_subscriberto explicitly start consuming from partition offset 0 (by passing in a committed offset of -1).
- Allow
-
3.6.1
- Make produce request version configurable as
produce_req_vsninbrod:producer_config() - Upgrade
kafka_protocolto2.1.2to support alpine/busybox build
- Make produce request version configurable as
-
3.6.0
- Moved 3 modules to kafka_protocol:
brod_sock->kpro_connectionbrod_auth_backed->kpro_auth_backendbrod_kafka_requests->kpro_sent_reqs
#kafka_message.keyand#kafka_message.valueare now alwaysbinary()(they were of specundefined | binary()prior to this version). i.e. empty bytes are now decoded as<<>>instead ofundefined. This may cause dialyzer check failures.brod_clientno longer logs about metadata socket down, it had been confusing rather than being helpful- There is no more cool-down delay for metadata socket re-establishment
brod_group_coordinatordefault session timeout changed from 10 seconds to 30, and heartbeat interval changed from 2 seconds to 5.- Add
brod:produce_cb/4andbrod:produce_cb/6to support user defined callback as produce ack handler. - Add
brod:produce_no_ack/3andbrod:produce_no_ack/5. min_compression_batch_sizeis removed from producer config.- Support magic v2 batch/message format (message headers).
- Use rebar3 as primary build tool for travis-ci, erlang.mk is still supported.
- Support
SCRAM-SHA-256andSCRAM-SHA-512SASL authentication mechanisms.
- Moved 3 modules to kafka_protocol:
-
3.5.2
- Fix issue #263: Kafka 0.11 may send empty batch in fetch response when messages are deleted in compacted topics.
-
3.5.1
- Add
extra_sock_optsclient socket options. It would be helpful for tuning the performance of tcp socket.
- Add
-
3.5.0
- Add
*_offsetvariants toproduceAPIs, returning the base offsets that were assigned by Kafka. Producers need to be restarted when upgrading to this version.
- Add
-
3.4.0
- Add
prefetch_bytes' consumer config.brod_consumer' should stop fetch-ahead only when bothprefetch_count' andprefetch_bytes' limits are exceeded
- Add
-
3.3.5
- Fix issue #252 -- Kafka 0.11 and 1.0 have more strict validations on compressed batch wrapper message. Changed kafka_protocol 1.1.2 has the wrapper timestamp and offsets fixed.
-
3.3.4
- Fix issue #247 -- revert the handling of offset = -1 in offset_fetch_response, bug introduced in 3.3.0 offset = -1 in offset_fetch_response is an indicator of 'no commit' should be ignored (not taken as 'latest')
-
3.3.3
- Add a --no-api-vsn-query option for brod-cli to support kafka 0.9
- Bump kafka_protocol to 1.1.1 to fix relative offsets issue so brod-cli can fetch compressed batches as expected, also brod_consumer can start picking fetch request version
- Upgrade roundrobin group protocol to roundrobin_v2 to fix offset commit incompatiblility with kafka spec and monitoring tools etc. see kafka4beam/brod#241 for details
-
3.3.2
- Enhancements
- Add sh script to wrap brod-cli escript for erts dir auto discover
- Detailed log for connection estabilishment failures
- Bug Fixes
- Demonitor producer pid after sync_produce_request timeout
- Enhancements
-
3.3.1
- Fix brod-cli commits command redandunt socket usage.
-
3.3.0
- New Features
- Support offset_fetch_request version 1 - 2
- Provide APIs to reset committed offsets
- Support offset commit in brod-cli
- Improved group coordinator logging: 1) stop showing member ID, 2) show callback process.
- Cache queried version ranges per kafka host
- Brod-cli 'offset' command by default resolves offsets for all partitions if '--partition' option is 'all' or missing
- Enhancements
- Brod rock with elvis with travis
- Travis run dialyzer check
- Bug Fixes
- Fixed brod-cli offset_fetch_request version when working with kafka 0.10.1.x or earlier
- Make group coordinator restart on heartbeat timeout
- New Features
-
3.2.0
- New Features
- Support produce_request version 0 - 2
- Support fetch_request version 0 - 3
- Support offsets_request version 0 - 1
- Support metadata_request version 0 - 2
- Support message create time by allowing
Valueto be[{Ts, Key, Value}]inbrod:produceandbrod:produce_syncAPIs - Bind all
#kafka_message{}fields to variables so they can be used in brod-clifetchcommand's--fmtexpression
- Bug Fixes
- Remove sasl application from dependent app list
- New Features
-
3.1.0
- New Features
- New message type option for topic and group subscribers that specifies whether to
handle a Kafka
messageormessage_set.
- New message type option for topic and group subscribers that specifies whether to
handle a Kafka
- New Features
-
3.0.0
- New Features
- New API
brod:connect_group_cordinatorto estabilish a sockt towards group coordinator broker. - New API
brod:fetch_committed_offsetsto fetch consumer group commited offsets. - New API
brod:list_groups,brod:list_all_groupsandbrod:describe_groups/3. - Brod-cli new command
groupsto list / describe consumer groups. - Brod-cli new command
commitsto list comsuer group committed offsets.
- New API
- Backward-incompatible changes
brod:get_offsetsAPI replaced withbrod:resolve_offset. Reason:brod:get_offsetsandbrod_utils:fetch_offsetsare very confusing, because they look like fetching consumer group committed offsets. Also, the return value has been changed from a list of offsets to a single offset.brod:get_metadatareturn value changed from#kpro_MetadataResponse{}record tokpro:struct().brod_utils:fetch/4is removed, usemake_fetch_fun/8instead.--countoption removed frombrod-clioffsetcommand, The command now resolves only one (or maybe none) offset at a time.- All type specs defined in
brod.hrlare moved to exported types frombrod.erl
- Backward-compatible changes
#kafka_message{}record is extended with new fieldsts_typeandts.#kafka_message.crcchanged from signed to unsigned integer.
- New Features
-
2.5.1
- Fix ignored commit history when committed offset is 0 (bug)
-
2.5.0
- Pluggable SASL authentication backend (contributor: ElMaxo)
- Brod-cli support extra ebin to code path
- Fix group subscriber duplicated loopback messages (bug)
- SASL-PLAIN username password in text file
- Hide SASL-PLAIN password in an anonymous function in
brod_clientstate
-
2.4.1 Fixed brod-cli typo fix
-
2.4.0 Added brod-cli