NAME
    gcloud logging metrics create - create a logs-based metric

SYNOPSIS
    gcloud logging metrics create METRIC_NAME
        (--config-from-file=PATH_TO_FILE
          | [--description=DESCRIPTION --log-filter=LOG_FILTER
          : --bucket-name=BUCKET_NAME]) [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    Create a logs-based metric to count the number of log entries that match a
    filter expression. Logs-based metrics can also be used to extract values
    from logs and create a distribution of the values.

EXAMPLES
    To create a metric that counts the number of log entries with a severity
    level higher than WARNING, run:

        $ gcloud logging metrics create high_severity_count \
            --description="Number of high severity log entries" \
            --log-filter="severity > WARNING"

    Detailed information about filters can be found at:
    https://cloud.google.com/logging/docs/view/logging-query-language

    To create a metric that uses advanced features like distribution or
    user-defined labels, run:

        $ gcloud logging metrics create my_metric \
            --config-from-file=$PATH_TO_FILE

    The config file can be in YAML or JSON format. Detailed information about
    how to configure metrics can be found at:
    https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics#LogMetric.

    To create a bucket log-based metric, run:

        $ gcloud logging metrics create my_bucket_metric \
            --description="DESCRIPTION" --log-filter="LOG_FILTER" \
            --bucket-name="BUCKET_NAME"

POSITIONAL ARGUMENTS
     METRIC_NAME
        The name of the new metric.

REQUIRED FLAGS
     Data about the new metric.

     Exactly one of these must be specified:

       --config-from-file=PATH_TO_FILE
          A path to a YAML or JSON file specifying the logs-based metric to
          create. Use a full or relative path to a local file containing the
          value of config.

       Or at least one of these can be specified:

         A group of arguments to specify simple counter logs-based metrics.

         --description=DESCRIPTION
            The metric's description.

            This flag argument must be specified if any of the other arguments
            in this group are specified.

         --log-filter=LOG_FILTER
            The metric's filter expression.

            This flag argument must be specified if any of the other arguments
            in this group are specified.

         --bucket-name=BUCKET_NAME
            The Log Bucket name which owns the log-based metric.

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
    These variants are also available:

        $ gcloud alpha logging metrics create

        $ gcloud beta logging metrics create

