Skip to content

Conversation

SageMoore
Copy link
Contributor

@SageMoore SageMoore commented Jul 18, 2025

Purpose

Note: the infrastructure in this PR is currently unused outside of unit tests.

The purpose of this PR is to add a "splitting" mechanism to the CommonAttentionMetadata class. This PR is a prerequisite for Dual Batch Overlap (#20448 ) support in vllm. Splitting, in this context, means slicing a batch of requests along some mid point and generating two new CommonAttentionMetadata instances. One for each "micro" batch.

Test Plan

I added a number of unit tests to test_attention_splitting.py. These tests are largely focused on decode-only batches for now since that's all Dual Batch Overlap will initially support, but this infrastructure should support prefills and mixed batches without any issue.

Signed-off-by: Sage Moore <[email protected]>
Signed-off-by: Sage Moore <[email protected]>
Signed-off-by: Sage Moore <[email protected]>
Signed-off-by: Sage Moore <[email protected]>
Signed-off-by: Sage Moore <[email protected]>
Signed-off-by: Sage Moore <[email protected]>
Copy link

👋 Hi! Thank you for contributing to the vLLM project.

💬 Join our developer Slack at https://slack.vllm.ai to discuss your PR in #pr-reviews, coordinate on features in #feat- channels, or join special interest groups in #sig- channels.

Just a reminder: PRs would not trigger full CI run by default. Instead, it would only run fastcheck CI which starts running only a small and essential subset of CI tests to quickly catch errors. You can run other CI tests on top of those by going to your fastcheck build on Buildkite UI (linked in the PR checks section) and unblock them. If you do not have permission to unblock, ping simon-mo or khluu to add you in our Buildkite org.

Once the PR is approved and ready to go, your PR reviewer(s) can run CI to test the changes comprehensively before merging.

To run CI, PR reviewers can either: Add ready label to the PR or enable auto-merge.

🚀

@mergify mergify bot added the v1 label Jul 18, 2025
Signed-off-by: Sage Moore <[email protected]>
Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request introduces a mechanism to split CommonAttentionMetadata, which is a prerequisite for dual batch overlap. The changes are well-contained and include new unit tests. I've identified a critical issue where the code could crash due to an unhandled edge case when creating a metadata slice for zero requests. A fix is suggested to prevent this runtime error.

Signed-off-by: Sage Moore <[email protected]>
Signed-off-by: Sage Moore <[email protected]>
Signed-off-by: Sage Moore <[email protected]>
Signed-off-by: Sage Moore <[email protected]>
@SageMoore SageMoore marked this pull request as ready for review July 18, 2025 16:08
Copy link
Collaborator

@LucasWilkinson LucasWilkinson left a comment

Choose a reason for hiding this comment

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

Overall looks good to me! Thanks for all the unit tests! Clean 🙂. Left a couple comments.

@SageMoore SageMoore changed the title [Attention] Add support for "splitting" the CommonAttentionMetadata [Attention][DBO] Add support for "splitting" the CommonAttentionMetadata Jul 21, 2025
Signed-off-by: Sage Moore <[email protected]>
Copy link
Collaborator

@LucasWilkinson LucasWilkinson left a comment

Choose a reason for hiding this comment

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

LGTM!

@LucasWilkinson LucasWilkinson enabled auto-merge (squash) July 24, 2025 18:27
@github-actions github-actions bot added the ready ONLY add when PR is ready to merge/full CI is needed label Jul 24, 2025
@DarkLight1337
Copy link
Member

Can you merge from main to see if the CI failures are fixed?

@vllm-bot vllm-bot merged commit 0edaf75 into vllm-project:main Aug 2, 2025
64 of 67 checks passed
npanpaliya pushed a commit to odh-on-pz/vllm-upstream that referenced this pull request Aug 6, 2025
jinzhen-lin pushed a commit to jinzhen-lin/vllm that referenced this pull request Aug 9, 2025
noamgat pushed a commit to noamgat/vllm that referenced this pull request Aug 9, 2025
paulpak58 pushed a commit to paulpak58/vllm that referenced this pull request Aug 13, 2025
diegocastanibm pushed a commit to diegocastanibm/vllm that referenced this pull request Aug 15, 2025
epwalsh pushed a commit to epwalsh/vllm that referenced this pull request Aug 28, 2025
zhewenl pushed a commit to zhewenl/vllm that referenced this pull request Aug 28, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ready ONLY add when PR is ready to merge/full CI is needed v1

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants