在 Cloud Monitoring 中使用简化的 API 配额指标

---

本文档介绍了如何在 Cloud Monitoring 信息中心、提醒政策和查询中使用简化的 Compute Engine API 配额指标。

简化了 API 配额指标

为了提高 Compute Engine API 配额的可发现性和可管理性， Google Cloud 通过将指标整合到更少的配额组中，减少了配额指标的数量。这些简化的配额指标还为每个配额组提供了更高的限额。

下表列出了所有可整合现有 API 配额指标的简化 API 配额指标：

现有 API 配额指标	简化的 API 配额指标
compute.googleapis.com/list_requests	Read requests per minute compute.googleapis.com/global_reads
compute.googleapis.com/read_requests
compute.googleapis.com/heavy_weight_read_requests
compute.googleapis.com/default 用于列出 Compute Engine 资源的方法的现有配额指标。
compute.googleapis.com/get_macsec_config_requests
compute.googleapis.com/license_verification_requests
compute.googleapis.com/default 用于创建、修改或删除 Compute Engine 资源的全局方法的现有配额指标。	Mutation requests per minute compute.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 region compute.googleapis.com/reads_per_region
compute.googleapis.com/read_requests_per_region
compute.googleapis.com/list_requests_per_region
compute.googleapis.com/default_per_region 用于列出 Compute Engine 资源的区域级和可用区级方法的现有配额指标。
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
compute.googleapis.com/default_per_region 用于创建、修改或删除 Compute Engine 资源的区域级和可用区级方法的现有配额指标。
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
compute.googleapis.com/cache_invalidation_requests	Cache invalidation requests per minute compute.googleapis.com/global_cache_invalidation_requests

在 Cloud Monitoring 中使用简化指标

如需根据简化的 API 指标监控 Compute Engine API 用量，请在 Cloud Monitoring 信息中心、提醒和查询中为这些指标添加过滤条件。

在 Cloud Monitoring 信息中心使用简化指标

如需在信息中心内使用简化的配额指标，请执行以下操作：

1. 在 Google Cloud 控制台中，前往 Monitoring：

   转至 Resources

2. 在导航窗格中，选择信息中心。

3. 选择要修改的信息中心以使用简化指标。

4. 点击修改信息中心，然后添加 widget。

5. 添加与要监控的指标对应的过滤条件：

   1. 在过滤条件字段中，选择 quota_metric。
   2. 在比较器字段中，选择 =。
   3. 在值字段中，指定 API 配额的指标名称。例如，过滤条件 quota_metric = compute.googleapis.com/global_reads 使用正则表达式来匹配使用配额指标 compute.googleapis.com/global_reads 的所有时序数据。

6. 如需将更改应用于信息中心，请在工具栏中点击应用。

在 Cloud Monitoring 提醒政策中使用简化的 API 配额指标

如需创建提醒政策来监控简化的 API 配额指标的用量，请执行以下操作：

1. 在 Google Cloud 控制台中，前往 Monitoring：

   转至 Resources

2. 在导航窗格中选择提醒。“提醒”页面会显示列出摘要信息、突发事件和提醒政策的窗格。

3. 点击创建政策以添加提醒政策。

4. 选择与要监控的指标对应的过滤条件：

   1. 在过滤条件字段中，选择 quota_metric。
   2. 在比较器字段中，选择 =。
   3. 在值字段中，指定简化配额的指标名称。例如，过滤条件 quota_metric = compute.googleapis.com/global_reads 使用正则表达式来匹配使用配额指标 compute.googleapis.com/global_reads 的所有时序数据。
   4. 点击完成以保存过滤条件更改。

5. 点击保存政策。

您还可以使用 Google Cloud Terraform 提供程序在Google Cloud 项目中创建提醒政策。如需了解详情，请参阅使用 Terraform 创建提醒政策。

在 Cloud Monitoring 查询中使用简化的配额指标

如需在基于 MQL 或 PromQL 的提醒政策或信息中心图表中使用简化的配额指标，请使用查询编辑器并修改查询过滤条件。请参阅使用查询编辑器。 打开查询编辑器并添加过滤条件，如以下示例所示： 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)]

注意：MQL 将于 2025 年 7 月 22 日弃用。使用 PromQL 构建信息中心。如需了解详情，请参阅 MQL 弃用。PromQL：

   sum(rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", 

   quota_metric=~"compute.googleapis.com/globalreads"}[${_interval}]))