[Документация Yandex Cloud](../../../../index.md) > [Yandex Serverless Integrations](../../../index.md) > [Пошаговые инструкции](../../index.md) > Workflows > Управление рабочим процессом > Управлять логами > Записать логи

# Записать логи в журнал выполнения рабочего процесса

{% note info %}

Логирование тарифицируется. Подробнее в [документации Yandex Cloud Logging](../../../../logging/pricing.md).

{% endnote %}

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. В [консоли управления](https://kz.console.yandex.cloud) перейдите в каталог, в котором находится [рабочий процесс](../../../concepts/workflows/workflow.md).
  1. Перейдите в сервис **Serverless Integrations**.
  1. На панели слева нажмите ![image](../../../../_assets/console-icons/graph-node.svg) **Workflows**.
  1. В строке с нужным рабочим процессом нажмите ![image](../../../../_assets/console-icons/ellipsis.svg) и выберите ![image](../../../../_assets/console-icons/pencil.svg) **Редактировать**.
  1. Раскройте блок **Дополнительные параметры** и найдите блок **Логирование**:

      1. Включите опцию **Запись логов**.
      1. В поле **Назначение** выберите:

         * `Каталог` — чтобы записывать логи в лог-группу по умолчанию для каталога, в котором находится рабочий процесс.
         * `Лог-группа` — чтобы записывать логи в пользовательскую лог-группу.
           
           Выберите лог-группу, в которую будут записываться логи, или [создайте](../../../../logging/operations/create-group.md) новую.

      1. (Опционально) Выберите минимальный уровень логирования.

  1. Нажмите **Сохранить**.

  Если минимальный уровень логирования задан, в журнал выполнения записываются логи указанного уровня и выше. Если минимальный уровень логирования не задан, в журнал выполнения записываются все логи рабочего процесса.

- CLI {#cli}

  Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), [установите и инициализируйте его](../../../../cli/quickstart.md#install).

  По умолчанию используется каталог, указанный при [создании](../../../../cli/operations/profile/profile-create.md) профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду `yc config set folder-id <идентификатор_каталога>`. Также для любой команды вы можете указать другой каталог с помощью параметров `--folder-name` или `--folder-id`. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

  ### Назначение логирования {#destination}

  Если в параметрах рабочего процесса не указана пользовательская [лог-группа](../../../../logging/concepts/log-group.md) или логирование не отключено, рабочий процесс автоматически пишет все логи в лог-группу по умолчанию для [каталога](../../../../resource-manager/concepts/resources-hierarchy.md#folder), в котором он находится.

  Чтобы записывать логи в лог-группу по умолчанию для другого каталога, укажите идентификатор этого каталога в параметре `--log-folder-id` при [создании](create-yawl.md) или [изменении](update.md) рабочего процесса. [Аккаунту](../../../../iam/concepts/users/accounts.md), от имени которого выполняется команда, на этот каталог должна быть назначена [роль](../../../../logging/security/index.md#logging-editor) `logging.editor` или выше.

  Чтобы записывать логи в пользовательскую лог-группу, укажите идентификатор этой лог-группы в параметре `--log-group-id` при создании или изменении рабочего процесса. Лог-группа может находиться в другом каталоге. Аккаунту, от имени которого выполняется команда, на этот каталог должна быть назначена роль `logging.editor` или выше.

  ### Минимальный уровень логирования {#log-level}

  Чтобы задать минимальный уровень логирования, укажите его в параметре `--min-log-level` при создании или изменении рабочего процесса.

  Если минимальный уровень логирования задан, в журнал выполнения записываются логи указанного уровня и выше. Если минимальный уровень логирования не задан, в журнал выполнения записываются все логи рабочего процесса.

  ### Отключение логирования {#disabled}

  Чтобы отключить логирование, при создании или изменении рабочего процесса укажите параметр `--no-logging`.

  ### Пример команды {#example}

  Чтобы записывать логи в пользовательскую лог-группу, выполните команду:

  ```
  yc serverless workflow update <имя_или_идентификатор_рабочего_процесса> \
    --yaml-spec <файл_спецификации> \
    --log-group-id <идентификатор_лог-группы> \
    --min-log-level <минимальный_уровень_логирования>
  ```

  Где:

  * `--yaml-spec` — путь к файлу с [YaWL-спецификацией](../../../concepts/workflows/yawl/index.md) рабочего процесса. Например: `./yawl-spec.json`.
  * `--log-group-id` — идентификатор лог-группы, в которую будут записываться логи.
  * `--min-log-level` — минимальный уровень логирования. Необязательный параметр.

  Результат:

  ```text
  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********
  ```

- API {#api}

  Чтобы записывать логи в журнал выполнения рабочего процесса, воспользуйтесь методом REST API [Update](../../../workflows/api-ref/Workflow/update.md) для ресурса [Workflows](../../../workflows/api-ref/Workflow/index.md) или вызовом gRPC API [workflow/Update](../../../workflows/api-ref/grpc/Workflow/update.md).

{% endlist %}