- NAME
- 
- gcloud alpha dataflow logs list - retrieve the job logs for a specific job
 
- SYNOPSIS
- 
- 
gcloud alpha dataflow logs listJOB_ID[--after=AFTER] [--before=BEFORE] [--importance=IMPORTANCE; default="warning"] [--region=REGION_ID] [--filter=EXPRESSION] [--limit=LIMIT] [GCLOUD_WIDE_FLAG โฆ]
 
- 
- DESCRIPTION
- 
(ALPHA)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 alpha dataflow logs list --importance=errorRetrieve all logs after some date: gcloud alpha dataflow logs list --after="2016-08-12 00:00:00"Retrieve logs from this year: gcloud alpha dataflow logs list --after=2018-01-01Retrieve logs more than a week old: gcloud alpha 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 alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct project,
you might be trying to access an API with an invitation-only early access
allowlist. This variant is also available:
gcloud beta dataflow logs list
      gcloud alpha 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 2025-05-07 UTC.