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 through the Selectel Storage API.

Uploaded logs are saved to the selected bucket.Log storage is charged in the same way as storing other objects in the storage, more details in the S3 Payment and Pricing Model instructions.

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

1. Create a log upload

In the control panel, on the top menu, click Products and select S3.
Go to the Logs section.
Select a region and pool.
Click Create Upload.
Specify the period for which you want to upload logs.
Optional: select the fields that will be displayed in the logs.If not selected, all fields will be displayed in the upload.
Optional: select the bucket for which logs will be included in the upload.If you do not select bucket, the upload will include logs for all bucket.
Optionally: specify a retention period for logs or leave indefinite storage.After the retention period expires, the log file will be deleted from the bucket.
Select the bucket in which the log file will be saved.If there are no bucket in the repository, click Create Bucket and create a new bucket.
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 be unavailable.You can recreate the upload with the same parameters.

In the control panel, on the top menu, click Products and select S3.
Go to the Logs section.
From the upload 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.

In the control panel, on the top menu, click Products and select S3.
Go to the Logs section.
From the menu of the upload, 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 goes to DONE status, you can download it.