- NAME
-
- gcloud beta dataflow logs list - retrieve the job logs for a specific job
- SYNOPSIS
-
-
gcloud beta dataflow logs listJOB_ID[--after=AFTER] [--before=BEFORE] [--importance=IMPORTANCE; default="warning"] [--region=REGION_ID] [--filter=EXPRESSION] [--limit=LIMIT] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(BETA)Retrieves the job logs from a specified job using the Dataflow Messages API with at least the specified importance level. Can also be used to display logs between a given time period using the --before and --after flags. These logs are produced by the service and are distinct from worker logs. Worker logs can be found in Cloud Logging. - EXAMPLES
- Retrieve only error logs:
gcloud beta dataflow logs list --importance = errorRetrieve all logs after some date:
gcloud beta dataflow logs list --after = "2016-08-12 00:00:00"Retrieve logs from this year:
gcloud beta dataflow logs list --after = 2018 -01-01Retrieve logs more than a week old:
gcloud beta dataflow logs list --before = -P1W - POSITIONAL ARGUMENTS
-
-
JOB_ID - Job ID to operate on.
-
- FLAGS
-
-
--after=AFTER - Only display messages logged after the given time. See $ gcloud topic datetimes
for
information on time formats. For example,
2018-01-01is the first day of the year, and-P2Wis 2 weeks ago. -
--before=BEFORE - Only display messages logged before the given time. See $ gcloud topic datetimes for information on time formats.
-
--importance=IMPORTANCE; default="warning" - Minimum importance a message must have to be displayed.
IMPORTANCEmust be one of:debug,detailed,warning,error. -
--region=REGION_ID - Region ID of the job's regional endpoint. Defaults to 'us-central1'.
-
- LIST COMMAND FLAGS
-
-
--filter=EXPRESSION - Apply a Boolean filter
EXPRESSIONto each resource item to be listed. If the expression evaluatesTrue, then that item is listed. For more details and examples of filter expressions, run $ gcloud topic filters . This flag interacts with other flags that are applied in this order:--flatten,--sort-by,--filter,--limit. -
--limit=LIMIT - Maximum number of resources to list. The default is
unlimited. This flag interacts with other flags that are applied in this order:--flatten,--sort-by,--filter,--limit.
-
- GCLOUD WIDE FLAGS
- These flags are available to all commands:
--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.Run
$ gcloud helpfor details. - NOTES
- This command is currently in beta and might change without notice. This variant
is also available:
gcloud alpha dataflow logs list
gcloud beta dataflow logs list
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.

