Skip to content

Conversation

@ngrayluna
Copy link
Contributor

@ngrayluna ngrayluna commented Jan 22, 2026

Description

Clarify how steps, metrics, and logged points relate to performance when logging to W&B. This PR also:

  • Defines how W&B counts logged data (steps, metrics, and logged points)
  • Explains how logging scales at large step counts
  • Disambiguates per-metric, per-run, and project-level limits
  • Improves examples and comments for metric frequency and commit behavior
  • Reorganizes section hierarchy to separate concepts, limits, and performance guidance
  • Word smithing (active voice, etc. )

Related issues

@github-actions
Copy link
Contributor

github-actions bot commented Jan 22, 2026

🔗 Link Checker Results

All links are valid!

No broken links were detected.

Checked against: https://wb-21fd5541-experiments-limits-page.mintlify.app

@github-actions
Copy link
Contributor

github-actions bot commented Jan 22, 2026

📚 Mintlify Preview Links

🔗 View Full Preview

📝 Changed (1 total)

📄 Pages (1)

File Preview
models/track/limits.mdx Limits

🤖 Generated automatically when Mintlify deployment succeeds
📍 Deployment: 63f0f44 at 2026-01-24 00:44:27 UTC

@ngrayluna ngrayluna marked this pull request as ready for review January 24, 2026 00:40
@ngrayluna ngrayluna requested a review from a team as a code owner January 24, 2026 00:40
@tristan-spaulding2
Copy link
Contributor

@ngrayluna I think the clarity is improved here, thanks, You may want to check with @dawita66 on the best guidance to give on the numbers right now. For example as we roll out v2, it's no longer so cut and dried between SaaS and Dedicated/Customer Managed. Some Dedicated do have v2 and with the mysql size (not a factor mentioned on this page, but relevant), can do well above 10,000 runs performantly. Meanwhile non-paid SaaS do not have v2 on and can't do 100,000 runs. etc.

W&B organizes logged data along three dimensions:

Use `wandb.Run.log()` to track experiment metrics.
* **Steps**: The number of time steps in a run that you finalize by committing logged data. Each step represents a single time index (such as a training step or epoch) and is finalized when you call `wandb.Run.log()` with `commit=True`, or implicitly when `commit` and `step` are not specified.
Copy link

Choose a reason for hiding this comment

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

"The number of time steps in a run" or just "The number of steps in a run"

| Dimension | Guidance at scale |
|-----------------------|--------------------------------------------|
| Steps per run | Millions of steps per run are common |
| Distinct metrics | Fewer than 100,000 per run |
Copy link

Choose a reason for hiding this comment

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

if a project has 10 runs, each run has 100K non-overlapping distinct metrics, then the project would have a total of 10 x 100K = 1M distinct metrics. The project page would not be able to load that because the per project limit is 100,000 distinct metrics.

however, if all the runs log to the same 100K metrics, then it would be okay to say it's "100,000 per run".

would it be more accurate to say "Fewer than 100,000 per project"?

Copy link

Choose a reason for hiding this comment

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

I am assuming this is for MT SaaS.

For dedicated instances, the distinct metric limits vary by instance size from our internal sizing benchmark. We probably don't want to publish them may be worthwhile to point out they are different from this MT SaaS number.

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