Update Cloud Monitoring dashboards to use simplified API quota metrics

---

This document describes how to update your Cloud Monitoring dashboards, alerting policies, and queries to use the simplified Compute Engine API quota metrics.

Preview

This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

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.

The following table lists all simplified API quota metrics that replace the existing API quota metrics:

Existing API quota metrics	Simplified API quota metric
compute.googleapis.com/list_requests	Read requests per minute compute.googleapis.com/global_reads^BETA
compute.googleapis.com/read_requests
compute.googleapis.com/heavy_weight_read_requests
compute.googleapis.com/default Existing quota metric for methods that list Compute Engine resources.
compute.googleapis.com/get_macsec_config_requests
compute.googleapis.com/license_verification_requests
compute.googleapis.com/default Existing quota metric for global methods that create, modify, or delete Compute Engine resources.	Mutation requests per minute compute.googleapis.com/global_writes^BETA
compute.googleapis.com/global_resource_write_requests
compute.googleapis.com/heavy_weight_write_requests
compute.googleapis.com/regional_v2_public_advertised_prefixes_delete_requests
compute.googleapis.com/regional_v2_public_advertised_prefixes_create_requests
compute.googleapis.com/address_move_requests
compute.googleapis.com/project_set_common_instance_metadata_requests
compute.googleapis.com/regional_v2_public_advertised_prefixes_announce_requests
compute.googleapis.com/license_insert_requests
compute.googleapis.com/heavy_weight_read_requests_per_region	Read requests per minute per region compute.googleapis.com/reads_per_region^BETA
compute.googleapis.com/read_requests_per_region
compute.googleapis.com/list_requests_per_region
compute.googleapis.com/default_per_region Existing quota metric for regional and zonal methods that list Compute Engine resources.
compute.googleapis.com/license_verification_requests_per_region
compute.googleapis.com/instance_list_referrers_requests_per_region
compute.googleapis.com/operation_read_requests_per_region
compute.googleapis.com/network_endpoint_list_requests_per_region
compute.googleapis.com/regional_network_endpoint_list_requests_per_region
compute.googleapis.com/get_serial_port_output_requests_per_region
compute.googleapis.com/read_requests
compute.googleapis.com/heavy_weight_write_requests_per_region	Mutation requests per minute per region compute.googleapis.com/writes_per_region^BETA
compute.googleapis.com/default_per_region Existing quota metric for regional and zonal methods that create, modify, or delete Compute Engine resources.
compute.googleapis.com/global_resource_write_requests_per_region
compute.googleapis.com/network_endpoint_write_requests_per_region
compute.googleapis.com/regional_network_endpoint_write_requests_per_region
compute.googleapis.com/regional_public_delegated_prefixes_create_requests_per_region
compute.googleapis.com/address_move_requests_per_region
compute.googleapis.com/simulate_maintenance_event_requests_per_region
compute.googleapis.com/regional_public_delegated_prefixes_delete_requests_per_region
compute.googleapis.com/regional_public_delegated_prefixes_announce_requests_per_region
compute.googleapis.com/recommend_locations_requests_per_region	RegionInstances RecommendLocations requests per minute per region compute.googleapis.com/recommend_locations_per_region^BETA
compute.googleapis.com/cache_invalidation_requests	Cache invalidation requests per minute compute.googleapis.com/global_cache_invalidation_requests^BETA

Update Cloud Monitoring metrics

To monitor Compute Engine API usage against the simplified API metrics, you must manually update your Cloud Monitoring dashboards, alerts, and queries that use the existing metrics.

Update Cloud Monitoring dashboard to use the simplified metrics

To change an alerting policy that monitors an existing API quota metric to a simplified metric, do the following:

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

   Go to Monitoring

2. In the navigation pane, select Dashboards.

3. Select the dashboard that you want to edit to use a simplified metric.

4. Click Edit dashboard.

5. Edit the filter that corresponds to the metric that you want to update:

   1. In the Filter field, select quota_metric.
   2. In the Comparator field, select =.
   3. In the Value field, specify the metric name for the API quota. For example, the filter quota_metric = compute.googleapis.com/global_reads uses a regular expression to match all time-series data that uses the quota metric compute.googleapis.com/global_reads.

6. To apply your changes to the dashboard, in the toolbar, click Apply.

Update Cloud Monitoring alerting policies to use the simplified API quota metrics

To change an alerting policy that monitors an existing API quota metric to a simplified 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. Click the alerting policy that you want to edit to use a simplified metric.

4. Click Edit to modify the policy.

5. Edit the filter that corresponds to the metric that you want to update:

   1. In the Filter field, select quota_metric.
   2. In the Comparator field, select =.
   3. In the Value field, specify the metric name for the simplified quota. For example, the filter quota_metric = compute.googleapis.com/global_reads uses a regular expression to match all time-series data that uses the quota metric compute.googleapis.com/global_reads.
   4. Click Done to save changes in the filter.

6. Click Save policy.

Update Cloud Monitoring queries to use the simplified quota metrics

To change the quota metric in an MQL-based or PromQL-based alerting policy or a chart in a dashboard, use the Query Editor and edit the query filter. See Using the Query Editor.

Open the Query Editor and edit the filter for query metric as shown in the following examples:

MQL:

  fetch consumer_quota
   | metric 'serviceruntime.googleapis.com/quota/rate/net_usage'
   | filter (metric.quota_metric =~ 'compute.googleapis.com/global_reads')
   | align rate(1m)
   | every 1m
   | group_by [], [value_net_usage_aggregate: aggregate(value.net_usage)]

Note: MQL will be deprecated on July 22, 2025. Use PromQL to build your dashboards. For more information, see MQL deprecation.

PromQL:

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