OSS log fields - Simple Log Service - Alibaba Cloud Documentation Center

This topic describes the fields of Object Storage Service (OSS) logs.

Access logs

Access logs record all incoming traffic to each OSS bucket. Access logs are collected in real time. The following table describes the fields in an access log.

Field	Description
__topic__	The topic of the log. The value is fixed as oss_access_log.
owner_id	The ID of the Alibaba Cloud account that owns the bucket.
region	The region where the bucket resides.
access_id	The AccessKey ID of the requester.
time	The time at which OSS receives the request. If you want to record timestamps, use the __time__ field.
User-Agent	The User-Agent field in the header of the request.
logging_flag	Indicates whether logging is enabled to export logs to a bucket at regular intervals.
bucket	The name of the bucket.
content_length_in	The value of the Content-Length field in the header of the request. Unit: bytes.
content_length_out	The value of the Content-Length field in the header of the response. Unit: bytes.
object	The URL-encoded object that is requested. You can include the select url_decode(object) clause in your query statement to decode the object.
object_size	The size of the requested object. Unit: bytes.
operation	The API operation. For more information, see the Operation types section of this topic.
request_uri	The URL-encoded URI of the request. The value of this field includes a query string. You can include the select url_decode(request_uri) clause in your query statement to decode the URI.
error_code	The error code that is returned by OSS. For more information, see Overview.
request_length	The size of the request. The size includes the header of the request. Unit: bytes.
client_ip	The IP address from which the request is sent. The IP address can be the IP address of a client, firewall, or proxy.
response_body_length	The size of the body of the response. The size excludes the header of the response.
http_method	The method that is used to send the request.
referer	The Referer field in the header of the request.
requester_id	The ID of the Alibaba Cloud account that is used to send the request. If you use an anonymous logon, the value of this field is a hyphen (-).
request_id	The ID of the request.
response_time	The amount of time that is taken by OSS to respond to the request. Unit: milliseconds.
server_cost_time	The amount of time that is taken by OSS to process the request. Unit: milliseconds.
http_type	The protocol over which the request is sent. Valid values: HTTP and HTTPS.
sign_type	The type of the signature in the request. For more information, see the Signature types section of this topic.
http_status	The status code in the response that is returned by OSS.
sync_request	The type of synchronous communication for the request. For more information, see the Synchronous request types section of this topic.
bucket_storage_type	The storage class of the requested object. For more information, see the Storage classes section of this topic.
host	The endpoint of the bucket.
vpc_addr	The virtual IP address (VIP) of the server that resides in a Virtual Private Cloud (VPC) and hosts the bucket. Data type: integer. Example: 343819108. You can convert the VIP into an IP address by using the `int_to_ip(cast(vpc_addr as bigint))` function.
vpc_id	VPC ID
delta_data_size	The change in the size of the requested object. If the object size does not change, the value of this field is 0. If the request is not an upload request, the value of this field is a hyphen (-).
acc_access_region	The region of the OSS endpoint that is specified in the request. If the request is sent when the transfer acceleration is enabled, the value of this field is the ID of the region. If the request is sent when the transfer acceleration is disabled, the value of this field is a hyphen (-).
restore_priority	The priority of the log in the event of data restoration.
extend_information	The extended fields. Default value: hyphen (-). If the request is initiated by using a RAM role, the log records the information about the RAM role. The information is in the `requesterParentId,roleName,roleSessionName,roleOwnerId` format. The fields in the information are separated with commas (,). New fields can be added to the information.

Batch deletion logs

Batch deletion logs record the operations that are performed to delete multiple objects at a time from each bucket. Batch deletion logs are collected in real time. The following table describes the fields in a batch deletion log.

Note

When you call the DeleteObjects operation, an access log is generated to record the operation. The information about the objects that you specify in the DeleteObjects operation is included in the body of the request. Therefore, the value of the object field in the generated access log is a hyphen (-). If you want to view the information about the objects that you specify in the DeleteObjects operation, you can query the batch deletion logs in which the value of the request_id field matches the ID of the request.

Field	Description
__topic__	The topic of the log. The value is fixed as oss_batch_delete_log.
owner_id	The ID of the Alibaba Cloud account that owns the bucket.
region	The region where the bucket resides.
client_ip	The IP address from which the request is sent. The IP address can be the IP address of a client, firewall, or proxy.
user_agent	The User-Agent field in the header of the request.
bucket	The name of the bucket.
error_code	The error code that is returned by OSS. For more information, see the Synchronous request types section of this topic.
request_length	The size of the body of the request. The size includes the header of the request. Unit: bytes.
response_body_length	The size of the body of the response. The size excludes the header of the response.
object	The URL-encoded object that is requested. You can include the select url_decode(object) clause in your query statement to decode the object.
object_size	The size of the requested object. Unit: bytes.
operation	The API operation. For more information, see the Operation types section of this topic.
bucket_location	The cluster to which the bucket belongs.
http_method	The method that is used to send the request.
referer	The Referer field in the header of the request.
request_id	The ID of the request.
http_status	The status code in the response that is returned by OSS.
sync_request	The type of synchronous communication for the request. For more information, see the Synchronous request types section of this topic.
request_uri	The URL-encoded URI of the request. The value of this field includes a query string. You can include the select url_decode(request_uri) clause in your query statement to decode the URI.
host	The endpoint of the bucket.
logging_flag	Indicates whether logging is enabled to export logs to a bucket at regular intervals.
server_cost_time	The amount of time that is taken by OSS to process the request. Unit: milliseconds.
owner_id	The ID of the Alibaba Cloud account that owns the bucket.
requester_id	The ID of the Alibaba Cloud account that is used to send the request. If you use an anonymous logon, the value of this field is a hyphen (-).
delta_data_size	The change in the size of the requested object. If the object size does not change, the value of this field is 0. If the request is not an upload request, the value of this field is a hyphen (-).

Hourly metering logs

Hourly metering logs record the hourly metering operations on each bucket. Hourly metering logs are collected several hours after the logs are generated. The following table describes the fields in an hourly metering log.

Field	Description
__topic__	The topic of the log. The value is fixed as oss_metering_log.
owner_id	The ID of the Alibaba Cloud account that owns the bucket.
bucket	The name of the bucket.
cdn_in	The volume of inbound traffic from CDN to the bucket. Unit: bytes.
cdn_out	The volume of outbound traffic from the bucket to CDN. Unit: bytes.
get_request	The number of GET requests that are sent to request resources from the bucket.
intranet_in	The volume of inbound traffic to the bucket over internal networks. Unit: bytes.
intranet_out	The volume of outbound traffic from the bucket over internal networks. Unit: bytes.
network_in	The volume of inbound traffic to the bucket over the Internet. Unit: bytes.
network_out	The volume of outbound traffic from the bucket over the Internet. Unit: bytes.
put_request	The number of PUT requests that are sent to request resources from the bucket.
storage_type	The storage class of the bucket. For more information, see the Storage classes section of this topic.
storage	The amount of data in the bucket. Unit: bytes.
metering_datasize	The amount of data whose storage class is not Standard in the bucket.
process_img_size	The size of the image that is processed. Unit: bytes.
process_img	The image that is processed.
sync_in	The volume of inbound traffic to the bucket over synchronous requests. Unit: bytes.
sync_out	The volume of outbound traffic from the bucket over synchronous requests. Unit: bytes.
start_time	The time at which the metering operation starts. Unit: seconds.
end_time	The time at which the metering operation ends. Unit: seconds.
region	The region where the bucket resides.

Table 1. Storage classes

Storage class	Description
standard	The Standard storage class.
archive	The Archive storage class.
infrequent_access	The Infrequent Access (IA) storage class.

For more information about API operations, see List of operations by function.

Table 2. Operation types

