Logs in S3

The logs contain information about requests to public buckets.

You can upload logs through the control panel. You can also work with logs via the Object Storage API.

Uploaded logs are stored in the selected bucket. Storage of logs is charged in the same way as storage of other objects in the storage, more details in the S3 Payment and Price Model instruction.

Log fields

client_ip	IP address from which the request came
client_to_server_bytes	Number of bytes transferred during a request to the storage
bucket_name	Name of the bucket to which the request was made
host	Host header — the address at which the request was made
http_method	HTTP method of request to storage
path	Path to the bucket or object in the storage to which the request was made
query	Request parameters
server_to_client_bytes	Number of bytes transferred in response to a request
status	HTTP status code in response to a request
timestamp	Date and time of logging

Upload logs

1. Create a log upload.
2. Download the log upload.

1. Create a log upload

1. In the control panel, on the top menu, click Products and select S3.
2. Go to the Logs section.
3. Select a region and pool.
4. Click Create Upload.
5. Specify the period for which you want to upload logs.
6. Optional: select the fields that will be displayed in the logs. If not selected, all fields will be displayed in the upload.
7. Optional: select bucket logs for which logs will be included in the upload. If you do not select bacteria, all bacteria logs will be included in the upload.
8. Optionally: specify logs storage period or leave indefinite storage. After the retention period expires, the log file will be deleted from the bucket.
9. Select the bucket in which the log file will be saved. If there are no bucket in the storage, click Create bucket and create a new bucket.
10. Click Create Upload. The upload will appear on the Log Upload Log page with a status of IN PROGRESS. When the upload goes to DONE status, you can download it.

2. Download the log upload

You can download a log upload that has not expired.

For your information

If the deadline has expired, the upload will be displayed on the Log Upload Log page, but the log file will be deleted and the download will not be available. You can recreate the upload with the same parameters.

1. In the control panel, on the top menu, click Products and select S3.
2. Go to the Logs section.
3. From theupload menu, select Download Upload.

Re-create log upload

If the storage period of the log file has expired or an error occurred when creating the upload, you can repeat the upload with the same parameters.

1. In the control panel, on the top menu, click Products and select S3.
2. Go to the Logs section.
3. From theUpload menu, select Recreate Upload. The new upload will be added as a separate line on the Log Upload Log page with a status of IN PROGRESS. When the upload is DONE, you will be able to download it.