From c8dd3b5c6a5d269dbd6287ec5ce9aa2a9f5da92d Mon Sep 17 00:00:00 2001
From: Akanksha Gawai <280726545+agawai@users.noreply.github.com>
Date: Sun, 30 Aug 2026 23:10:12 +0530
Subject: [PATCH] OSDOCS-21417: add schedstats kernel arg to memory overcommit
 MachineConfig

Signed-off-by: Akanksha Gawai <280726545+agawai@users.noreply.github.com>
---
 modules/virt-enabling-higher-vm-workload-density.adoc | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/modules/virt-enabling-higher-vm-workload-density.adoc b/modules/virt-enabling-higher-vm-workload-density.adoc
index c0959c59ba5..f64667a5700 100644
--- a/modules/virt-enabling-higher-vm-workload-density.adoc
+++ b/modules/virt-enabling-higher-vm-workload-density.adoc
@@ -66,10 +66,14 @@ spec:
             RequiredBy=kubelet-dependencies.target
           enabled: true
           name: swap-provision.service
+  kernelArguments:
+    - schedstats=enable
 ----
 +
 Set the `SWAP_SIZE_MB` value to the amount of swap space to provision on the node, in MB. Adjust this value by using the formula that follows.
 +
+The `schedstats=enable` kernel argument enables scheduler statistics that virtualization observability dashboards use, such as vCPU wait metrics. This kernel argument adds a minor additional load to the scheduler.
++
 Ensure that the provisioned swap space is at least equal to the overcommitted RAM. Calculate the amount of swap space to provision on a node by using the following formula:
 +
 ----