本文介绍OSS日志类型及相关的日志字段详情。

OSS日志类型

日志类型说明
访问日志记录相关OSS Bucket的所有访问日志,实时采集。
批量删除日志记录批量删除日志时具体的删除信息,实时采集。
说明 当您调用DeleteObjects接口时,访问日志中会有一条请求记录。
每小时计量日志记录特定OSS Bucket每个小时累计的一些统计计量,延迟时间为几小时,用于辅助分析。

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

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

日志服务提供的日志包含OSS访问记录日志的全部信息,但是日志字段与OSS自带日志字段不同,如下表所示。更多信息,请参见访问日志
OSS自带日志字段日志服务-OSS日志字段
Remote IPclient_ip
Timetime
Request-URIrequest-uri
HTTP Statushttp_status
SentBytesresponse_body_length
RequestTime (ms)response_time
Refererreferer
User-Agentuser-agent
HostNamehost
Request IDrequest_id
LoggingFlaglogging_flag
Requester Aliyun IDrequester_id
Operationoperation
Bucketbucket
Keyobject
ObjectSizeobject_size
Server Cost Time (ms)server_cost_time
Error Codeerror_code
Request Lengthrequest_length
UserIDowner_id
Delta DataSizedelta_data_size
Sync Requestsync_request

访问日志

字段名称含义
__topic__日志主题,固定为oss_access_log。
acc_access_region如果是传输加速请求,该字段为请求接入点所在地域名,否则为短划线(-)。
access_id请求者的AccessKey ID。
bucketOSS Bucket名称。
bucket_locationOSS Bucket所在的数据中心,一般格式为oss-<region ID>。
bucket_storage_typeOSS Object存储类型。
  • standard:标准存储类型。
  • archive:归档存储类型。
  • infrequent_access:低频访问存储类型。
client_ip发起请求的IP地址,即客户端IP地址、其网络防火墙或Proxy IP地址。
content_length_in请求头中Content-Length的值,单位:字节。
content_length_out响应头中Content-Length的值,单位:字节。
delta_data_sizeOSS Object大小的变化量,如果没有变化则为0;如果不是上传请求,则为短划线(-) 。
error_codeOSS返回的错误码。更多信息,请参见错误码概述
host请求访问域名,例如:bucket123.oss-cn-beijing.aliyuncs.com。
http_methodHTTP请求方法。
http_statusHTTP请求返回的状态。
http_typeHTTP请求类型,包括HTTP和HTTPS。
logging_flag是否开启定期导出日志到OSS Bucket的功能,true表示开启。
object请求的OSS Object,格式为URL编码,查询时可以使用select url_decode(object)解码。
object_sizeOSS Object的大小,单位:字节。
operation访问类型。更多信息,请参见附录:访问类型
owner_idOSS Bucket拥有者的阿里云账号ID。
referer请求的HTTP Referer。
request_id请求ID。
request_lengthHTTP请求的大小,包括header,单位:字节。
request_uriHTTP请求的URI,包括query-string,格式为URL编码,查询时可以使用select url_decode(request_uri)解码。
requester_id请求者的ID,如果是匿名访问,则显示为短划线(-)。
response_body_lengthHTTP响应中的Body大小,不包括header。
response_timeHTTP响应时间,单位:毫秒。
server_cost_timeOSS服务器处理本次请求所花的时间,单位:毫秒。
sign_type签名类型 。
  • NotSign:未签名。
  • NormalSign:一般方式签名。
  • UriSign:通过URL签名。
  • AdminSign:管理员账号。
sync_request同步请求类型 。
  • 短划线(-):一般请求。
  • cdn:CDN回源。
  • sync-public:跨区域复制。
  • lifecycle:设置生命周期规则。
timeOSS收到请求的时间,例如27/Feb/2018:13:58:45。如果需要时间戳可以使用__time__字段。
user-agentHTTP的User-Agent头,例如curl/7.15.5。
vpc_addrOSS所在VPC的VIP地址。

