Skip to content

[https://nvbugs/6501404][fix] Request the output window only when bufferSizeBytes >= minRegistrationThreshold - #16911

Open
trtllm-agent wants to merge 6 commits into
NVIDIA:mainfrom
tensorrt-cicd:repair-bot-bug6501404
Open

trtllm-agent wants to merge 6 commits into
NVIDIA:mainfrom
tensorrt-cicd:repair-bot-bug6501404

Conversation

@trtllm-agent

@trtllm-agent trtllm-agent commented Jul 27, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

This PR updates the NCCL symmetric allreduce path so the output tensor no longer unconditionally requests a window-backed allocation.

Previously, runNCCLAllReduceSymmetric() applied the registration threshold when deciding whether to copy the input into a new window, but always called createNCCLWindowTensor() for the output. Small messages could skip that input allocation while still entering the output window allocation/registration path. Window allocation is a collective, so taking that path on some ranks and not others is the failure mode this change avoids.

The new behavior requests a window-backed output tensor only when:

  • bufferSizeBytes >= minRegistrationThreshold

If no valid output window is obtained, the existing torch::empty_like(...) fallback is used. The threshold still honors TLLM_NCCL_MIN_REGISTRATION.

This is not the same predicate as the input path. The input can already be window-backed for a sub-threshold message: searchBuffer() returns a valid windowBuffer0 when the caller reused a previously registered tensor, and that pointer is used as sendbuf regardless of size. The output gate does not include windowBuffer0.isValid(). In that case ncclAllReduce sees a registered send buffer and a plain recv buffer. All ranks still take the same branches when SPMD inputs match, so this is a send/recv mix on the symmetric kernel (possible degrade / fallback), not an unpaired createNCCLWindowTensor hang.

Test coverage

  • Marked test_row_linear_norm_fusion as post_merge.
  • Added the H100 2-GPU post-merge test-list entry:
    • unittest/_torch/multi_gpu -m "post_merge" TIMEOUT (90)
  • Removed the stale waiver for:
    • unittest/_torch/multi_gpu/test_linear.py::test_row_linear_norm_fusion[2-hidden:16-seqlen:2]

Test plan

  • Run the H100 2-GPU post-merge multi-GPU unittest stage, including test_row_linear_norm_fusion[2-hidden:16-seqlen:2].
  • Confirm sub-threshold messages no longer call createNCCLWindowTensor for the output.
  • Check for regressions in the NCCL symmetric allreduce path.

Links

Dev Engineer Review

  • Updated runNCCLAllReduceSymmetric to request the output window only when bufferSizeBytes >= minRegistrationThreshold. This is intentionally size-only and does not mirror the input's windowBuffer0.isValid() reuse path.
  • Preserved the torch::empty_like fallback when symmetric-memory allocation is unavailable.
  • Passed outputTensor.data_ptr() directly to ncclAllReduce.
  • Preserved the supported fast path and TLLM_NCCL_MIN_REGISTRATION behavior.
  • Removed the waiver for unittest/_torch/multi_gpu/test_linear.py::test_row_linear_norm_fusion[2-hidden:16-seqlen:2].
  • No public API or configuration changes.

QA Engineer Review

  • Removed one entry from tests/integration/test_lists/waives.txt.
  • The affected regression test is no longer skipped by this waiver.
  • CBTS coverage data is unavailable.
  • Verdict: needs follow-up.

@coderabbitai

coderabbitai Bot commented Jul 27, 2026 •

Copy link
Copy Markdown
Contributor

Review Change Stack

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review

No actionable comments were generated in the recent review.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: b30ff5f3-48d9-45eb-817d-57bfb027f5bb

📥 Commits

Reviewing files that changed from the base of the PR and between 5ac2c94 and 9b71341.

📒 Files selected for processing (2)
  • cpp/tensorrt_llm/thop/allreduceOp.cpp
  • tests/integration/test_lists/waives.txt
🚧 Files skipped from review as they are similar to previous changes (2)
  • tests/integration/test_lists/waives.txt
  • cpp/tensorrt_llm/thop/allreduceOp.cpp

Walkthrough

runNCCLAllReduceSymmetric conditionally allocates a window-backed output tensor, falls back to a CUDA tensor when required, and passes the selected tensor to ncclAllReduce. A related integration-test waiver is removed.

Changes

Symmetric all-reduce output handling

Layer / File(s) Summary
Conditional output buffer allocation
cpp/tensorrt_llm/thop/allreduceOp.cpp, tests/integration/test_lists/waives.txt
Output window creation is gated by input-buffer validity or the registration threshold. Invalid or skipped allocation uses torch::empty_like(inputTensor). ncclAllReduce receives the selected tensor’s data pointer. The related test waiver is removed.

Estimated code review effort: 2 (Simple) | ~10 minutes

Suggested reviewers: crazydemo, niukuo, mzweilz, zongfeijing

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Title check ✅ Passed The title clearly identifies the bug fix and the main change: gating output-window requests by buffer size. It follows the repository’s NVBugs and fix-title format.
Description check ✅ Passed The description clearly explains the issue, solution, behavior for sub-threshold messages, fallback behavior, test coverage, and test plan. The repository checklist is not reproduced, but the core req…
Full details: Description check

Explanation

The description clearly explains the issue, solution, behavior for sub-threshold messages, fallback behavior, test coverage, and test plan. The repository checklist is not reproduced, but the core required information is complete.

✨ Finishing Touches: 💡 1
⚔️ Resolve merge conflicts: 💡
  • Resolve merge conflict in branch repair-bot-bug6501404
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🧹 Nitpick comments (1)
cpp/tensorrt_llm/thop/allreduceOp.cpp (1)

564-569: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Make the window allocation result const.

windowOutput and windowBuffer1 are never reassigned.

Proposed fix
-            auto [windowOutput, windowBuffer1] = createNCCLWindowTensor(rawComm, input.sizes(), input.scalar_type());
+            auto const [windowOutput, windowBuffer1]
+                = createNCCLWindowTensor(rawComm, input.sizes(), input.scalar_type());

As per coding guidelines, “declare unmodified variables const.”

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@cpp/tensorrt_llm/thop/allreduceOp.cpp` around lines 564 - 569, Declare the
structured-binding variables windowOutput and windowBuffer1 as const in the
createNCCLWindowTensor result within the surrounding allreduce operation,
preserving the existing validity check and outputTensor assignment.

Source: Coding guidelines

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In `@cpp/tensorrt_llm/thop/allreduceOp.cpp`:
- Around line 564-569: Declare the structured-binding variables windowOutput and
windowBuffer1 as const in the createNCCLWindowTensor result within the
surrounding allreduce operation, preserving the existing validity check and
outputTensor assignment.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: 99f0fbf3-1e74-44af-92b9-b0dbc4a1acd8

📥 Commits

Reviewing files that changed from the base of the PR and between 9fe5853 and f74413d.

📒 Files selected for processing (1)
  • cpp/tensorrt_llm/thop/allreduceOp.cpp

@brnguyen2 brnguyen2 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Making the output allocation follow the same gate as the input is the right consistency fix regardless of the bug — with a 64-byte tensor and a ~290 KB threshold at 2 ranks, the old code skipped registration for the input and then ran a full collective allocateAndRegisterBuffer for the output, which is both inconsistent and wasteful.

What I don't follow is the causal story. The failure in nvbugs/6501404 was on 2×H100, where NVLink is present, so minRegistrationThreshold is never SIZE_MAX on that path and the mechanism the new comment describes never fires there. allocateAndRegisterBuffer is also written specifically so every rank reaches the min-allreduce even when ncclMemAlloc fails asymmetrically. So this change plausibly removes a collective from the hot path, but it isn't shown to remove the one that hung — and the linked bug records that the failure could not be reproduced.

So I'd land the gating change on its own merits and keep the waiver until there's evidence the hang is actually gone. A concrete way to get that evidence without holding up this PR: open a separate draft PR that (a) removes the waiver, (b) adds instrumentation around the symmetric allreduce path (log per-rank windowBuffer0.isValid(), bufferSizeBytes, minRegistrationThreshold, and entry/exit of allocateAndRegisterBuffer), and (c) runs only the failing stage with the test list trimmed to test_row_linear_norm_fusion (and neighbors if needed) so repeated runs are cheap on capacity and turnaround. Re-run that until the hang reproduces; the instrumentation then tells you which rank diverged and why. Once you have a pre-fix hang and a post-fix pass on the same stage, dropping the waiver here is easy to justify.

Comment thread cpp/tensorrt_llm/thop/allreduceOp.cpp Outdated
// ncclAllReduce plus cudaStreamSynchronize inside allocateAndRegisterBuffer cannot
// complete, so allocating here unconditionally hangs every rank.
torch::Tensor outputTensor;
if (windowBuffer0.isValid() || bufferSizeBytes >= minRegistrationThreshold)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

This if guards a collective. createNCCLWindowTensor → requestBuffer → allocateAndRegisterBuffer does an ncclAllReduce on the sync flag plus ncclCommWindowRegister, so every rank has to make the same decision here or the ones that enter will wait forever for the ones that didn't.

Of the two operands, only one is safe in that role. bufferSizeBytes >= minRegistrationThreshold is computed from the same inputs on every rank, so it's uniform. windowBuffer0.isValid() is not: it comes from allocator.searchBuffer(comm, input.data_ptr()) or from a pool best-fit inside requestBuffer, both of which depend on rank-local allocator state. If the input ends up registered on rank 0 but not on rank 1 while the size is below the threshold, rank 0 calls the collective and rank 1 skips it — a hang that the old unconditional call could not produce.

If the intent is "the input is window-backed, so the output should be too", either gate on the rank-uniform condition alone, or add a comment explaining why windowBuffer0.isValid() is guaranteed to agree across ranks.

Comment thread cpp/tensorrt_llm/thop/allreduceOp.cpp Outdated
void* outputPtr = windowBuffer1.isValid() ? windowBuffer1.ptr : outputTensor.data_ptr();
if (!windowBuffer1.isValid())
// Use a window-backed output buffer under the same threshold gate as the input above.
// minRegistrationThreshold is SIZE_MAX without NVLink/MNNVL, where the collective

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

The comment explains the fix with a mechanism that can't apply to the reported failure. It says minRegistrationThreshold is SIZE_MAX without NVLink/MNNVL and that the collective inside allocateAndRegisterBuffer therefore can't complete — but the bug reproduced on 2×H100, which has NVLink, so that branch was never taken. allocateAndRegisterBuffer is also written so that all ranks reach the min-allreduce even when ncclMemAlloc fails on only some of them.

Suggest describing what the change actually does instead of asserting an unproven hang cause, e.g.: "Allocate an output window only when the input path also registered a window. This keeps window use all-or-nothing and lets small messages skip the registration collective entirely."

Comment thread tests/integration/test_lists/waives.txt Outdated
@@ -351,7 +351,6 @@ unittest/_torch/modules/moe/test_moe_backend.py::test_moe_backend[act=Relu2-e60_
unittest/_torch/modules/moe/test_moe_module.py::test_configurable_moe_single_gpu -k "TRTLLM" SKIP (https://nvbugs/6464169)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

The bug this waiver points at was never reproduced, and the fix above doesn't clearly explain the observed hang on 2×H100. Un-waiving here risks the pre-merge job going intermittently red again with no new information.

I'd keep the waiver until there's a run that hangs without this patch and passes with it. To get there cheaply: put the un-waive plus instrumentation of the symmetric allreduce path (per-rank windowBuffer0.isValid(), bufferSizeBytes, minRegistrationThreshold, entry/exit of allocateAndRegisterBuffer) in a throwaway draft PR, trim the test list for the failing stage down to this test, and run that stage repeatedly until it hangs. That keeps the capacity cost and turnaround per attempt low, and the logs will show which rank diverged. Then drop the waiver here with the before/after runs linked.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

@brnguyen2 is it okay to merge the PR first. If the hang issue still exists, we can re-open the bug.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Fair — the later commit marking the test post_merge changes my objection. With it out of the blocking pre-merge glob, un-waiving no longer risks turning pre-merge intermittently red, which was the whole basis for keeping the waiver. Merge it.

Two asks so this doesn't just go quiet: keep the bug open until a post-merge run on the 2-GPU H100 stage has actually exercised the un-waived test, and treat that stage as the signal rather than the pre-merge result on this PR. If it hangs again there, the reproduction data from that run is what we lacked the first time.

@kris1025

Copy link
Copy Markdown
Collaborator

/bot run

@kris1025
kris1025 requested a review from a team as a code owner August 10, 2026 05:07
@kris1025
kris1025 requested a review from crazydemo August 10, 2026 05:07
@coderabbitai

coderabbitai Bot commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Note

GitHub couldn't provide a complete incremental comparison for this pull request, so CodeRabbit is performing a full review instead. This review may take a little longer.

@kris1025

Copy link
Copy Markdown
Collaborator

/bot kill

@kris1025

Copy link
Copy Markdown
Collaborator

/bot run

@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #64957 [ run ] triggered by Bot. Commit: 28a72c6 Link to invocation

@kris1025 kris1025 self-assigned this Aug 10, 2026
@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #64957 [ run ] completed with state FAILURE. Commit: 28a72c6
/LLM/main/L0_MergeRequest_PR pipeline #52792 completed with status: 'FAILURE'

CI Report

⚠️ Action Required:

  • Please check the failed tests and fix your PR
  • If you cannot view the failures, ask the CI triggerer to share details
  • Once fixed, request an NVIDIA team member to trigger CI again

CI Agent Failure Analysis

Link to invocation

@kris1025

Copy link
Copy Markdown
Collaborator

/bot run

@trtllm-agent

This comment has been minimized.

@coderabbitai

This comment has been minimized.

@trtllm-agent

This comment has been minimized.

@coderabbitai

This comment has been minimized.

@trtllm-agent

This comment has been minimized.

@coderabbitai

This comment has been minimized.

@trtllm-agent

This comment has been minimized.

@coderabbitai

This comment has been minimized.

@trtllm-agent

This comment has been minimized.

@coderabbitai

This comment has been minimized.

@trtllm-agent

This comment has been minimized.

@coderabbitai

This comment has been minimized.

@trtllm-agent

This comment has been minimized.

@coderabbitai

This comment has been minimized.

@github-actions

github-actions Bot commented Oct 2, 2026 •

Copy link
Copy Markdown

Semantic conflict review

The verdict of record is the Semantic conflict with target branch / PR #16911 commit status on the requested head commit. This summary updates on reply events and may lag between a new request and its reply.

Latest recorded state: Review completed: inconclusive for head a7161f44554a218ccaab9c3de48480cf3082a25a, target a81da8a5a8380c4ec8c2d3eafabb8cfc55d7ad56, merge base 879603afff3efe7be78eb9f8d299df902d51f8ee (request b51955e4-8069-47b5-971d-1e179c5d7946). CodeRabbit analysis.

Best-effort AI judgment for the recorded revisions. PASS, FAIL and INCONCLUSIVE may be incomplete or incorrect. PR authors and reviewers should independently verify the evidence and relevant behavior. This semantic review and its status/workflow are advisory, not required merge checks under current repository rules; other merge requirements still apply. Advisory status does not make a confirmed defect safe to ignore.

Requested (UTC) Head Target Verdict Comment
2026-10-02T08:48:34Z a7161f44554a a81da8a5a838 INCONCLUSIVE reply
2026-10-02T01:18:16Z a7161f44554a 80f1809362f1 INCONCLUSIVE reply
2026-10-01T16:41:07Z a7161f44554a de1d696889ae INCONCLUSIVE reply
2026-10-01T10:43:29Z a7161f44554a d6ebc4dc07aa INCONCLUSIVE reply
2026-10-01T02:58:49Z a7161f44554a 534e1f8ad9d5 INCONCLUSIVE reply
2026-09-30T20:44:55Z a7161f44554a 6ae42bb89253 INCONCLUSIVE reply
2026-09-30T13:00:15Z a7161f44554a 84de36ed03b2 INCONCLUSIVE reply
2026-09-30T06:59:58Z a7161f44554a 7fe1dd2ba608 INCONCLUSIVE reply
2026-09-29T22:50:32Z a7161f44554a affd82461714 INCONCLUSIVE reply
2026-09-29T14:45:58Z a7161f44554a ae3531adf3ed INCONCLUSIVE reply
2026-09-29T08:49:47Z a7161f44554a af131fc340c6 INCONCLUSIVE reply
2026-09-29T01:19:19Z a7161f44554a 5054e82a6d0b INCONCLUSIVE reply
2026-09-28T18:48:39Z a7161f44554a 336c4337a0a4 INCONCLUSIVE reply
2026-09-28T10:41:10Z a7161f44554a cc608b774ae9 FAIL reply

Processed request and reply comments are minimized to reduce timeline noise; they remain expandable for audit.

@trtllm-agent

This comment has been minimized.

@coderabbitai

This comment has been minimized.

@BowenFu

BowenFu commented Oct 22, 2026

Copy link
Copy Markdown
Contributor

Bug engineer ownership

@kris1025, as the engineer assigned to the linked bug, you are responsible for driving this bot PR to resolution. Please coordinate review, address feedback and required code changes, get CI passing, and verify the original failure before driving it to merge. If the PR is obsolete or superseded, close it with a reason. Keep this PR updated with blockers and the next step.

@trtllm-agent
trtllm-agent force-pushed the repair-bot-bug6501404 branch 3 times, most recently from dfca738 to 42aa8ad Compare October 26, 2026 12:03
HandongLi-01 and others added 6 commits October 26, 2026 21:19
…ration threshold

runNCCLAllReduceSymmetric allocated its window-backed output buffer with an
unconditional createNCCLWindowTensor, bypassing the minRegistrationThreshold
gate that the input path a few lines above already applies. That threshold is
set to SIZE_MAX when neither NVLink nor MNNVL is supported, so on such
topologies the collective ncclAllReduce plus cudaStreamSynchronize inside
allocateAndRegisterBuffer never completes and every rank hangs, which the CI
stage reports as "Test terminated unexpectedly".

Apply the same gate to the output allocation: request a window buffer only when
the input already obtained one or the message is at least as large as the
threshold. Gating on the threshold rather than on mIsNVLINKSupported /
mIsMNNVLSupported keeps the symmetric-memory fast path enabled wherever it
works and still honors TLLM_NCCL_MIN_REGISTRATION. The pre-existing
invalid-buffer fallback to torch::empty_like covers the skipped case, so no new
error path is introduced.

Signed-off-by: handongl <handongl@nvidia.com>
test_row_linear_norm_fusion needs 2 GPUs and has been flaky under
nvbugs/6501404. Mark it @pytest.mark.post_merge so it is dropped from the
blocking pre_merge 2-GPU glob (unittest/_torch/multi_gpu -m "not
post_merge") on l0_dgx_h100, and add a matching 2-GPU post_merge condition
block that collects it via -m "post_merge" so coverage is retained in the
non-blocking post_merge stage.

Signed-off-by: linquanh <linquanh@nvidia.com>
Signed-off-by: linquanh <linquanh@nvidia.com>
Signed-off-by: linquanh <linquanh@nvidia.com>
Signed-off-by: handongl <handongl@nvidia.com>

[nvbugs/6501404][chore] Sort ray_orchestrator waive entry

The file-contents-sorter pre-commit hook requires waives.txt to be
byte-sorted. The newly added ray_orchestrator waive was placed after the
sampler entry; reorder it before to satisfy the hook.

Signed-off-by: linquanh <linquanh@nvidia.com>
…RMS_NORM release

Rebasing onto main brings in the RMS_NORM release of the internal output
window in runNCCLAllReduceSymmetric (NVIDIA#20232), which reads windowBuffer1
after the fused fallback. The threshold-gated output allocation declared
windowBuffer1 inside the gate, so that read was out of scope.

Declare windowBuffer1 at function scope. It stays invalid unless the gate
allocates a valid window, which is exactly when outputTensor is
window-backed and must be released, so the release keeps its meaning.

Signed-off-by: trtllm-agent <296075020+trtllm-agent@users.noreply.github.com>
@trtllm-agent
trtllm-agent force-pushed the repair-bot-bug6501404 branch from 42aa8ad to baeb776 Compare October 27, 2026 04:23

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.