metrics-server

Updated at:

Built on the open-source Metrics Server, this offline monitoring add-on collects pod CPU and memory metrics and exposes them through the Metrics API for HPA scaling and basic resource monitoring.

Usage notes

metrics-server provides container basic resource monitoring. For more information, see [Discontinued] Basic resource monitoring.

If you encounter an issue when using the metrics-server add-on, read FAQ about metrics-server first for troubleshooting.

Release notes

June 2026

Version Image address Release date Description Impact
v0.3.14-079483b-aliyun registry.{REGION}.aliyuncs.com/acs/metrics-server:v0.3.14-079483b-aliyun June 2026 Aligned the calculation of allocated container resources (requests) with the bin-packing logic of the Kubernetes scheduler. Fixed an issue where the allocated node resources displayed for init containers and sidecar containers did not match the scheduler's actual allocation. No impact on workloads.

February 2026

Version Image address Release date Description Impact
v0.3.12-08c15e8-aliyun registry.{REGION}.aliyuncs.com/acs/metrics-server:v0.3.12-08c15e8-aliyun February 2026
  • Added basic resource monitoring for Hybrid nodes in hybrid cloud node pools.
  • Added support for displaying the resource usage of each workload in the workload list of the Container Service for Kubernetes (ACK) console through an aggregation API.
No impact on workloads.

January 2024

Version Image address Release date Description Impact
v0.3.9.7-85b3699-aliyun registry.{REGION}.aliyuncs.com/acs/metrics-server:v0.3.9.7-85b3699-aliyun January 2024
  • Optimized monitoring performance for large-scale clusters.
  • Stabilized Horizontal Pod Autoscaler (HPA) scaling during rolling updates. To enable, set --enable-hpa-rolling-update-skipped=true. For more information, see FAQ about node auto scaling.
No impact on workloads.

June 2023

Version Image address Release date Description Impact
v0.3.9.5-1e8461a-aliyun registry.{REGION}.aliyuncs.com/acs/metrics-server:v0.3.9.5-1e8461a-aliyun June 2023
  • Improved add-on security.
  • Reduced unnecessary log output.
No impact on workloads.

May 2023

Version Image address Release date Description Impact
v0.3.9.4-ff225cd-aliyun registry.{REGION}.aliyuncs.com/acs/metrics-server:v0.3.9.4-ff225cd-aliyun May 2023 Compatible with ACK clusters running Kubernetes 1.26. No impact on workloads.

March 2023

Version Image address Release date Description Impact
v0.3.9.3-ff225cd-aliyun registry.{REGION}.aliyuncs.com/acs/metrics-server:v0.3.9.3-ff225cd-aliyun March 2023 Fixed: metrics not collected from virtual nodes in ACK Edge clusters. No impact on workloads.
v0.3.9.3-628a248-aliyun registry.{REGION}.aliyuncs.com/acs/metrics-server:v0.3.9.3-628a248-aliyun February 2023 Fixed: transient CPU metric spikes that may occur when pod monitoring data collection is interrupted. No impact on workloads.

July 2022

Version Image address Release date Description Impact
v0.3.9-d554015-aliyun registry.{REGION}.aliyuncs.com/acs/metrics-server:v0.3.9-d554015-aliyun July 2022
  • Patched security vulnerabilities.
  • Compatible with ACK clusters running Kubernetes 1.22.
No impact on workloads.

May 2022

Version Image address Release date Description Impact
v0.3.8.7-307cf45-aliyun registry.{REGION}.aliyuncs.com/acs/metrics-server:v0.3.8.5-307cf45-aliyun May 2022 Compatible with ACK clusters running Kubernetes 1.22. No impact on workloads.

February 2022

Version Image address Release date Description Impact
v0.3.8.6-307cf45-aliyun registry.{REGION}.aliyuncs.com/acs/metrics-server:v0.3.8.5-307cf45-aliyun February 2022 Compatible with ACK clusters running Kubernetes 1.22 and earlier. No impact on workloads.

May 2021

Version Image address Release date Description Impact
v0.3.8.5-307cf45-aliyun registry.{REGION}.aliyuncs.com/acs/metrics-server:v0.3.8.5-307cf45-aliyun May 2021
  • Supports ACK clusters that run Kubernetes versions earlier than 1.20.
  • Supports container basic resource monitoring in the new CloudMonitor.
No impact on workloads.

April 2021

Version Image address Release date Description Impact
v0.2.2-b4bf266-aliyun registry.{REGION}.aliyuncs.com/acs/metrics-server:v0.2.2-b4bf266-aliyun April 2021
  • Added metric collection for Windows and Linux nodes.
  • Added support for adjusting the scaling sensitivity in four tiers: 15s, 20s, 30s, and 60s.
  • Fixed: HPA adds excess pods during rolling updates.
Updating the add-on to the latest version is recommended.