gcloud logging metrics create

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