在 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_readsBETA
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_writesBETA
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_regionBETA
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_regionBETA
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_regionBETA
compute.googleapis.com/cache_invalidation_requests Cache invalidation requests per minute
compute.googleapis.com/global_cache_invalidation_requestsBETA

在 Cloud Monitoring 中使用簡易指標

如要根據簡易 API 指標監控 Compute Engine API 用量，請在 Cloud Monitoring 資訊主頁、快訊和查詢中新增這些指標的篩選器。

在 Cloud Monitoring 資訊主頁中使用簡易指標

如要在資訊主頁中使用簡易配額指標，請按照下列步驟操作：

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

    前往「Monioring」

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

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

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

  5. 新增對應於要監控的指標的篩選器：

    1. 在「Filter」欄位中選取 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. 在「Filter」欄位中選取 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 供應工具，在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}]))