- NAME
-
- gcloud beta dataflow metrics list - retrieves the metrics from a specific job
- SYNOPSIS
-
-
gcloud beta dataflow metrics listJOB_ID[--changed-after=CHANGED_AFTER] [--hide-committed] [--region=REGION_ID] [--source=SOURCE; default="all"] [--tentative] [--transform=TRANSFORM] [--filter=EXPRESSION] [--limit=LIMIT] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(BETA)This command can be used to explore the job's metrics at a fine-grained level. - EXAMPLES
- Filter metrics with the given name:
gcloud beta dataflow metrics list JOB --filter = "name=ElementCount"Filter child metrics with matching transforms:
gcloud beta dataflow metrics list JOB --transform = WordCountFilter child output metrics:
gcloud beta dataflow metrics list JOB --transform = WordCount/Write.*outFilter all output metrics:
gcloud beta dataflow metrics list JOB --transform = .*outFilter all custom-defined user metrics
gcloud beta dataflow metrics list JOB --source = userFilter metrics with a scalar value greater than a threshold.
gcloud beta dataflow metrics list JOB --filter = "scalar > 50"List metrics that have changed in the last 2 weeks:
gcloud beta dataflow metrics list JOB --changed-after = -P2W - POSITIONAL ARGUMENTS
-
-
JOB_ID - Job ID to operate on.
-
- FLAGS
-
-
--changed-after=CHANGED_AFTER - Only display metrics that have changed 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. - If true, hide committed values.
-
--region=REGION_ID - Region ID of the job's regional endpoint. Defaults to 'us-central1'.
-
--source=SOURCE; default="all" - Set the metrics source.
SOURCEmust be one of:-
all - Retrieves all metrics.
-
service - Retrieves only dataflow service metrics.
-
user - Retrieves only custom user metrics.
-
-
--tentative - If true, display tentative values.
-
--transform=TRANSFORM - Filters only the metrics that prefix match the given regex.
-
- 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 metrics list
gcloud beta dataflow metrics 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.

