alicloud-monitor-controller is an ACK system component that integrates your cluster with Alibaba Cloud observability services—Managed Service for Prometheus, Simple Log Service (SLS), and CloudMonitor. It synchronizes observability configurations—including alert rules—and manages their full lifecycle.
Features
Alert configuration management: Provides the alert management feature in ACK with flexible alert settings.
Rule synchronization: Syncs default alert configurations deployed in the cluster and alert rules defined in AckAlertRule CustomResourceDefinitions (CRDs) to Managed Service for Prometheus, SLS, and CloudMonitor.
Lifecycle management: Manages alert configurations across their full lifecycle.
Upgrade considerations
When you open the Alerts page, ACK checks whether alicloud-monitor-controller is on the latest version and prompts you to upgrade if it is not. During an upgrade, the system also upgrades the default AckAlertRule CustomResource (CR) to the latest version and resynchronizes alert rules.
If you previously used Advanced Configuration to navigate to a monitoring service and manually modified an official ACK alert rule, the system overwrites your custom changes with the official ACK alert rule template during the upgrade.
To preserve custom alert rule changes after an upgrade, define your alert rules using CRs instead of modifying official ACK alert rules through Advanced Configuration.
Usage
For instructions on configuring alerts, see Alert management.
Release notes
February 2026
| Version | Image | Release date | Changes | Impact |
|---|---|---|---|---|
| v1.8.9 | registry.{REGION}.aliyuncs.com/acs/alicloud-monitor-controller:v1.8.8-c22ff94-aliyun | 2026-02-27 | Added Cluster node low-level system event anomaly alert rule to the default alert rule template. Upgraded AckAlertRule CR version to v1.0.18. | Adds new alert rules to existing enabled rule sets and inherits notification recipient groups from existing configurations. If you previously used Advanced Configuration to manually modify an official ACK alert rule, the system overwrites your custom changes with the official ACK alert rule template. |
July 2025
| Version | Image | Release date | Changes | Impact |
|---|---|---|---|---|
| v1.8.8 | registry.{REGION}.aliyuncs.com/acs/alicloud-monitor-controller:v1.8.8-c22ff94-aliyun | 2025-07-25 | CloudMonitor-based alert rules can now be configured using CRs for more flexible monitoring. ACK dedicated clusters support security hardening using ECS instance metadata hardened mode. For more information, see Enforce hardened mode when accessing ECS instance metadata. | No impact on workloads. |
December 2023
| Version | Image | Release date | Changes | Impact |
|---|---|---|---|---|
| v1.8.5 | registry.{REGION}.aliyuncs.com/acs/alicloud-monitor-controller:v1.8.5-88ba904-aliyun | 2023-12-25 | ACK One and registered clusters are automatically configured with default alert rules across different network environments. | No impact on workloads. |
August 2023
| Version | Image | Release date | Changes | Impact |
|---|---|---|---|---|
| v1.8.4 | registry.{REGION}.aliyuncs.com/acs/alicloud-monitor-controller:v1.8.4-d2d72d6-aliyun | 2023-08-14 | Role-Based Access Control (RBAC) permissions are now limited. Default alert rules can be configured for ACK One and registered clusters. | No impact on business operations. |
July 2023
| Version | Image | Release date | Changes | Impact |
|---|---|---|---|---|
| v1.8.3 | registry.{REGION}.aliyuncs.com/acs/alicloud-monitor-controller:v1.8.3-d2d72d6-aliyun | 2023-07-25 | Nodes with ARM architecture are now supported. SLS alert rules are localized—you can choose a notification language or let the system select one based on your site. | No impact on workloads. |
February 2023
| Version | Image | Release date | Changes | Impact |
|---|---|---|---|---|
| v1.8.0-7c28347-aliyun | registry.{REGION}.aliyuncs.com/acs/alicloud-monitor-controller:v1.8.0-7c28347-aliyun | 2023-02-24 | The ACK alert center now supports DingTalk, WeCom, and Lark as notification methods. Default alert rules for audit logs are supported. | No impact on workloads. |
July 2022
| Version | Image | Release date | Changes | Impact |
|---|---|---|---|---|
| v1.6.5-2c5c836-aliyun | registry.{REGION}.aliyuncs.com/acs/alicloud-monitor-controller:v1.6.5-2c5c836-aliyun | 2022-07-07 | Alibaba Cloud internal networks are now supported. Fixed alert rules failing to sync due to network issues. Fixed the alert rule synchronization logic in Managed Service for Prometheus. Patched vulnerabilities in the component image. | No impact on workloads. |
April 2022
| Version | Image | Release date | Changes | Impact |
|---|---|---|---|---|
| v1.6.1-aa20856-aliyun | registry.{REGION}.aliyuncs.com/acs/alicloud-monitor-controller:v1.6.1-aa20856-aliyun | 2022-04-15 | Default alert rules in Managed Service for Prometheus are supported, including rules for key cluster components and workloads. The default alert rule for OS kernel crashes on cluster nodes is supported. Cluster environments without Internet access are now supported. | No impact on services. |
March 2022
| Version | Image | Release date | Changes | Impact |
|---|---|---|---|---|
| v1.5.15-ed0a4c72-aliyun | registry.{REGION}.aliyuncs.com/acs/alicloud-monitor-controller:v1.5.15-ed0a4c72-aliyun | 2022-03-02 | Fixed alert rules failing to sync in certain situations. Patched vulnerabilities in the component image. | No impact on workloads. |
November 2021
| Version | Image | Release date | Changes | Impact |
|---|---|---|---|---|
| v1.5.13-6990db0e-aliyun | registry.{REGION}.aliyuncs.com/acs/alicloud-monitor-controller:v1.5.13-6990db0e-aliyun | 2021-11-04 | Default alert rules for basic cluster resources are supported by the ACK alert center. | No impact on workloads. |
August 2021
| Version | Image | Release date | Changes | Impact |
|---|---|---|---|---|
| v1.5.12-f7aedb4a-aliyun | registry.{REGION}.aliyuncs.com/acs/alicloud-monitor-controller:v1.5.12-f7aedb4a-aliyun | 2021-08-23 | Alerting configurations optimized. | No impact on workloads. |
| v1.5.10-a75e4ee2-aliyun | registry.{REGION}.aliyuncs.com/acs/alicloud-monitor-controller:v1.5.10-a75e4ee2-aliyun | 2021-08-19 | Alerting configurations optimized. | No impact on business operations. |
April 2021
| Version | Image | Release date | Changes | Impact |
|---|---|---|---|---|
| v1.5.7-e1d5de8a-aliyun | registry.{REGION}.aliyuncs.com/acs/alicloud-monitor-controller:v1.5.7-e1d5de8a-aliyun | 2021-04-23 | Event alerting is supported. Configure alerts based on Kubernetes events using CRDs. | No impact on workloads. |
July 2020
| Version | Image | Release date | Changes | Impact |
|---|---|---|---|---|
| v1.4.0-49ff2362-aliyun | registry.{REGION}.aliyuncs.com/acs/alicloud-monitor-controller:v1.4.0-49ff2362-aliyun | 2020-07-24 | Metric collection now works in clusters with both Windows and Linux node pools. Elastic sensitivity is adjustable to 15s, 20s, 30s, or 60s. Fixed Horizontal Pod Autoscaler (HPA) being triggered during rolling updates. | No impact on business operations. |
Troubleshooting
No application group appears in CloudMonitor
Check the following:
Verify that the alicloud-monitor-controller pod is running normally in the
kube-systemnamespace.Check the component version. If it is not the latest version, upgrade it.
Check the alicloud-monitor-controller logs for connection timeout errors and SDK errors.
No data appears in the CloudMonitor application group
Check the following:
Verify that the instance name in the application group matches the pod name of the application.
If the instance name does not match, follow the troubleshooting steps for "No application group appears in CloudMonitor" above.
If the instance name matches the pod name, continue to the next step.
Verify that the metrics-server component pod is running normally.
Check the metrics-server logs. If the log contains
Successful write 164190 bytes metrics to monitor server, data is being collected normally.