文档中心

容器服务

请输入

日志管理

采集控制面组件日志

容器服务支持采集集群控制面组件日志，帮助您排查 kube-apiserver、kube-scheduler、etcd 等核心组件的运行异常。本文介绍如何开启控制面组件日志采集，并查看采集结果。

说明

开启控制面组件日志，会产生相关费用。详细计费说明，请参见日志服务产品计费。

背景信息

支持采集的组件

容器服务支持采集多个控制面组件的日志，帮助您了解控制面关键组件的运行状态，并为集群异常排查提供参考。目前支持采集的组件，如下表所示。

组件	说明
kube-apiserver	kube-apiserver 组件暴露 Kubernetes API 接口的控制面组件。任何资源的请求和调用都是通过该组件进行的。详情请参见官网文档。
kube-scheduler	kube-scheduler 组件主要负责整个集群资源的调度功能。详情请参见官网文档。
kube-controller-manager	kube-controller-manager 组件是集群的管理和自动化控制中心，负责管理集群中众多类型的控制器，例如：Node Controller（节点控制器）、Replication Controller（副本控制器）等。详情请参见官网文档。
etcd	etcd 是 Kubernetes 的存储服务，负责存储集群的重要信息。详情请参见官网文档。
cluster-autoscaler	cluster-autoscaler 组件是节点弹性伸缩组件，负责实现集群资源的弹性伸缩。详情请参见节点自动伸缩（Cluster AutoScaler）。
karpenter	karpenter 组件是节点即时弹性伸缩组件，负责实现集群资源的弹性伸缩。详情请参见节点即时弹性（Karpenter）。

自动生成的日志主题

开启控制面组件日志采集后，系统会为对应组件自动生成日志主题。了解各组件对应的日志主题命名格式，有助于您在日志服务中快速定位目标主题并查询相关日志。各组件对应的日志主题命名格式，如下表所示。

说明

控制面组件日志主题默认日志存储时长为 30 天，日志分区数量为 2 个。同时默认开启自动分裂日志分区。更多日志主题相关说明，请参见日志主题。

删除集群后，对应的日志主题不会被删除。如需删除，请在日志服务控制台手动删除。

组件	自动生成的日志主题名称
kube-apiserver	vke-apiserver-<your_clusterid>-xxxxxx
kube-scheduler	vke-scheduler-<your_clusterid>-xxxxxx
kube-controller-manager	vke-kcm-<your_clusterid>-xxxxxx
etcd	vke-etcd-<your_clusterid>-xxxxxx
cluster-autoscaler	vke-ca-<your_clusterid>-xxxxxx
karpenter	vke-ka-<your_clusterid>-xxxxxx

前提条件

已开通日志服务。若未开通，请登录日志服务控制台，根据控制台向导提示，开通服务。

（可选）已在日志服务中创建日志项目。详细操作，请参见日志项目。

操作步骤

登录容器服务控制台。

在左侧导航栏中，选择集群，单击目标集群名称，进入集群管理页面。

在左侧导航栏中，选择日志中心，并选择控制面组件日志页签。

单击设置，配置控制面组件日志采集。

配置项	说明
控制面组件日志	配置需要采集日志的控制面组件。勾选：采集该组件的日志。开启后，需要指定组件日志保持的日志项目。未勾选：不再采集该组件的日志，但已生成的日志主题不会被删除，仍可能计费。如果不再需要，请前往日志服务控制台手动删除。详细操作，请参见删除日志主题。说明开启组件日志采集后，系统会自动生成对应组件的日志主题。详情请参见自动生成的日志主题。由于 cluster-autoscaler 组件和 karpenter 组件互斥，不能在集群中同时安装。因此，采集组件日志时，也不能同时开启这两个组件的日志采集。
日志使用类型	选择需要使用的日志类型，包括：使用已有日志项目：使用日志服务中已经创建好的项目，组件的日志将会写入该项目。自动创建新日志项目：自动创建新的日志项目。组件的日志会写入新创建的项目。注意更换集群控制面组件日志的日志项目，会同步更换集群审计日志的日志项目，请谨慎操作。详情请参见集群审计。系统自动创建的日志项目，项目名称为 vke-k8s-log-{clusterId}。
所属项目	在下拉菜单中选择日志的所属项目。详情请参见项目管理。
日志项目	在下拉菜单中选择控制面组件日志写入的日志项目。也支持在下拉菜单中单击创建日志项目，创建新的日志项目。详情请参见日志项目。

单击确定，完成配置。

结果验证

控制面组件日志采集功能配置完成后，可以在配置界面中查看采集到的日志信息。

在日志中心页面中，选择控制面组件日志页签。

在组件选择下拉菜单中，选择需要查看日志的控制面组件，即可查看到相关的日志信息。

若页面中已展示所选组件的日志内容，说明控制面组件日志采集已生效。

若暂未看到日志，请等待数分钟后刷新页面再次查看。

最近更新时间：2026.08.19 15:40:32

这个页面对您有帮助吗？

有用

无用