OpsCanary
kubernetesobservabilityPractitioner

Kubernetes v1.37: Metrics API Stabilization and Its Impact

5 min read Kubernetes BlogAug 27, 2026Reviewed for accuracy
Share
PractitionerHands-on experience recommended

The promotion of the metrics.k8s.io API to stable in Kubernetes v1.37 is a game changer for cluster monitoring. This API allows you to retrieve CPU and memory usage metrics for both nodes and Pods, which is essential for making informed decisions about resource allocation and autoscaling. With commands like kubectl top, you can easily access this data, which is vital for maintaining optimal performance in production environments.

The Metrics API operates through the API aggregation layer and requires an implementation, such as metrics-server, to function. To utilize the v1 metrics API, your chosen implementation must serve the v1.metrics.k8s.io API, and you must register an associated APIService. This setup ensures that you can efficiently query metrics data, enabling features like resource-metrics-based autoscaling. For example, you can run kubectl get --raw /apis/metrics.k8s.io/v1/nodes to fetch node metrics or kubectl get --raw /apis/metrics.k8s.io/v1/namespaces/default/pods for Pod metrics, including a per-container breakdown.

In production, leveraging the metrics.k8s.io API effectively can lead to significant performance improvements. Since it has been in the ecosystem since Kubernetes v1.6, it has matured through alpha and beta stages, ensuring stability and reliability. You don’t need to enable any feature gates, making it straightforward to implement. Just ensure that your metrics implementation is correctly configured and registered to take full advantage of this API's capabilities.

Key takeaways

  • Utilize the metrics.k8s.io API for real-time CPU and memory metrics.
  • Implement metrics-server or a compatible solution to access the v1 metrics API.
  • Run commands like `kubectl get --raw /apis/metrics.k8s.io/v1/nodes` for node metrics.
  • Use `kubectl top` to monitor resource usage effectively.
  • No feature gates are required to enable the Metrics API.

Why it matters

This stabilization means you can rely on the metrics.k8s.io API for critical monitoring and autoscaling tasks, enhancing your cluster's performance and resource management.

Code examples

Bash
kubectl get --raw /apis/metrics.k8s.io/v1/nodes
Bash
kubectl get --raw /apis/metrics.k8s.io/v1/namespaces/default/pods
Bash
kubectl get apiservice v1.metrics.k8s.io

When NOT to use this

The official docs don't call out specific anti-patterns here. Use your judgment based on your scale and requirements.

Want the complete reference?

Read official docs

Test what you just learned

Quiz questions written from this article

Take the quiz →
Linux FoundationSponsor

Industry-standard certifications built by the people behind Linux and Kubernetes. Earn the CKA — the gold standard Kubernetes administrator cert. OpsCanary readers get 30% off year-round with code OPSCANARY3.

Get CKA certified →

Get the daily digest

One email. 5 articles. Every morning.

No spam. Unsubscribe anytime.