该地址为整数类型(例如343819108),您可以使用int_to_ip(cast(vpc_addr as bigint)),将其转换为IP地址形式。

vpc_id客户端所在VPC的ID。
restore_priority解冻优先级。
extend_information扩展字段,默认为短划线(-)。

如果是通过RAM角色发起的请求,则日志会记录相关的RAM角色信息,拼接规则为requesterParentId,roleName,roleSessionName,roleOwnerId,以半角逗号(,)分隔,可能会继续拼接新字段。

批量删除日志

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

字段名称说明
__topic__日志主题,固定为oss_batch_delete_log。
client_ip发起请求的IP地址,例如客户端IP地址、其网络防火墙或Proxy的IP地址。
user_agentHTTP的User-Agent头,例如curl/7.15.5。
bucketOSS Bucket名称。
error_codeOSS返回的错误码。更多信息,请参见错误码概述
request_lengthHTTP请求的大小,包括header,单位:字节。
response_body_lengthHTTP响应Body的大小,不包括header。
object请求的OSS Object,格式为URL编码,查询时可以使用select url_decode(object)解码。
object_sizeOSS Object的大小,对应请求对象的大小,单位:字节。
operation访问类型。更多信息,请参见附录:访问类型
bucket_locationOSS Bucket所在的数据中心,格式为oss-<region ID>。
http_methodHTTP请求方法,例如POST。
referer请求的HTTP Referer。
request_id请求ID。
http_statusHTTP请求返回的状态。
sync_request同步请求类型。
  • 短划线(-):一般请求。
  • cdn:CDN回源。
  • sync-public:跨区域复制。
request_uri请求的URI,包括query-string,格式为URL编码,查询时可以使用select url_decode(request_uri)解码。
host请求访问域名,例如bucket123.oss-cn-beijing.aliyuncs.com。
logging_flag是否开启定期导出日志到OSS Bucket的功能,true表示开启。
server_cost_timeOSS服务器处理本次请求的时间,单位:毫秒。
owner_idOSS Bucket拥有者的阿里云账号ID。
requester_id请求者的ID,如果匿名访问则为短划线(-)。
delta_data_sizeOSS Object大小的变化量,如果没有变化则为0;如果不是上传请求,则为短划线(-)。

每小时计量日志

记录特定OSS Bucket每个小时累计的计量信息,供辅助分析时参考使用。

字段名称说明
__topic__日志主题,固定为oss_metering_log。
owner_idOSS Bucket拥有者的阿里云账号ID。
bucketOSS Bucket名称。
cdn_inCDN流入量,单位:字节。
cdn_outCDN流出量,单位:字节。
get_requestGET请求次数。
intranet_in内网流入量,单位:字节。
intranet_out内网流出量,单位:字节。
network_in外网流入量,单位:字节。
network_out外网流出量,单位:字节。
put_requestPUT请求次数。
storage_typeOSS Bucket存储类型 。
  • standard:标准存储类型。
  • archive:归档存储类型。
  • infrequent_access:低频访问存储类型。
storageOSS Bucket存储量,单位:字节。
metering_datasize非标准存储的计量数据大小。
process_img_size处理的图像大小,单位:字节。
process_img处理图像。
sync_in同步流入量,单位:字节。
sync_out同步流出量,单位:字节。
start_time计量开始时间戳,单位:秒。
end_time计量截止时间戳,单位:秒。
regionOSS Bucket所在地域。
bucket_locationOSS 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文件。
RedirectBucketbucket endpoint重定向。
RestoreObject解冻文件。
UploadPart断点上传文件。
UploadPartCopy复制文件块。
get_image_exif获取图片的exif信息。
get_image_info获取图片的长宽等信息。
get_image_infoexif获取图片的长宽以及exif信息。
get_style获取Bucket样式。
list_style列举Bucket的样式。
put_style创建Bucket样式。