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 using 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; learn more in the S3 Payment Model and Pricing instructions.

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

Export logs

1. Create a log export.
2. Download a log export.

1. Create a log export

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 export.
5. Specify the period for which you want to export logs.
6. Optional: select the fields that will be shown in the logs. If you do not select any, all fields will be shown in the export.
7. Optional: select the buckets whose logs will be included in the export. If you do not select buckets, the export will include logs for all buckets.
8. Optional: specify the log retention period or leave them indefinitely. Once the retention period expires, the log file will be deleted from the bucket.
9. 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 bucket.
10. Click Create export. The export will appear on the Log export log page with the status IN PROGRESS. 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 period has expired, the export will still appear on the Log export log page, but the log file will have been deleted and will be unavailable for download. You can re-create the export 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. 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.

1. In the control panel, on the top menu, click Products and select S3.
2. Go to the Logs section.
3. In the menu for the export, select Re-create export. The new export will be added as a separate line on the Log export log page with the status IN PROGRESS. When the export status changes to DONE, you will be able to download it.