|
2 | 2 | reviewers:
|
3 | 3 | - fgrzadkowski
|
4 | 4 | - piosz
|
5 |
| -title: Resource metrics pipeline |
| 5 | +title: Resource metrics pipeline |
6 | 6 | content_type: concept
|
7 | 7 | ---
|
8 | 8 |
|
@@ -77,22 +77,23 @@ The architecture components, from right to left in the figure, consist of the fo
|
77 | 77 | * [Metrics API](#metrics-api): Kubernetes API supporting access to CPU and memory used for
|
78 | 78 | workload autoscaling. To make this work in your cluster, you need an API extension server that
|
79 | 79 | provides the Metrics API.
|
80 |
| - |
| 80 | + |
81 | 81 | {{< note >}}
|
82 | 82 | cAdvisor supports reading metrics from cgroups, which works with typical container runtimes on Linux.
|
83 | 83 | If you use a container runtime that uses another resource isolation mechanism, for example
|
84 | 84 | virtualization, then that container runtime must support
|
85 | 85 | [CRI Container Metrics](https://github.com/kubernetes/community/blob/master/contributors/devel/sig-node/cri-container-stats.md)
|
86 | 86 | in order for metrics to be available to the kubelet.
|
87 | 87 | {{< /note >}}
|
88 |
| - |
| 88 | + |
89 | 89 | <!-- body -->
|
90 | 90 |
|
91 | 91 | ## Metrics API
|
| 92 | +{{< feature-state for_k8s_version="1.8" state="beta" >}} |
92 | 93 |
|
93 | 94 | The metrics-server implements the Metrics API. This API allows you to access CPU and memory usage
|
94 | 95 | for the nodes and pods in your cluster. Its primary role is to feed resource usage metrics to K8s
|
95 |
| -autoscaler components. |
| 96 | +autoscaler components. |
96 | 97 |
|
97 | 98 | Here is an example of the Metrics API request for a `minikube` node piped through `jq` for easier
|
98 | 99 | reading:
|
@@ -201,7 +202,7 @@ Memory is reported as the working set, measured in bytes, at the instant the met
|
201 | 202 |
|
202 | 203 | In an ideal world, the "working set" is the amount of memory in-use that cannot be freed under
|
203 | 204 | memory pressure. However, calculation of the working set varies by host OS, and generally makes
|
204 |
| -heavy use of heuristics to produce an estimate. |
| 205 | +heavy use of heuristics to produce an estimate. |
205 | 206 |
|
206 | 207 | The Kubernetes model for a container's working set expects that the container runtime counts
|
207 | 208 | anonymous memory associated with the container in question. The working set metric typically also
|
@@ -264,4 +265,3 @@ curl http://localhost:8080/api/v1/nodes/minikube/proxy/stats/summary
|
264 | 265 | The summary API `/stats/summary` endpoint will be replaced by the `/metrics/resource` endpoint
|
265 | 266 | beginning with metrics-server 0.6.x.
|
266 | 267 | {{< /note >}}
|
267 |
| - |
0 commit comments