gcloud_alpha_dataflow_logs_list (1)
NAME
- gcloud alpha dataflow logs list - retrieve the job logs for a specific job
SYNOPSIS
-
gcloud alpha dataflow logs list JOB_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
POSITIONAL ARGUMENTS
-
- JOB_ID
-
The 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-01 is the first
day of the year, and -P2W is 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. IMPORTANCE must be
one of: debug, detailed, warning, error.
- --region=REGION_ID
-
The region ID of the job's regional endpoint.
LIST COMMAND FLAGS
-
- --filter=EXPRESSION
-
Apply a Boolean filter EXPRESSION to each resource item to be listed. If
the expression evaluates True, 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: --account, --configuration, --flags-file, --flatten, --format, --help, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity. Run $ gcloud help for details.
EXAMPLES
Retrieve only error logs:
- $ gcloud alpha dataflow logs list --importance=error
Retrieve 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-01
Retrieve logs more than a week old:
- $ gcloud alpha dataflow logs list --before=-P1W
NOTES
This command is currently in ALPHA and may change without notice. If this command fails with API permission errors despite specifying the right project, you will have to apply for early access and have your projects registered on the API whitelist to use it. To do so, contact Support at cloud.google.com/support This variant is also available:
- $ gcloud beta dataflow logs list