NAME

gcloud beta dataflow metrics list - retrieves the metrics from a specific job

SYNOPSIS

gcloud beta dataflow metrics list JOB_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=WordCount

Filter child output metrics:

$ gcloud beta dataflow metrics list JOB \ --transform=WordCount/Write.*out

Filter all output metrics:

$ gcloud beta dataflow metrics list JOB --transform=.*out

Filter all custom-defined user metrics

$ gcloud beta dataflow metrics list JOB --source=user

Filter 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

The 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-01 is the first day of the year, and -P2W is 2 weeks ago.

--hide-committed

If true, hide committed values.

--region=REGION_ID

The region ID of the job's regional endpoint. Defaults to 'us-central1'.

--source=SOURCE; default="all"

Set the metrics source. SOURCE must 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 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: --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 help for details.

NOTES

This command is currently in beta and might change without notice. This variant is also available:

$ gcloud alpha dataflow metrics list