Kubernetes v1.37 graduates the metrics.k8s.io API from v1beta1 to v1, providing stability guarantees for CPU and memory usage data. This transition is a version graduation with no changes to the underlying resource types or collected metrics, maintaining backward compatibility for existing tools like kubectl top.
Key points
The metrics.k8s.io v1 API is now the stable, recommended version for node and pod resource metrics.
The v1 API surface is functionally identical to the previous v1beta1 version.
Transitioning requires the metrics implementation (e.g., metrics-server) to serve the v1 endpoint and register an APIService.
Clients and cluster operators should plan for dual-version support as v1beta1 remains available for backward compatibility.