Skip to content

[#9847][fix] AutoDeploy: Added option to skip first layer of allreduce+rmsnorm fusion to avoid a hang - #10084

Closed
MrGeva wants to merge 4 commits into
NVIDIA:mainfrom
nv-auto-deploy:egeva/skip_first_layer_fusion
Closed

MrGeva wants to merge 4 commits into
NVIDIA:mainfrom
nv-auto-deploy:egeva/skip_first_layer_fusion

Conversation

@MrGeva

@MrGeva MrGeva commented Dec 17, 2025 •

Copy link
Copy Markdown
Collaborator

Added an option to skip the first rms+alreduce in the graph to avoid a hang with tp>1. This is a WAR.

Summary by CodeRabbit

  • New Features

    • Added a configuration option to control fusion behavior for allreduce and normalization operations, allowing users to customize optimization strategies during model compilation.
  • Bug Fixes

    • Improved handling of a known issue that could cause hangs during certain optimization scenarios.

✏️ Tip: You can customize this high-level summary in your review settings.

Description

Test Coverage

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)

  • 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

/bot [-h] ['run', 'kill', 'skip', 'reuse-pipeline'] ...

Provide a user friendly way for developers to interact with a Jenkins server.

Run /bot [-h|--help] to print this help message.

See details below for each supported subcommand.

Details

run [--reuse-test (optional)pipeline-id --disable-fail-fast --skip-test --stage-list "A10-PyTorch-1, xxx" --gpu-type "A30, H100_PCIe" --test-backend "pytorch, cpp" --add-multi-gpu-test --only-multi-gpu-test --disable-multi-gpu-test --post-merge --extra-stage "H100_PCIe-TensorRT-Post-Merge-1, xxx" --detailed-log --debug(experimental)]

Launch build/test pipelines. All previously running jobs will be killed.

--reuse-test (optional)pipeline-id (OPTIONAL) : Allow the new pipeline to reuse build artifacts and skip successful test stages from a specified pipeline or the last pipeline if no pipeline-id is indicated. If the Git commit ID has changed, this option will be always ignored. The DEFAULT behavior of the bot is to reuse build artifacts and successful test results from the last pipeline.

--disable-reuse-test (OPTIONAL) : Explicitly prevent the pipeline from reusing build artifacts and skipping successful test stages from a previous pipeline. Ensure that all builds and tests are run regardless of previous successes.

--disable-fail-fast (OPTIONAL) : Disable fail fast on build/tests/infra failures.

--skip-test (OPTIONAL) : Skip all test stages, but still run build stages, package stages and sanity check stages. Note: Does NOT update GitHub check status.

--stage-list "A10-PyTorch-1, xxx" (OPTIONAL) : Only run the specified test stages. Examples: "A10-PyTorch-1, xxx". Note: Does NOT update GitHub check status.

--gpu-type "A30, H100_PCIe" (OPTIONAL) : Only run the test stages on the specified GPU types. Examples: "A30, H100_PCIe". Note: Does NOT update GitHub check status.

--test-backend "pytorch, cpp" (OPTIONAL) : Skip test stages which don't match the specified backends. Only support [pytorch, cpp, tensorrt, triton]. Examples: "pytorch, cpp" (does not run test stages with tensorrt or triton backend). Note: Does NOT update GitHub pipeline status.

--only-multi-gpu-test (OPTIONAL) : Only run the multi-GPU tests. Note: Does NOT update GitHub check status.

--disable-multi-gpu-test (OPTIONAL) : Disable the multi-GPU tests. Note: Does NOT update GitHub check status.

--add-multi-gpu-test (OPTIONAL) : Force run the multi-GPU tests in addition to running L0 pre-merge pipeline.

--post-merge (OPTIONAL) : Run the L0 post-merge pipeline instead of the ordinary L0 pre-merge pipeline.

--extra-stage "H100_PCIe-TensorRT-Post-Merge-1, xxx" (OPTIONAL) : Run the ordinary L0 pre-merge pipeline and specified test stages. Examples: --extra-stage "H100_PCIe-TensorRT-Post-Merge-1, xxx".

--detailed-log (OPTIONAL) : Enable flushing out all logs to the Jenkins console. This will significantly increase the log volume and may slow down the job.

--debug (OPTIONAL) : Experimental feature. Enable access to the CI container for debugging purpose. Note: Specify exactly one stage in the stage-list parameter to access the appropriate container environment. Note: Does NOT update GitHub check status.

For guidance on mapping tests to stage names, see docs/source/reference/ci-overview.md
and the scripts/test_to_stage_mapping.py helper.

kill

kill

Kill all running builds associated with pull request.

skip

skip --comment COMMENT

Skip testing for latest commit on pull request. --comment "Reason for skipping build/test" is required. IMPORTANT NOTE: This is dangerous since lack of user care and validation can cause top of tree to break.

reuse-pipeline

reuse-pipeline

Reuse a previous pipeline to validate current commit. This action will also kill all currently running builds associated with the pull request. IMPORTANT NOTE: This is dangerous since lack of user care and validation can cause top of tree to break.

Signed-off-by: Eran Geva <19514940+MrGeva@users.noreply.github.com>
@MrGeva
MrGeva requested a review from a team as a code owner December 17, 2025 13:08
@MrGeva
MrGeva requested a review from lucaslie December 17, 2025 13:08
@coderabbitai

coderabbitai Bot commented Dec 17, 2025 •

Copy link
Copy Markdown
Contributor
📝 Walkthrough

Walkthrough

Added a new skip_first_match configuration parameter to the FuseAllreduceResidualRMSNorm transform that allows skipping the first allreduce+rmsnorm fusion match. Implemented configuration class and conditional replacement logic in Python code and corresponding YAML configuration entry.

Changes

Cohort / File(s) Summary
Configuration
tensorrt_llm/_torch/auto_deploy/config/default.yaml
Added skip_first_match: false field to the fuse_allreduce_residual_rmsnorm transform configuration in the post_load_fusion stage.
Transform Implementation
tensorrt_llm/_torch/auto_deploy/transform/library/collectives.py
Introduced FuseAllreduceResidualRMSNormConfig class with skip_first_match boolean field; added get_config_class() classmethod to FuseAllreduceResidualRMSNorm; implemented _conditional_repl() function to conditionally apply fusion based on match count and configuration; wired conditional replacement logic into transform application for both residual_first and x_first patterns.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~18 minutes

  • Config class implementation: Verify FuseAllreduceResidualRMSNormConfig schema and inheritance from TransformConfig
  • Conditional replacement logic: Examine the _conditional_repl() counter mechanism and ensure state is correctly tracked across pattern matches
  • Integration point: Confirm the configuration is properly wired into both pattern replacements and that the classmethod is correctly exposing the config type

Pre-merge checks and finishing touches

❌ Failed checks (2 warnings)
Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. You can run @coderabbitai generate docstrings to improve docstring coverage.
Description check ⚠️ Warning PR description is incomplete and missing critical required sections from the template including Description, Test Coverage, and populated PR Checklist items. Fill in the Description section with detailed explanation of the issue and solution, provide Test Coverage section listing relevant tests, and complete all PR Checklist items with appropriate selections.
✅ Passed checks (1 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes the main change: adding an option to skip first layer allreduce+rmsnorm fusion to avoid hangs, which is directly reflected in both configuration and transform changes.
✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

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

@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.

Actionable comments posted: 1

📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between f7e2456 and 8b7b68a.

📒 Files selected for processing (2)
  • tensorrt_llm/_torch/auto_deploy/config/default.yaml (1 hunks)
  • tensorrt_llm/_torch/auto_deploy/transform/library/collectives.py (5 hunks)
🧰 Additional context used
📓 Path-based instructions (2)
**/*.py

📄 CodeRabbit inference engine (CODING_GUIDELINES.md)

**/*.py: Code developed for TensorRT-LLM should conform to Python 3.8+
Indent Python code with 4 spaces. Do not use tabs
Always maintain the namespace when importing, even if only one class or function from a module is used (e.g., use from package.subpackage import foo; foo.SomeClass() instead of from package.subpackage.foo import SomeClass)
Python filenames should use snake_case (e.g., some_file.py)
Python classes should use PascalCase (e.g., class SomeClass)
Python functions and methods should use snake_case (e.g., def my_awesome_function():)
Python local variables should use snake_case. Prefix 'k' for variable names that start with a number (e.g., k_99th_percentile = ...)
Python global variables should use upper snake_case and prefix 'G' (e.g., G_MY_GLOBAL = ...)
Python constants should use upper snake_case (e.g., MY_CONSTANT = ...)
Avoid shadowing variables declared in an outer scope in Python code
Initialize all externally visible members of a Python class in the constructor
For Python interfaces that may be used outside a file, prefer docstrings over comments
Python comments should be reserved for code within a function, or interfaces that are local to a file
Use Google style docstrings for Python classes and functions, which can be parsed by Sphinx
Python attributes and variables can be documented inline with attribute docstrings that will be rendered under the class docstring
Avoid using reflection in Python when functionality can be easily achieved without reflection
When using try-except blocks in Python, limit the except to the smallest set of errors possible
When using try-except blocks in Python to handle multiple possible variable types (duck-typing), keep the body of the try as small as possible, using the else block to implement the logic

Files:

  • tensorrt_llm/_torch/auto_deploy/transform/library/collectives.py
**/*.{h,hpp,cpp,cc,cxx,cu,py}

📄 CodeRabbit inference engine (CODING_GUIDELINES.md)

All TensorRT-LLM source code files should contain an NVIDIA copyright header with the current year, including .cpp, .h, .cu, .py, and other source files

Files:

  • tensorrt_llm/_torch/auto_deploy/transform/library/collectives.py
🧠 Learnings (1)
📚 Learning: 2025-09-23T15:12:38.312Z
Learnt from: nv-lschneider
Repo: NVIDIA/TensorRT-LLM PR: 7910
File: cpp/tensorrt_llm/thop/allreduceOp.cpp:352-446
Timestamp: 2025-09-23T15:12:38.312Z
Learning: In TensorRT-LLM NCCL device allreduce implementation (cpp/tensorrt_llm/thop/allreduceOp.cpp), the goto pattern in runNCCLAllReduceDeviceFusion is intentionally used for future extensibility, allowing multiple switch cases to fallback to the default handler. While not aesthetically ideal, this pattern supports adding more fusion cases later that can reuse the same fallback logic.

Applied to files:

  • tensorrt_llm/_torch/auto_deploy/config/default.yaml
  • tensorrt_llm/_torch/auto_deploy/transform/library/collectives.py
🧬 Code graph analysis (1)
tensorrt_llm/_torch/auto_deploy/transform/library/collectives.py (10)
tensorrt_llm/llmapi/llm_args.py (1)
  • Field (68-95)
tensorrt_llm/_torch/auto_deploy/shim/interface.py (1)
  • CachedSequenceInterface (11-92)
tensorrt_llm/_torch/auto_deploy/utils/pattern_matcher.py (2)
  • ADPatternMatcherPass (61-67)
  • register_ad_pattern (99-182)
tensorrt_llm/_torch/auto_deploy/transform/interface.py (5)
  • BaseTransform (219-506)
  • TransformConfig (71-114)
  • TransformInfo (123-180)
  • get_config_class (241-246)
  • get_config_class (530-532)
tensorrt_llm/builder.py (1)
  • default (45-50)
tensorrt_llm/_torch/auto_deploy/transform/library/compile_model.py (1)
  • get_config_class (39-40)
tensorrt_llm/_torch/auto_deploy/transform/library/fused_moe.py (2)
  • get_config_class (811-812)
  • get_config_class (1508-1509)
tensorrt_llm/_torch/auto_deploy/transform/library/rms_norm.py (1)
  • get_config_class (123-124)
tensorrt_llm/_torch/auto_deploy/transform/library/attention.py (1)
  • get_config_class (849-850)
tensorrt_llm/_torch/auto_deploy/transform/library/rope.py (1)
  • get_config_class (250-251)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
  • GitHub Check: Pre-commit Check
🔇 Additional comments (4)
tensorrt_llm/_torch/auto_deploy/transform/library/collectives.py (3)

8-8: LGTM: Import additions follow coding guidelines.

The new imports support the configuration mechanism and follow the guideline to maintain namespace when importing.

Also applies to: 11-11, 17-23


118-120: LGTM: Configuration wiring follows established pattern.

The get_config_class implementation matches the standard approach used by other transforms in the codebase.


96-107: Clarify the torch.compile + NCCL hang scenario and verification status.

The description references a specific hang with torch.compile + NCCL during lazy initialization, but this scenario is not documented in public PyTorch issues or NCCL documentation. Provide a reference to the internal issue or test case that confirms this hang, and clarify whether skipping the first fusion match has been verified to resolve the issue.

tensorrt_llm/_torch/auto_deploy/config/default.yaml (1)

128-128: LGTM: Configuration default is correct.

The YAML configuration correctly adds the skip_first_match field with a false default, matching the Python config class definition and maintaining backward compatibility.

@greg-kwasniewski1 greg-kwasniewski1 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.

We need a proper fix eventually, but this WAR LGTM for now to keep it going.

MrGeva and others added 3 commits December 17, 2025 05:54
Signed-off-by: Eran Geva <19514940+MrGeva@users.noreply.github.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Signed-off-by: Eran Geva <19514940+MrGeva@users.noreply.github.com>
Signed-off-by: Eran Geva <19514940+MrGeva@users.noreply.github.com>
@MrGeva

MrGeva commented Dec 17, 2025

Copy link
Copy Markdown
Collaborator Author

/bot run

@MrGeva MrGeva changed the title [#9847][fix] Added option to skip first layer of allreduce+rmsnorm fusion to avoid a hang [#9847][fix] AutoDeploy: Added option to skip first layer of allreduce+rmsnorm fusion to avoid a hang Dec 17, 2025
@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #28789 [ run ] triggered by Bot. Commit: 9464543

@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #28789 [ run ] completed with state SUCCESS. Commit: 9464543
/LLM/main/L0_MergeRequest_PR pipeline #22036 completed with status: 'FAILURE'

⚠️ 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

@MrGeva MrGeva closed this Dec 21, 2025
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.

3 participants