Operation	Description
AbortMultiPartUpload	Cancels a multipart upload task.
AppendObject	Appends an object.
CompleteUploadPart	Completes a multipart upload task.
CopyObject	Copies an object.
DeleteBucket	Deletes a bucket.
DeleteLiveChannel	Deletes a LiveChannel.
DeleteObject	Deletes an object.
DeleteObjects	Deletes multiple objects.
GetBucket	Queries all objects in a bucket.
GetBucketAcl	Queries the access control list (ACL) of a bucket.
GetBucketCors	Queries the cross-origin resource sharing (CORS) rules of a bucket.
GetBucketEventNotification	Queries the notification configurations of a bucket.
GetBucketInfo	Queries the information about a bucket.
GetBucketLifecycle	Queries the lifecycle rules of a bucket.
GetBucketLocation	Queries the region where a bucket resides.
GetBucketLog	Queries the access log configurations of a bucket.
GetBucketReferer	Queries the hotlink protection configurations of a bucket.
GetBucketReplication	Queries the cross-region replication (CRR) rules of a bucket.
GetBucketReplicationProgress	Queries the progress of a CRR task that is performed on a bucket.
GetBucketStat	Queries the status of a bucket.
GetBucketWebSite	Queries the status of the static website hosting feature for a bucket.
GetLiveChannelStat	Queries the status of a LiveChannel.
GetObject	Reads an object.
GetObjectAcl	Queries the ACL of an object.
GetObjectInfo	Queries the information about an object.
GetObjectMeta	Queries the metadata of an object.
GetObjectSymlink	Queries the symbolic link of an object.
GetPartData	Queries the data in all parts of an object.
GetPartInfo	Queries the information about all parts of an object.
GetProcessConfiguration	Queries the image processing configurations of a bucket.
GetService	Queries all buckets that are created within your Alibaba Cloud account.
HeadBucket	Queries the information about a bucket.
HeadObject	Queries the metadata of an object.
InitiateMultipartUpload	Initializes a multipart upload task.
ListMultiPartUploads	Queries all multipart upload tasks in progress.
ListParts	Queries the status of all parts of an object.
PostObject	Uploads an object by using a form.
PostProcessTask	Commits a task to process data, such as screenshots.
PostVodPlaylist	Creates a playlist for a LiveChannel.
ProcessImage	Processes an image.
PutBucket	Creates a bucket.
PutBucketCors	Configures CORS rules for a bucket.
PutBucketLifecycle	Configures lifecycle rules for a bucket.
PutBucketLog	Enables logging for a bucket.
PutBucketWebSite	Enables the static website hosting feature for a bucket.
PutLiveChannel	Creates a LiveChannel.
PutLiveChannelStatus	Changes the state of a LiveChannel.
PutObject	Uploads an object.
PutObjectAcl	Modifies the ACL of an object.
PutObjectSymlink	Creates a symbolic link for an object.
RedirectBucket	Redirects a request to the endpoint of a different bucket.
RestoreObject	Restores an object.
UploadPart	Uploads an object by part.
UploadPartCopy	Copies a part of an object.
get_image_exif	Queries the exchangeable image file format (EXIF) data of an image.
get_image_info	Queries the length and width of an image.
get_image_infoexif	Queries the length, width, and EXIF data of an image.
get_style	Queries a style of a bucket.
list_style	Queries all styles of a bucket.
put_style	Creates a style for a bucket.

Table 3. Synchronous request types

Synchronous request type	Description
Hyphen (-)	The request is a general request.
cdn	The request is a CDN back-to-origin request.
sync-public	The request is a CRR request.
lifecycle	The request is a lifecycle rules configuration request.

For more information about signatures, see Verify user signatures.

Table 4. Signature types

Signature type	Description
Hyphen (-)	The request is a general request.
NotSign	The request is unsigned.
NormalSign	The request is signed by using a regular signature.
UriSign	The request is signed by using a URL signature.
AdminSign	The request is signed by using an administrator account.
NORMAL_SIGN4	The request is signed by using the Authorization header that includes a V4 signature. For more information, see (Recommended) Include a V4 signature in the Authorization header.
URI_SIGN4	The request is signed by using a URL that includes a V4 signature. For more information, see Signature version 4 (recommended).