在 Cloud Monitoring 中使用簡化的 API 配額指標

本文說明如何在 Cloud Monitoring 資訊主頁、警告政策和查詢中使用簡化的 Compute Engine API 配額指標。

簡化的 API 配額指標

為提升 Compute Engine API 配額的可探索性和可管理性， Trusted Cloud by S3NS 已減少配額指標數量，將指標整合至較少的配額群組。這些簡化的配額指標也為每個配額群組提供更高的限制。

下表列出所有簡化的 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 資訊主頁中使用簡化指標

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

前往 Trusted Cloud 控制台的「Monitoring」：

前往「Monioring」
在導覽窗格中，選取「Dashboards」(資訊主頁)。
選取要編輯的資訊主頁，使用簡化指標。
按一下「編輯資訊主頁」，然後新增小工具。
新增與要監控的指標相應的篩選器：
1. 在「篩選器」欄位中，選取「quota_metric」。
2. 在「Comparator」(比較子) 欄位中，選取 =。
3. 在「Value」(值) 欄位中，指定 API 配額的指標名稱。舉例來說，篩選器 quota_metric = compute.googleapis.com/global_reads 會使用規則運算式，比對所有使用配額指標 compute.googleapis.com/global_reads 的時間序列資料。
如要將變更套用至資訊主頁，請按一下工具列中的「套用」。

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

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

前往 Trusted Cloud 控制台的「Monitoring」：

前往「Monioring」
在導覽窗格中，選取「快訊」。「快訊」頁面會顯示窗格，列出摘要資訊、事件和快訊政策。
按一下「建立政策」，新增快訊政策。
選取與要監控的指標相應的篩選器：
1. 在「篩選器」欄位中，選取「quota_metric」。
2. 在「Comparator」(比較子) 欄位中，選取 =。
3. 在「Value」(值) 欄位中，指定簡化配額的指標名稱。舉例來說，篩選器 quota_metric = compute.googleapis.com/global_reads 會使用規則運算式，比對所有使用配額指標 compute.googleapis.com/global_reads 的時間序列資料。
4. 按一下「完成」，儲存篩選器的變更。
按一下 [Save Policy] (儲存政策)。

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