| 1 | # Kubernetes tab |
| 2 | |
| 3 | The Netdata dashboards feature enhanced visualizations for the resource utilization of Kubernetes (k8s) clusters, embedded in the default [Metrics tab](/docs/dashboards-and-charts/metrics-tab-and-single-node-tabs.md) dashboard. |
| 4 | |
| 5 | These visualizations include a health map for viewing the status of k8s pods/containers, in addition to [Netdata charts](/docs/dashboards-and-charts/netdata-charts.md) for viewing per-second CPU, memory, disk, and networking metrics from k8s nodes. |
| 6 | |
| 7 | See our [Kubernetes deployment instructions](/packaging/installer/methods/kubernetes.md) for details on deploying Netdata on your Kubernetes cluster. |
| 8 | |
| 9 | ## Available Kubernetes metrics |
| 10 | |
| 11 | Netdata Cloud organizes and visualizes the following metrics from your Kubernetes cluster from every container: |
| 12 | |
| 13 | | Metric | Description | |
| 14 | |------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |
| 15 | | `k8s.cgroup.cpu_limit` | CPU utilization as a percentage of the limit defined by the [pod specification `spec.containers[].resources.limits.cpu`](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/#resource-requests-and-limits-of-pod-and-container) or a [`LimitRange` object](https://kubernetes.io/docs/tasks/administer-cluster/manage-resources/cpu-default-namespace/#create-a-limitrange-and-a-pod). | |
| 16 | | `k8s.cgroup.cpu` | CPU utilization of the pod/container. 100% usage equals 1 fully-utilized core, 200% equals 2 fully-utilized cores, and so on. | |
| 17 | | `k8s.cgroup.throttled` | The percentage of runnable periods when tasks in a cgroup have been throttled. | |
| 18 | | `k8s.cgroup.throttled_duration` | The total time duration for which tasks in a cgroup have been throttled. | |
| 19 | | `k8s.cgroup.mem_utilization` | Memory utilization within the configured or system-wide (if not set) limits. | |
| 20 | | `k8s.cgroup.mem_usage_limit` | Memory utilization, without cache, as a percentage of the limit defined by the [pod specification `spec.containers[].resources.limits.memory`](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/#resource-requests-and-limits-of-pod-and-container) or a [`LimitRange` object](https://kubernetes.io/docs/tasks/administer-cluster/manage-resources/cpu-default-namespace/#create-a-limitrange-and-a-pod). | |
| 21 | | `k8s.cgroup.mem_usage` | Used memory, without cache. | |
| 22 | | `k8s.cgroup.mem` | The sum of `cache` and `rss` (resident set size) memory usage. | |
| 23 | | `k8s.cgroup.writeback` | The size of `dirty` and `writeback` cache. | |
| 24 | | `k8s.cgroup.pgfaults` | Sum of page fault bandwidth, which are raised when the Kubernetes cluster tries accessing a memory page that is mapped into the virtual address space, but not actually loaded into main memory. | |
| 25 | | `k8s.cgroup.throttle_io` | Sum of `read` and `write` per second across all PVs/PVCs attached to the container. | |
| 26 | | `k8s.cgroup.throttle_serviced_ops` | Sum of the `read` and `write` operations per second across all PVs/PVCs attached to the container. | |
| 27 | | `k8s.cgroup.net_net` | Sum of `received` and `sent` bandwidth per second. | |
| 28 | | `k8s.cgroup.net_packets` | Sum of `multicast`, `received`, and `sent` packets. | |
| 29 | |
| 30 | When viewing the [overview of this dashboard](#kubernetes-containers-overview), Netdata presents the above metrics per container, or aggregated based on |
| 31 | their associated pods. |
| 32 | |
| 33 | ## Kubernetes Containers overview |
| 34 | |
| 35 | At the top of the Kubernetes containers section, there is a map that with a given context colorizes the containers in terms of their utilization. |
| 36 | |
| 37 | The filtering of this map is controlled by using the [NIDL framework](/docs/dashboards-and-charts/netdata-charts.md#nidl-framework) from the definition bar of the chart. |
| 38 | |
| 39 | ### Detailed information |
| 40 | |
| 41 | Hover over any of the pods/containers in the map to display a modal window, which contains contextual information and real-time metrics from that resource. |