Get started
Yandex Object Storage

Logging actions with the bucket

Written by

To track operations with the bucket, enable logging. Detailed information about requests to the source bucket will be saved in an object in the target bucket. However, Object Storage doesn't guarantee that the logs will be saved fully and quickly.

Logging is disabled by default. After you enable it, Object Storage will save information about actions with the bucket once an hour.

Enable logging

To log requests to the bucket:

  1. Use an existing target bucket or create a new target bucket named bucket-logs, for example. This is the bucket your logs will be written to.

    How create backet
    1. In the management console, select the folder where you want to create a bucket.
    2. Select Object Storage.
      This opens a page with a list of buckets.
    3. Click Create bucket.
    4. On the bucket creation page:

      1. Enter the bucket name, following the naming guidelines.

      2. If necessary, limit the maximum bucket size.

        If 0, the maximum size isn't limited. It's similar to the enabled No limit option.

      3. Selected the type of access.

      4. Select the default storage class by default.

      5. Click Create bucket to complete the operation.

  2. Enable logging in the source bucket that you want to track.

    Send the request using the method putBucketLogging. In the request body, specify:

    • The name of the target bucket in the parameter <TargetBucket>, for example, bucket-logs.
    • (optional) Prefix to be used with all the keys of the log objects, in the parameter <TargetPrefix>. The prefix must end with /, for example, logs/.

    Example of the HTTP request body:

    <BucketLoggingStatus xmlns="http://doc.s3.amazonaws.com/2006-03-01">
  <LoggingEnabled>
    <TargetBucket>bucket-logs</TargetBucket>
    <TargetPrefix>logs/</TargetPrefix>
  </LoggingEnabled>
</BucketLoggingStatus>

Get the logging settings

To get the name of the target bucket and the prefix of the key for the log object, follow these steps:

Send the request using the method getBucketLogging.

Example of the HTTP response body:

HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus>
   <LoggingEnabled>
      <TargetBucket>bucket-logs</TargetBucket>
      <TargetPrefix>logs/</TargetPrefix>
   </LoggingEnabled>
</BucketLoggingStatus>

Get the logs

To get your logs, download the object with the logs/ prefix from the bucket-logs bucket:

  1. In the management console, select the folder where the bucket-logs bucket is located.
  2. Select Object Storage.
  3. Click on the bucket-logs bucket name.
  4. Click on the object name with the logs/ prefix.
  5. Click Download.

Disable logging

To disable logging, follow these steps:

Send the request using the method putBucketLogging. In the request body, pass the <BucketLoggingStatus> parameter with an empty value.

Example of the HTTP request body:

<BucketLoggingStatus xmlns="http://doc.s3.amazonaws.com/2006-03-01" />
In this article: