设置桶日志管理配置-九游平台

功能介绍

创建桶时，默认是不生成桶的日志的，如果需要生成桶的日志，该桶需要打开日志配置管理的开关。桶日志功能开启后，桶的每次操作将会产生一条日志，并将多条日志打包成一个日志文件。日志文件存放位置需要在开启桶日志功能时指定，可以存放到开启日志功能的桶中，也可以存放到其他您有权限的桶中，但需要和开启日志功能的桶在同一个region中。

由于日志文件是obs产生，并且由obs上传到存放日志的桶中，因此obs需要获得委托授权，用于上传生成的日志文件，所以在配置桶日志管理前，需要先到统一身份认证服务生成一个对obs服务的委托，并将委托名作为参数配置到桶上，并且在xml文件中标签下配置相应的日志管理功能。在为委托配置权限时只需设置目标桶的上传对象权限。

委托权限示例

{
    "version": "1.1",
    "statement": [
        {
            "action": [
                "obs:object:putobject"
            ],
            "resource": [
                "obs:*:*:object:mybucketlogs/*"
            ],
            "effect": "allow"
        }
    ]
}

关闭桶日志功能的方法是上传一个带有空的bucketloggingstatus标签的logging文件。

默认存储类别为低频访问存储或归档存储的桶不能作为存放日志文件的桶。日志文件存放到桶中后，这些日志文件会占用空间，并按照用户存放数据同样的计费策略进行计费。

目标桶开启kms加密时，需要在委托中授予kms访问权限。

请求消息样式

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

put/?logginghttp/1.1
host:bucketname.obs.cn-north-4.myhuaweicloud.com
date:date
authorization:signaturevalue


agency-name

mybucketlogs
mybucket-access_log-/



domainid
read

请求消息参数

该请求消息中不使用消息参数。

请求消息头

该请求使用公共消息头，具体请参见表3。

请求消息元素

存储访问日志的object命名规则

1

yyyy-mm-dd-hh-mm-ss-

• 为用户指定的目标前缀。
• yyyy-mm-dd-hh-mm-ss为日志生成的日期与时间，各字段依次表示年、月、日、时、分、秒。
• 为obs自动生成的字符串。

一个实际用于存储obs访问日志的object名称示例如下：

1

bucket-log2015-06-29-12-22-07-n7mxlaf1bdg7mpdv

• "bucket-log"为用户指定的目标前缀。
• "2015-06-29-12-22-07"为日志生成的日期与时间。
• "n7mxlaf1bdg7mpdv"为obs自动生成的字符串。

桶访问日志格式

以下所示为在目标桶生成的桶访问日志文件记录：

1

787f2f92b20943998a4fe2ab75eb09b8bucket[13/aug/2015:01:43:42 0000]xx.xx.xx.xx787f2f92b20943998a4fe2ab75eb09b8281599bacad9376ece141b842b94535brest.get.bucket.location-"get/bucket?locationhttp/1.1"200-211-66"-""httpclient"--

每个桶访问日志都包含如下信息：

响应消息样式

1
2
3

http/1.1status_code
date:date
content-length:length

响应消息头

该请求的响应消息使用公共消息头，具体请参考表1。

响应消息元素

该请求的响应消息中不带有响应元素。

错误响应消息

无特殊错误，所有错误已经包含在表2中。

请求示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

put/?logginghttp/1.1
user-agent:curl/7.29.0
host:examplebucket.obs.cn-north-4.myhuaweicloud.com
accept:*/*
date:wed,01jul201502:40:06gmt
authorization:obsh4ipjx0tqththebqqcec:mcojer/l4zzuy9qr6aonkeiwvvk=
content-length:528


agencygrantputlogging

log-bucket
mybucket-access_log-/



783fc6652cf246c096ea836694f71855
read

响应示例

1
2
3
4
5
6

http/1.1200ok
server:obs
x-obs-request-id:bf26000001643663ce53b6af31c619fd
x-obs-id-2:32aaaqaaeaabsaakpaiaabaaaqaaeaabct9cjuox8cetsrbqkm35s1dl/tlhrndz
date:wed,01jul201502:40:06gmt
content-length:0

请求示例：关闭桶日志转存

put /?logging http/1.1
authorization: obs h4ipjx0tqththebqqcec:iqspeubl66pwxdapxjrkk6hlcn4=
user-agent: curl/7.29.0
host: examplebucket.obs.region.myhuaweicloud.com
date: wed, 01 jul 2015 02:37:22 gmt
content-type: application/xml
 

响应示例：关闭桶日志转存

x-obs-id-2: 32aaaqaaeaabsaagaaeaabaaaqaaeaabcsalxuwjla91ewuxroicckzfjfgcryn0
x-obs-request-id: 0000018a2bc32fb6d2c62c9689dd14b3
server: obs
content-length: 0
date: wed, 01 jul 2015 02:37:22 gmt