gcloud_alpha_monitoring_policies_conditions_create (1)

NAME

gcloud alpha monitoring policies conditions create - create a condition in an alerting policy

SYNOPSIS

gcloud alpha monitoring policies conditions create ALERT_POLICY [--aggregation=AGGREGATION --condition-display-name=CONDITION_DISPLAY_NAME --condition-filter=CONDITION_FILTER --duration=DURATION --if=IF_VALUE --trigger-count=TRIGGER_COUNT | --trigger-percent=TRIGGER_PERCENT] [--condition=CONDITION | --condition-from-file=CONDITION_FROM_FILE] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION

(ALPHA) Create a condition in an alerting policy.

POSITIONAL ARGUMENTS

Alert Policy resource - Name of the Alert Policy to add a condition to. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the [project] attribute: provide the argument [alert_policy] on the command line with a fully specified name; provide the argument [--project] on the command line; set the property [core/project]. This must be specified.

ALERT_POLICY

ID of the Alert Policy or fully qualified identifier for the Alert Policy.

FLAGS

Condition Settings. This will add a condition to the created policy. If any conditions are already specified, this condition will be appended.

--aggregation=AGGREGATION

Specifies an Aggregation message as a JSON/YAML value to be applied to the condition. For more information about the format: cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.alertPolicies

--condition-display-name=CONDITION_DISPLAY_NAME

The display name for the condition.

--condition-filter=CONDITION_FILTER

Specifies the "filter" in a metric absence or metric threshold condition.

--duration=DURATION

The duration (e.g. "60s", "2min", etc.) that the condition must hold in order to trigger as true.

--if=IF_VALUE

One of "absent", "< THRESHOLD", "> THRESHOLD" where "THRESHOLD" is an integer or float.

At most one of these may be specified:

--trigger-count=TRIGGER_COUNT

The absolute number of time series that must fail the predicate for the condition to be triggered.

--trigger-percent=TRIGGER_PERCENT

The percentage of time series that must fail the predicate for the condition to be triggered.

At most one of these may be specified:

--condition=CONDITION

The condition as a string. In either JSON or YAML format.

--condition-from-file=CONDITION_FROM_FILE

The path to a JSON or YAML file containing the condition.

GCLOUD WIDE FLAGS

These flags are available to all commands: --account, --configuration, --flags-file, --flatten, --format, --help, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity. Run $ gcloud help for details.

NOTES

This command is currently in ALPHA and may change without notice. If this command fails with API permission errors despite specifying the right project, you will have to apply for early access and have your projects registered on the API whitelist to use it. To do so, contact Support at cloud.google.com/support