[Документация Yandex Cloud](../../index.md) > [Yandex Audit Trails](../index.md) > [Концепции](index.md) > Аудитный лог событий уровня сервисов # Аудитный лог событий уровня сервисов Отслеживайте [события уровня сервисов](events-data-plane.md), чтобы убедиться, что только авторизованные пользователи получают доступ к вашим данным и изменяют их. Это поможет обеспечить соответствие вашей облачной инфраструктуры нормативным правовым актам и отраслевым стандартам. Например, вы можете отслеживать получение сотрудниками доступа к конфиденциальным данным, хранящимся в бакетах. Анализируйте логи событий уровня сервисов, чтобы оптимизировать использование ресурсов в вашей инфраструктуре. Так вы сможете определить наиболее часто используемые ресурсы и повысить их производительность. Или, наоборот, выявить редко используемые ресурсы, которые можно объединить или удалить для сокращения затрат. {% note warning %} При настройке сбора событий уровня сервисов для бакета Object Storage не рекомендуем выбирать этот же бакет в качестве [объекта назначения](trail.md#target) загрузки логов. В этом случае может возникнуть автоматическая рекурсивная генерация логов аудита, что приведет к увеличению объема генерируемых логов (приблизительно на 16 МБ в месяц для всех событий одного трейла, сохраняемых в бакете). {% endnote %} Аудитный лог событий уровня сервисов — это запись о событиях, которые произошли с ресурсами Yandex Cloud, в форме JSON-объекта. [Формат](#scheme) записей универсален для всех событий. Значения некоторых полей определяются ресурсом-источником и типом события. Объект события — ресурс сервиса, над которым производится операция. Субъект события — аккаунт, от имени которого производится операция. {% cut "Пример аудитного лога уровня сервисов при запросе содержимого секрета" %} Если федеративный пользователь запросит содержимое секрета в сервисе Yandex Lockbox, в аудитный лог попадет такая запись: ```json { "event_id": "<идентификатор_события>", "event_source": "lockbox", "event_type": "yandex.cloud.audit.lockbox.GetPayload", "event_time": "<дата_события>", "authentication": { "authenticated": true, "subject_type": "FEDERATED_USER_ACCOUNT", "subject_id": "<идентификатор_пользователя>", "subject_name": "<логин_пользователя>", "federation_id": "<идентификатор_федерации>", "federation_name": "<имя_федерации>", "federation_type": "<тип_федерации>" }, "authorization": { "authorized": true }, "resource_metadata": { "path": [ { "resource_type": "organization-manager.organization", "resource_id": "<идентификатор_организации>", "resource_name": "<имя_организации>" }, { "resource_type": "resource-manager.cloud", "resource_id": "<идентификатор_облака>", "resource_name": "<имя_облака>" }, { "resource_type": "resource-manager.folder", "resource_id": "<идентификатор_каталога>", "resource_name": "<имя_каталога>" } ] }, "request_metadata": { "remote_address": "cloud.yandex", "user_agent": "Yandex Cloud", "request_id": "<идентификатор_запроса>" }, "event_status": "DONE", "details": { "secret_id": "<идентификатор_секрета>", "secret_name": "<имя_секрета>", "secret_version_id": "<идентификатор_версии_секрета>", "secret_kms_key_id": "<идентификатор_ключа_шифрования_секрета_в_KMS>", "secret_status": "<статус_секрета>", "secret_version_status": "<статус_версии_секрета>", "secret_version_payload_entry_keys": [ "<ключи_записей_в_версии_секрета>" ] }, "request_parameters": { "secret_id": "<идентификатор_секрета>", "version_id": "<идентификатор_версии_секрета>" }, "response": { "version_id": "<идентификатор_версии>", "entry_keys": [ "<ключи_записей>" ] } } ``` {% endcut %} ## Схема данных {#scheme} ```json { "event_id": string, "event_source": string, "event_type": string, "event_time": string, "authentication": { "authenticated": boolean, "subject_type": string, "subject_id": string, "subject_name": string, "federation_id": string, "federation_name": string, "federation_type": string, "token_info": { "masked_iam_token": string, "iam_token_id": string, "impersonator_id": string, "impersonator_type": string, "impersonator_name": string, "impersonator_federation_id": string, "impersonator_federation_name": string, "impersonator_federation_type": string } }, "authorization": { "authorized": boolean }, "resource_metadata": { "path": [{ "resource_type": string, "resource_id": string, "resource_name": string }] }, "request_metadata": { "remote_address": string, "user_agent": string, "request_id": string }, "event_status": string, "error": { "code": number, "message": string, "details": { object } }, "details": { object }, "request_parameters": { object }, "response": { object } } ``` Поле | Описание --- | --- `event_id` | **string**
Идентификатор события. `event_source` | **string**
Имя сервиса-источника события. `event_type` | **string**
Тип события. Определяется сервисом-источником события. Подробнее смотрите в разделе [Справочник событий уровня сервисов](events-data-plane.md). `event_time` | **string**
Время, в которое произошло событие. `authentication` ^1^ | **object**
Данные аутентификации субъекта события. `authentication.authenticated` | **boolean**
Результат аутентификации. Возможные значения: