tocdepth

2

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

Аудитный лог событий — это запись в виде 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 free tier
для Dev & Test
Получить