设置日志查询
更新时间：2026-01-27
概述
访问对象存储 BOS 的过程中会产生大量的访问日志。日志查询功能将 BOS 与日志服务（BLS）相结合， 允许您在 BOS 控制台调用 BLS 服务查询 BOS 的访问日志，可实现对 BOS 操作审计、访问统计、异常事件回溯和问题定位等工作，提升工作效率并帮助您更好地基于数据进行决策。该功能需开通百度智能云日志服务（BLS）。
注意：
- 该功能基于百度智能云日志服务（BLS）实现对象存储日志实时查询，您需先开通日志服务（BLS）
- 该功能将产生一定费用，由日志服务单独收费，查看日志服务计费说明，开通服务后您需创建索引对实时日志进行检索与分析。
开通日志查询
- 登录 对象存储 BOS 管理控制台。
- 在左侧 Bucket 列表中，选择需要设置日志查询的 Bucket，点击 Bucket 名称进入 Bucket 管理目录。
-
在【基础配置管理】页面中选择【实时日志查询】，单击【开通服务】进行开通：
- 若您未开通日志服务（BLS），可点击【立即开通 BLS】前往开通。
- 若您已开通日志服务（BLS），可点击【开通服务】开通 BOS 日志查询功能。
查询实时日志
方式一：通过BOS控制台
- 登录 对象存储 BOS 管理控制台。
- 在左侧 Bucket 列表中，选择已开通 BOS 日志查询功能的 Bucket，点击 Bucket 名称进入 Bucket 管理目录。
- 在【基础配置管理】页面中选择【实时日志查询】，单击【立即查询日志】跳转至 BLS 页面查询。
注意
北京地域目前需在BLS控制台内在【索引管理】中首先完成索引配置，方可实现对开启后的增量日志进行分析与检索。
方式二：通过BLS控制台
- 登陆 日志服务 BLS 控制台。
- 在顶部选择已开通 BOS 日志查询功能的 Bucket 所属地域。
- 在左侧导航栏中选择【查询分析】->【日志查询】。
- 选择日志集，点击【查询】。
关闭日志查询
当您确认不再需要保留日志数据，请按如下步骤关闭实时日志查询。
- 登录 对象存储 BOS 管理控制台。
- 在左侧 Bucket 列表中，选择需要关闭日志查询的 Bucket，点击 Bucket 名称进入 Bucket 管理目录。
- 在【基础配置管理】页面中选择【实时日志查询】，页面中点击【关闭服务】。
- 在二次弹窗中仔细阅读点击【确认】即可。
日志格式
| 输出字段 | 例子 | 说明 |
|---|---|---|
| time | 2026-09-05T09:02:03+08:00 | 发起请求的时间（北京时间） |
| bucket_owner | e12345678************************69387b8 |
Bucket的Owner ID |
| bucket | samplebucket | 请求访问的Bucket名字 |
| key | dir/sample.jpg | 请求访问的Object名字 |
| remote_ip | 1.2.3.4 | 请求者IP地址 |
| requester | e12345678************************69387b8 |
请求者的ID |
| request_id | a94dbe12-717e-4e72-bcf2-0aa4a3100360 | 用于唯一标志该请求的UUID，同Header中的x-bce-request-id |
| request_host | bj.bcebos.com | HTTP请求的Host请求头 |
| operation | GetObject | 请求对应的API |
| request_url | "GET/v1/tables.xml" | HTTP请求中的URI，需要用双引号引用 |
| http_status | 200 | BOS返回的HTTP状态码 |
| error_code | InvalidURI | BOS返回的错误码 |
| bytes_send | 2314 | 用户从BOS下载的流量 |
| object_size | 1024 | Object大小，单位为Bytes |
| total_time | 11 | 从开始接收请求到相应返回的总时长，单位为毫秒 |
| referer | <https://cloud.baidu.com/product/bos.html> |
HTTP请求的Referer请求头 |
| user_agent | "curl/7.33.0" | HTTP请求的User Agent请求头 |
| storage_class | STANDARD | 对象的存储类型 |
| multiple_delete | "abc%0Adef" | Multiple Delete删除的对象信息，'%0A'为分隔符 |
| vip | 10.0.0.100 | 用户请求的vip |
| rename_src | "test" | rename 源object |
| ak | 1234abcdefg | 用户的ak |
| source | cdn | 请求来源。cdn表示cdn回源请求，"-"表示不是CDN回源 |
| mirror_type | 302 | 302表示重定向镜像回源；fetch表示镜像抓取；-表示不是镜像回源 |
| copy_src | STANDARD | copy的源存储类型 |