mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-08 18:45:13 +00:00
88 lines
3 KiB
Text
88 lines
3 KiB
Text
NAME
|
|
gcloud logging metrics update - update the definition of a logs-based
|
|
metric
|
|
|
|
SYNOPSIS
|
|
gcloud logging metrics update METRIC_NAME
|
|
(--config-from-file=PATH_TO_FILE | --bucket-name=BUCKET_NAME
|
|
--description=DESCRIPTION --log-filter=LOG_FILTER)
|
|
[GCLOUD_WIDE_FLAG ...]
|
|
|
|
DESCRIPTION
|
|
Update the description or the filter expression of an existing logs-based
|
|
metric.
|
|
|
|
EXAMPLES
|
|
To update the description of a metric called high_severity_count, run:
|
|
|
|
$ gcloud logging metrics update high_severity_count \
|
|
--description="Count of high-severity log entries."
|
|
|
|
To update the filter expression of the metric, run:
|
|
|
|
$ gcloud logging metrics update high_severity_count \
|
|
--log-filter="severity >= WARNING"
|
|
|
|
Detailed information about filters can be found at:
|
|
https://cloud.google.com/logging/docs/view/logging-query-language
|
|
|
|
For advanced features such as user-defined labels and distribution metrics,
|
|
update using a config file:
|
|
|
|
$ gcloud logging metrics update high_severity_count \
|
|
--config-from-file=$PATH_TO_FILE
|
|
|
|
The config file should be in YAML 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.
|
|
Any top-level fields in the LogMetric definition that aren't specified in
|
|
the config file will not be updated in the metric.
|
|
|
|
To update the bucket associated with a bucket log-based metric, run:
|
|
|
|
$ gcloud logging metrics update my-bucket-metric \
|
|
--bucket-name="NEW_BUCKET_NAME"
|
|
|
|
POSITIONAL ARGUMENTS
|
|
METRIC_NAME
|
|
The name of the log-based metric to update.
|
|
|
|
REQUIRED FLAGS
|
|
Data about the metric to update.
|
|
|
|
Exactly one of these must be specified:
|
|
|
|
--config-from-file=PATH_TO_FILE
|
|
A path to a YAML file specifying the updates to be made to the
|
|
logs-based metric. Use a full or relative path to a local file
|
|
containing the value of config.
|
|
|
|
Arguments to specify information about simple counter logs-based
|
|
metrics.
|
|
|
|
--bucket-name=BUCKET_NAME
|
|
The Log Bucket name which owns the log-based metric.
|
|
|
|
--description=DESCRIPTION
|
|
A new description for the metric. If omitted, the description is
|
|
not changed.
|
|
|
|
--log-filter=LOG_FILTER
|
|
A new filter string for the metric. If omitted, the filter is not
|
|
changed.
|
|
|
|
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 update
|
|
|
|
$ gcloud beta logging metrics update
|
|
|