Skip to content

[None][chore] Fix MAX_UTILIZATION reuse token budget on main#15066

Draft
brb-nv wants to merge 2 commits into
NVIDIA:mainfrom
brb-nv:user/brb/fix-maxutil-reuse-token-budget-main
Draft

[None][chore] Fix MAX_UTILIZATION reuse token budget on main#15066
brb-nv wants to merge 2 commits into
NVIDIA:mainfrom
brb-nv:user/brb/fix-maxutil-reuse-token-budget-main

Conversation

@brb-nv
Copy link
Copy Markdown
Collaborator

@brb-nv brb-nv commented Jun 7, 2026

Description

getNeededBlocksOneStep (MAX_UTILIZATION) derived estimatedReusableTokens from reusableBlocksAllocated (active-ref blocks only), the same conservative count correctly used for the block/capacity budget since #11731. In steady state, prefixes from completed requests are free-but-cached (no refs), so reusableBlocksAllocated drops to ~0 while reusableBlocksAll stays large. The micro batch scheduler then under-credits reuse, FCFS charges full context chunks, one request saturates max_num_tokens, and context requests serialize to ~1/iter -- inflating TTFT at high concurrency.

Decouple the two budgets in getNeededBlocksOneStep:

Test Coverage

TEST(KVCacheManagerReuseAccountingTest, NeededBlocksOneStepCreditsFreeCachedReuseInTokenBudget)

PR Checklist

Please review the following before submitting your PR:

  • PR description clearly explains what and why. If using CodeRabbit's summary, please make sure it makes sense.

  • PR Follows TRT-LLM CODING GUIDELINES to the best of your knowledge.

  • Test cases are provided for new code paths (see test instructions)

  • If PR introduces API changes, an appropriate PR label is added - either api-compatible or api-breaking. For api-breaking, include BREAKING in the PR title.

  • Any new dependencies have been scanned for license and vulnerabilities

  • CODEOWNERS updated if ownership changes

  • Documentation updated as needed

  • Update tava architecture diagram if there is a significant design change in PR.

  • The reviewers assigned automatically/manually are appropriate for the PR.

  • Please check this after reviewing the above items as appropriate for this PR.

GitHub Bot Help

To see a list of available CI bot commands, please comment /bot help.

brb-nv added 2 commits June 7, 2026 15:37
getNeededBlocksOneStep (MAX_UTILIZATION) derived estimatedReusableTokens
from reusableBlocksAllocated (active-ref blocks only), the same conservative
count correctly used for the block/capacity budget since NVIDIA#11731. In steady
state, prefixes from completed requests are free-but-cached (no refs), so
reusableBlocksAllocated drops to ~0 while reusableBlocksAll stays large. The
micro batch scheduler then under-credits reuse, FCFS charges full context
chunks, one request saturates max_num_tokens, and context requests serialize
to ~1/iter -- inflating TTFT at high concurrency.

Decouple the two budgets in getNeededBlocksOneStep:
- Block/capacity budget keeps reusableBlocksAllocated (avoids the NVIDIA#11731
  double-count / over-admission).
- Token/compute budget now uses reusableBlocksAll, since cached KV is
  recovered via prepopulatedPromptLen regardless of ref state.

This mirrors the accounting getRemainingBlocksToCompletion already uses for
GUARANTEED_NO_EVICT, removing the discrepancy between the two policies.

Signed-off-by: Balaram Buddharaju <169953907+brb-nv@users.noreply.github.com>
(cherry picked from commit 8d1df0d)
Add a regression test for getNeededBlocksOneStep showing that a free-but-cached
shared prefix (reusableBlocksAllocated == 0, reusableBlocksAll > 0) now credits
estimatedReusableTokens from reusableBlocksAll, while the block/capacity budget
still credits only allocated reuse.

The test models the FCFS micro-batch scheduler's compute-aware admission for a
fixed token budget: with the conservative (allocated-only) estimate only one
context request fits; with the all-cached estimate four fit. It fails before the
fix (estimatedReusableTokens == 0) and passes after.

Signed-off-by: Balaram Buddharaju <169953907+brb-nv@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant