本文档介绍OSS访问日志功能中提供的所有日志字段。

OSS日志格式

表 1. OSS日志格式
日志类型 说明
访问日志 记录了对应的Bucket的所有访问日志。实时收集。
批量删除日志 记录了批量删除日志时具体的删除信息。实时收集。
说明 当用户调用DeleteObjects时,访问日志中会有一条请求记录。但因为删除的文件信息存放在用户请求的HTTP Body中,访问日志中的object会是-,如果要参考具体的删除文件的列表,就需要查看批量删除的日志,可以通过request_id关联。
每小时计量日志 记录特定Bucket每个小时累计的一些统计计量,延迟为几小时,用于辅助分析。

OSS自带日志和OSS访问记录日志

OSS访问日志功能由日志服务提供,是OSS访问数据、批量删除数据和每小时计量数据的日志记录、采集、存储和分析等系列功能。OSS自带日志是OSS产品自带的访问数据的日志记录和存储功能,同样记录OSS存储空间的访问信息。

日志服务提供的日志包含OSS访问记录日志的全部信息,但是日志字段与OSS自带日志字段不同。详细字段名称区别请参考下表。
OSS自带日志字段 日志服务-OSS日志字段 含 义
Remote IP client_ip 请求发起的IP地址(Proxy代理或用户防火墙可能会屏蔽该字段)。
Time time OSS收到请求的时间。
Request-URI request-uri 用户请求的URI(包括query-string)。
HTTP Status http_status OSS返回的HTTP状态码。
SentBytes response_body_length 用户从OSS下载的流量。
RequestTime (ms) response_time 完成本次请求的时间,单位:毫秒。
Referer referer 请求的HTTP Referer。
User-Agent User-Agent HTTP的User-Agent头。
HostName host 请求访问域名。
Request ID request_id 用于标识该请求的唯一ID。
LoggingFlag logging_flag 是否开启了访问日志功能。
Requester Aliyun ID requester_id 请求者的阿里云ID;匿名访问为“-”。
Operation operation 请求类型。
Bucket bucket 请求访问的Bucket名字。
Key object 用户请求的Key。
说明 日志服务的object字段经URL编码。
ObjectSize object_size Object大小。
Server Cost Time (ms) server_cost_time OSS服务器处理本次请求的时间,单位:毫秒。
Error Code error_code OSS返回的错误码。
Request Length request_length 用户请求的长度,单位:Byte。
UserID owner_id Bucket拥有者ID。
Delta DataSize delta_data_size Bucket大小的变化量;若没有变化为-
Sync Request sync_request 是否是CDN回源请求;若不是为-

访问日志

表 2. 访问日志
字段 含义 示例
access_id 访问者的AccessKey ID。 mEEJX**********
__topic__ 主题,固定为oss_access_log -
time 访问时间,即OSS收到请求的时间,如果需要时间戳可以使用__time__ 27/Feb/2018:13:58:45
owner_id Bucket拥有者阿里云ID。 12345678
User-Agent HTTP的User-Agent头。 curl/7.15.5
logging_flag 是否开启logging,即是否开启了日志定期导出到OSS Bucket的功能。 true
bucket Bucket名称。 bucket123
content_length_in 请求头中Content-Length的值,单位:Byte。 12345
content_length_out 回应头中Content-Length的值,单位:Byte。 12345
object 用户请求的object,URL编码,查询时可以使用select url_decode(object)解码。 data%2Fcur_file.txt
object_size 对象大小,即对应请求对象的大小,单位:Byte。 1234
operation 访问类型,完整访问类型列表与描述,请参考访问类型 GetObject
bucket_location Bucket所在集群,一般格式是oss-<region>-id oss-cn-beijing-f
request_uri 用户请求的URI,包括query-string,路径是URL编码,查询时可以使用select url_decode(request_uri)解码。 /1518085703067732%2Fcur_file.txt HTTP/1.1
error_code OSS返回的错误码,完整错误码列表与描述,请参考OSS错误响应 NoSuchKey
request_length HTTP请求的大小,包括header。单位:Byte。 376
client_ip 请求发起的IP地址,即客户端IP、其网络防火墙或者Proxy的IP。 1.2.3.4
response_body_length HTTP响应中body的大小,即HTTP response的body的大小,不包括header。 123
http_method HTTP请求方法。 GET
referer 请求的HTTP Referer。 http://www.abc.com
requester_id 请求者阿里云ID,匿名访问为“-”。 12345678
request_id 请求ID,表示本次请求的ID,用于OSS技术人员问题排查。 5A7C39674857FB9FFFFFF
response_time 请求响应时间,单位:毫秒。 123
server_cost_time OSS服务器处理时间,即OSS服务器处理本次请求所花的时间,单位:毫秒。 123
http_type HTTP请求类型,即http或https请求。 http
sign_type 签名类型,完整签名类型列表和描述,请参考签名类型 NormalSign
http_status HTTP状态,即OSS请求返回的HTTP状态。 200
sync_request 同步请求类型,完整同步请求类型列表和描述,请参考同步请求类型 cn
bucket_storage_type Bucket存储类型,完整Bucket存储类型列表和描述,请参考Bucket存储类型 standard
host 请求访问域名。 bucket123.oss-cn-beijing.aliyuncs.com
vpc_addr 用户访问oss的域名对应的vip的地址,整形格式,用于OSS技术人员问题排查。 1234567890
vpc_id 用户通过vpc访问时的vpc id,用于OSS技术人员问题排查。 1234
delta_data_size object大小的变化量,若没有变化为0;如果不是上传请求,则为“-” 。 280
acc_access_region 如果是传输加速请求,这个字段为请求接入点所在区域名,否则为“-”。 cn-hangzhou

