本文介绍OSS日志类型及相关的日志字段详情。
OSS日志类型
日志类型 | 说明 |
访问日志 | 记录相关OSS Bucket的所有访问日志,实时采集。 |
批量删除日志 | 记录批量删除日志时具体的删除信息,实时采集。 说明 当您调用DeleteObjects接口时,访问日志中会有一条请求记录。 |
每小时计量日志 | 记录特定OSS Bucket每个小时累计的一些统计计量,延迟时间为几小时,用于辅助分析。 |
OSS自带日志和OSS访问记录日志
OSS访问日志实时查询分析功能由日志服务提供,包括OSS访问数据、批量删除数据和每小时计量数据的日志记录、采集、存储和分析等系列功能。OSS自带日志是OSS产品自带的访问数据的日志记录和存储功能,同样记录OSS存储空间的访问信息。
日志服务提供的日志包含OSS访问记录日志的全部信息,但是日志字段与OSS自带日志字段不同,如下表所示。更多信息,请参见访问日志。
OSS自带日志字段 | 日志服务-OSS日志字段 |
Remote IP | client_ip |
Time | time |
Request-URI | request-uri |
HTTP Status | http_status |
SentBytes | response_body_length |
RequestTime (ms) | response_time |
Referer | referer |
User-Agent | user-agent |
HostName | host |
Request ID | request_id |
LoggingFlag | logging_flag |
Requester Aliyun ID | requester_id |
Operation | operation |
Bucket | bucket |
Key | object |
ObjectSize | object_size |
Server Cost Time (ms) | server_cost_time |
Error Code | error_code |
Request Length | request_length |
UserID | owner_id |
Delta DataSize | delta_data_size |
Sync Request | sync_request |
访问日志
字段名称 | 含义 |
__topic__ | 日志主题,固定为oss_access_log。 |
acc_access_region | 如果是传输加速请求,该字段为请求接入点所在地域名,否则为短划线(-)。 |
access_id | 请求者的AccessKey ID。 |
bucket | OSS Bucket名称。 |
bucket_location | OSS Bucket所在的数据中心,一般格式为oss-<region ID>。 |
bucket_storage_type | OSS Object存储类型。
|
client_ip | 发起请求的IP地址,即客户端IP地址、其网络防火墙或Proxy IP地址。 |
content_length_in | 请求头中Content-Length的值,单位:字节。 |
content_length_out | 响应头中Content-Length的值,单位:字节。 |
delta_data_size | OSS Object大小的变化量,如果没有变化则为0;如果不是上传请求,则为短划线(-) 。 |
ec | 详细错误码。根据错误码自助排查的步骤,请参见使用EC错误码自助排查。 |
error_code | OSS返回的错误码。更多信息,请参见错误码概述。 |
host | 请求访问域名,例如:bucket123.oss-cn-beijing.aliyuncs.com。 |
http_method | HTTP请求方法。 |
http_status | HTTP请求返回的状态。 |
http_type | HTTP请求类型,包括HTTP和HTTPS。 |
logging_flag | 是否开启定期导出日志到OSS Bucket的功能,true表示开启。 |
object | 请求的OSS Object,格式为URL编码,查询时可以使用 |
object_size | OSS Object的大小,单位:字节。 |
operation | 访问类型。更多信息,请参见附录:访问类型。 |
owner_id | OSS Bucket拥有者的阿里云账号ID。 |
referer | 请求的HTTP Referer。 |
request_id | 请求ID。 |
request_length | HTTP请求的大小,包括header,单位:字节。 |
request_uri | HTTP请求的URI,包括query-string,格式为URL编码,查询时可以使用 |
requester_id | 请求者的ID,如果是匿名访问,则显示为短划线(-)。 |
response_body_length | HTTP响应中的Body大小,不包括header。 |
response_time | HTTP响应时间,单位:毫秒。 |
server_cost_time | OSS服务器处理本次请求所花的时间,单位:毫秒。 |
sign_type | 签名类型 。
|
sync_request | 同步请求类型 。
|
time | OSS收到请求的时间,例如27/Feb/2018:13:58:45。如果需要时间戳可以使用__time__字段。 |
user-agent | HTTP的User-Agent头,例如curl/7.15.5。 |
vpc_addr | OSS所在VPC的VIP地址。 该地址为整数类型(例如343819108),您可以使用 |
vpc_id | 客户端所在VPC的ID。 |
restore_priority | 解冻优先级。 |
extend_information | 扩展字段,默认为短划线(-)。 如果是通过RAM角色发起的请求,则日志会记录相关的RAM角色信息,拼接规则为 |
user_defined_log_fields | 是一个JSON文本经过base64编码后的值,该JSON文本里记录了用户自定义的请求头或URL参数信息。 |
批量删除日志
当您调用DeleteObjects接口时,访问日志中会有一条请求记录。但因为删除的文件信息存放在请求的HTTP Body中,访问日志中的object字段值为短划线(-)。查看具体的删除文件的列表,需要查看批量删除日志。批量删除日志的字段及说明如下,可以通过request_id字段关联。
字段名称 | 说明 |
__topic__ | 日志主题,固定为oss_batch_delete_log。 |
client_ip | 发起请求的IP地址,例如客户端IP地址、其网络防火墙或Proxy的IP地址。 |
user_agent | HTTP的User-Agent头,例如curl/7.15.5。 |
bucket | OSS Bucket名称。 |
error_code | OSS返回的错误码。更多信息,请参见错误码概述。 |
request_length | HTTP请求的大小,包括header,单位:字节。 |
response_body_length | HTTP响应Body的大小,不包括header。 |
object | 请求的OSS Object,格式为URL编码,查询时可以使用 |
object_size | OSS Object的大小,对应请求对象的大小,单位:字节。 |
operation | 访问类型。更多信息,请参见附录:访问类型 。 |
bucket_location | OSS Bucket所在的数据中心,格式为oss-<region ID>。 |
http_method | HTTP请求方法,例如POST。 |
referer | 请求的HTTP Referer。 |
request_id | 请求ID。 |
http_status | HTTP请求返回的状态。 |
sync_request | 同步请求类型。
|
request_uri | 请求的URI,包括query-string,格式为URL编码,查询时可以使用 |
host | 请求访问域名,例如bucket123.oss-cn-beijing.aliyuncs.com。 |
logging_flag | 是否开启定期导出日志到OSS Bucket的功能,true表示开启。 |
server_cost_time | OSS服务器处理本次请求的时间,单位:毫秒。 |
owner_id | OSS Bucket拥有者的阿里云账号ID。 |
requester_id | 请求者的ID,如果匿名访问则为短划线(-)。 |
delta_data_size | OSS Object大小的变化量,如果没有变化则为0;如果不是上传请求,则为短划线(-)。 |
每小时计量日志
记录特定OSS Bucket每个小时累计的计量信息,供辅助分析时参考使用。
字段名称 | 说明 |
__topic__ | 日志主题,固定为oss_metering_log。 |
owner_id | OSS Bucket拥有者的阿里云账号ID。 |
bucket | OSS Bucket名称。 |
cdn_in | CDN流入量,单位:字节。 |
cdn_out | CDN流出量,单位:字节。 |
get_request | GET请求次数。 |
intranet_in | 内网流入量,单位:字节。 |
intranet_out | 内网流出量,单位:字节。 |
network_in | 外网流入量,单位:字节。 |
network_out | 外网流出量,单位:字节。 |
put_request | PUT请求次数。 |
storage_type | OSS Bucket存储类型 。
|
storage | OSS Bucket存储量,单位:字节。 |
metering_datasize | 非标准存储的计量数据大小。 |
process_img_size | 处理的图像大小,单位:字节。 |
process_img | 处理图像。 |
sync_in | 同步流入量,单位:字节。 |
sync_out | 同步流出量,单位:字节。 |
start_time | 计量开始时间戳,单位:秒。 |
end_time | 计量截止时间戳,单位:秒。 |
region | OSS Bucket所在地域。 |
bucket_location | OSS Bucket所在的数据中心,一般格式为oss-<region ID>。 |
附录:访问类型
访问类型如下表所示。更多信息,请参见API概览。
操作 | 说明 |
AbortMultiPartUpload | 断点上传-中止。 |
AppendObject | 追加上传文件。 |
CompleteUploadPart | 完成断点上传。 |
CopyObject | 复制文件。 |
DeleteBucket | 删除Bucket。 |
DeleteLiveChannel | 删除LiveChannel。 |
DeleteObject | 删除文件。 |
DeleteObjects | 删除多个文件。 |
GetBucket | 列举文件。 |
GetBucketAcl | 获取Bucket权限。 |
GetBucketCors | 查看Bucket的CORS规则。 |
GetBucketEventNotification | 获取Bucket通知配置。 |
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 | 获取Bucket图片处理配置。 |
GetService | 列举Bucket。 |
HeadBucket | 查看Bucket信息。 |
HeadObject | 查看文件信息。 |
InitiateMultipartUpload | 初始化断点上传文件。 |
ListMultiPartUploads | 列举断点事件。 |
ListParts | 列举断点块状态。 |
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样式。 |