The alibaba-cloud-metrics-adapter component collects metrics from your cluster. Horizontal Pod Autoscaler (HPA) can scale your application pods based on the collected metrics. This topic describes how to deploy alibaba-cloud-metrics-adapter in a registered cluster in the Container Service for Kubernetes (ACK) console.


An external Kubernetes cluster is registered in the ACK console. For more information, see Create a cluster registration proxy and register an on-premises cluster.

Background information

In Kubernetes, metrics are collected to monitor resources. In addition, HPA scales the number of pods based on the collected metrics. To meet the diverse monitoring requirements of developers, Kubernetes defines APIs that are used to collect the following types of metrics: resource metrics, custom metrics, and external metrics.
  • Resource metrics are collected by using the metrics-server component. The collected metrics are used to monitor the usage of Kubernetes resources, such as pods, nodes, and namespaces.
  • Custom metrics are collected by using Application Real-Time Monitoring Service (ARMS) Prometheus. HPA scales application pods based on the collected custom metrics.
  • External metrics are collected by using the external metrics API provided by the cloud service provider. These metrics are used to monitor the external environment. For example, you can monitor the queries per second (QPS) to an Ingress and use HPA to scale application pods when the QPS exceeds the scaling threshold.


  1. Log on to the ACK console.
  2. In the left-side navigation pane of the ACK console, choose Marketplace > App Catalog.
  3. On the Marketplace page, click the App Catalog tab. Find and click ack-alibaba-cloud-metrics-adapter.
  4. On the ack-alibaba-cloud-metrics-adapter page, click Deploy.
  5. In the Deploy wizard, select a cluster and namespace, and then click Next.
    Use the default values for the Namespace and Release Name parameters.
  6. On the Parameters wizard page, set the parameters and click OK.
    Parameter Description
    AccessKeyId The AccessKey ID of your Alibaba Cloud account.
    AccessKeySecret The AccessKey secret of your Alibaba Cloud account.
    Region The region where your cluster is deployed, for example, cn-qingdao or ap-southeast-1.
    Note If an Express Connect circuit is deployed between the cluster and the virtual private cloud (VPC) where the cluster resides, the Express Connect circuit is automatically used.