Use simplified API quota metrics in Cloud Monitoring

---

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

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 consolidate 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

Use simplified metrics in Cloud Monitoring

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

Use the simplified metrics in Cloud Monitoring dashboards

To use a simplified quota metric in the dashboards, 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 and add a widget.

5. Add a filter that corresponds to the metric that you want to monitor:

   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.

Use the simplified API quota metrics in Cloud Monitoring alerting policies

To create an alerting policy to monitor the usage of a simplified API 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. Click Create policy to add an alerting policy.

4. Select a filter that corresponds to the metric that you want to monitor:

   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.

5. 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.

Use simplified quota metrics in Cloud Monitoring queries

To use the simplified 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 add the filter 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/globalreads"}[${_interval}]))