Skip to content

Add node tuning and monitoring guide#3178

Open
anegg0 wants to merge 1 commit intonitro-cli-guidefrom
nitro-cli/node-tuning
Open

Add node tuning and monitoring guide#3178
anegg0 wants to merge 1 commit intonitro-cli-guidefrom
nitro-cli/node-tuning

Conversation

@anegg0
Copy link
Copy Markdown
Contributor

@anegg0 anegg0 commented Mar 26, 2026

Summary

  • New how-to page covering memory management, cache tuning, validator config, metrics, and monitoring
  • Merges content from existing 05-nitro-memory-management.mdx (original by @athomas) into this comprehensive guide
  • Adds new sections: validator tuning (GOMEMLIMIT, GOMAXPROCS), metrics/Prometheus setup, health check patterns, concrete tuning recipes (32 GB / 128 GB / 16 GB)

Post-merge action needed

After the parent PR (#3174) merges to master, 05-nitro-memory-management.mdx should be cleaned up:

  1. Update all internal links pointing to it
  2. Remove from sidebars.js
  3. Delete the file

Content gap tracking

  • TW-694: Node hardware requirements
  • TW-692: Node operations runbook (partial)

Test plan

  • Page renders correctly at /run-arbitrum-node/nitro/node-tuning-and-monitoring
  • yarn lint:markdown passes
  • Memory management content accurately merged from existing page
  • Tuning recipe numbers are reasonable (verify GOMEMLIMIT calculations)

Part of #3174

Merge all content from the existing memory management page
(allocators, cache config, GOMEMLIMIT calculation) and add new
sections: validator tuning, metrics/monitoring, health checks,
and sized example configurations (32 GB full, 128 GB archive,
16 GB validator).
@vercel
Copy link
Copy Markdown

vercel bot commented Mar 26, 2026

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

Project Deployment Actions Updated (UTC)
arbitrum-docs Ready Ready Preview Mar 26, 2026 11:54pm

Request Review

@athomas
Copy link
Copy Markdown

athomas commented Mar 27, 2026

  • Merges content from existing 05-nitro-memory-management.mdx (original by @athomas) into this comprehensive guide

I have no idea what this is did not have part in creating this. No idea why my GitHub account is mentioned here :)

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.

I don't find 0.05 reference for this one on nitro codebase, but found it on community helm chart codebase. (Also this is disabled by default)
We should add a note mention this is a community helm chart behavior.

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.

Same as above (should be a community helm chart behavior)

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

Labels

Needs SME review slop starter Generated draft to start from

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants