Use simplified API quota metrics in Cloud Monitoring Stay organized with collections Save and categorize content based on your preferences.
Simplified API quota metrics
To improve the discoverability and manageability of Compute Engine APIquota, Google Cloud has reduced the number of quota metrics by consolidating metricsinto fewer quota groups. These simplified quota metrics also offer higher limitsfor each quota group.
The following table lists all simplified API quota metrics that consolidate theexisting API quota metrics:
| Existing API quota metrics | Simplified API quota metric |
|---|---|
compute.googleapis.com/list_requests | Read requests per minutecompute.googleapis.com/global_reads |
compute.googleapis.com/read_requests | |
compute.googleapis.com/heavy_weight_read_requests | |
compute.googleapis.com/defaultExisting 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/defaultExisting quota metric for global methods that create, modify, or delete Compute Engine resources. | Mutation requests per minutecompute.googleapis.com/global_writes |
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 regioncompute.googleapis.com/reads_per_region |
compute.googleapis.com/read_requests_per_region | |
compute.googleapis.com/list_requests_per_region | |
compute.googleapis.com/default_per_regionExisting 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 regioncompute.googleapis.com/writes_per_region |
compute.googleapis.com/default_per_regionExisting 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 regioncompute.googleapis.com/recommend_locations_per_region |
compute.googleapis.com/cache_invalidation_requests | Cache invalidation requests per minutecompute.googleapis.com/global_cache_invalidation_requests |
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:
In the Google Cloud console, go toMonitoring:
In the navigation pane, selectDashboards.
Select the dashboard that you want to edit to use a simplified metric.
ClickEdit dashboard and add a widget.
Add a filter that corresponds to the metric that you want to monitor:
- In theFilter field, select
quota_metric. - In theComparator field, select
=. - In theValue field, specify the metric name for the API quota.For example, the filter
quota_metric = compute.googleapis.com/global_readsuses a regular expression to match all time-series data that uses the quotametriccompute.googleapis.com/global_reads.
- In theFilter field, select
To apply your changes to the dashboard, in the toolbar, clickApply.
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:
In the Google Cloud console, go toMonitoring:
In the navigation pane, selectAlerting.The Alerting page displays panes that list summary information, incidents,and alerting policies.
ClickCreate policy to add an alerting policy.
Select a filter that corresponds to the metric that you want to monitor:
- In theFilter field, select
quota_metric. - In theComparator field, select
=. - In theValue field, specify the metric name for the simplified quota.For example, the filter
quota_metric = compute.googleapis.com/global_readsuses a regular expression to match all time-series data that uses the quotametriccompute.googleapis.com/global_reads. - ClickDone to save changes in the filter.
- In theFilter field, select
ClickSave policy.
You can also use the Google Cloud Terraform Provider to create alerting policies in yourGoogle Cloud project. For more information,seeCreate alerting policies with Terraform.
Use simplified quota metrics in Cloud Monitoring queries
To use the simplified quota metric in a PromQL-based alerting policy or a chartin a dashboard, use the Query Editor and edit the query filter. SeeUse the code editor for PromQL.Open the Query Editor and add the filter as shown in the followingexample:
sum(rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \ quota_metric=~"compute.googleapis.com/global_reads"}[${__interval}]))Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-12-15 UTC.