Записать логи в журнал выполнения рабочего процесса
Примечание
На данный момент Workflows поддерживается в двух интерфейсах — Yandex Cloud и Yandex AI Studio. При этом:
- рабочие процессы, созданные в интерфейсе Yandex Cloud, автоматически доступны в интерфейсе AI Studio;
- рабочие процессы, созданные в интерфейсе AI Studio, недоступны в интерфейсе Yandex Cloud.
С 3 сентября 2026 года Workflows перестанет поддерживаться в интерфейсе Yandex Cloud. Для создания рабочих процессов и управления ими используйте интерфейс AI Studio.
Примечание
Логирование тарифицируется. Подробнее в документации Yandex Cloud Logging.
-
В консоли управления перейдите в каталог, в котором находится рабочий процесс.
-
Перейдите в сервис Serverless Integrations.
-
На панели слева нажмите Workflows.
-
В строке с нужным рабочим процессом нажмите и выберите Редактировать.
-
Раскройте блок Дополнительные параметры и найдите блок Логирование:
-
Включите опцию Запись логов.
-
В поле Назначение выберите:
Каталог— чтобы записывать логи в лог-группу по умолчанию для каталога, в котором находится рабочий процесс.-
Лог-группа— чтобы записывать логи в пользовательскую лог-группу.Выберите лог-группу, в которую будут записываться логи, или создайте новую.
-
(Опционально) Выберите минимальный уровень логирования.
-
-
Нажмите Сохранить.
Если минимальный уровень логирования задан, в журнал выполнения записываются логи указанного уровня и выше. Если минимальный уровень логирования не задан, в журнал выполнения записываются все логи рабочего процесса.
Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.
По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.
Назначение логирования
Если в параметрах рабочего процесса не указана пользовательская лог-группа или логирование не отключено, рабочий процесс автоматически пишет все логи в лог-группу по умолчанию для каталога, в котором он находится.
Чтобы записывать логи в лог-группу по умолчанию для другого каталога, укажите идентификатор этого каталога в параметре --log-folder-id при создании или изменении рабочего процесса. Аккаунту, от имени которого выполняется команда, на этот каталог должна быть назначена роль logging.editor или выше.
Чтобы записывать логи в пользовательскую лог-группу, укажите идентификатор этой лог-группы в параметре --log-group-id при создании или изменении рабочего процесса. Лог-группа может находиться в другом каталоге. Аккаунту, от имени которого выполняется команда, на этот каталог должна быть назначена роль logging.editor или выше.
Минимальный уровень логирования
Чтобы задать минимальный уровень логирования, укажите его в параметре --min-log-level при создании или изменении рабочего процесса.
Если минимальный уровень логирования задан, в журнал выполнения записываются логи указанного уровня и выше. Если минимальный уровень логирования не задан, в журнал выполнения записываются все логи рабочего процесса.
Отключение логирования
Чтобы отключить логирование, при создании или изменении рабочего процесса укажите параметр --no-logging.
Пример команды
Чтобы записывать логи в пользовательскую лог-группу, выполните команду:
yc serverless workflow update <имя_или_идентификатор_рабочего_процесса> \
--yaml-spec <файл_спецификации> \
--log-group-id <идентификатор_лог-группы> \
--min-log-level <минимальный_уровень_логирования>
Где:
--yaml-spec— путь к файлу с YaWL-спецификацией рабочего процесса. Например:./yawl-spec.json.--log-group-id— идентификатор лог-группы, в которую будут записываться логи.--min-log-level— минимальный уровень логирования. Необязательный параметр.
Результат:
id: dfqjl5hh5p90********
folder_id: b1g681qpemb4********
specification:
spec_yaml: "yawl: ..."
created_at: "2025-03-11T09:27:51.691990Z"
name: my-workflow
description: created via cli
labels:
owner: "admin"
version: "alpha"
status: ACTIVE
log_options:
log_group_id: e23u2vn449av********
min_level: DEBUG
service_account_id: aje4tpd9coa********
network_id: enpm8v48ehcl********
Чтобы записывать логи в журнал выполнения рабочего процесса, воспользуйтесь методом REST API Update для ресурса Workflows или вызовом gRPC API workflow/Update.