批量删除日志

当用户调用DeleteObjects时,访问日志中会有一条请求记录。但因为删除的文件信息存放在用户请求的HTTP Body中,访问日志中的object会是-。参考具体的删除文件的列表,需要查看批量删除日志。批量删除日志的字段及说明如下,可以通过request_id关联。

表 3. 批量删除日志
字段 说明 示例
__topic__ 主题,固定为oss_batch_delete_log -
client_ip 请求发起的IP地址,客户端IP或者其网络防火墙或者Proxy的IP。 1.2.3.4
user_agent User-Agent,HTTP的User-Agent头。 curl/7.15.5
bucket Bucket名称。 bucket123
error_code OSS返回的错误码,完整错误码列表与描述,请参考OSS错误响应 NoSuchKey
request_length request的大小,HTTP请求的大小,包括header。单位:Byte。 376
response_body_length response的body的大小,HTTP response的body的大小,不包括header。 123
object 用户请求的object,URL编码,查询时可以使用select url_decode(object)解码。 data%2Fcur_file.txt
object_size 对象大小,对应请求对象的大小,单位:Byte。 1234
operation 访问类型,完整访问类型列表与描述,请参考访问类型 GetObject
bucket_location Bucket所在集群,一般格式是oss-<region>-id oss-cn-beijing-f
http_method HTTP请求方法。 POST
referer 请求的HTTP Referer。 http://www.abc.com
request_id 请求ID,表示本次请求的ID,用于OSS技术人员问题排查。 5A7C39674857FB9FFFFFF
http_status HTTP状态,OSS请求返回的HTTP状态。 200
sync_request 同步请求类型,完整同步请求类型列表和描述,请参考同步请求类型 cdn
request_uri 用户请求的URI,包括query-string,路径是URL编码,查询时可以使用select url_decode(request_uri)解码。 /1518085703067732%2Fcur_file.txt HTTP/1.1
host 请求访问域名。 bucket123.oss-cn-beijing.aliyuncs.com
logging_flag 是否开启logging,即是否开启了原来的日志定期导出功能。 true
server_cost_time OSS服务器处理时间,单位:毫秒。 123
owner_id Bucket拥有者阿里云ID。 12345678
requester_id 请求者阿里云ID,匿名访问为“-”。 12345678
delta_data_size object大小的变化量,若没有变化为0;如果不是上传请求,则为“-”。 280

每小时计量日志

记录特定Bucket每个小时累计的一些统计计量,几小时延迟,仅供辅助分析时参考使用。

