设置访问日志
更新时间：2025-06-09
概述
当用户需要跟踪 BOS 的访问请求时可以开启 BOS 日志功能。日志记录功能可以应用在访问统计和安全审核等方面，每条访问日志记录了单个访问请求的详细信息，包括请求者、Bucket 名称、请求时间和请求操作等信息，访问日志格式描述请参见设置访问日志。当一个 Bucket 开启访问日志功能后，会自动将对这个 Bucket 的访问请求，以小时为单位，按照固定的命名规则，生成日志文件写入用户指定的 Bucket。
说明：
- 访问日志存储投递目标 Bucket存在一定延时。大多数情况下，一个访问请求从发生，到对应日志存储到目标 Bucket 会在 2-3 小时内完成。但受到网络环境等因素影响，有的日志可能会延迟较长时间才能存储到目标 Bucket。
- 日志文件与普通文件性质相同，BOS 无法对其进行清除，只能您主动删除不需要的日志文件。若您一直未删，则日志文件一直保留。如果您有定期删除老旧日志文件的需求，建议配置生命周期规则来删除过期文件。
设置访问日志
- 登录 对象存储 BOS 管理控制台。
- 点击 Bucket 列表 ，进入存储桶列表页，点击需要配置的 Bucket 名称进入 Bucket 详情页，您可通过页面存储桶下拉框进行存储桶便捷切换。
- 选择 基础配置 下 日志管理配置 ，对该 Bucket 的日志管理进行配置，默认情况下日志功能不开启。 在日志管理配置页面中，点击 修改配置，日志启动 状态设置为开启，则可进行生成与投递规则进行配置。
配置参数说明
| 参数 | 说明 |
|---|---|
| 日志投递存储桶 | 设置日志生成后投递至的目标存储桶信息，需注意目标存储桶需满足与日志生成存储桶相同地域，您可配置与日志源桶或者其他同地域存储桶进行存储日志 |
| 日志文件前缀 | 设置日志生成后投递的路径信息。前缀可以包含字母，数字，下划线，中划线和斜杠，以字母开头，长度1～64字符 |
| 访问类型 | 默认日志将包含全部请求类型，即读/写/删除操作，读操作：包含请求method为HEAD/GET/OPTIONS，写操作：包含请求methodPOST/PUT；删除操作：包含请求method为DELETE，日志内容您可按需生成，推荐您选择全部操作类型 |
| 访问类型 | 默认日志将包含全部请求类型，即读/写/删除操作，读操作：包含请求method为HEAD/GET/OPTIONS，写操作：包含请求methodPOST/PUT，批量删除操作请求method为POST，特别提示 如需记录批量删除操作，请选择写操作；删除操作：包含请求method为DELETE，日志内容您可按需生成，推荐您选择全部操作类型 |
| 访问来源 | 可用于区分请求类型，包含2种配置：全部访问 与 排除百度智能云CDN服务请求，默认为全部来源，你可排除百度智能云CDN的请求日志 |
注意：
- 日志存储的目标 Bucket 和源 Bucket必须在同地域；
- 日志功能无需额外的收费，只收取日志文件产生的存储费用。日志文件传输不会产生数据传输费，但对已生成的日志文件的访问则与任何其他数据传输同等计费；
- 访问来源默认包含全部来源，建议您保持该配置。
- 访问类型配置，因批量删除操作请求 method 为 POST ，如您需记录批量删除操作，请选择勾选写操作，推荐您采用默认全部访问类型配置
- 单击 确定，保存配置。您可在当前页面查看相应信息并进行修改。
相关 API
- PutBucketLogging 接口：使用 PutBucketLogging API 接口开启 Bucket 的访问日志并指定存放日志的 Bucket 和访问日志的文件前缀。
- GetBucketLogging 接口：使用 GetBucketLogging API 接口获取某个 Bucket 的访问日志配置情况。
- DeleteBucketLogging 接口：使用 DeleteBucketLogging API 接口关闭 Bucket 访问日志记录功能。