Logs in S3

The logs contain information about requests to buckets.

You can export logs via the Control Panel. You can also work with logs via the Object Storage API.

Exported logs are saved to the selected bucket. Log storage is billed the same way as other objects in the storage; for more details, see the S3 billing model and prices guide.

Log fields

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

1. Create a log export

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 export.
Specify the period for which you want to export logs.
Optional: select the fields to be displayed in the logs. If you do not select any, all fields will be displayed in the export.
Optional: select the buckets to include logs from in the export. If you do not select any buckets, logs from all buckets will be included in the export.
Optional: specify the log retention period or leave it for indefinite storage. Once the retention period expires, the log file will be deleted from the bucket.
Select the bucket where the log file will be saved. If there are no buckets in the storage, click Create bucket and create a new one.
Click Create export. The export will appear on the Log Export Log page with the IN PROGRESS status. When the export status changes to DONE, you will be able to download it.

2. Download a log export

You can download an export of logs that has not yet expired.

For your information

If the retention period has expired, the export will be shown on the Log Export Log page, but the log file will be deleted and downloading will be unavailable. You can recreate the export with the same parameters.

In the control panel, on the top menu, click Products and select S3.
Go to the Logs section.
In the menu for the export, select Download export.

Re-create a log export

If the log file storage period has expired or an error occurred during export creation, you can repeat the export with the same parameters.

In the control panel, on the top menu, click Products and select S3.
Go to the Logs section.
In the menu of the export, select Recreate export. The new export will be added as a separate row on the Log Export Log page with the IN PROGRESS status. When the export status changes to DONE, you will be able to download it.