Работа с механизмом логирования действий с бакетом
Чтобы отслеживать работу с бакетом, включите механизм логирования. Подробная информация о запросах к исходному бакету будет сохранена в объекте в целевом бакете. Однако Object Storage не гарантирует полноту и своевременность записи логов.
По умолчанию механизм логирования отключен. После его включения, Object Storage будет записывать информацию о действиях с бакетом раз в час.
Включите механизм логирования
Чтобы логировать обращения к бакету:
-
Используйте существующий или создайте новый целевой бакет с именем, например,
bucket-logs
. В этот бакет будут записываться логи.Как создать бакетКонсоль управления- В консоли управления выберите каталог, в котором хотите создать бакет.
- Выберите сервис Object Storage.
- Нажмите кнопку Создать бакет.
- На странице создания бакета:
-
Введите имя бакета в соответствии с правилами именования.
-
При необходимости ограничьте максимальный размер бакета.
Размер
0
означает отсутствие ограничений и аналогичен включенной опции Без ограничений. -
Выберите тип доступа.
-
Выберите класс хранилища по умолчанию.
-
Нажмите кнопку Создать бакет для завершения операции.
-
-
Включите механизм логирования в исходном бакете, который вы хотите отслеживать.
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>
- имя целевого бакета в параметре
Получите настройки логирования
Чтобы получить имя целевого бакета и префикс ключа объекта с логами, выполните следующее действие:
Отправьте запрос методом getBucketLogging.
Пример тела HTTP-ответа:
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/
:
- В консоли управления выберите каталог, где находится бакет
bucket-logs
. - Выберите сервис Object Storage.
- Нажмите на имя бакета
bucket-logs
. - Нажмите на имя объекта с префиксом
logs/
. - Нажмите кнопку Скачать.
Выключить механизм логирования
Чтобы выключить логирование, выполните следующее действие:
Отправьте запрос методом putBucketLogging. В теле запроса передайте параметр <BucketLoggingStatus>
с пустым значением.
Пример тела HTTP-запроса:
<BucketLoggingStatus xmlns="http://doc.s3.amazonaws.com/2006-03-01" />