Skip to content

[Data] Modify maximum memory to OOM prevention docs - #65509

Open
viiccwen wants to merge 2 commits into
ray-project:masterfrom
viiccwen:docs/data-oom-memory-buffer
Open

[Data] Modify maximum memory to OOM prevention docs#65509
viiccwen wants to merge 2 commits into
ray-project:masterfrom
viiccwen:docs/data-oom-memory-buffer

Conversation

@viiccwen

Copy link
Copy Markdown
Contributor

Description

Update the Ray Data OOM prevention guide to recommend setting memory to 125% of the maximum observed worker heap memory. This leaves a 20% buffer for variation between jobs and future increases in memory use.

Related issues

closes #65508.

Additional information

Optional: Add implementation details, API changes, usage examples, screenshots, etc.

Signed-off-by: viiccwen <vicwen@apache.org>
@viiccwen
viiccwen requested review from a team as code owners August 16, 2026 03:50

@gemini-code-assist gemini-code-assist 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.

Code Review

This pull request updates the documentation on avoiding out-of-memory (OOM) errors in Ray Data by recommending that users set the memory parameter to 1.25 times (or 125% of) the maximum observed heap memory. The feedback suggests clarifying the reference to max_uss_bytes by explicitly pointing out that users should look at the 'max' key within this dictionary to avoid ambiguity.

Comment thread doc/source/data/how-to-avoid-ooms.md Outdated
Signed-off-by: viiccwen <vicwen@apache.org>
@viiccwen

Copy link
Copy Markdown
Contributor Author

Hello @bveeramani, it's can be reviewed, PTAL. Thanks!

@ray-gardener ray-gardener Bot added docs An issue or change related to documentation data Ray Data-related issues community-contribution Contributed by the community labels Aug 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

community-contribution Contributed by the community data Ray Data-related issues docs An issue or change related to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Data] Modify maximum memory to OOM prevention guidance

1 participant