Skip to main content

Logs in S3

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 storing other objects in the storage; for details, see the S3 billing model and prices instructions.

Log fields

client_ipIP address from which the request originated
client_to_server_bytesNumber of bytes transferred during the request to storage
bucket_nameName of the bucket the request was made to
hostHost header — address to which the request was made
http_methodHTTP method of the request to storage
pathPath to the bucket or object in storage that the request was made to
queryRequest parameters
server_to_client_bytesNumber of bytes transferred in response to the request
statusHTTP status code in response to the request
timestampDate and time of the log entry

Export logs

  1. Export logs.
  2. Download exported logs.

1. Create a log export

  1. In the Control panel, click Products in the top menu 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 fields to be displayed in the logs. If none are selected, all fields will be included in the export.
  7. Optional: select the buckets for which logs will be included in the export. If you do not select any buckets, the export will include logs for all buckets.
  8. 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.
  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 history page with the IN PROGRESS status. Once the export changes its status 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 be displayed on the Log export history page, but the log file will be deleted and downloading will be unavailable. You can recreate the export with the same parameters.

  1. In the Control panel, click Products in the top menu and select S3.
  2. Go to the Logs section.
  3. In the export menu, 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, click Products in the top menu and select S3.
  2. Go to the Logs section.
  3. In the export menu, select Recreate export. A new export will be added as a separate line on the Log export history page with the IN PROGRESS status. Once the export changes its status to DONE, you will be able to download it.