Overview

You can enable the log management feature for log analysis or auditing purposes. Logs provide the bucket owner with comprehensive insights into the attributes, types, and trends of access requests to the bucket. Once you enable the log management feature for a bucket, ZOS automatically logs access requests to that bucket and generates log files, which are then written to the specified bucket. Logs also consume storage space, resulting in additional costs. By default, the log management feature is disabled.

Log Field Description

When the log management feature is enabled, the generated access log includes the following fields:

Name	Examples	Description
owner_id	testuser	Source storage bucket owner ID
bucket	sbucket	Source storage bucket name
time	[23/Aug/2020:10:00:42+0800]	Access Time
remote_addr	192.168.56.xxx	IP Address of the Initiated Request
user	testuser	Execution User
request_id	tx00000000000000000001c-005f41cdca-a222f-default	Unique request ID
operation	REST.GET.ACL	Request Type
oname	obj_name	Object Name
uri	GET/sbucket?aclHTTP/1.1	URI of User Request
http_status	200	Returned HTTP Status Code
error_code	-	Returned Error Code
bytes_sent	441	Traffic Consumed by the Download
obj_size	0	Object Size
total_time	1	Time (in milliseconds) taken to process the request
referrer	-	HTTP referer of the Request
user_agent	Boto3/1.4.6Python/2.7.5Linux/3.10.0-1062.el7.x86_64Botocore/1.8.35	The user-agent header of the HTTP request
oversion_id	-	Version ID

Note:

Log file format: Field names are presented sequentially from left to right and are separated by spaces.
Any field can be replaced by a hyphen (-), indicating unknown data or that the field is invalid for the request.

Zettabyte Object Storage

Introduction to Logging