对象存储 日志存储概述

一、日志存储路径

在目标存储桶中，日志记录路径为：

目标存储桶/路径前缀{YYYY}/{MM}/{DD}/{time}_{random}_{index}

日志每5分钟生成一次，一条记录为一行，每条记录包含多个字段，字段之间以空格分隔。需要注意的是，单个日志文件最大为256MB，如果你在这5分钟内产生的日志量超过256MB，那你的日志会被分割成多份日志文件。目前支持的日志字段如下：

二、使用控制台

1. 登录 对象存储控制台。

2. 在左侧导航栏中，单击存储桶列表，进入存储桶列表管理页面。

3. 找到需要开启日志存储的源存储桶，单击该存储桶名称，进入该存储桶管理页面。

4. 在左侧导航栏中，选择日志管理 > 日志存储，单击编辑，将当前状态修改为“开启”。

5. 在日志存储的配置项中，按照以下说明进行配置：

·目标存储桶：开启日志存储的源存储桶和存放日志的目标存储桶必须在同一地域。COS 不推荐将源存储桶设置为存放日志的存储桶。

·路径前缀：输入便于你查找日志的自定义路径前缀。如不填，则默认为目标存储桶的根路径。

·服务授权：首次开启日志存储功能，你需要授权 CLS 产品服务向你的存储桶中投递访问日志。根据提示完成授权即可。

6. 确认输入信息无误后，单击保存。此时日志存储功能启用完毕。

注意：说明：

注意：开启日志存储功能后，预计需要1小时完成首批日志投递。后续每5分钟会生成一次日志，日志投递的具体时间取决于数据量大小。

7. 找到你此前配置日志存放的目标存储桶，即可看到生成的日志文件。

8. 日志文件下载后，可按照字段说明进行查看，详情请参见 日志字段说明。

注意：目前只有存储桶所有者拥有设置日志存储的权限，其他用户登录控制台不会显示日志存储配置项。

三、相关说明

·日志存储功能开启时，需要在访问管理控制台上创建日志角色，并允许该角色对目标存储桶进行日志读写操作。

·日志存储功能关闭时，不删除日志角色时，不会取消该角色对目标存储桶进行日志读写操作的授权。

四、使用 API

使用 API 为指定存储桶开启日志存储功能时，请参考以下步骤：

五、1. 创建日志角色

创建日志角色，具体接口信息请参见 CreateRole。
其中，roleName 必须为：CLS_QcsRole。
policyDocument 为：

{ "version": "2.0", "statement": [{ "action": "name/sts:AssumeRole", "effect": "allow", "principal": { "service": "cls.cloud.tencent.com" } }]}

六、2. 日志角色绑定权限

日志角色绑定权限，具体接口信息参见 AttachRolePolicy。

其中，policyName 为：QcloudCOSAccessForCLSRole。roleName 为第1步中的 CLS_QcsRole，也可以使用创建 roleName 时返回的 roleID。

七、3. 开启日志存储

调用接口，开启日志存储功能，具体接口信息请参见 PUT Bucket logging。其中，要求存放日志的目标存储桶和源存储桶在同一地域。