Specifying Conditions (Beta)

Before you begin

This page describes the new UI (Beta). The new UI allows you to configure alerting policies that use Metric Conditions. These conditions include threshold, rate-of-change, uptime-check, and metric-absence conditions. If you want to create an alerting policy based on an uptime check, the simplest approach is to create the alerting policy directly from the page for the uptime check. See Using uptime checks in alerting policies.

This page does not describe process-health alerting policies. You must use the current GA UI for these “health” alert policies.

Adding a condition

To add a condition to an alerting policy, expand the Conditions dialog in the Create New Alerting Policy page, if necessary. Next, click the Add Condition button to bring up the following page:

Add or edit a condition

If you are editing an existing condition, the page is populated. If you are adding a new condition, the page is empty.


The target describes a metric and a resource that you want the alerting policy to monitor. The Target region for an alerting policy uses the same metric selector that is used in Metrics Explorer and for creating charts.

In the Find resource type and metric drop-down list, select the resource type that you want to monitor:

Select resource type

After you have selected the resource type, all available metrics for that resource type are presented. Scroll through the Metrics options and select the specific metric that you want your policy to monitor:

Select metric

The page expands to provide fine-grained control for your alerting condition after you select the resource type and metric:

  • You can control aggregation and aligner choices, including using custom metrics and logs-based metrics.
  • You can precisely filter and group the time series in the metric, including metadata filtering.
  • You can edit conditions created with the API that cannot be edited with the current UI

The chart accompanying the metric selector gives you a visual representation of the data being captured by the metric as you configure it. If you are not already familiar with the metric selector, see Configuring a Target Metric.

For additional reference, Sample Policies includes a variety of alerting policies in JSON format.


The title field is required. It is automatically populated with information based on your selections for the Target information. You can change the content in the title field.

If you are creating an alerting policy as part of creating an uptime check, the Target selections are auto-filled. In this case, you must manually enter a condition title.


The Configuration region describes the behavior of the target metric that will be considered as meeting the policy condition. Use this to specify how many of time series in the target metric (some, all, a percentage) must have some relationship (above, below, etc.) to a threshold value for a time period:

Configuring the target metric

This configuration lets you specify whether the target metric will participate in a metric-threshold or metric-absence condition.

When you have completed describing your condition, click the Save Condition button at the bottom of the page. This takes you back to the Add (or Edit) Alerting Policy page, from which you can:

Was this page helpful? Let us know how we did:

Send feedback about...

Stackdriver Monitoring