Skip to content

[FLINK-38716][docs] Describe the impact of slot.request.max-interval on balanced tasks scheduling. #27270

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.

Sign up for GitHub

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

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
+20 −0
Open

[FLINK-38716][docs] Describe the impact of slot.request.max-interval on balanced tasks scheduling. #27270

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions docs/content.zh/docs/deployment/tasks-scheduling/balanced_tasks_scheduling.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -116,6 +116,16 @@ You can enable balanced tasks scheduling through the following configuration ite

- `taskmanager.load-balance.mode`: `tasks`

<span class="label label-info">Note</span> During failover scenarios,
when resources are released and resource requests are processed,
the delayed updates in the resource view may lead to allocation results that are not optimally balanced.
In such cases, you can improve the situation by appropriately increasing the value of
Copy link
Contributor

@davidradl davidradl Nov 25, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To make this clearer, I suggest:

  • being explicit as to what you mean by appropriately
  • being explicit as to what you mean by sub-optimal and what optimal would look like.
  • it would be helpful to describe why increasing slot.request.max-interval can help, and maybe what happens if it is too high.
  • Maybe give an example to illustrate the points you are making in the text.

[`slot.request.max-interval`]({{< ref "docs/deployment/config" >}}#slot-request-max-interval).
It must be emphasized that if suboptimal task balancing still occurs after the value of
option has been sufficiently increased, you may report it in
<a href="https://issues.apache.org/jira/browse/FLINK-38715">FLINK-38715</a>,
which should include descriptions of scheduling-related configurations and the observed phenomena.

## More details

See the <a href="https://cwiki.apache.org/confluence/x/U56zDw">FLIP-370</a> for more details.
Expand Down
10 changes: 10 additions & 0 deletions docs/content/docs/deployment/tasks-scheduling/balanced_tasks_scheduling.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -116,6 +116,16 @@ You can enable balanced tasks scheduling through the following configuration ite

- `taskmanager.load-balance.mode`: `tasks`

<span class="label label-info">Note</span> During failover scenarios,
when resources are released and resource requests are processed,
the delayed updates in the resource view may lead to allocation results that are not optimally balanced.
In such cases, you can improve the situation by appropriately increasing the value of
[`slot.request.max-interval`]({{< ref "docs/deployment/config" >}}#slot-request-max-interval).
It must be emphasized that if suboptimal task balancing still occurs after the value of
option has been sufficiently increased, you may report it in
<a href="https://issues.apache.org/jira/browse/FLINK-38715">FLINK-38715</a>,
which should include descriptions of scheduling-related configurations and the observed phenomena.

## More details

See the <a href="https://cwiki.apache.org/confluence/x/U56zDw">FLIP-370</a> for more details.
Expand Down