prefer-align-cpus-by-uncore-cache blog

add prefer-align-cpus-by-uncorecache blog post

Author: wongchar

content/en/blog/_posts/2025-xx-xx-prefer-align-cpus-by-uncore-cache-beta/c2c_latency.png

@@ -0,0 +1,57 @@
+---
+layout: blog
+title: 'Kubernetes v1.34: Introducing CPU Manager Static Policy Option for Uncore Cache Alignment'
+date: 2025-xx-xx
+slug: prefer-align-by-uncore-cache-cpumanager-static-policy-optimization
+author: Charles Wong (AMD)
+---
+
+A new CPU Manager Static Policy Option called `prefer-align-cpus-by-uncorecache` was introduced in Kubernetes v1.32 as an alpha feature and has graduated to beta in Kubernetes v1.34. This new CPU Manager Policy Option is designed to optimize performance for specific workloads running on processors with a split uncore cache architecture.
+
+## Understanding the feature
+
+### What is Split Uncore Cache Architecture
+Split uncore caches (also referred to as last-level-caches) is an architectural design available for x86 and ARM based processors. Instead of a large monolithic uncore cache uniformly shared across all cores, a split uncore cache architecture divides the cache into separate segments that are aligned with specific CPU groupings.
+![architecture_diagram](./mono_vs_split_uncore.png)
+
+### Benefit of the feature
+The matrix below shows the [cpu-to-cpu latency](https://github.com/nviennot/core-to-core-latency) measured in nanoseconds when passing a packet between CPUs via its cache coherence protocol on a split uncore cache processor.
+![cpu_to_cpu_latency](./c2c_latency.png)
+Blue entries in the matrix represent latency between CPUs sharing the same uncore cache, while grey entries indicate latency between CPUs corresponding to different uncore caches. Latency between CPUs that correspond to different caches are higher than the latency between CPUs that belong to the same cache.
+
+With `prefer-align-cpus-by-uncorecache` enabled, the static CPU Manager will allocate CPU resources for a container such that all CPUs assigned to a container share the same uncore cache. This policy operates on a best-effort basis, aiming to minimize the distribution of a container's CPU resources across uncore caches, based on the container's requirements and allocatable resources on the node.
+
+By concentrating CPU resources within a single or minimal number of uncore cahes, applications running on processors with split uncore caches can benefit from reduced cache latency (as seen in the matrix above) and reduced contention against other workloads, resulting in higher throughput.
+
+## Use cases
+Common use cases can include telco applications like vRAN, Mobile Packet Core, and Firewalls. It's important to note that the optimization provided by `prefer-align-cpus-by-uncorecache` is dependent on the workload. For example, applications that are memory bandwidth bound may not benefit from uncore cache alignment, as utilizing more uncore caches can increase memory bandwidth access.  
+
+## Enabling the feature
+To enable this feature, set the CPU Manager Policy to `static` and enable the CPU Manager Policy Options with `prefer-align-cpus-by-uncorecache`.
+
+For version 1.34, the feature is in the beta stage and will require `CPUManagerPolicyBetaOptions` to also be enabled.
+
+Append the following to the kubelet configuration file:
+```yaml
+kind: KubeletConfiguration
+apiVersion: kubelet.config.k8s.io/v1beta1
+featureGates:
+  ...
+  CPUManagerPolicyBetaOptions: true
+cpuManagerPolicy: "static"
+cpuManagerPolicyOptions:
+  prefer-align-cpus-by-uncorecache: "true"
+reservedSystemCPUs: "0"
+...
+```
+Remove the `cpu_manager_state` file and restart kubelet.
+
+`prefer-align-cpus-by-uncorecache` can be enabled on nodes with a monolithic uncore cache processor. The feature will mimic a best-effort socket alignment effect and will pack CPU resources on the socket similar to the default static CPU Manager policy.
+
+## Further reading
+Please see [Node Resource Managers](/content/en/docs/concepts/policy/node-resource-managers.md) to learn more about the CPU Manager and the available Policy Options.
+
+Please see the [Kubernetes Enhancement Proposal](https://github.com/kubernetes/enhancements/tree/master/keps/sig-node/4800-cpumanager-split-uncorecache) for more information on how `prefer-align-cpus-by-uncorecache` is implemented.
+
+## Getting involved
+This feature is driven by [SIG Node](https://github.com/Kubernetes/community/blob/master/sig-node/README.md). If you are interested in helping develop this feature, sharing feedback, or participating in any other ongoing SIG Node projects, please attend the SIG Node meeting for more details.