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 requester. 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 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 type of the operation that is specified in the request. 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 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 "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 OSS object. For more information, see storage classes. host The domain name that is requested. vpc_addr The virtual private cloud (VPC) IP address 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 "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 type of the operation that is specified in the request. 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 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 "storage classes" 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. Unit: seconds. end_time The time at which the metering operation ends. Unit: seconds. region The region where the bucket resides.
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.
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. |
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.
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. |