最近更新时间：2023.11.17 12:36:44
首次发布时间：2022.12.15 23:27:41
TOS 支持日志分析功能，支持通过日志服务，检索分析您访问 TOS 过程中产生的访问日志。本文介绍日志分析功能相关的前提条件及操作步骤。
关于日志服务的功能说明，请参见什么是日志服务。
使用日志分析功能前，请确保您已完成以下操作：
已开通日志服务功能。
已授权 TOS 访问火山引擎日志服务 TLS。如果您之前已授权 TOS 访问 TLS，则无需重复授权。
日志分析功能目前处于邀测状态，如您需要使用该功能，请联系客户经理。
邀测期间，TOS 免费提供最近 7 天内的 TOS 实时日志查询，7 天之后开始计费，日志服务的计费详情，请参见计费概述。
邀测结束后的计费时间及计费标准会另行通知，请您及时关注相应信息及产品公告。
开启日志分析功能后，日志服务会自动创建日志项目及主题存放 TOS 的相关日志。
| 名称 | 示例 | 说明 |
|---|---|---|
| LogType | tos_access_log | 日志类型，固定为 tos_access_log。 |
| Time | 2022-05-14T16:15:09+08:00 | TOS 收到请求的时间。 |
| RequestId | 879b4ce26e62835b | 请求 ID。 |
| Bucket | test | TOS Bucket 名称。 |
| Object | object1 | 请求的 Object Key。 |
| ObjectSize | 1024 | 请求的 Object Size。 单位：字节。 |
| VersionId | 102332212244 | 请求的 Object 的版本号。 |
| Operation | PutObject | 访问的操作类型。 |
| RemoteIp | 192.168.0.1 | 请求来源 IP。 |
| BucketLocation | cn-beijing | TOS Bucket所在的区域。 |
StorageClass | STANDARD | TOS Bucket的存储类型，取值说明如下：
|
| Host | test.tos-cn-beijing.volces.com | 请求访问域名。 |
| HTTPMethod | PUT | HTTP 请求方法。 |
| HTTPStatus | 200 | HTTP 请求返回的状态。 |
| HTTPSchema | HTTP | HTTP 请求协议，包括 HTTP 和 HTTPS。 |
| RequestSize | 1024 | 请求头中 Content-Length 的值，单位：字节。 |
| ResponseSize | 0 | 响应头中 Content-Length 的值，单位：字节。 |
| DeltaDataSize | 1024 | 请求对存储量的改变（Bytes）。 |
| RequestUri | /fdgfdgsf?acl | HTTP 请求的 URI，包括 query-string。 |
| CostTime | 12 | TOS 服务器处理本次请求所花的时间，单位：毫秒。 |
| UserAgent | curl/7.15.5 | HTTP 的 User-Agent 头。 |
| Referer | *.example.com | 请求的 HTTP Referer。 |
| OwnerId | 200000**** | TOS Bucket 拥有者的账号 ID。 |
| RequesterId | 200000**** | 请求者的账号 ID，如果是匿名访问，则显示为短划线（-）。 |
| AccessKeyId | AKAKAKAKAKAKAKAK | 请求者的 AccessKey ID。 |
| RequesterUserName | user1 | 请求者的用户名。 |
RequestSourceType | cdn | 同步请求类型 ，取值说明如下：
|
| ErrorCode | NoSuchBucket | TOS 返回的错误码。 |
| ReservedFiled | - | 保留字段，显示为 -。 |
本章节介绍为不同状态的存储桶开启日志分析的操作步骤。
登录对象存储控制台。
在左侧导航栏单击桶列表，在桶列表页面左上方单击创建桶。
在创建存储桶页面，展开高级设置，打开日志分析开关。
说明
创建存储桶时的其他参数说明，请参见创建存储桶。
单击确定。
说明
开启日志分析后，您可以在日志管理页面的检索分析页签，检索分析对象存储相关访问日志，关于检索分析的详细说明，请参见检索分析。
登录对象存储控制台。
单击左侧导航栏中的桶列表，单击目标桶名称。
单击左侧导航栏中的日志管理，在日志管理页面，单击编辑。
打开日志分析的开关，单击确定。
说明
开启日志分析后，您可以在日志管理页面的检索分析页签，检索分析对象存储相关访问日志，关于检索分析的详细说明，请参见检索分析。
当您不需要再查看 TOS 的日志信息时，您可以关闭日志分析功能。本章节介绍关闭日志分析功能的操作步骤。
注意
开启日志分析时，会自动创建日志项目和主题，但关闭日志分析后，日志项目和主题不会自动删除。为了避免关闭关联日志后继续产生日志项目费用，建议您在关闭关联日志前，先在日志服务删除日志项目。
在日志管理页面进行关闭关联日志的操作时，会弹出对话框提示该存储桶对应的日志项目 ID，您可以根据该 ID 删除该存储桶对应的日志项目和主题。具体操作，请参见删除日志主题和删除日志项目。
登录对象存储控制台。
单击左侧导航栏中的桶列表，单击目标桶名称。
单击左侧导航栏中的日志管理，在日志分析页面，单击关闭关联日志。
在弹出的对话框中，单击确定。
TOS 的日志默认保存 7 天。保存天数超过 7 天的部分，会产生日志服务产品的费用，计费规则，请参见日志服务计费说明。如果您需要延长日志的保存时间，您可以参考以下步骤设置。
登录对象存储控制台。
单击左侧导航栏中的桶列表，单击目标桶名称。
单击左侧导航栏中的日志管理，在日志分析页面，单击设置日志保存时间。
在弹出的对话框中，单击具体时间，单击确定。
说明
自定义数据保存时间支持 1~3650 天。