Edit This Page

Pod Overhead

When you run a Pod on a Node, the Pod itself takes an amount of system resources. These resources are additional to the resources needed to run the container(s) inside the Pod. Pod Overhead is a feature for accounting for the resources consumed by the pod infrastructure on top of the container requests & limits.

• Pod Overhead
• What's next

Pod Overhead

In Kubernetes, the pod’s overhead is set at admission time according to the overhead associated with the pod’s RuntimeClass.

When Pod Overhead is enabled, the overhead is considered in addition to the sum of container resource requests when scheduling a pod. Similarly, Kubelet will include the pod overhead when sizing the pod cgroup, and when carrying out pod eviction ranking.

Set Up

You need to make sure that the PodOverhead feature gate is enabled (it is off by default) across your cluster. This means:

• in kube-schedulerControl plane component that watches for newly created pods with no assigned node, and selects a node for them to run on.
• in kube-apiserverControl plane component that serves the Kubernetes API.
• in the kubeletAn agent that runs on each node in the cluster. It makes sure that containers are running in a pod. on each Node
• in any custom API servers that use feature gates

Note: Users who can write to RuntimeClass resources are able to have cluster-wide impact on workload performance. You can limit access to this ability using Kubernetes access controls. See Authorization Overview for more details.

What's next

• RuntimeClass
• PodOverhead Design

Feedback

Was this page helpful?

Thanks for the feedback. If you have a specific, answerable question about how to use Kubernetes, ask it on Stack Overflow. Open an issue in the GitHub repo if you want to report a problem or suggest an improvement.