功能概述

对象存储日志服务可以将 Bucket 的访问日志以 Object 的形式存储至指定 Bucket 下的指定目录。只有 Bucket 的所有者才有权限设置或关闭该功能。

操作步骤

  1. 进入对象存储的主页面，选择待设置跨区域复制的 Bucket，点击 右键 > 设置：

    set bucket logging1

  2. 进入 Bucket 设置页面，点击 日志，根据页面信息，填写相关参数后，点击 开启日志功能：

    set bucket logging2

    说明：

    • 目标 Bucket 和源 Bucket 必须属于同一个用户下的同一数据中心内，且目标 Bucket 必须处于正常状态。

    • 日志文件前缀可参考下文 日志文件命名规则。

  3. 开启日志功能后，页面显示如下：

    set bucket logging3

    说明：

    • 如需修改用于存放日志的 Bucket，或日志文件命名的前缀，可在上图页面中直接修改后，点击 应用修改 即可。

    • 如需关闭日志功能，可点击如上页面中的 关闭日志功能。

相关说明

日志文件命名规则

日志命名格式为：

<TargetPrefix><Source-Bucket-Name>-<YYYY-MM-DD-HH>-<OrderString>.log

各参数说明如下：

  • <TargetPrefix> 为在 QingCloud 管理控制台或者通过API设置的前缀。

  • <Source-Bucket-Name> 为产生日志的 Bucket，即源 Bucket。

  • <YYYY-MM-DD-HH> 精确到小时的时间字符串。例：2018-11-11-11。

  • <OrderString> 每个小时的日志按照 1G 大小进行切片归档到一个或多个文件，OrderString 为切片唯一编号。

日志格式相关说明

每条日志之间，使用换行符进行分隔。任意字段如果没有输出会用 - 做占位符。

示例日志：

 192.168.1.1 - [25/Jun/2018:03:36:04 +0800] "GET http://demo.xxxx.xxxx.com/?limit=1000" 200 0.057 289 406 "curl/7.15.5" "http://www.this.is.http.referer" demo-bucket list_objects usr-thisDeMo 30458f69af1c85b4

字段说明：

日志字段 说明

192.168.1.1

访问IP

[25/Jun/2018:03:36:04 +0800]

访问时间

GET

HTTP 方法

http://demo.xxxx.xxxx.com/?limit=1000

访问 URL

200

状态码

0.057

请求时长

289

请求的长度（包括请求行，请求头和请求正文）

406

发送给客户端的总字节数

curl/7.15.5

访问端 UA

http://www.this.is.http.refer

http_referer

demo-bucket

Bucket 名称

list_objects

操作

usr-thisDeMo

请求用户

30458f69af1c85b4

请求 ID

其他说明

  • 源 Bucket 和目标 Bucket 必须属于同一个用户下的同一数据中心内，且目标 Bucket 必须处于正常状态

  • 推荐设置前缀，避免用户 Object 名与日志文件命名冲突。

  • 如果日志量比较大，一个小时可能会有多个日志文件，则日志文件会按照 OrderString 唯一序列号区分。

  • 正常情况下，日志会以 Object 的形式延迟 1-2 小时归档至指定位置。

  • 开启该功能后，归档存储的日志文件会占用存储空间，故，对象存储会对其所占存储进行收费。

  • 日志生成后，用户可以按照普通的 Object 来操作这些文件。