Use simplified API quota metrics in Cloud Monitoring

Simplified API quota metrics

To improve the discoverability and manageability of Compute Engine API quota, Google Cloud has reduced the number of quota metrics by consolidating metrics into fewer quota groups. These simplified quota metrics also offer higher limits for each quota group.

Legacy and simplified API quota metrics

The following table lists the legacy API quota metrics and their simplified equivalent metrics:

Use the simplified metrics in Cloud Monitoring dashboards

To monitor Compute Engine API usage against the simplified API metrics, add filters for these metrics in your Cloud Monitoring dashboards, alerts, and queries.

Create a dashboard that uses simplified API quota metrics

To create a dashboard that uses simplified metrics, do the following:

1. In the Google Cloud console, go to Monitoring:

   Go to Monitoring

2. In the navigation pane, select Dashboards.

3. Click Create custom dashboard.

4. In the dashboard toolbar, click Add widgetand select a widget type (for example, Line chart). The Configure widgetpage opens.

5. In the Select a metricsection, do the following:

   1. Select Consumer Quotafor the resource.
   2. Select Quotafor the metric category.
   3. Select Rate quota usagefor the metric and then click Apply.

6. In the Add filtersection, use the quota_metric filter and select the corresponding simplified API quota metric. To find the simplified metric, see Legacy and simplified API quota metrics .

7. Click Applyto add the widget to the dashboard.

8. In the toolbar, click Saveto save the dashboard.

Modify a dashboard that uses a legacy quota metric

To update a dashboard that contains a legacy metric, do the following:

1. In the Google Cloud console, go to Monitoring:

   Go to Monitoring

2. In the navigation pane, select Dashboards.

3. Open the dashboardcontaining the chart that needs an update.

4. Click Edit.

5. Find the widget you want to update and edit it.

6. In the Select a metricsection, update the filter containing the legacy metric:

   1. In the Filterfield, select quota_metric .
   2. In the Valuefield, update the current value to the corresponding simplified API quota metric. To find the replacement for your legacy metric, see Legacy and simplified API quota metrics . For example, change compute.googleapis.com/read_requests to compute.googleapis.com/global_reads .

7. To apply your changes, click Apply.

Use the simplified API quota metrics in Cloud Monitoring alerting policies

To monitor Compute Engine API usage against the simplified API metrics, add filters for these metrics in your Cloud Monitoring alerting policies.

Create an alerting policy that uses simplified API quota metrics

To create an alerting policy that uses simplified metrics, do the following:

1. In the Google Cloud console, go to Monitoring:

   Go to Monitoring

2. In the navigation pane, select Alerting.

3. Click Create policy.

4. In the Select a metricsection, do the following:

   1. Select Consumer Quotafor the resource.
   2. Select Quotafor the metric category.
   3. Select Rate quota usagefor the metric and then click Apply.

5. In the Add filtersection, use the quota_metric filter and select the corresponding simplified API quota metric. To find the simplified metric, see Legacy and simplified API quota metrics .

6. Configure the condition, notification channels, and documentation as needed.

7. Click Save policy.

You can also use the Google Cloud Terraform Provider to create alerting policies in your Google Cloud project. For more information, see Create alerting policies with Terraform .

Modify an alerting policy that uses a legacy quota metric

To update an existing alert policy that uses a legacy quota metric, do the following:

1. In the Google Cloud console, go to Monitoring:

   Go to Monitoring

2. In the navigation pane, select Alerting. The Alerting page displays panes that list summary information, incidents, and alerting policies.

3. To edit an existing policy, click the policy name under Policies.

4. In the Select a metricsection, update the filter containing the legacy metric:

   1. In the Filterfield, select quota_metric .
   2. In the Valuefield, update the value to the corresponding simplified API quota metric. To find the replacement for your legacy metric, see Legacy and simplified API quota metrics . For example, change compute.googleapis.com/read_requests to compute.googleapis.com/global_reads .

5. Click Doneto save changes in the filter.

6. Click Save policy.

Use simplified quota metrics in Cloud Monitoring queries

To update a PromQL-based alerting policy or a chart in a dashboard, use the Query Editor and edit the query filter. For more information, see Use the code editor for PromQL .

To update your query, replace the legacy metric name in the quota_metric filter with the corresponding simplified metric name.

Example 1:

Query that uses a legacy metric:

rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \
quota_metric=~" compute.googleapis.com/read_requests"}[1m])

Modified query using simplified metric:

rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \
quota_metric=~" compute.googleapis.com/global_reads"}[1m])

Example 2:

Query that uses a legacy metric:

 rate 
 ( 
 serviceruntime_googleapis_com: 
 quota_rate_net_usage 
 { 
 monitored_resource 
 = 
 "consumer_quota" 
 , 
  
 \ 
 quota_metric 
 =~ 
 " compute.googleapis.com/heavy_weight_write_requests_per_region" 
 }[ 
 1 
 m 
 ]) 

Modified query using simplified metric:

 rate 
 ( 
 serviceruntime_googleapis_com: 
 quota_rate_net_usage 
 { 
 monitored_resource 
 = 
 "consumer_quota" 
 , 
  
 \ 
 quota_metric 
 =~ 
 " compute.googleapis.com/writes_per_region" 
 }[ 
 1 
 m 
 ])