Работа с механизмом логирования действий с бакетом

Чтобы отслеживать работу с бакетом, включите механизм логирования. Подробная информация о запросах к исходному бакету будет сохранена в объекте в целевом бакете. Однако Object Storage не гарантирует полноту и своевременность записи логов.

По умолчанию механизм логирования отключен. После его включения, Object Storage будет записывать информацию о действиях с бакетом раз в час.

Включите механизм логирования

Чтобы логировать обращения к бакету:

1. Используйте существующий или создайте новый целевой бакет с именем, например,bucket-logs. В этот бакет будут записываться логи.

   Как создать бакет

   Консоль управления

   1. В консоли управления выберите каталог, в котором хотите создать бакет.
   2. Выберите сервис Object Storage.
   3. Нажмите кнопку Создать бакет.
   4. На странице создания бакета:

      1. Введите имя бакета в соответствии с правилами именования.

      2. При необходимости ограничьте максимальный размер бакета.

         Размер 0 означает отсутствие ограничений и аналогичен включенной опции Без ограничений.

      3. Выберите тип доступа.

      4. Выберите класс хранилища по умолчанию.

      5. Нажмите кнопку Создать бакет для завершения операции.

2. Включите механизм логирования в исходном бакете, который вы хотите отслеживать.

   API

   Отправьте запрос методом putBucketLogging. В теле запроса укажите:

   • имя целевого бакета в параметре <TargetBucket>, например, bucket-logs;
   • (опционально) префикс, который будет использоваться со всеми ключами объектов с логами, в параметре <TargetPrefix>. Префикс должен заканчиваться знаком /, например, logs/.

   Пример тела HTTP-запроса:

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

Получите настройки логирования

Чтобы получить имя целевого бакета и префикс ключа объекта с логами, выполните следующее действие:

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

Получите логи

Чтобы получить логи, скачайте из бакета bucket-logs объект с префиксом logs/:

Выключить механизм логирования

Чтобы выключить логирование, выполните следующее действие:

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