All Documents
Current Document

Content is empty

If you don't find the content you expect, please try another search term

Documentation

Configure logging

Last updated:2021-10-18 16:00:49

You can enable and disable logging for buckets in the Kingsoft Cloud Standard Storage Service (KS3) console. You can store the logs of a bucket in the same bucket itself or create a bucket in the same region to store the logs.

By default, logging is disabled for buckets in KS3. You can enable logging for a bucket and manually specify the storage location.

A log file is named in the format of ks3log_Bucket name_yyyy_MM_dd.log.

For more information about the API operation for configuring logging, see GET Bucket logging.

Log format

The following table describes the fields in a log. The fields are arranged from left to right and separated with tabs.

Field Example Remarks
bucket_owner NzM0MDEzMzI= The Base64-encoded result of the Kingsoft Cloud account ID.
bucket bucket_test The bucket name.
time [11/Jan/2016:15:05:35 +0800] The time when the log was generated.
remote_ip 219.141.176.229 The request IP address.
requester Anonymous The requester. If the requester is an anonymous user, the field value is Anonymous.
If the requester is a Kingsoft Cloud account, the field value is the Base64-encoded result of the Kingsoft Cloud account ID.
If the requester is an IAM user, the field value is the Base64-encoded result of a string in the format of `ID of the Kingsoft Cloud account/Username of the IAM user.
request_id 1e6ac821e4904e4ca21d3a9e0ce52e25 The request ID.
operation REST.POST.OBJECT The operation. The operation in this example is Post Object.
key - The object key.
request_uri "POST /chenjin.jpg HTTP/1.1" The request URL.
http_status 200 The request status code.
error_code - The error code.
bytes_sent 461 The number of bytes that are sent.
object_size 139008 The size of the accessed resource.
total_time 2 The total request duration, measured in seconds and accurate to milliseconds.
turn_around_time 2 The round trip duration between NGINX and the API server, measured in seconds and accurate to milliseconds.
referer "http://ks3.ksyun.com/console.html" The request referer.
user_agent "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/45.0.2454.101 Safari/537.36" The user agent.
version_id - The version ID. This field is reserved.
storageclass Standard The storage class of the accessed resource.
usertype - The user type. By default, this field is not displayed for regular users. For CDN users, the field value is kc.
nginx_port 80 The NGINX port. Ports 8000 and 4433 are used for access over the internal network. Port 80 is used for access over the Internet.

Note:

  • The logging latency is one day. You can view the logs of a day in the afternoon of the next day.
  • The value of any field in the log can be displayed as -, which indicates unknown data or invalidity of the field for the current request.
  • New fields will be added to the end of KS3 logs as required. Consider compatibility when you develop log processing tools.

Operation methods

Operation method Description
Console Web application, which is easy to use
SDK for Java Diversified and complete SDK demos in various languages
SDK for PHP
SDK for Node.js
SDK for Go
On this page
Pure ModeNormal Mode

Pure Mode

Click to preview the document content in full screen
Feedback