All Products
Search
Document Center

Container Service for Kubernetes:alicloud-monitor-controller

Last Updated:Jun 23, 2026

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: Enables flexible alert settings through ACK alert management.

  • Rule synchronization: Syncs default alert configurations and AckAlertRule CustomResourceDefinition (CRD) rules to Managed Service for Prometheus, Simple Log Service (SLS), and CloudMonitor.

  • Lifecycle management: Manages alert configurations across their full lifecycle.

Upgrade considerations

To ensure new configurations sync properly, when you open the Alerts page, the system prompts you to upgrade alicloud-monitor-controller to the latest version if it is not current.Alerts page, ACK checks the alicloud-monitor-controller version and prompts you to upgrade if needed. Upgrades also update the default AckAlertRule CustomResource (CR) and resync alert rules.

Important

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.Advanced Configuration, the upgrade overwrites your changes with the official alert rule template.

To preserve custom alert rules after upgrades, define them as CRs instead of modifying official rules through Advanced Configuration.

Usage

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 template. Upgraded AckAlertRule CR to v1.0.18. Adds new alert rules to enabled rule sets and inherits notification recipient groups from existing configurations. If you modified an official ACK alert rule through Advanced Configuration, the upgrade overwrites your changes with the official 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 with CRs for flexible monitoring. ACK dedicated clusters support security hardening with ECS instance metadata hardened mode. 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 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 workloads.

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 ARM architecture nodes are now supported. SLS alert rules are localized—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 ACK alert center now supports DingTalk, WeCom, and Lark notifications. Added default alert rules for audit logs. 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 rule sync failures due to network issues. Fixed alert rule sync logic in Managed Service for Prometheus. Patched component image vulnerabilities. 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 Prometheus alert rules are supported, including rules for key cluster components and workloads. Added default alert rule for OS kernel crashes on cluster nodes. Cluster environments without Internet access are now supported. No impact on workloads.

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 rule sync failures in certain situations. Patched component image vulnerabilities. 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 ACK alert center now supports default alert rules for basic cluster resources. 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 workloads.

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 with 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) triggering during rolling updates. No impact on workloads.

Troubleshooting

No application group appears in CloudMonitor

Check the following:

  1. Verify the alicloud-monitor-controller pod is running in the kube-system namespace.

  2. Check the component version and upgrade if needed.

  3. Check the alicloud-monitor-controller logs for connection timeout errors and SDK errors.

No data appears in the CloudMonitor application group

Check the following:

  1. Verify the instance name in the application group matches the application pod name.

    • If the instance name does not match, follow the troubleshooting steps for "No application group appears in CloudMonitor" above.

    • If they match, continue to the next step.

  2. Verify the metrics-server pod is running.

  3. Check the metrics-server logs. If the log contains Successful write 164190 bytes metrics to monitor server, data collection is working.