访问 TOS 的过程中会产生大量的访问日志。日志存储功能支持将 TOS 的访问日志以文件的形式保存到指定的存储桶中，便于您进行审计对账、排查问题。本文介绍存储日志文件的规则、日志参数、开启日志存储功能的操作步骤等内容。

注意事项

请确保目标存储桶已创建且容量充足，并已授予 TOS 写入权限。若目标存储桶不存在、容量不足或缺少写入权限，日志将无法上传，且对应日志会被丢弃。

存储日志文件的目标存储桶必须与访问日志来源存储桶处于同一账号下，并且位于相同地域。

当前仅华北2（北京）和华东2（上海）支持日志存储功能。

日志存储功能开启后，预计在 24 小时内生成日志文件，某个时段的日志文件可能不会完整记录该时段的所有请求，部分请求可能会出现在相邻时段的日志文件中。

日志存储规则

开启日志存储功能后，TOS 会每间隔 5 分钟生成一次日志文件，每次可能生成多个日志文件。如果在这期间，源存储桶没有访问日志，则不会生成日志文件。生成日志文件后，日志文件会按照以下规则命名：

参数说明如下：

参数	说明
Prefix	日志前缀，您可以在开启日志存储功能时自定义设置。
SourceBucket	日志来源存储桶的名称。
YYYY-MM-DD-HH-MM-SS	日志生成的时间，分别为年、月、日、小时、分钟和秒。
UniqueString	系统自动生成的日志唯一字符串。

日志字段说明

TOS 会通过日志服务采集访问请求的 Time、Object 等字段，并记录在日志文件中。日志每 5 分钟生成一次，一条记录为一行，每条记录包含多个字段，字段之间以逗号分隔，日志示例如下：

示例中参数说明如下：

序号	参数	示例值	说明
1	Time	2024-05-14T16:15:09+08:00	TOS 收到请求的时间。
2	Object	aaa.jpg	请求的对象名称。
3	Bucket	bucketname	存储桶名称。
4	RequestId	61fd011dad9ff187681dad9f-b77xxxx-1uDI5f-GBM-cgb-tos-front-mtaz-c1	请求 ID。
5	ObjectSize	1164596	请求的对象大小。单位：字节。
6	VersionId	102332212244	请求的对象版本号。
7	Operation	GetBucketMirror	请求的操作类型。
8	RemoteIp	10.1.25x.xxx	请求来源 IP。
9	BucketLocation	cn-beijing	请求的地域
10	StorageClass	STANDARD	TOS Bucket 的存储类型，取值说明如下： STANDARD：标准存储。 IA: 低频存储。 ARCHIVE_FR：归档闪回存储。 ARCHIVE: 归档存储。 COLD_ARCHIVE：冷归档存储。 DEEP_COLD_ARCHIVE：深度冷归档存储。
11	Host	test.tos-cn-beijing.volces.com	请求访问域名。
12	HTTPMethod	GET	请求方法。
13	HTTPStatus	200	请求返回的状态。
14	HTTPSchema	https	请求协议，包括 HTTP 和 HTTPS。
15	RequestSize	1164596	请求头中 Content-Length 的值，单位：字节。
16	ResponseSize	0	响应头中 Content-Length 的值，单位：字节。
17	DeltaDataSize	1164596	请求对存储量的改变（Bytes），说明如下：正值：表示该请求增加了存储量。上传对象的操作将增加存储量。负值：表示该请求减少了存储量。彻底删除对象的操作将减少存储量。
18	HistoricalVersionDeltaSize	209351	请求对历史版本对象存储量的改变（Bytes），说明如下：正值：表示该请求增加了历史版本对象的存储量。开启版本控制情况下上传时覆盖对象、为对象添加删除标记操作会增加历史版本对象的存储量。负值：表示该请求减少了历史版本对象的存储量。在无最新版本对象的场景下删除对象的删除标记、彻底删除历史对象操作会减少历史版本对象的存储量。说明您可以通过 DeltaDataSize 和 HistoricalVersionDeltaSize 计算请求对最新版本对象存储存储量的改变，计算公式如下：最新版本对象存储量的改变＝ DeltaDataSize - HistoricalVersionDeltaSize
19	RequestUri	/fdgfdgsf?acl	HTTP 请求的 URI，包括 query-string。
20	CostTime	17	TOS 服务器处理本次请求所花的时间，单位：毫秒。
21	UserAgent	curl/7.15.5	HTTP 的 User-Agent 头。
22	Referer	x.example.com	请求的 HTTP Referer。
23	OwnerId	200000xxxx	TOS 存储桶拥有者的账号 ID。
24	RequesterId	200000xxxx	请求者的账号 ID，如果是匿名访问，则显示为短划线（-）。
25	AccessKeyId	AKTP07cMTfZg0nvA3R1I194IY8SVyUjl5Yxxxx	请求者的 AccessKey ID。
26	RequesterUserName	user1	请求者的用户名。
27	RequestSourceType	cdn	同步请求类型，取值说明如下： -（短划线）：一般请求。 cdn：CDN 回源。 crr-sync：跨区域复制。 lifecycle：生命周期规则。 accelerate：传输加速。
28	ErrorCode	NoSuchBucket	TOS 返回的错误码。
29	MirrorSourceStatus	0	回源场景下源站返回的状态码。
30	ECCode	0010-00000021	EC 错误码。
31	LogVersion	2.0	日志文件中对象名称的编码方式，取值说明如下： 1.0 ：日志文件中的对象名称未进行任何编码处理。 2.0 ：日志文件中的对象名称进行了 URL 编码。
32	RespTime	35	响应时间，即从接受请求到响应第一个字节的时间，单位为毫秒。
33	TrashPath	.Trash/20250912023000/tree.png	HNS 桶开启回收站功能后，被删除对象在回收站中的存储路径。
34	MRAPAlias	m941ea886xxxx-mrap	多区域接入点别名。
35	MRAPDstEndpoint	arctic.tos-cn-beijing.volces.com	通过多区域接入点访问 TOS ，在源桶对象不存在时，回源的目标存储桶的桶域名。
36	MRAPDstRegion	cn-beijing	通过多区域接入点访问 TOS ，在源桶对象不存在时，回源的目标存储桶所在地域。
37	MRAPDstBucket	DstBucket	通过多区域接入点访问 TOS ，在源桶对象不存在时，回源的目标存储桶名称。
38	MRAPSrcRegion	cn-shanghai	通过多区域接入点访问 TOS 时，请求被路由的源地域。
39	MRAPSrcBucket	SrcBucket	通过多区域接入点访问 TOS 时，请求被路由的源桶。
40	StorageTier	INFREQUENT	智能分层对象所在层级，取值说明如下： FREQUENT：智能分层高频访问层。 INFREQUENT：智能分层低频访问层。 ARCHIVEFR：智能分层归档闪回访问层。
41	Payer	BucketOwner	请求的付费方，取值说明如下： BucketOwner：存储桶拥有者付费。 Requester：请求者付费。
42	TargetStorageClass	ARCHIVE_FR	目标对象的存储类型，仅当 Operation 字段为 TransferObject 或 CopyObject 时，才会返回该字段，说明如下：如果 Operation 字段为 TransferObject ，则 TargetStorageClass 字段表示使用生命周期规则转换对象存储类型时，对象转换后的存储类型。如果 Operation 字段为 CopyObject ，则 TargetStorageClass 字段表示复制对象时，新对象的存储类型。

