概述

当用户需要跟踪 BOS 的访问请求时可以开启 BOS 日志功能。日志记录功能可以应用在访问统计和安全审核等方面，每条访问日志记录了单个访问请求的详细信息，包括请求者、Bucket 名称、请求时间和请求操作等信息，访问日志格式描述请参见设置访问日志。当一个 Bucket 开启访问日志功能后，会自动将对这个 Bucket 的访问请求，以小时为单位，按照固定的命名规则，生成日志文件写入用户指定的 Bucket。

说明：

• 访问日志存储到目标 Bucket 是一个“尽力而为”的过程。大多数情况下，一个访问请求从发生，到对应日志存储到目标 Bucket 会在 2-3 小时内完成。但受到网络环境等因素影响，有的日志可能会延迟较长时间才能存储到目标 Bucket。
• 日志文件与普通文件性质相同，BOS 无法对其进行清除，只能您主动删除不需要的日志文件。若您一直未删，则日志文件一直保留。如果您有定期删除老旧日志文件的需求，建议配置生命周期规则来删除过期文件。

设置访问日志

1. 登录 对象存储 BOS 管理控制台。
2. 在左侧 Bucket 列表中，选择需要设置权限的 Bucket，点击 Bucket 名称进入 Bucket 管理目录。
3. 在上方导航栏选择 配置管理 页签。
4. 在 配置管理 页面中选择 基础配置，在 日志管理 区域点击 修改配置 对该 Bucket 的日志管理进行配置。默认情况下日志功能不开启。

5. 在日志管理配置面板中，将日志启用状态选为开启，并设置当前日志文件存储到的Bucket位置、日志前缀。
6. BOS 支持对日志中记录的访问类型以及访问来源进行自定义设置，默认包含全部访问来源以及访问类型，您可根据需求进行相应调整。

注意：

• 日志存储的目标 Bucket 和源 Bucket必须在同Region；
• 日志功能无需额外的收费，只收取日志文件产生的存储费用。日志文件传输不会产生数据传输费，但对已生成的日志文件的访问则与任何其他数据传输同等计费；
• 日志前缀可以包含字母，数字，下划线，中划线和斜杠，且必须以字母开头，长度1-64位。
• 访问类型默认包含全部类型（读、写、删除操作），建议您选择全部类型。
• 访问来源默认包含全部来源，建议您保持该配置。
• 批量删除操作请求method为POST，如需记录批量删除操作，请选择写操作

6. 设置完成后，点击 确认 完成日志配置。您可在当前页面查看相应信息并进行修改。

相关 API

• PutBucketLogging 接口：使用 PutBucketLogging API 接口开启 Bucket 的访问日志并指定存放日志的 Bucket 和访问日志的文件前缀。
• GetBucketLogging 接口：使用 GetBucketLogging API 接口获取某个 Bucket 的访问日志配置情况。
• DeleteBucketLogging 接口：使用 DeleteBucketLogging API 接口关闭 Bucket 访问日志记录功能。