访问 TOS 的过程中会产生大量的访问日志。日志存储功能支持将 TOS 的访问日志以文件的形式保存到指定的存储桶中，便于您进行审计对账、排查问题。本文介绍存储日志文件的规则、日志参数、开启日志存储功能的操作步骤等内容。 ## 注意事项 * 存储日志文件的目标存储桶必须与访问日志来源存储桶处于同一账号下，并且位于相同地域。 * 当前仅华北2（北京）和华东2（上海）支持日志存储功能。 * 日志存储功能开启后，预计在 24 小时内生成日志文件，某个时段的日志文件可能不会完整记录该时段的所有请求，部分请求可能会出现在相邻时段的日志文件中。 ## 日志存储规则开启日志存储功能后，TOS 会每间隔 5 分钟生成一次日志文件，每次可能生成多个日志文件。如果在这期间，源存储桶没有访问日志，则不会生成日志文件。生成日志文件后，日志文件会按照以下规则命名： ```Plain Prefix/SourceBucket/YYYY-MM-DD-HH-MM-SS/UniqueString ``` * Prefix：日志前缀，您可以在开启日志存储功能时自定义设置。 * SourceBucket：日志来源存储桶的名称。 * YYYY\-MM\-DD\-HH\-MM\-SS ：日志生成的时间，分别为年、月、日、小时、分钟和秒。 * UniqueString：系统自动生成的日志唯一字符串。 ## 日志字段说明 TOS 会通过日志服务采集访问请求的 `Time`、`Object` 等字段，并记录在日志文件中。日志每 5 分钟生成一次，一条记录为一行，每条记录包含多个字段，字段之间以逗号分隔，日志示例如下： :::tip 批量删除时，TOS 会先生成一条包含详细信息的请求日志（DeleteObjects），然后再为每个删除对象单独生成一条简要日志（DeleteObject）。 ::: ```Plain "2025-05-28T15:51:17.883+08:00","","bucketname","fe650136c07534886836****-b2edeef-1uKBZF-HB-cgb-tos-front-mtaz-c1","0","","HeadBucket","10.4.**.**","cn-beijing","STANDARD","bucketname.tos-cn-beijing.volces.com","HEAD","200","https","","0","0","0","/test-mlf2/","3","Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36","","214748****","214748****","AKTP234ZAVqgvZSNpYPAmCg4reblp2qKXJW4TUFcJwo****","root","-","","0","" ``` |**序号** |**参数** |**示例值** |**说明** | |---|---|---|---| |1 |Time |2024\-05\-14T16:15:09+08:00 |TOS 收到请求的时间。 | |2 |Object |aaa.jpg |请求的对象名称。 | |3 |Bucket |bucketname |存储桶名称。 | |4 |RequestId |61fd011dad9ff187681dad9f\-b77\*\*\*\*\-1uDI5f\-GBM\-cgb\-tos\-front\-mtaz\-c1 |请求 ID。 | |5 |ObjectSize |1164596 |请求的对象大小。单位：字节。 | |6 |VersionId |102332212244 |请求的对象版本号。 | |7 |Operation |GetBucketMirror |请求的操作类型。 | |8 |RemoteIp |10.1.25\*.\*\*\* |请求来源 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），说明如下：|\ | | | ||\ | | | |* 正值：表示该请求增加了历史版本对象的存储量。开启版本控制情况下上传时覆盖对象、为对象添加删除标记操作会增加历史版本对象的存储量。|\ | | | |* 负值：表示该请求减少了历史版本对象的存储量。在无最新版本对象的场景下删除对象的删除标记、彻底删除历史对象操作会减少历史版本对象的存储量。|\ | | | ||\ | | | |:::tip|\ | | | |您可以通过 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 |\*.example.com |请求的 `HTTP Referer`。 | |23 |OwnerId |200000\*\*\*\* |TOS 存储桶拥有者的账号 ID。 | |24 |RequesterId |200000\*\*\*\* |请求者的账号 ID，如果是匿名访问，则显示为短划线（\-）。 | |25 |AccessKeyId |AKTP07cMTfZg0nvA3R1I194IY8SVyUjl5Y\*\*\*\* |请求者的 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 |1.0 |日志文件中对象名称的编码方式，取值说明如下：|\ | | | ||\ | | | |* 1.0 ：日志文件中的对象名称未进行任何编码处理。|\ | | | |* 2.0 ：日志文件中的对象名称进行了 URL 编码。 | |32 |RespTime |35 |响应时间，即从接受请求到响应第一个字节的时间，单位为毫秒。 | |33 |TrashPath |.Trash/20250912023000/tree.png |HNS 桶开启回收站功能后，被删除对象在回收站中的存储路径。 | |34 |MRAPAlias |m941ea886\*\*\*\*\-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 服务的权限。 ### 操作步骤 1. 登录[对象存储控制台](https://console.volcengine.com/tos)。 2. 在左侧导航栏单击**桶列表**，在**桶列表**页面单击目标桶名称。 3. 在左侧导航栏，单击**日志管理。** 4. 在**日志管理**页面，单击**日志存储**页签。 5. 在**日志存储**页签下，单击**编辑**，配置以下参数。 |**参数** |**说明** | |---|---| |当前状态 |选择**启用**。 | |目的存储桶 |选择存储日志文件的目标存储桶，只能选择同一账号下，且与源存储桶位于同一地域的存储桶。|\ | |:::warning|\ | |如果目标存储桶的读写权限是公共读或公共写，会存在日志文件泄漏的风险，请谨慎设置。|\ | ||\ | |:::| |日志前缀 |日志文件在目标存储桶的存储路径。|\ | |例如设置日志前缀为 tos\-accesslog，则日志文件会存储在 `tos-accesslog/SourceBucket/YYYY-MM-DD-HH-MM-SS` 路径下，文件名为系统自动生成的字符串。关于文件命名规则，请参见[存储规则](/docs/6349/1471117#6f993b78)。 | 6. 完成设置后，单击**确定。** ## 关闭日志存储 1. 登录[对象存储控制台](https://console.volcengine.com/tos)。 2. 在左侧导航栏单击**桶列表**，在**桶列表**页面单击目标桶名称。 3. 在左侧导航栏，单击**日志管理。** 4. 在**日志管理**页面，单击**日志存储**页签。 5. 在**日志存储**页签下，单击**编辑**，设置**当前状态**为**关闭**，然后单击**确定**。