Writing to the workflow execution log
Note
Logging is not free of charge. For more information, see the Yandex Cloud Logging documentation.
-
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 installed yet, install and initialize it.
By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also set a different folder for any specific 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.
For logging to another folder's default log group, provide that folder's ID in the --log-folder-id parameter when creating or updating a workflow. The account used to run the command must have the logging.editor role or higher for the folder.
For logging to a custom log group, provide that log group's ID in the --log-group-id parameter when creating or updating a workflow. The log group may reside in a different folder. The account used to run the command must have the logging.editor role or higher for the folder.
Minimum logging level
To set the minimum logging level, specify 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
For logging 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********
For logging to the workflow execution log, use the Update REST API method for the Workflows resource or the workflow/Update gRPC API call.