Skip to content

Documentation updates for k8s Node swap monitoring and troubleshooting. Target: 1.34 #51153

Open
@ajaysundark

Description

@ajaysundark

This is a Feature Request

What would you like to be added

  • The "Resource Management for Pods and Containers" page should be updated:
    a section for Swap alongside CPU and Memory.

  • Explain how to view configured limits

  • Explain how to view usage via kubectl top pod, kubectl top node and monitoring tools (Prometheus, etc.) querying swap relevant metrics (eg: container_swap_usage_bytes)

  • Explain how to interpret swap-related Events and Node conditions

  • Explain how to troubleshoot “I configured swap, but it doesn’t swap”

  • Explain how to troubleshoot noisy neighbour issues

*Explain swap and disk IO metrics relationships

Why is this needed

Provide clear visibility into swap configuration and usage at both the node and pod levels for different user personas (admins, app owners) and enable effective tuning. Kubernetes NodeSwap feature has implications on workload performance and it's important to improve documentation for clear visibility and troubleshooting.

Comments
/sig node
/language en

Metadata

Metadata

Assignees

Labels

kind/featureCategorizes issue or PR as related to a new feature.language/enIssues or PRs related to English languageneeds-triageIndicates an issue or PR lacks a `triage/foo` label and requires one.sig/nodeCategorizes an issue or PR as relevant to SIG Node.

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions