Skip to content

Conversation

@yali-arch
Copy link
Collaborator

@yali-arch yali-arch commented Jul 31, 2025

Summary by CodeRabbit

  • Tests

    • Introduced a new test suite to verify custom PyTorch operator registrations and ensure the presence of required fake implementations.
    • Added checks to flag missing fake implementations for custom operators in the "trtllm" namespace.
  • Refactor

    • Removed registration of specific matrix multiplication functions from the user-facing library interface.

Description

It has been observed that the problem of missing fake implementations for new custom operations occurs from time to time, and such issues are often identified only after a certain period.
As a result, a new test file tensorrt_llm/_torch/custom_ops/torch_custom_ops.py is added to check the presence of fake implementations for each custom operation.

There are some CPP custom ops that don't have fake impl. They are tracked in the test but will be fixed in future PRs:

        to_fix = {
            "trtllm::lora_grouped_gemm",
            "trtllm::mtp_relaxed_acceptance_op",
            "trtllm::mtp_update_hidden_states_op",
            "trtllm::mtp_prepare_drafter_inputs_op",
            "trtllm::selective_scan",
            "trtllm::reducescatter_list",
            "trtllm::fp8_per_tensor_scale_moe_runner",
            "trtllm::migrate_to_host_accessible",
            "trtllm::mnnvl_moe_alltoallv_prepare_without_allgather",
            "trtllm::mamba_conv1d",
            "trtllm::llama4_moe_tp8ep1_min_latency",
            "trtllm::llama4_fp8_fp8_gemm_swiglu",
            "trtllm::llama4_fp8_bf16_gemm",
            "trtllm::llama4_bf16_bf16_gemm",
            "trtllm::fused_topk_softmax",
            "trtllm::fp8_batched_quantize_1x128_permute102",
            "trtllm::fp8_block_scaling_moe_gemm",
            "trtllm::fp8_block_scaling_bmm_out",
            "trtllm::fp8_block_scaling_bmm",
            "trtllm::fp4_batched_quantize",
            "trtllm::fp4_gemm_trtllmgen",
            "trtllm::fp4_bmm",
            "trtllm::merge_chunked_attention_for_mla",
            "trtllm::cuda_scaled_mm",
            "trtllm::initialize_static_lowprecision_buffers",
            "trtllm::cutlass_scaled_mm",
            "trtllm::fp8_per_tensor_scaling_tllmg_gemm",
            "trtllm::load_chunked_kv_cache_for_mla",
            "trtllm::load_paged_kv_cache_for_mla",
            "trtllm::set_paged_kv_cache_for_mla",
            "trtllm::set_chunked_kv_cache_for_mla",
            "trtllm::mla_rope_append_paged_kv_assign_q",
            "trtllm::fused_qk_norm_rope",
        }

Test Coverage

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.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Jul 31, 2025

📝 Walkthrough

Walkthrough

The changes remove the registration of two out-variant matrix multiplication functions from the Torch library fragment in a C++ source file. Additionally, a new Python test suite is introduced to verify the presence of fake kernel implementations for custom PyTorch operators, specifically targeting the "trtllm" namespace.

Changes

Cohort / File(s) Change Summary
Torch Library Fragment Registration Removal
cpp/tensorrt_llm/thop/cublasScaledMM.cpp
Removed the registration of cublas_scaled_mm_out and cublas_mm_out functions from the Torch library fragment, leaving their implementations unchanged.
Custom Operator Fake Kernel Tests
tests/unittest/_torch/test_custom_ops.py
Added a new test suite to discover custom ops in the "trtllm" namespace and verify that all have registered fake kernel implementations, asserting failure if any are missing.

Sequence Diagram(s)

sequenceDiagram
    participant Tester as TestCustomOp (Python)
    participant Torch as PyTorch Operator Registry
    participant TRTLLM as trtllm Custom Ops

    Tester->>Torch: Discover custom ops in "trtllm" namespace
    loop For each custom op
        Tester->>Torch: Check for fake kernel implementation
        alt Fake kernel missing and not waived
            Tester->>Tester: Mark test as failed
        else Fake kernel present or waived
            Tester->>Tester: Continue
        end
    end
    Tester->>Tester: Report test results
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~15 minutes

Suggested reviewers

  • venkywonka
  • liji-nv
  • tburt-nv

Note

⚡️ Unit Test Generation is now available in beta!

Learn more here, or try it out under "Finishing Touches" below.


📜 Recent review details

Configuration used: .coderabbit.yaml
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between c9253f3 and e07d82b.

