This topic describes the fields in the log entries that are generated by Object Storage Service (OSS).

  • Access logs

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

    Field Description
    __topic__ The topic of the log entry. Valid value: 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 Alibaba Cloud account that sends the request.
    time The time at which OSS receives the request. If you want to record timestamps, use the _time_ field.
    owner_id The ID of the Alibaba Cloud account that owns the bucket.
    User-Agent The User-Agent field in the header of the request.
    logging_flag Indicates whether logging is enabled to export logs to the 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 type of the operation that is specified in the request. For more information, see the "Table 2" 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 Error responses.
    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 sends 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 "Table 4" 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 "Table 3" section of this topic.
    bucket_storage_type The storage class of the OSS bucket. For more information, see Table 1.
    host The domain name that is requested.
    vpc_addr The IP address of the virtual private cloud (VPC) that maps the requested domain name.
    vpc_id The ID of the VPC to which the bucket belongs.
    delta_data_size The amount of change in the size of the requested object. If the size of the object does not change, the value of this field is 0. If the request does not specify an upload operation, the value of this field is a hyphen (-).
    acc_access_region If the request specifies to accelerate data transmission, the value of this field is the ID of the region where the requested access point resides. Otherwise, the value of this field is a hyphen (-).
    restore_priority The priority of the log entry in the event of data restoration.
  • Batch deletion logs
    Batch deletion logs record the operations that are performed to delete multiple objects at a time from each bucket. Batch deletion log entries are collected in real time. The following table describes the fields in a batch deletion log entry.
    Note When you call the DeleteObjects operation, an access log entry is generated to record the operation. The information about the objects that you specify in the DeleteObjects operation is carried in the body of the request. Therefore, the value of the object field in the generated access log entry 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 log entries in which the value of the request_id field matches the ID of the request.
    Field Description
    __topic__ The topic of the log entry. Valid value: 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 "Table 3" 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 type of the operation that is specified in the request. For more information, see the "Table 2" 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 "Table 3" 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 domain name that is requested.
    logging_flag Indicates whether logging is enabled to export logs to the 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 sends the request. If you use an anonymous logon, the value of this field is a hyphen (-).
    delta_data_size The amount of change in the size of the requested object. If the size of the object does not change, the value of this field is 0. If the request does not specify an upload operation, the value of this field is a hyphen (-).
  • Hourly metering logs

    Hourly metering logs record the hourly metering operations on each bucket. Hourly metering log entries are collected at a latency of a few hours. The following table describes the fields in an hourly metering log entry.

    Field Description
    __topic__ The topic of the log entry. Valid value: 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 OSS bucket. For more information, see the "Table 1" section of this topic.
    storage The amount of data in the bucket. Unit: bytes.
    metering_datasize The amount of data of a storage class rather than the Standard storage class 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.
    end_time The time at which the metering operation ends.
    region The region where the bucket resides.
Table 1. Bucket 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 the related API operations, see List of operations by function.
Table 2. Operation types
Operation Description
AbortMultiPartUpload Aborts 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 live channel.
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 live channel.
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 events of a bucket.
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 video-on-demand (VOD) playlist for a live channel.
ProcessImage Processes an image.
PutBucket Creates a bucket.
PutBucketCors Configures a CORS rule for a bucket.
PutBucketLifecycle Configures the lifecycle of a bucket.
PutBucketLog Configures an access log for a bucket.
PutBucketWebSite Configures the static website hosting feature for a bucket.
PutLiveChannel Creates a live channel.
PutLiveChannelStatus Specifies the status of a live channel.
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 Resumes a multipart upload task from a specified checkpoint.
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 the bucket style of a live channel.
list_style Queries all bucket styles that are available for a live channel.
put_style Creates a bucket style.
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.
For more information about signatures, see Verify user signatures.
Table 4. Signature types
Signature type Description
NotSign The request is unsigned.
NormalSign The request is signed with a regular signature.
UriSign The request is signed with a URL signature.
AdminSign The request is signed with an administrator account.