开启日志存储

前提条件

使用日志存储功能转存访问日志时，TOS 对象存储需要向您的存储桶读写文件。若您的目标存储桶开启了服务端加密功能，您需要授予 TOS 对象存储服务访问您的 KMS 服务的权限，以便 TOS 对象存储可以使用 KMS 服务的密钥对日志文件进行加密存储。因此首次开启日志存储功能时，您需要执行以下操作：

在日志存储页面，授予读写权限处单击点击授权，授予 TOS 对象存储对存储桶的读写权限。

在日志存储页面，授予 KMS 权限处单击点击授权，授予 TOS 对象存储服务访问您的 KMS 服务的权限。

操作步骤

登录对象存储控制台。

在左侧导航栏单击桶列表，在桶列表页面单击目标桶名称。

在左侧导航栏，单击日志管理。

在日志管理页面，单击日志存储页签。

在日志存储页签下，单击编辑，配置以下参数。

参数	说明
当前状态	选择启用。
目的存储桶	选择存储日志文件的目标存储桶，只能选择同一账号下，且与源存储桶位于同一地域的存储桶。注意如果目标存储桶的读写权限是公共读或公共写，会存在日志文件泄漏的风险，请谨慎设置。
日志前缀	日志文件在目标存储桶的存储路径。例如设置日志前缀为 tos-accesslog，则日志文件会存储在 tos-accesslog/SourceBucket/YYYY-MM-DD-HH-MM-SS 路径下，文件名为系统自动生成的字符串。关于文件命名规则，请参见存储规则。

完成设置后，单击确定。

关闭日志存储

登录对象存储控制台。

在左侧导航栏单击桶列表，在桶列表页面单击目标桶名称。

在左侧导航栏，单击日志管理。

在日志管理页面，单击日志存储页签。

在日志存储页签下，单击编辑，设置当前状态为关闭，然后单击确定。