> For the complete documentation index, see [llms.txt](https://docs.infra.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.infra.app/features/cpu-and-memory-utilization.md).

# CPU & memory utilization

View resource utilization for your cluster's applications and nodes

### Overview

Infra App provides real-time information about cluster and workload utilization, so you can identify how resources such as CPU and Memory are being used and reserved across your Kubernetes cluster.

{% hint style="info" %}
**Metrics Server Required**

CPU & memory utilization will work out of the box with most clusters. For real-time usage metrics, you'll need to make sure the official Kubernetes [metrics server](https://github.com/kubernetes-sigs/metrics-server) is installed. Many cloud Kubernetes providers such as GKE include it by default.
{% endhint %}

### Resource utilization

In the main view, Infra App shows the resource utilization of each resource at a glance. Infra App automatically adds up all the resources used by all pods of your resource, so you can view the total footprint of your workload across the cluster:

![](https://2997771214-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Ll2YPh7b5O2frfEMtKk%2F-MKCllG731SQGHVi-1xX%2F-MKCm1GSYbxaZe1aKykr%2Fimage.png?alt=media\&token=9318e1a4-e866-4bb8-8f35-11b7a9b4b135)

**To view top resources by utilization,** click on **CPU Usage** or **Memory Usage** in the table to sort the resources:

![](https://2997771214-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Ll2YPh7b5O2frfEMtKk%2F-MKCllG731SQGHVi-1xX%2F-MKCm8oKrhMKvbC3N7c4%2Fimage.png?alt=media\&token=9806118e-8a76-4e3a-ba1f-ec35de552606)

### Individual resource utilization

By clicking on an individual resource, you can see more details about its CPU & Memory utilization:

![](https://2997771214-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Ll2YPh7b5O2frfEMtKk%2F-MKCllG731SQGHVi-1xX%2F-MKCmHkvoNIgecwizBNS%2Fimage.png?alt=media\&token=da899cb5-e0e0-4442-a177-f2a6a2332636)

{% hint style="info" %}
**Hint:** CPU & Memory Percent is calculated by comparing the workload's usage against (in order):

* Requests (if set)
* Limits (if set)
* Total cluster capacity
  {% endhint %}

To further view a resource's utilization breakdown by pod, the pod table includes the utilization per-pod:

![](https://2997771214-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Ll2YPh7b5O2frfEMtKk%2F-MBuO5tjMC6w8b8esPF1%2F-MBuOYSDRe-Ep7nD2_l-%2FScreen%20Shot%202020-07-10%20at%204.24.02%20PM.png?alt=media\&token=1f286995-7251-4f35-a92f-8ba6031be3be)

### Cluster Utilization

In the utilization view, Infra App shows what percent your Kubernetes cluster's resources are being used:

![](https://2997771214-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Ll2YPh7b5O2frfEMtKk%2F-MKCllG731SQGHVi-1xX%2F-MKCmUhdGGokTDGoGtDy%2Fimage.png?alt=media\&token=c73d8a8c-3bdc-48b2-aa78-61377c06316a)

In this case, the cluster is almost out of CPU requests, meaning that future resources may not be successfully deployed by Kubernetes.

### Node Utilization

In the utilization view, Infra App includes a list of nodes with CPU & Memory utilization included. You can switch between usage, requests and limits to compare different utilization metrics for your nodes.

![](https://2997771214-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Ll2YPh7b5O2frfEMtKk%2F-MKCllG731SQGHVi-1xX%2F-MKCmdEJ_U8uqEpUFEHv%2Fimage.png?alt=media\&token=77c2596c-a2ef-48f7-92ff-4a7803f51b4e)

Clicking on a node in the table, you'll see the node's utilization at a glance:

![](https://2997771214-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Ll2YPh7b5O2frfEMtKk%2F-MKCllG731SQGHVi-1xX%2F-MKCmiop0_NTbZjhFjdf%2Fimage.png?alt=media\&token=e9ce3242-4ecc-4e91-bcf3-d720a9394fa6)

Lastly, a list of pods on the node view can show you how resources are allocated on this node:

![](https://2997771214-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Ll2YPh7b5O2frfEMtKk%2F-MKCllG731SQGHVi-1xX%2F-MKCmmnpAkuLiXAimVG-%2Fimage.png?alt=media\&token=c5104df3-4b96-4d50-97cb-9669161ee28e)
