Writing to the workflow execution log
-
In the management console, select the folder containing the workflow.
-
Select Serverless Integrations.
-
In the left-hand panel, click Workflows.
-
Click in the workflow row and select Edit.
-
Expand Additional parameters and find Logging.
-
Enable Write logs.
-
In the Destination field, select:
-
Folder: To write logs to the default log group of the folder containing the workflow. -
Log group: To write logs to a custom log group.- Select the log group to write logs to or create a new one.
-
-
(Optional) Select the minimum logging level.
-
-
Click Save.
If you set the minimum logging level, logs of that level and higher will be written to the execution log. With no minimum logging level set, all workflow logs will be written to the execution log.
If you do not have the Yandex Cloud CLI yet, install and initialize it.
The folder specified when creating the CLI profile is used by default. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also specify a different folder for any command using the --folder-name or --folder-id parameter.
Logging destination
If a custom log group is not specified in the workflow parameters or logging is not turned off, the workflow automatically writes all logs to the default log group of the folder it resides in.
To write logs to a custom log group, provide the log group ID in the --log-group-id parameter when creating or updating the workflow. The log group must reside in the same folder as the workflow.
Minimum logging level
To set the minimum logging level, provide it in the --min-log-level parameter when creating or updating the workflow.
If you set the minimum logging level, logs of that level and higher will be written to the execution log. With no minimum logging level set, all workflow logs will be written to the execution log.
Disabling logging
To disable logging, set the --no-logging parameter when creating or updating the workflow.
Command example
To write logs to a custom log group, run this command:
yc serverless workflow update <workflow_name_or_ID> \
--yaml-spec <specification_file> \
--log-group-id <log_group_ID> \
--min-log-level <minimum_logging_level>
Where:
--yaml-spec: Path to the YaWL specification file for the workflow, e.g.,./yawl-spec.json.--log-group-id: ID of the log group to write logs to.--min-log-level: Minimum logging level. This is an optional parameter.
Result:
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********
To write to the workflow execution log, use the Update REST API method for the Workflows resource or the workflow/Update gRPC API call.