文档中心

日志服务

TOS 日志采集

采集 TOS 日志

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

功能概述

对象存储 TOS 基于日志服务基础能力提供 TOS 日志分析功能，实时记录 TOS 资源的访问信息，适用于云资源操作审计、热度统计、异常场景的问题排查与事件回溯等场景。

TOS 日志分析功能实时记录 TOS 中所有资源的访问信息，包括每次访问请求的账号、Bucket 名称、操作类型、来源 IP 地址等信息。开启访问日志功能后，日志将存储在日志服务的指定日志主题中，您可以通过日志检索分析功能进行实时检索与 SQL 分析，了解相关访问事件的变化趋势，也可以基于 SQL 分析语句搭建仪表盘、配置监控告警。

TOS 日志分析功能相关配置如下：

配置	说明
日志类型	TOS 访问日志。
日志存储位置	开通 TOS 日志分析功能之后，日志服务会在当前地域下创建 TOS 日志专属的日志项目与日志主题。详情请参考管理 TOS 日志资源。专属日志项目：tos-log-<accountID>-<region name> 专属日志主题：tos-log-topic
日志保存时长	默认为 7 天，日志超期后将被自动删除。您也可以根据业务需求修改日志保存时长。
日志分区	预设 2 个分区。默认开启自动分裂，在写入流量较大时日志服务会自动分裂分区以满足数据写入需求。
索引设置	已配置所有字段的索引。
日志字段	详细的日志字段列表请参考 TOS 日志字段。

采集 TOS 日志

费用说明

开启 TOS 日志分析功能后，将产生日志存储、索引存储、写流量、索引流量、服务请求次数、日志分区数量等费用。如果对 TOS 专属日志主题进行加工、投递、消费等操作，将产生内网读流量、公网读流量、数据加工流量、数据投递流量等费用。费用由日志服务单独收取，详情请参见计费概述。

使用限制

TOS 日志分析功能的专属日志主题仅用于存储功能相关的日志数据，不支持写入其他数据、修改索引配置、删除日志主题等涉及资源变更的操作。检索分析、日志转储、日志消费、仪表盘与监控告警等功能上无特殊限制。

采集 TOS 日志步骤

支持为已创建的或新创建存储桶时，开启日志分析功能，详情可参考日志分析。

说明

以创建存储桶时开启日志分析为例：

登录对象存储控制台，在左侧导航栏单击桶列表。

在页面左上方单击创建桶，展开高级设置，打开日志分析开关，单击确定。

TOS 日志字段

每一条存储桶的访问请求都会记录一条访问日志，详细的日志字段如下：

名称	说明
LogType	日志类型，固定为 tos_access_log。
Time	TOS 收到请求的时间。
RequestId	请求 ID。
Bucket	TOS Bucket 名称。
Object	请求的 Object Key。
ObjectSize	请求的 Object Size。单位：字节。
VersionId	请求的 Object 的版本号。
Operation	访问的操作类型。
RemoteIp	请求来源 IP。
BucketLocation	TOS Bucket所在的区域。
StorageClass	TOS Bucket的存储类型，取值说明如下： STANDARD：标准存储。 IA: 低频存储。 ARCHIVE_FR：归档闪回存储。 ARCHIVE: 归档存储。 COLD_ARCHIVE：冷归档存储。 DEEP_COLD_ARCHIVE：深度冷归档存储。
Host	请求访问域名。
HTTPMethod	HTTP 请求方法。
HTTPStatus	HTTP 请求返回的状态。
HTTPSchema	HTTP 请求协议，包括 HTTP 和 HTTPS。
RequestSize	请求头中 Content-Length 的值，单位：字节。
ResponseSize	响应头中 Content-Length 的值，单位：字节。
DeltaDataSize	请求对存储量的改变（Bytes），说明如下：正值：表示该请求增加了存储量。上传对象的操作将增加存储量。负值：表示该请求减少了存储量。彻底删除对象的操作将减少存储量。
HistoricalVersionDeltaSize	请求对历史版本对象存储量的改变（Bytes），说明如下：正值：表示该请求增加了历史版本对象的存储量。开启版本控制情况下上传时覆盖对象、为对象添加删除标记操作会增加历史版本对象的存储量。负值：表示该请求减少了历史版本对象的存储量。在无最新版本对象的场景下删除对象的删除标记、彻底删除历史对象操作会减少历史版本对象的存储量。
RequestUri	HTTP 请求的 URI，包括 query-string。
CostTime	TOS 服务器处理本次请求所花的时间，单位：毫秒。
UserAgent	HTTP 的 User-Agent 头。
Referer	请求的 HTTP Referer。
OwnerId	TOS Bucket 拥有者的账号 ID。
RequesterId	请求者的账号 ID，如果是匿名访问，则显示为短划线（-）。
AccessKeyId	请求者的 AccessKey ID。
RequesterUserName	请求者的用户名。
RequestSourceType	同步请求类型，取值说明如下：短划线（-）：一般请求。 cdn：CDN回源。 crr-sync：跨区域复制。 lifecycle：生命周期规则。 accelerate：传输加速。
ErrorCode	TOS 返回的错误码。
ReservedFiled	保留字段，显示为-。
MirrorSourceStatus	回源场景下源站返回的状态码。
ECCode	EC 错误码。
RespTime	响应时间，即从接受请求到响应第一个字节的时间，单位为毫秒。
TrashPath	HNS 桶开启回收站功能后，被删除对象在回收站中的存储路径。
MRAPAlias	多区域接入点别名。
MRAPDstEndpoint	通过多区域接入点访问 TOS ，在源桶对象不存在时，回源的目标存储桶的桶域名。
MRAPDstRegion	通过多区域接入点访问 TOS ，在源桶对象不存在时，回源的目标存储桶所在地域。
MRAPDstBucket	通过多区域接入点访问 TOS ，在源桶对象不存在时，回源的目标存储桶名称。
MRAPSrcRegion	通过多区域接入点访问 TOS 时，请求被路由的源地域。
MRAPSrcBucket	通过多区域接入点访问 TOS 时，请求被路由的源桶。
StorageTier	智能分层对象所在层级，取值说明如下： FREQUENT：智能分层高频访问层。 INFREQUENT：智能分层低频访问层。 ARCHIVEFR：智能分层归档闪回访问层。
Payer	请求的付费方，取值说明如下： BucketOwner：存储桶拥有者付费。 Requester：请求者付费。
TargetStorageClass	目标对象的存储类型，仅当 Operation 字段为 TransferObject 或 CopyObject 时，才会返回该字段，说明如下：如果 Operation 字段为 TransferObject ，则 TargetStorageClass 字段表示使用生命周期规则转换对象存储类型时，对象转换后的存储类型。如果 Operation 字段为 CopyObject ，则 TargetStorageClass 字段表示复制对象时，新对象的存储类型。

最近更新时间：2026.02.03 14:53:41

这个页面对您有帮助吗？

有用

无用