Настройте запись логов и анализируйте производительность
Инструкции в этом пункте чек-листа помогут вам настроить работу с логами и проанализировать производительность.
Создайте лог-группу
-
В консоли управления
перейдите в каталог, в котором хотите создать лог-группу. -
Откройте сервис Cloud Logging.
-
Нажмите кнопку Создать группу.
-
(Опционально) Введите имя и описание лог-группы. Формат имени:
- длина — от 3 до 63 символов;
- может содержать строчные буквы латинского алфавита, цифры и дефисы;
- первый символ — буква, последний — не дефис.
-
Укажите срок хранения записей в лог-группе.
-
Нажмите кнопку Создать группу.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Примечание
Срок хранения записей можно указать только в часах, минутах или секундах. Например, 1h
или 1440m
.
Чтобы создать лог-группу, выполните команду:
yc logging group create --name=group --retention-period=1h
--name
— имя лог-группы.--retention-period
— срок хранения записей в лог-группе. Необязательный параметр.
Результат:
done (1s)
id: af3flf29t8**********
folder_id: aoek6qrs8t**********
cloud_id: aoegtvhtp8**********
created_at: "2021-06-24T09:56:38.970Z"
name: group
status: ACTIVE
retention_period: 3600s
Создать пользовательскую лог-группу можно с помощью метода API create.
Назначьте роли на лог-группу
Выполните команду, чтобы назначить роль на пользовательскую лог-группу:
- пользователю:
yc logging group add-access-binding \ --name <имя_лог-группы> \ --user-account-id <идентификатор_пользователя> \ --role <роль>
Результат:
done (1s)
- сервисному аккаунту:
yc logging group add-access-binding \ --name <имя_лог-группы> \ --service-account-id <идентификатор_сервисного_аккаунта> \ --role <роль>
done (1s)
- всем авторизованным пользователям (публичная группа
All authenticated users
):yc logging group add-access-binding \ --name <имя_лог-группы> \ --all-authenticated-users \ --role <роль>
done (1s)
- сервисному аккаунту:
Назначить роли на пользовательскую лог-группу можно с помощью метода API setAccessBindings.
Просматривайте графики
- В консоли управления
перейдите в каталог, в котором находится лог-группа. - Откройте сервис Cloud Logging.
- Выберите лог-группу.
- Перейдите на вкладку Мониторинг.
- На странице появятся следующие графики:
- Records successfully ingested — количество записей, доставленных в систему логирования Cloud Logging. Учитываются только пользовательские логи.
- Records saved — количество записей, сохраненных в систему логирования Cloud Logging. Учитываются логи сервисов и пользовательские логи.
- Records read — количество прочитанных записей.
- Records ingest errors — количество ошибок при добавлении записей.
- Records save lag — разница между временем доставки записи и ее сохранением в систему логирования Cloud Logging.