-
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
'sfetch
command is updated to call thisfold
API for better performance. - Add callbacks to allow
brod_client:stop_producer
andbrod_client:stop_consumer
to 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_consumer
in 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_consumer
orbrod_utils:fetch
jumps 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
badrecord
race: message-set is delivered tobrod_group_subscriber
after 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_assignment
data 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 inbrod
before 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/3
to return an updated cb_state brod_client:get_connection
is 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/5
andbrod_group_subscriber:commit/4
to 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_consumer
no longer restart onleader_not_availble
andnot_leader_for_partition
error codes received in fetch response. It resets connection and rediscover leader after delay.
- Add
-
3.6.2
- Allow
brod_topic_subscriber
to 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_vsn
inbrod:producer_config()
- Upgrade
kafka_protocol
to2.1.2
to support alpine/busybox build
- Make produce request version configurable as
-
3.6.0
- Moved 3 modules to kafka_protocol:
brod_sock
->kpro_connection
brod_auth_backed
->kpro_auth_backend
brod_kafka_requests
->kpro_sent_reqs
#kafka_message.key
and#kafka_message.value
are 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_client
no 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_coordinator
default session timeout changed from 10 seconds to 30, and heartbeat interval changed from 2 seconds to 5.- Add
brod:produce_cb/4
andbrod:produce_cb/6
to support user defined callback as produce ack handler. - Add
brod:produce_no_ack/3
andbrod:produce_no_ack/5
. min_compression_batch_size
is 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-256
andSCRAM-SHA-512
SASL 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_opts
client socket options. It would be helpful for tuning the performance of tcp socket.
- Add
-
3.5.0
- Add
*_offset
variants toproduce
APIs, 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' and
prefetch_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#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
Value
to be[{Ts, Key, Value}]
inbrod:produce
andbrod:produce_sync
APIs - Bind all
#kafka_message{}
fields to variables so they can be used in brod-clifetch
command's--fmt
expression
- 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
message
ormessage_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_cordinator
to estabilish a sockt towards group coordinator broker. - New API
brod:fetch_committed_offsets
to fetch consumer group commited offsets. - New API
brod:list_groups
,brod:list_all_groups
andbrod:describe_groups/3
. - Brod-cli new command
groups
to list / describe consumer groups. - Brod-cli new command
commits
to list comsuer group committed offsets.
- New API
- Backward-incompatible changes
brod:get_offsets
API replaced withbrod:resolve_offset
. Reason:brod:get_offsets
andbrod_utils:fetch_offsets
are 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_metadata
return value changed from#kpro_MetadataResponse{}
record tokpro:struct()
.brod_utils:fetch/4
is removed, usemake_fetch_fun/8
instead.--count
option removed frombrod-cli
offset
command, The command now resolves only one (or maybe none) offset at a time.- All type specs defined in
brod.hrl
are moved to exported types frombrod.erl
- Backward-compatible changes
#kafka_message{}
record is extended with new fieldsts_type
andts
.#kafka_message.crc
changed 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_client
state
-
2.4.1 Fixed brod-cli typo fix
-
2.4.0 Added brod-cli