Skip to content

Conversation

aliafzal
Copy link
Contributor

@aliafzal aliafzal commented Sep 5, 2025

Summary:
Summary:

  • Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner.
  • Supports two key scenarios:
    1. Reusing previously computed and stored sharding plans to avoid regeneration costs
    2. Using sharding plans from previous runs as starting points for iterative improvements
  • Defines two abstract methods:
    • load(): Returns a dictionary mapping sharding option hashes to ShardingOption objects
    • plan_validation_str(): Provides validation string for plan integrity checks
  • Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Differential Revision: D81571293

@meta-cla meta-cla bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Sep 5, 2025
@facebook-github-bot
Copy link
Contributor

This pull request was exported from Phabricator. Differential Revision: D81571293

aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 8, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Differential Revision: D81571293
aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 8, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Differential Revision: D81571293
@facebook-github-bot
Copy link
Contributor

This pull request was exported from Phabricator. Differential Revision: D81571293

aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 8, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Differential Revision: D81571293
aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 8, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Differential Revision: D81571293
@facebook-github-bot
Copy link
Contributor

This pull request was exported from Phabricator. Differential Revision: D81571293

aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 8, 2025
Summary:
Pull Request resolved: meta-pytorch#3355

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner.
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Differential Revision: D81571293
@aliafzal aliafzal force-pushed the export-D81571293 branch 2 times, most recently from 8adb0e7 to a2dc995 Compare September 11, 2025 12:30
aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 11, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Reviewed By: mserturk

Differential Revision: D81571293
@facebook-github-bot
Copy link
Contributor

This pull request was exported from Phabricator. Differential Revision: D81571293

aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 11, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Reviewed By: mserturk

Differential Revision: D81571293
@facebook-github-bot
Copy link
Contributor

This pull request was exported from Phabricator. Differential Revision: D81571293

aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 14, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Reviewed By: mserturk

Differential Revision: D81571293
aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 14, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Reviewed By: mserturk

Differential Revision: D81571293
@facebook-github-bot
Copy link
Contributor

@aliafzal has exported this pull request. If you are a Meta employee, you can view the originating diff in D81571293.

aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 14, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Reviewed By: mserturk

Differential Revision: D81571293
@facebook-github-bot
Copy link
Contributor

@aliafzal has exported this pull request. If you are a Meta employee, you can view the originating diff in D81571293.

aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 14, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Reviewed By: mserturk

Differential Revision: D81571293
aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 14, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Reviewed By: mserturk

Differential Revision: D81571293
aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 16, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Reviewed By: mserturk

Differential Revision: D81571293
@facebook-github-bot
Copy link
Contributor

@aliafzal has exported this pull request. If you are a Meta employee, you can view the originating diff in D81571293.

aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 16, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Reviewed By: mserturk

Differential Revision: D81571293
aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 16, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Reviewed By: mserturk

Differential Revision: D81571293
@facebook-github-bot
Copy link
Contributor

@aliafzal has exported this pull request. If you are a Meta employee, you can view the originating diff in D81571293.

aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 16, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Reviewed By: mserturk

Differential Revision: D81571293
aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 16, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Reviewed By: mserturk

Differential Revision: D81571293
@facebook-github-bot
Copy link
Contributor

@aliafzal has exported this pull request. If you are a Meta employee, you can view the originating diff in D81571293.

aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 16, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Reviewed By: mserturk

Differential Revision: D81571293
aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 17, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Reviewed By: mserturk

Differential Revision: D81571293
aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 17, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Reviewed By: mserturk

Differential Revision: D81571293
@facebook-github-bot
Copy link
Contributor

@aliafzal has exported this pull request. If you are a Meta employee, you can view the originating diff in D81571293.

aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 17, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Reviewed By: mserturk

Differential Revision: D81571293
@facebook-github-bot
Copy link
Contributor

@aliafzal has exported this pull request. If you are a Meta employee, you can view the originating diff in D81571293.

aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 17, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Reviewed By: mserturk

Differential Revision: D81571293
aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 17, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Reviewed By: mserturk

Differential Revision: D81571293
aliafzal added a commit to aliafzal/torchrec that referenced this pull request Sep 17, 2025
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Reviewed By: mserturk

Differential Revision: D81571293
@facebook-github-bot
Copy link
Contributor

@aliafzal has exported this pull request. If you are a Meta employee, you can view the originating diff in D81571293.

…torch#3327)

Summary:
internal

Context: This change is part of the effort in improving planners overall UX and reliability.

This Diff:
1. Add ConfigeratorStats to upload sharding plan to config store.

**How is a sharding plan stored in Configerator?**

The Thrift definition of a sharding plan includes two fields: Topology and Dict[int, ShardingOption].

1. Topology: The Topology field contains the information mentioned in this diff D79142495.
2. Dict[int, ShardingOption]: This field represents a dictionary where each key is a 64-bit hash of a sharding option, and the value is the corresponding Thrift-converted sharding option. The hash is calculated using the storage_hash function within the ShardingOption object, which takes into account factors such as the fqn, sharding type, and compute kernel.

**How can a loaded plan be merged with an enumerated search space?**

**Background:** When a plan is preserved during the logging stage, a hash is generated to ensure that the same plan can be loaded and validated later. The [hash is calculated](https://www.internalfb.com/code/fbsource/[fdf90ff2be9041f867bc6c9e4aec6ee94862fa11]/fbcode/torchrec/distributed/planner/types.py?lines=1010-1026) using input fields such as topology, batch size, constraints, storage reservation, and storage reservation policy, as well as fields from the sharding options like fqn, sharding type, kernel type, shards, and cache parameters.

Once the plan is loaded and validated, we can safely assume that all loaded sharding options are a 1:1 map of enumerated sharded options. During the loading process, we traverse the enumerated search space, calculate the storage hash for each sharding option, look up the corresponding sharding option from the loaded plan, and replace the Shards of the enumerated sharding option with those of the loaded sharding option. This approach enables us to generate precise sharding options that can be seamlessly converted into a sharing plan as done by the planner and this also ensures consistent logging while also facilitating plan replay.

Reviewed By: ge0405

Differential Revision: D81185992
Summary:

internal
Context: Planner stats db is introduced in this diff to track metadata and perf metrics associated with sharding plan.

This Diff:
1. Added methods to insert, select and delete planner stats db row.
2. UTs for planner stats db
3. Integration of planner stats db with ConfigeratorStats

Reviewed By: ge0405

Differential Revision: D81216987
Summary:

**Summary:**

*   Added PlanLoader abstract base class to enable loading pre-computed sharding plans from stored locations within planner. 
*   Supports two key scenarios:
    1.  Reusing previously computed and stored sharding plans to avoid regeneration costs
    2.  Using sharding plans from previous runs as starting points for iterative improvements
*   Defines two abstract methods:
    *   `load()`: Returns a dictionary mapping sharding option hashes to ShardingOption objects
    *   `plan_validation_str()`: Provides validation string for plan integrity checks
*   Part of the broader effort to improve planner UX and reliability by enabling plan persistence and reuse across training runs

Reviewed By: mserturk

Differential Revision: D81571293
@facebook-github-bot
Copy link
Contributor

@aliafzal has exported this pull request. If you are a Meta employee, you can view the originating diff in D81571293.

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

Labels

CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. fb-exported meta-exported

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants