在 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」：

   前往「Monioring」

2. 在導覽窗格中，選取「Dashboards」(資訊主頁)。

3. 選取要編輯的資訊主頁，使用簡化指標。

4. 按一下「編輯資訊主頁」，然後新增小工具。

5. 新增與要監控的指標相應的篩選器：

   1. 在「篩選器」欄位中，選取「quota_metric」。
   2. 在「Comparator」(比較子) 欄位中，選取 =。
   3. 在「Value」(值) 欄位中，指定 API 配額的指標名稱。 舉例來說，篩選器 quota_metric = compute.googleapis.com/global_reads 會使用規則運算式，比對所有使用配額指標 compute.googleapis.com/global_reads 的時間序列資料。

6. 如要將變更套用至資訊主頁，請按一下工具列中的「套用」。

在 Cloud Monitoring 快訊政策中使用簡化的 API 配額指標

如要建立快訊政策，監控簡化版 API 配額指標的使用量，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「Monitoring」：

   前往「Monioring」

2. 在導覽窗格中，選取「快訊」。 「快訊」頁面會顯示窗格，列出摘要資訊、事件和快訊政策。

3. 按一下「建立政策」，新增快訊政策。

4. 選取與要監控的指標相應的篩選器：

   1. 在「篩選器」欄位中，選取「quota_metric」。
   2. 在「Comparator」(比較子) 欄位中，選取 =。
   3. 在「Value」(值) 欄位中，指定簡化配額的指標名稱。舉例來說，篩選器 quota_metric = compute.googleapis.com/global_reads 會使用規則運算式，比對所有使用配額指標 compute.googleapis.com/global_reads 的時間序列資料。
   4. 按一下「完成」，儲存篩選器的變更。

5. 按一下 [Save Policy] (儲存政策)。

您也可以使用 Google Cloud Terraform Provider 在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)]

注意：系統將於 2025 年 7 月 22 日淘汰 MQL。使用 PromQL 建構資訊主頁。 詳情請參閱「淘汰 MQL」。 PromQL：

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

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