Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[improve][doc] Improve doc for maxTotalReceiverQueueSizeAcrossPartitions and receiverQueueSize of ConsumerBuilder #21841

Merged
merged 1 commit into from
Jan 9, 2024

Conversation

RobertIndie
Copy link
Member

@RobertIndie RobertIndie commented Jan 3, 2024

Fixes #21838

Motivation

From the implementation, the maximum number of messages actually cached by multi-topics consumer is approximately receiverQueueSize+maxTotalReceiverQueueSizeAcrossPartitions.This seems to go against the case described in the documentation.

Please see more details in #21838

Modifications

  • Improve the doc to clarify the correct behavior of maxTotalReceiverQueueSizeAcrossPartitions

Verifying this change

This change is a trivial rework / code cleanup without any test coverage.

Does this pull request potentially affect one of the following parts:

If the box was checked, please highlight the changes

  • Dependencies (add or upgrade a dependency)
  • The public API
  • The schema
  • The default values of configurations
  • The threading model
  • The binary protocol
  • The REST endpoints
  • The admin CLI options
  • The metrics
  • Anything that affects deployment

Documentation

  • doc
  • doc-required
  • doc-not-needed
  • doc-complete

Matching PR in forked repository

PR in forked repository:

…ions` and `receiverQueueSize` of ConsumerBuilder

Motivation

From the implementation, the maximum number of messages actually cached by multi-topics consumer is approximately receiverQueueSize+maxTotalReceiverQueueSizeAcrossPartitions.This seems to go against the case described in the documentation.

Modification
- Improve doc for `maxTotalReceiverQueueSizeAcrossPartitions` and `receiverQueueSize` of ConsumerBuilder
@RobertIndie RobertIndie added this to the 3.3.0 milestone Jan 3, 2024
@RobertIndie RobertIndie self-assigned this Jan 3, 2024
@github-actions github-actions bot added the doc Your PR contains doc changes, no matter whether the changes are in markdown or code files. label Jan 3, 2024
@codecov-commenter
Copy link

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (b944f10) 73.37% compared to head (b6e4ba5) 73.58%.
Report is 33 commits behind head on master.

Additional details and impacted files

Impacted file tree graph

@@             Coverage Diff              @@
##             master   #21841      +/-   ##
============================================
+ Coverage     73.37%   73.58%   +0.20%     
+ Complexity    32772    32309     -463     
============================================
  Files          1897     1858      -39     
  Lines        140647   138146    -2501     
  Branches      15489    15141     -348     
============================================
- Hits         103206   101659    -1547     
+ Misses        29363    28626     -737     
+ Partials       8078     7861     -217     
Flag Coverage Δ
inttests 24.19% <ø> (+0.03%) ⬆️
systests 23.74% <ø> (-0.91%) ⬇️
unittests 72.86% <ø> (+0.18%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

see 151 files with indirect coverage changes

@RobertIndie RobertIndie merged commit 6560a21 into apache:master Jan 9, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
doc Your PR contains doc changes, no matter whether the changes are in markdown or code files.
Projects
None yet
4 participants