Аудитный лог событий

Аудитный лог событий — это запись в виде JSON-объекта о событиях, которые произошли с ресурсами Cloud.ru.

Формат записей универсален для всех событий. Значения полей определяются ресурсом-источником.

Объект события — ресурс сервиса, над которым производится операция.

Субъект события — аккаунт, от имени которого производится операция. Например, создание VM, изменение конфигурации, старт/стоп, etc.

Таблица с логами

Маппинг

Тип данных

Описание

authorization

object

Данные авторизации субъекта события

authorization.authorized

boolean

Результат авторизации

event_source

string

Имя сервиса-источника события

event_level

string

Тип важности события вычисляется в зависимости от значения event_status:

  • INFO для статуса STARTED / DONE / SUCCESS / неизвестный нам статус

  • WARN для статуса CANCELLED

  • ERROR для статуса ERROR

event_type

string

Тип события. Справочник

event_status

string

Статус события:

  • STARTED — операция начата

  • ERROR — операция завершена с ошибкой

  • SUCCESS / DONE — операция завершена успешно

  • CANCELLED — операция отменена

resource_metadata

array

Метаданные объекта события

resource_metadata[].resource_type

string

Тип ресурса, над которым было произведено действие:

  • customer

  • project

  • object

resource_metadata[].resource_name

string

Имя ресурса, над которым было произведено действие

request_metadata

object

Данные о запросе, который инициировал событие

request_metadata.remote_address

string

IP-адрес субъекта события

request_metadata.user_agent

string

User-Agent субъекта события

request_metadata.request_id

string

Идентификатор запроса

request_method

string

Метод запроса

request_endpoint

string

Адрес запроса

request

string

Подробности о запросе

response

string

Подробности об ответе на запрос

authentication

object

Данные аутентификации субъекта события

authentication.authenticated

boolean

Результат аутентификации

authentication.subject_type

string

Тип субъекта:

Возможные значения:

  • USER_ACCOUNT

  • FEDERATED_USER_ACCOUNT

  • SERVICE_ACCOUNT

authentication.subject_name

string

Имя субъекта

x_request_id

string

Сквозной идентификатор запроса

error

string

Описание ошибки

details

string

Детали события, сервис-источник сам определяет состав параметров внутри объекта

Пример сообщения

{
"eventSource" : "string" ,
"eventLevel" : "string" ,
"eventType" : "string" ,
"eventStatus" : "string" ,
"eventId" : "string" ,
"authorization" :{
"authorized" : boolean
},
"resourceMetadata" :[
{
"resourceType" : "customer" ,
"resourceId" : "string" ,
"resourceName" : "string"
},
{
"resourceType" : "project" ,
"resourceId" : "string" ,
"resourceName" : "string"
},
{
"resourceType" : "object" ,
"resourceId" : "string" ,
"resourceName" : "string"
}
],
"requestMetadata" :{
"remoteAddress" : "string" ,
"userAgent" : "string" ,
"requestId" : "string"
},
"requestMethod" : "string" ,
"requestEndpoint" : "string" ,
"request" : "string" ,
"response" : "string" ,
"authentication" :{
"authenticated" : boolean ,
"subjectType" : "string" ,
"subjectId" : "string" ,
"subjectName" : "string"
},
"xRequestId" : "string" ,
"error" : "string" ,
"details" : "string" ,
"eventTime" : "string"
}
Evolution