📒 Files selected for processing (1)
  • tests/unittest/_torch/test_custom_ops.py (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • tests/unittest/_torch/test_custom_ops.py
✨ Finishing Touches
  • 📝 Generate Docstrings
🧪 Generate unit tests
  • 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
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Explain this complex logic.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai explain this code block.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and explain its main purpose.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR.
  • @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
  • @coderabbitai generate unit tests to generate unit tests for this PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai or @coderabbitai title anywhere in the PR title to generate the title automatically.

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@yali-arch yali-arch changed the title Test custom ops [TRTLLM-4279] fix: Add a protection test for checking trtllm custom ops Jul 31, 2025
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

🧹 Nitpick comments (3)
tests/unittest/_torch/test_custom_ops.py (3)

4-4: Consider replacing wildcard import with specific imports.

The wildcard import from typing can make code less readable and may introduce unexpected names into the namespace. Consider importing only the specific types needed.

-from typing import *  # noqa: F403
+from typing import List, Set

20-84: Well-structured base class with comprehensive operator discovery.

The implementation correctly handles the challenges of discovering lazy-loaded C++ custom operators using schemas and provides thorough cleanup of global registries. The separation of concerns between discovery and testing is good design.

Consider adding error handling for cases where library_utils.lookup_op might fail:

         for schema in ops_schemas:
             if not schema.name.startswith(ns_prefix):
                 continue
-            op = library_utils.lookup_op(schema.name)
-            ops.append(op)
-            print(f"    {op._name}")
+            try:
+                op = library_utils.lookup_op(schema.name)
+                ops.append(op)
+                print(f"    {op._name}")
+            except Exception as e:
+                print(f"    Failed to lookup {schema.name}: {e}")

133-192: Core test effectively addresses the PR objective.

The test logic is sound and will prevent new custom operators from being added without fake implementations. The separation of waived operations (legitimately don't need fakes) from those marked for future fixes is appropriate.

The extensive to_fix list (44 operators) represents significant technical debt. Consider:

  1. Adding GitHub issue references for tracking progress
  2. Adding a mechanism to periodically validate that operators in to_fix still exist in the codebase
         # TODO: add fake impl for these ops in follow-up PRs.
+        # Tracked in GitHub issues: [add issue numbers]
         to_fix = {
📜 Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between baece56 and c9253f3.

📒 Files selected for processing (2)
  • cpp/tensorrt_llm/thop/cublasScaledMM.cpp (0 hunks)
  • tests/unittest/_torch/test_custom_ops.py (1 hunks)
💤 Files with no reviewable changes (1)
  • cpp/tensorrt_llm/thop/cublasScaledMM.cpp
🧰 Additional context used
🧠 Learnings (2)
📓 Common learnings
Learnt from: moraxu
PR: NVIDIA/TensorRT-LLM#6303
File: tests/integration/test_lists/qa/examples_test_list.txt:494-494
Timestamp: 2025-07-28T17:06:08.621Z
Learning: In TensorRT-LLM testing, it's common to have both CLI flow tests (test_cli_flow.py) and PyTorch API tests (test_llm_api_pytorch.py) for the same model. These serve different purposes: CLI flow tests validate the traditional command-line workflow, while PyTorch API tests validate the newer LLM API backend. Both are legitimate and should coexist.
tests/unittest/_torch/test_custom_ops.py (1)

Learnt from: moraxu
PR: #6303
File: tests/integration/test_lists/qa/examples_test_list.txt:494-494
Timestamp: 2025-07-28T17:06:08.621Z
Learning: In TensorRT-LLM testing, it's common to have both CLI flow tests (test_cli_flow.py) and PyTorch API tests (test_llm_api_pytorch.py) for the same model. These serve different purposes: CLI flow tests validate the traditional command-line workflow, while PyTorch API tests validate the newer LLM API backend. Both are legitimate and should coexist.

🔇 Additional comments (4)
tests/unittest/_torch/test_custom_ops.py (4)

14-17: LGTM!

The decorator correctly handles Windows incompatibility with torch.compile using the appropriate unittest skip mechanism.


87-93: LGTM!

The test class is properly structured with appropriate inheritance and decorator usage. The docstring clearly explains the purpose.


95-128: Excellent validation test for the testing infrastructure.

This test effectively validates that the fake kernel detection mechanism works correctly by creating a test operator without a fake implementation and confirming it's properly detected. The use of torch.library.opcheck and library_utils.has_fake_kernel provides comprehensive validation.


195-196: LGTM!

Standard unittest execution pattern.

@yali-arch
Copy link
Collaborator Author

/bot run

@tensorrt-cicd
Copy link
Collaborator

PR_Github #13673 [ run ] triggered by Bot

@yali-arch yali-arch requested review from a team, byshiue, lfr-0531 and liji-nv and removed request for a team and byshiue July 31, 2025 12:18
@tensorrt-cicd
Copy link
Collaborator

PR_Github #13673 [ run ] completed with state SUCCESS
/LLM/main/L0_MergeRequest_PR pipeline #10265 completed with status: 'FAILURE'

@yali-arch
Copy link
Collaborator Author

/bot run

@tensorrt-cicd
Copy link
Collaborator

PR_Github #13695 [ run ] triggered by Bot

@tensorrt-cicd
Copy link
Collaborator

PR_Github #13695 [ run ] completed with state SUCCESS
/LLM/main/L0_MergeRequest_PR pipeline #10286 completed with status: 'SUCCESS'
Pipeline passed with automatic retried tests. Check the rerun report for details.

@yali-arch
Copy link
Collaborator Author

/bot run

@tensorrt-cicd
Copy link
Collaborator

PR_Github #13755 [ run ] triggered by Bot

@tensorrt-cicd
Copy link
Collaborator

PR_Github #13755 [ run ] completed with state SUCCESS
/LLM/main/L0_MergeRequest_PR pipeline #10337 completed with status: 'SUCCESS'
Pipeline passed with automatic retried tests. Check the rerun report for details.

@yali-arch yali-arch self-assigned this Aug 1, 2025
@litaotju litaotju merged commit ac23f4a into NVIDIA:main Aug 1, 2025
3 checks passed
lancelly pushed a commit to lancelly/TensorRT-LLM that referenced this pull request Aug 6, 2025
…ps (NVIDIA#6515)

Signed-off-by: Yang Li <[email protected]>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Signed-off-by: Lanyu Liao <[email protected]>
jain-ria pushed a commit to jain-ria/TensorRT-LLM that referenced this pull request Aug 7, 2025
…ps (NVIDIA#6515)

Signed-off-by: Yang Li <[email protected]>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@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.

4 participants