Отправка логов в сервис

Перед началом работы

1. Создайте и настройте лог-группу.

2. Создайте сервисный аккаунт. В блоке Доступы и роли выберите:

   • проект — «Пользователь сервисов»;

   • сервис — «logaas.writer».

3. Для сервисного аккаунта создайте API-ключ. В параметрах API-ключа укажите сервис «logging_as_a_service».

   Срок действия API-ключа ограничен. Когда он подойдет к концу, мы отправим вам уведомление. После этого необходимо обновить API-ключ.

Отправка логов

1. В заголовке Authorization передайте API-ключ:

   Authorization: Api-Key <user-api-key>
   
   

   Где <user-api-key> — API-ключ.

2. В теле запроса передайте лог, например:

{
  "logs": [
    {
      "timestamp": "2026-01-15T10:20:00.908+03:00",
      "level": "INFO",
      "projectId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx",
      "logGroupId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx",
      "traceId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx",
      "serviceName": "notification",
      "instanceId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx",
      "labels": {
        "className": "notify",
        "serviceVersion": "3.2.1"
      },
      "message": "Email notification dispatched successfully",
      "jsonMessage": "{\"notificationId\":\"notif_abc123def456\",\"type\":\"email\",\"recipient\":\"user@example.com\",\"template\":\"welcome_email\",\"status\":\"sent\"}"
    }
  ]
}

• timestamp — время создания лога в формате YYYY-MM-DDThh:mm:ss\[.sss\]±hh:mm.

• level — уровень лога.

• projectId — ID проекта, в который будет добавлен лог.

• logGroupId — ID лог-группы, в которую будет добавлен лог.

• traceId — ID трассировки для связывания различных событий или сообщений, относящихся к одному и тому же процессу.

• serviceName — наименование сервиса-источника логов.

• instanceId — ID конкретного экземпляра приложения, сервера или процесса, который генерирует лог.

• labels — набор меток в виде списка. В метки можно записывать любые данные в формате "наименование": "значение" для фильтрации данных и быстрого поиска логов.

• message — сообщение лога.

• jsonMessage — структурированные поля лога в формате JSON.