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
        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
        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

