Skip to content

Make weight and optimizer memory estimation take into account expert parallelism correctly - #4687

Merged
deepakn94 merged 10 commits into
NVIDIA:mainfrom
YangFei1990:fix_memory_util
May 14, 2026
Merged

Make weight and optimizer memory estimation take into account expert parallelism correctly#4687
deepakn94 merged 10 commits into
NVIDIA:mainfrom
YangFei1990:fix_memory_util

Conversation

@YangFei1990

@YangFei1990 YangFei1990 commented May 7, 2026

Copy link
Copy Markdown
Contributor

What does this PR do ?

Fix memory estimation. Previously the function counted MoE routed expert parameters together with regular transformer parameters, so per-rank weight and optimizer memory did not account for expert tensor parallelism, expert parallelism, or expert data parallelism.

This change separates regular TP-sharded parameters, replicated non-expert parameters, and routed expert parameters. Routed experts now use ETP/EP for parameter ownership and EDP for distributed optimizer sharding, while shared experts remain on regular TP.

Issue tracking

Fixes #4050

Contribution process

Pre-checks

  • I have added relevant unit tests
  • I have added relevant functional tests
  • I have added proper typing to my code Typing guidelines
  • I have added relevant documentation
  • I have run the autoformatter.sh on my PR

Code review

Feel free to message or comment the @mcore-oncall to help accelerate your merge into main. The less complex your PR is, the faster it will be approved and merged!

All PRs start as draft. If you open a non-draft PR, it will be automatically converted to draft.

Step 1: Mark PR as "Ready for Review"

  1. When your PR is ready, click Ready for Review.
  2. An oncall reviewer is auto-assigned and expert reviewers are notified based on your changes.
    • Some PRs may jump straight to step 2. This is determined by .github/CODEOWNERS.

⚠️ Only mark as ready once merge-conflicts are resolved and the CI is passing.
Final Review might get declined if these requirements are not fulfilled.

Step 2: Final Review

For PRs that change megatron/core, once all expert reviewers have approved, the Final Review label is applied automatically and final reviewers are assigned.

For PRs outside megatron/core, this step is skipped.

Step 3: Approved

Once all required reviewers have approved, the Approved label is applied automatically.

Merge

Any member of mcore-engineers will be able to merge your PR.

For MRs into `dev` branch The proposed review process for `dev` branch is under active discussion.

MRs are mergable after one approval by either eharper@nvidia.com or zijiey@nvidia.com.

@YangFei1990
YangFei1990 requested review from a team as code owners May 7, 2026 23:46
@svcnvidia-nemo-ci
svcnvidia-nemo-ci marked this pull request as draft May 7, 2026 23:47
@github-actions

github-actions Bot commented May 7, 2026

Copy link
Copy Markdown
Contributor

This PR has been automatically converted to draft because all PRs must start as drafts.

When you are ready for review, click Ready for Review to begin the review process. This will:

  1. Add the oncall reviewer (optional reviewer)
  2. Add required review teams based on your changes

See the contribution guide for more details.

@copy-pr-bot

copy-pr-bot Bot commented May 7, 2026

Copy link
Copy Markdown

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

@YangFei1990
YangFei1990 marked this pull request as ready for review May 7, 2026 23:48
@svcnvidia-nemo-ci
svcnvidia-nemo-ci requested a review from a team May 7, 2026 23:48
@YangFei1990

Copy link
Copy Markdown
Contributor Author

/claude review

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

LGTM — the decomposition into TP-sharded, replicated, and routed-expert parameter categories is correct, and using separate data-parallel sizes for the distributed optimizer byte calculation is the right fix.

One suggestion: compute_weight_and_optimizer_memory has no unit tests today, and this PR rewrites most of its arithmetic. A parameterized unit test that constructs a mock args namespace and asserts known outputs for a few configurations (dense-only, MoE with ETP/EP > 1, distributed optimizer on/off, untied embeddings with PP=1) would protect against future regressions and make reviewing easier. The PR checklist also has the test boxes unchecked — worth adding before merging.

@YangFei1990

Copy link
Copy Markdown
Contributor Author

/ok to test 60d595e

@svcnvidia-nemo-ci svcnvidia-nemo-ci added the Approved All necessary approvals have been made label May 13, 2026
@deepakn94 deepakn94 changed the title Fix weights/opt memory estimation Make weight and optimizer memory estimation take into account expert parallelism correctly May 13, 2026
@deepakn94
deepakn94 enabled auto-merge May 13, 2026 22:45
@deepakn94

Copy link
Copy Markdown
Contributor

/ok to test 541a0d8

@deepakn94
deepakn94 disabled auto-merge May 13, 2026 22:50
@deepakn94
deepakn94 enabled auto-merge May 13, 2026 22:50
@svcnvidia-nemo-ci

Copy link
Copy Markdown
Contributor

🔄 Merge queue validation started!

You can track the progress here: https://github.com/NVIDIA/Megatron-LM/actions/runs/25836565088

Merged via the queue into NVIDIA:main with commit a7c9e8c May 14, 2026
74 of 75 checks passed
cspades pushed a commit to cspades/Megatron-LM that referenced this pull request May 14, 2026
janEbert pushed a commit to janEbert/Megatron-LM that referenced this pull request Jun 2, 2026
yhgalaxy pushed a commit to yhgalaxy/Megatron-LM that referenced this pull request Jun 17, 2026
…parallelism correctly (NVIDIA#4687)

Signed-off-by: yhgalaxy <yhgalaxy@outlook.com>
jon-barker pushed a commit to jon-barker/Megatron-LM that referenced this pull request Jul 10, 2026
…parallelism correctly (NVIDIA#4687)

Signed-off-by: Jon Barker <jbarker@aws-cmh-slurm-1-vscode-02.cm.cluster>
terminator123 pushed a commit to 021ai/Megatron-LM that referenced this pull request Aug 3, 2026
svcnvidia-nemo-ci pushed a commit to dimapihtar/Megatron-LM that referenced this pull request Aug 4, 2026
…parallelism correctly (NVIDIA#4687)

Signed-off-by: Dmytro Pykhtar <dpykhtar@nvidia.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Approved All necessary approvals have been made complexity: medium

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[QUESTION] MoE layer theoretical memory calculation needs to account for ETP/EDP.

4 participants