ACK streams control plane logs from managed clusters to a Simple Log Service (SLS) project in your account for health monitoring, troubleshooting, and auditing.
Prerequisites
Ensure that you have:
-
A sufficient Logstore quota in SLS
-
An understanding of SLS pay-as-you-go billing — collected logs incur SLS charges
High-volume components such as kube-apiserver can generate significant log data. To manage costs, enable collection only for the components you need.
Supported components and Logstores
Each control plane component logs to a dedicated SLS Logstore. See Kubernetes Components.
| Component | Logstore | Collected by default | Description |
|---|---|---|---|
| kube-apiserver | apiserver | Yes | Exposes the Kubernetes API. |
| kube-controller-manager | kcm | Yes | Runs core Kubernetes control loops. |
| kube-scheduler | scheduler | Yes | Assigns pods to nodes. |
| Cloud Controller Manager | ccm | Yes | Integrates Kubernetes with Alibaba Cloud services such as Classic Load Balancer (CLB) and Virtual Private Cloud (VPC). CLB was formerly known as Server Load Balancer (SLB). |
| controlplane-events | controlplane-events | Yes | Captures control plane events such as out of memory (OOM) kills. |
| ALB Ingress controller | alb | Yes | Provides a unified Ingress entry point for Services based on Application Load Balancer (ALB). |
| cluster-autoscaler | cluster-autoscaler | No | Automatically scales nodes in ACK clusters. |
| ack-goatscaler | ack-goatscaler | No | Provides instant elasticity for ACK nodes. |
| kuberay-operator | kuberay-operator | No | Extends the KubeRay operator with ACK scheduling, elastic quota, and resource priority for Ray cluster management. |
Components marked No in the Collected by default column must be manually enabled. See Update collected components.
Enable log collection
Enable control plane log collection during cluster creation or for existing clusters. See Control Plane Components.
Log collection is enabled by default for Pro clusters. For Basic clusters, enable it manually.
Select an existing SLS Project in the Control Plane Component Logs section.
Enable during cluster creation
-
Follow the steps in Create an ACK managed cluster.
-
Choose Use Existing Project or Create New Project. When you choose Create New Project, an SLS project named k8s-log-{ClusterID} is created automatically. After log collection is enabled, logs from managed control plane components, including kube-apiserver, kube-controller-manager, and kube-scheduler, are sent to SLS.
Enable for an existing cluster
-
Log on to the ACK console. In the left navigation pane, click Clusters.
-
On the Clusters page, click the name of the target cluster. In the left-side pane, choose Operations > Log Center.
-
Click the Control Plane Component Logs tab, then click Enable Component Log Collection.
Query logs
Query control plane logs in the ACK console or SLS console. See Index-based query and analysis for query syntax.
Query in the ACK console
Choose either path:
From the cluster overview:
-
On the cluster details page, click the Basic Information tab.
-
Click View next to Control Plane Component Logs.
-
On the Log Center page, select a component to view its logs.
From the Operations section:
-
In the left navigation pane of the cluster details page, choose Operations > Log Center.
-
Click the Control Plane Component Logs tab, then select a component.
Query in the SLS console
-
Log on to the SLS console.
-
In the Projects section, click the project for your cluster.
-
On the Log Storage > Logstores tab, click the Logstore for the target component.
Update collected components
Add or remove components from log collection at any time.
-
On the Clusters page, click the name of the target cluster. In the left-side pane, choose Operations > Log Center.
-
Click the Control Plane Component Logs tab, then click Update Component.
-
In the dialog box, select or clear components as needed, then click OK.
Clearing all components disables control plane log collection.
Disable log collection
-
On the Clusters page, click the name of the target cluster. In the left-side pane, choose Operations > Log Center.
-
Click the Control Plane Component Logs tab, then click Close.