使用场景
媒体存储日志存储功能支持自动把桶的各类访问请求记录日志，并存储到某一存储桶中，适合对请求有分析或审计等需求的用户使用。
- 日志文件存放位置需要在开启桶日志存储功能时指定，仅支持在源存储桶所属区域中选择存储桶，也包括开启日志功能的桶本身。
- 日志记录设置成功后，大约5~10分钟后可在日志存储桶中查看到桶的操作日志。
- 为了更有效的管理日志，建议您将日志存放到不同的桶中。
- 日志文件记录的是通过API或SDK方式进行的S3协议操作。
- 生成的日志文件会保存在指定的存储桶，占用存储空间，因此会产生存储费用。如需定时清理，可通过生命周期相关配置实现，具体可参考：生命周期 。
- 日志文件生成规则：
- 日志文件存储路径：日志存储位置 /日志文件前缀（如无设置则省略）/YYYY - MM - DD - HH-mm-ss_UniqueStiring 。
- 生成周期：启用规则后开始生成，并且以5分钟为单位保存至日志存储位置中。
适用区域
本功能目前仅部分资源池支持，具体可参考：资源池与区域节点。
如需使用，可联系客户经理或提交工单申请。
日志文件参数
以下所示为生成的桶访问日志文件记录：
gdoss.xstore.ctyun.cn [$server_addr] [$remote_addr] [$time_local] "$request_method" "$host" "$request_uri" $status $body_bytes_sent $content_length "$http_referer" $request_time "$http_user_agent" "$http_x_forwarded_for" "$scheme" "$op_name" "$http_transfer_encoding" "$http_ctyun_network_type" "$varUser" "$upstream_response_time"
访问日志主要包含如下信息：
| 参数 | 说明 |
|---|---|
| gdoss.xstore.ctyun.cn | 资源池域名，用来标记资源池。 |
| $server_addr | 当前服务器地址，一般是内网IP。 |
| $remote_addr | 连接的对端服务器地址。 |
| $time_local | 日志时间。 |
| $request_method | HTTP Method，如PUT、GET、DELETE、POST、HEAD等。 |
| $host | HTTP请求里面的header字段：host。 |
| $request_uri | HTTP请求里面的URI。 |
| $status | HTTP状态码。如200、204、206、403、404等。 |
| $body_bytes_sent | 服务端发送给客户端的消息body长度。 |
| $content_length | 服务端收到的消息的请求的长度。 |
| $http_referer | HTTP请求里面的referer字段。 |
| $request_time | 请求持续时间。包含从服务端建立连接完成到完成响应这段时间。 |
| $http_user_agent | HTTP请求里面的user_agent字段。 |
| $http_x_forwarded_for | HTTP请求里面的x_forwarded_for字段。 |
| $scheme | 区分HTTP还是HTTPS请求。 |
| $op_name | API接口名称。如GetObject、ListBuckets等等。 |
| $http_transfer_encoding | HTTP请求里面的transfer_encoding。 |
| $http_ctyun_network_type | 表示请求来源的网络类型:public（公网）、private(内网）。 |
| $varUser | 用户标记，表示这个请求对应的用户。 |
| $upstream_response_time | 请求在资源池内部的处理时间。 |
日志文件内容根据开通的区域不同，格式会有一定出入，请以实际为准。
使用方式
媒体存储支持通过控制台、API方式设置日志存储。
| 操作途径 | 使用方式 |
|---|---|
| 控制台 | 可参考：日志存储。 |
| OpenAPI | 可参考：设置日志存储规则，目前OpenAPI仅支持西藏资源池调用，如其他区域需通过API访问调用，请联系媒体存储技术团队。 |
