文档中心

日志服务

VKE 日志采集

采集 VKE 日志

本文档介绍 VKE 日志相关的功能介绍、使用限制等。

功能概述

容器服务 VKE 基于火山引擎日志服务，提供日志功能，包括容器日志数据采集，关键字查询、SQL 分析等多种功能。

通过日志功能，将容器服务的日志与事件存储到日志服务中，以达到持久化存储的目的。当集群发生故障后，您也可以从日志服务中查看过去的日志信息，进行故障排查，详情可参考容器服务日志概述。

容器服务集群支持多种资源的日志采集，包括容器日志、组件日志、控制面组件日志等。

采集对象	说明
容器日志	容器标准输出：容器标准输出是指将容器中的日志发送到容器的标准输出设备（Stdout）和标准错误设备（Stderr）。这两个标准输出设备，实际上就是容器的控制台终端。容器文件路径：除了容器标准输出设备，大部分应用会将应用日志写入固定路径下的 log 文件中。您可以通过指定容器内的日志文件路径，获取指定容器的日志。例如：容器服务将 GPU Xid 相关信息输出到 Pod 的日志文件/var/log/xid.log中。可以通过该路径获取日志，观测 Xid 出现的时间和具体信息，帮助进行 GPU 设备故障排查。
ingress 组件日志	支持采集 ingress 组件的标准输出日志，并发送至日志服务进行保存和检索。
控制面组件日志	支持采集控制面主要组件的日志，用于了解集群控制面的状态和记录。

开启实时日志功能后，日志将存储在日志服务的指定日志主题中，您可以通过日志检索分析功能进行实时检索与 SQL 分析，也可以基于 SQL 分析语句搭建仪表盘、配置监控告警。

VKE 容器日志功能相关配置如下：

配置	说明
日志类型	容器日志。
日志存储位置	在日志服务控制台手动/自动创建的日志项目与日志主题，管理日志资源详情请参考管理 VKE 日志资源。专属日志项目：自定义专属日志主题：自动创建或自定义
日志保存时长	默认为 30 天，日志超期后将被自动删除。您也可以根据业务需求修改日志保存时长。
日志分区	容器日志预设 2 个分区，组件日志预设 1 个分区。默认开启自动分裂，在写入流量较大时日志服务会自动分裂分区以满足数据写入需求。
索引设置	已配置所有字段的索引。
日志字段	详细的日志字段列表请参考 VKE 日志字段。

采集 VKE 日志

VKE 日志字段

容器日志/组件日志字段

字段	说明
bytes_sent	当前请求返回给客户端的响应体字节数。
request_time	从接收到请求到发送完整响应所花费的总时间。
status	HTTP 状态码。例如 200、404、500，用来判断请求是否成功以及失败类型。
request_length	HTTP 请求的总长度。
time	日志事件发生的时间戳，即服务器处理该请求的时间。
remote_addr	客户端 IP 地址。
x_forward_for	X-Forwarded-For 头部，记录经过各级代理时的原始客户端 IP 链路。
request_id	请求的唯一标识 ID。
remote_user	经过 HTTP 认证后的远程用户标识。
vhost	虚拟主机名。
request_proto	请求使用的协议版本。
request_query	URL 中的查询字符串部分。
method	HTTP 方法，例如 GET、POST、PUT、DELETE 等。
http_referrer	HTTP Referer 头。
http_user_agent	客户端 User-Agent 字符串，标识浏览器、SDK 或调用方类型和版本等。
content	原始日志内容或请求/响应的文本信息。
namespace	Pod 所在的 Kubernetes 命名空间。
pod_name	Pod 名称，用于定位到具体的 Pod 实例。
pod_uid	Pod 在 Kubernetes 中的唯一 UID。
container_name	容器名称。
host_ip	承载该 Pod 的节点 IP。
container_id	容器运行时分配的容器 ID。
pod_ip	Pod 的业务 IP。
image_name	容器镜像名称。
cluster_id	Kubernetes 集群 ID。

控制面日志字段

字段	说明
annotations	审计事件附加的键值对注解。
apiVersion	审计事件或被操作对象使用的 API 版本。
auditID	审计事件的唯一 ID。
cluster_id	Kubernetes 集群的 ID。
impersonatedUser	Impersonation 用户信息。
kind	审计记录或被操作对象的类型。
level	审计级别。
namespace	资源所在的命名空间。
objectRef	引用信息。
requestObject	客户端请求体中提交的对象内容。
requestReceivedTimestamp	API Server 接收到该请求的时间戳。
requestURI	完整的请求 URI。
responseObject	API Server 返回给客户端的对象内容。
responseStatus	响应状态信息。
sourceIPs	请求来源 IP 列表。
stage	审计事件对应的处理阶段。
stageTimestamp	生成当前审计阶段记录的时间戳。
user	认证用户信息。
userAgent	发起请求的客户端 User-Agent。
verb	Kubernetes 语义上的操作动词，如 get、list、create、update、patch、delete、watch 等，对应资源操作类型。

最近更新时间：2026.07.29 10:43:41

这个页面对您有帮助吗？

有用

无用