日志管理

最近更新时间:2023-02-22 10:30:53

查看PDF

您可以利用管理控制台为存储空间启用和禁用日志记录。您可以在已启用日志记录的同一存储空间中存储日志,也可以在同一Region内另外创建新存储空间来存储日志。

KS3中日志记录功能默认为不开启状态,您可以手动开启,并手动设置存储位置。

日志文件格式为:ks3log_空间名_yyyy_MM_dd.log

日志设置相关API请参见API文档-GET Bucket logging

操作步骤

1. 登录KS3控制台,点击左侧 存储空间,单击目标Bucket名称。

2. 点击 空间设置 > 基础设置 > 日志状态设置

3. 点击 授权,跳转至“角色授权页”进行“KsyunKS3BucketLoggingProcessingRole”授权,您必须完成授权后才能开始使用服务。

注意:只有主账号或具有PutBucketLoggingGetBucketLogging权限的子账号才能开通该服务。

 

4. 授权成功后,点击 设置

 

5. 点击 设置 后出现如下信息,在“日志存储位置”下拉框内选择日志文件的存储空间,默认存储在当前空间内,也可选择其他存储空间(只支持选择同一Region的存储空间)。在“路径前缀”输入框内输入日志存放的桶内具体路径,默认路径为:KS3-access-log,可进行修改。若当前路径在桶内不存在,会自动生成对应路径文件夹。点击 保存 完成日志设置。

 

日志文件格式

日志文件的格式组成:以下名称从左至右,以制表符分隔。

字段 记录示例 备注
bucket_owner NzM0MDEzMzI= 经过base64编码的用户ID
bucket bucket_test bucket名
time [11/Jan/2016:15:05:35 +0800] 时间
remote_ip 219.141.176.229 请求IP
requester Anonymous 如果请求者是匿名用户,记录值为Anonymous;
如果请求者是主账户,记录值为用户ID的base64编码;
如果请求者是子用户,记录值为用户ID/子用户名的base64编码
request_id 1e6ac821e4904e4ca21d3a9e0ce52e25 请求ID
operation REST.POST.OBJECT 操作,本例是Post Object
key - Object Key
request_uri “POST /chenjin.jpg HTTP/1.1” 请求的URL
http_status 200 请求状态码
error_code - 错误码
bytes_sent 461 发送的字节数
object_size 139008 被访问资源的大小
total_time 2 请求总时长,单位为秒,精确到毫秒
turn_around_time 2 nginx到api server往返时长,单位为秒,精确到毫秒
referer “http://ks3.ksyun.com/console.html” 请求的Referer
user_agent “Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/45.0.2454.101 Safari/537.36” 用户代理
version_id - 版本ID,暂不使用
storageclass Standard 被访问资源的存储类型
usertype - 用户类型:普通用户默认不显示;cdn用户显示"kc"
nginx_port 80 nginx端口:8000、4433为内网访问;80为外网访问

注意事项:

  • 日志延迟时间为一天,即在第二天下午可以看到第一天的日志。
  • 日志中的任何一个字段,都可能出现-,用于表示未知数据或对于当前请求该字段无效。
  • 根据需求,KS3的日志格式未来会在尾部添加一些新字段,请开发者开发日志处理工具时考虑兼容性的问题。

操作方式

操作方式 说明
Java SDK 丰富、完整的各类语言 SDK demo
Go SDK
Node.js SDK
PHP SDK

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

内容不全,不深入
内容更新不及时
描述不清晰,比较混乱
系统或功能太复杂,缺乏足够的引导
内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