Skip to content

Add runtime memory protection settings to Nitro memory management docs#3155

Merged
pete-vielhaber merged 18 commits intomasterfrom
at/affectionate-mahavira
Apr 23, 2026
Merged

Add runtime memory protection settings to Nitro memory management docs#3155
pete-vielhaber merged 18 commits intomasterfrom
at/affectionate-mahavira

Conversation

@a-thomas-22
Copy link
Copy Markdown
Contributor

@a-thomas-22 a-thomas-22 commented Mar 14, 2026

Summary

  • Documents node.resource-mgmt.mem-free-limit (RPC throttling via HTTP 429) and node.block-validator.memory-free-limit (validation pausing) as a new "Runtime memory protection" section
  • Explains the shared cgroup-based memory checking mechanism (v1/v2), including the formula for effective usage calculation
  • Lists all Prometheus metrics and log lines emitted by both features
  • Adds guidance on choosing between the two settings based on node type
  • Adds two new tuning recommendations for monitoring these protections

Ref: SREP-2531

Document node.resource-mgmt.mem-free-limit (RPC throttling) and
node.block-validator.memory-free-limit (validation pausing), including
how cgroup-based memory checking works, metrics emitted, log lines,
and guidance on choosing between the two settings.
@vercel
Copy link
Copy Markdown

vercel Bot commented Mar 14, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
arbitrum-docs Ready Ready Preview Apr 23, 2026 6:56pm

Request Review

Delete the "Choosing between the two settings" subsection and its table that compared node.resource-mgmt.mem-free-limit and node.block-validator.memory-free-limit. Cleans up the Nitro memory management docs by removing the redundant/outdated comparison.
@a-thomas-22 a-thomas-22 marked this pull request as ready for review March 19, 2026 07:28
Comment thread docs/run-arbitrum-node/nitro/05-nitro-memory-management.mdx Outdated
Copy link
Copy Markdown
Contributor

@pete-vielhaber pete-vielhaber left a comment

Choose a reason for hiding this comment

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

LGTM

@pete-vielhaber pete-vielhaber merged commit 699fff6 into master Apr 23, 2026
7 checks passed
@pete-vielhaber pete-vielhaber deleted the at/affectionate-mahavira branch April 23, 2026 19:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants