文档中心

容器服务

请输入

日志管理

采集容器日志

容器服务集群基于火山引擎日志服务，支持采集集群中的容器日志，包括标准输出日志和文件路径日志。本文为您介绍如何配置和查看容器日志。

说明

本文介绍标准容器的日志采集方式，弹性容器（VCI）的日志采集方式，请参见通过日志服务采集 VCI 容器日志。

使用限制

如果您需要采集 JSON 格式的日志，需要将 log-collector 组件升级到 v1.2.5 及以上版本。详情请参见组件发布记录。

前提条件

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

已在日志服务中创建日志项目和日志主题。详情请参见日志项目和日志主题。

已安装 log-collector 组件，详情请参见安装组件。

说明

若未安装组件，日志中心页面会通过横幅提示您安装该组件。请根据界面提示完成 log-collector 组件的安装。

操作步骤

容器服务支持采集容器的标准输出（Stdout）、标准错误（Stderr）和文本日志。操作步骤如下：

登录容器服务控制台。

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

在左侧导航栏中选择日志中心，并选择日志采集规则页签。

单击新建采集规则，配置容器日志采集规则。

选择日志空间：配置 IAM 项目、日志项目和日志主题。配置完成后，单击下一步：采集规则。

采集规则：配置容器日志的采集规则，包括日志采集类型和采集目标。配置完成后，单击下一步：检查索引配置。

说明

本文仅介绍配置采集规则时的常见必选配置，更多配置项说明，详情请参见采集容器标准输出、采集容器文本日志。

标准输出日志

容器文本日志

容器服务支持采集容器的标准输出（Stdout）和标准错误（Stderr）日志。

配置项	说明
配置基础信息
规则别名	配置采集规则名称。单击导入其他采集配置，允许将其他已创建的采集配置，导入到当前配置中。
容器日志采集	勾选启用，开启容器日志采集。
采集类型	选择容器日志采集类型，支持 K8s 容器标准输出、K8s 容器文本日志。本例中选择 K8s 容器标准输出。
采集信息	选择容器日志采集信息，包括：标准输出 - stdout 和标准错误 - stderr。
通用容器采集规则	使用容器的通用信息来指定日志采集对象和内容。具体参数说明，请参见采集容器标准输出。说明未配置通用容器采集规则时，表示采集集群中所有容器的日志。
K8s 采集规则	使用 Kubernetes 容器信息来指定日志采集对象和内容。具体参数说明，请参见采集容器标准输出。说明未配置 K8s 采集规则时，表示采集集群中所有容器的日志。
配置日志格式
采集模式	配置解析日志文件的模式，您可以根据实际业务场景选择对应的采集模式，并配置指定模式下的日志解析规则。不同模式的说明和详情，请参见如下文档：单行全文模式 JSON 模式分隔符模式多行全文模式单行完整正则模式多行完整正则模式 NGINX 配置模式

检查索引配置：根据页面提示，按需设置或更新索引，您也可以单击导入已有索引配置，导入其他日志主题的索引。

若此日志主题未设置索引，可以参考配置索引进行设置。

若此日志主题已设置索引，可以根据采集规则中解析的日志字段判断是否需要更新索引。

说明

启用索引后，您才能检索分析采集到的日志数据。

更新后的索引设置仅对后续写入的新数据生效。其他检索分析的使用说明及限制请参考检索概述和分析概述。

单击提交，完成配置。

结果验证

在集群管理页面的左侧导航栏中，单击日志中心。

选择容器日志页签，并指定日志项目和日志主题，即可查看当前集群的容器日志。

说明

日志检索和分析语法，请参见检索语法、分析语法。

图表分析语法，请参见检索分析图表。

输入索引内容，例如__pod_name__ : "log-collector-lptnx" ，并选择检索时间范围，单击搜索，即可查看指定容器的日志。

其他配置

采集数据过滤

在日志采集的过程中，存在着大量低价值或无关日志（如 DEBUG/INFO 级别日志），不仅造成存储资源浪费、增加成本，还影响查询效率。因此，您可以通过精细化过滤策略实现高效、安全的日志采集。

基于采集规则进行过滤

基于内容进行过滤

您可以在配置采集规则时，基于容器元信息（如容器名称、容器 Label、容器环境变量等）或 Kubernetes 容器信息（命名空间、工作负载类型、工作负载名称等）设置采集条件，精准控制采集哪些容器的日志。配置步骤如下：

配置采集规则时，根据需要勾选启用通用容器采集规则或 K8s 采集规则，并配置采集规则详情。

采集规则	配置说明
通用容器采集规则	容器名称：配置待采集的容器名称。支持正则匹配，例如配置容器名称为 ^(container-demo)$，表示采集所有名称为 container-demo 的容器。容器 Label 黑白名单：支持基于容器 Label 指定采集的目标容器。容器环境变量黑白名单：支持基于容器环境变量指定采集的目标容器。
K8s 采集规则	Namespace：待采集的命名空间名称，支持正则匹配。例如设置 Namespace 名称为^default$，表示采集 default 命名空间下的所有容器。工作负载类型：通过工作负载的类型指定采集的容器，包括无状态负载、有状态负载、守护进程、任务和定时任务。工作负载名称：通过工作负载的名称指定待采集的容器。支持正则匹配。例如设置工作负载名称为 ^(http.*)$，表示采集以 http 开头的工作负载下面的所有容器。 Pod Label 黑白名单：支持基于 Pod Label 指定待采集的容器。 Pod Annotation 黑白名单：支持基于 Pod Annotation 指定待采集的容器。 Pod 名称匹配规则：配置待采集的 Pod 名称。支持正则匹配，例如设置 Pod 名称为 ^(container-test)$，表示采集所有名称为 container-test 的 Pod。

管理采集规则

在集群管理页面的左侧导航栏中，单击日志中心，选择日志采集规则页签，即可查看采集规则。

单击采集规则列表中操作列的编辑或删除，允许更新或删除采集规则。

操作	说明
编辑	更新已有的日志采集规则。
删除	删除已有的日志采集规则。注意若已升级 log-collector 组件至 v1.1.0 及以上版本，则此处删除日志采集规则后，会同步删除日志服务控制台上的关联采集规则，请谨慎操作。若未升级 log-collector 组件，则此处删除日志采集规则后，不涉及日志服务控制台内容。

最近更新时间：2026.01.05 11:07:49

这个页面对您有帮助吗？

有用

无用