表 4. 每小时计量日志
字段 说明 示例
__topic__ 主题,固定为oss_metering_log -
owner_id Bucket拥有者阿里云ID。 12345678
bucket Bucket名称。 bucket123
cdn_in CDN流入量,单位为字节。 123
cdn_out CDN流出量,单位为字节。 123
get_request GET请求次数。 123
intranet_in 内网流入量,单位为字节。 123
intranet_out 内网流出量,单位为字节。 123
network_in 外网流入量,单位为字节。 123
network_out 外网流出量,单位为字节。 123
put_request PUT请求次数。 123
storage_type Bucket存储类型,完整Bucket存储类型列表和描述,请参考Bucket存储类型 standard
storage Bucket存储量,单位为字节。 123
metering_datasize 非标准存储的计量数据大小。 123
process_img_size 处理的图像大小,单位为字节。 123
process_img 处理图像。 123
sync_in 同步流入量,单位为字节。 123
sync_out 同步流出量,单位为字节。 123
start_time 计量开始时间戳。 1518084000
end_time 计量截止时间戳,一般一小时一个计量时间单位。 1518087600
region Bucket所在区域。 cn-beijing
bucket_location Bucket所在集群,一般格式是oss-<region>-id oss-cn-beijing-f

访问类型

表 5. 访问类型
操作值 描述
AbortMultiPartUpload 断点上传-中止。
AppendObject 追加上传文件。
CommitTransition CommitTransition。
CompleteUploadPart 完成断点上传。
CopyObject 复制文件。
DeleteBucket 删除Bucket。
DeleteLiveChannel 删除LiveChannel。
DeleteObject 删除文件。
DeleteObjects 删除多个文件。
ExpireObject ExpireObject。
GetBucket 列举文件。
GetBucketAcl 获取Bucket权限。
GetBucketCors 查看Bucekt的CORS规则。
GetBucketEventNotification 获取Bucekt通知配置。
GetBucketInfo 查看Bucket信息。
GetBucketLifecycle 查看Bucket的Lifecycle配置。
GetBucketLocation 查看Bucket区域。
GetBucketLog 查看Bucket访问日志配置。
GetBucketReferer 查看Bucket防盗链设置。
GetBucketReplication 查看跨区域复制。
GetBucketReplicationProgress 查看跨区域复制进度。
GetBucketStat 获取bucket的相关信息。
GetBucketWebSite 查看Bucket的静态网站托管状态。
GetLiveChannelStat 获取LiveChannel状态信息。
GetObject 读取文件。
GetObjectAcl 获取文件访问权限。
GetObjectInfo 获取文件信息。
GetObjectMeta 查看文件信息。
GetObjectSymlink 获取symlink文件的详细信息。
GetPartData 获取断点文件块数据。
GetPartInfo 获取断点文件块信息。
GetProcessConfiguration 获取Bucekt图片处理配置。
GetService 列举Bucket。
HeadBucket 查看Bucket信息。
HeadObject 查看文件信息。
InitiateMultipartUpload 初始化断点上传文件。
ListMultiPartUploads 列举断点事件。
ListParts 列举断点块状态。
Options Options。
PostObject 表单上传文件。
PostProcessTask 提交相关的数据处理,例如截图等。
PostVodPlaylist 创建LiveChannel点播列表。
ProcessImage 图片处理。
PutBucket 创建Bucket。
PutBucketCors 设置Bucket的CORS规则。
PutBucketLifecycle 设置Bucket的Lifecycle配置。
PutBucketLog 设置Bucket访问日志。
PutBucketWebSite 设置Bucket静态网站托管模式。
PutLiveChannel 创建LiveChannel。
PutLiveChannelStatus 设置LiveChannel状态。
PutObject 上传文件。
PutObjectAcl 修改文件访问权限。
PutObjectSymlink 创建symlink文件。
RedirectBucket bucket endpoint重定向。
RestoreObject 解冻文件。
UploadPart 断点上传文件。
UploadPartCopy 复制文件块。
get_image_exif 获取图片的exif信息。
get_image_info 获取图片的长宽等信息。
get_image_infoexif 获取图片的长宽以及exif信息。
get_style 获取Bucket样式。
list_style 列举Bucket的样式。
put_style 创建Bucket样式。

关于每个操作的具体信息,请参考API概览

同步请求类型

表 6. 同步请求类型
同步请求类型 描述
- 一般请求。
cdn CDN回源。

签名类型

表 7. 签名类型
签名类型 描述
NotSign 未签名。
NormalSign 一般方式签名。
UriSign 通过URL签名。
AdminSign 管理员账号。

关于签名的进一步信息,请参考用户签名验证

Bucket存储类型

表 8. Bucket存储类型
存储类型 描述
standard 标准存储类型。
archive 归档存储类型。
infrequent_access 低频访问存储类型。

关于每个存储类型的进一步信息,请参考存储类型介绍