將 API 配額從全域指標遷移至區域指標

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

---

本文說明區域 API 的配額指標，以及各指標的限制。並說明如何更新 Cloud Monitoring 資訊主頁、快訊政策和查詢，以便使用區域指標。

區域 API 配額指標

使用全球配額指標的 Compute Engine 區域 API 已遷移至使用區域指標。全球 API 會繼續使用全球指標和配額限制。請參閱「全球指標的 API 使用頻率限制」。

如要進一步瞭解使用地區指標的方法和限制，請參閱「地區指標的 API 使用頻率限制」。

下表列出從全球 API 配額指標遷移至區域指標的所有指標：

全域 API 配額指標	區域 API 配額指標
compute.googleapis.com/default	compute.googleapis.com/default_per_region
compute.googleapis.com/read_requests	compute.googleapis.com/read_requests_per_region
compute.googleapis.com/list_requests	compute.googleapis.com/list_requests_per_region
compute.googleapis.com/operation_read_requests	compute.googleapis.com/operation_read_requests_per_region
compute.googleapis.com/heavy_weight_read_requests	compute.googleapis.com/heavy_weight_read_requests_per_region
compute.googleapis.com/heavy_weight_write_requests	compute.googleapis.com/heavy_weight_write_requests_per_region
compute.googleapis.com/global_resource_write_requests	compute.googleapis.com/global_resource_write_requests_per_region

下列指標沒有任何全域 API。如果您在 Cloud Monitoring 資訊主頁、快訊或查詢中參照這些指標，則必須將這些指標遷移至對應的區域指標。

全域 API 配額指標	區域 API 配額指標
compute.googleapis.com/simulate_maintenance_event_requests	compute.googleapis.com/simulate_maintenance_event_requests_per_region
compute.googleapis.com/instance_list_referrers_requests	compute.googleapis.com/instance_list_referrers_requests_per_region
compute.googleapis.com/get_serial_port_output_requests	compute.googleapis.com/get_serial_port_output_requests_per_region
compute.googleapis.com/network_endpoint_write_requests	compute.googleapis.com/network_endpoint_write_requests_per_region
compute.googleapis.com/network_endpoint_list_requests	compute.googleapis.com/network_endpoint_list_requests_per_region

下列指標沒有任何區域或區域 API。因此，您不需要變更區域 API 配額遷移作業。

• compute.googleapis.com/project_set_common_instance_metadata_requests
• compute.googleapis.com/license_insert_requests

遷移 Cloud Monitoring 指標

從現有的 API 配額指標遷移至區域 API 配額指標時，您必須手動更新 Cloud Monitoring 資訊主頁、快訊和查詢，才能使用區域指標。

更新 Cloud Monitoring 資訊主頁，以便使用區域指標

如要將監控全球 API 配額指標的快訊政策變更為區域指標，請按照下列步驟操作：

1. 在 Google Cloud 控制台中選取「Monitoring」。
2. 在導覽窗格中，選取「Dashboards」(資訊主頁)。
3. 選取要編輯的資訊主頁，以便使用區域指標。
4. 按一下「編輯資訊主頁」。

5. 編輯對應於要遷移的指標的篩選器：

   1. 在「Filter」欄位中選取 quota_metric。
   2. 在「Comparator」欄位中選取 =~。

   3. 在「Value」欄位中，指定區域 API 配額的指標名稱。舉例來說，篩選器 quota_metric =~ compute.googleapis.com/read_requests.* 會使用規則運算式，比對使用配額指標 compute.googleapis.com/read_requests.* 的所有時序資料。

      

      如要進一步瞭解指標，請參閱「區域指標的 API 使用頻率限制」。

   4. 按一下「完成」即可儲存變更。

   5. 選用步驟：如要查看各個區域的配額用量，請展開「Grouped」標頭，然後在「Group by」欄位中選取 location。

6. 按一下「Close editor」(關閉編輯器)。

更新 Cloud Monitoring 快訊政策，以便使用區域 API 配額指標

如要將監控全球 API 配額指標的快訊政策變更為區域指標，請按照下列步驟操作：

1. 在 Google Cloud 控制台中選取「Monitoring」。
2. 在導覽窗格中，選取「快訊」。「快訊」頁面會顯示列出摘要資訊、事件和快訊政策的窗格。
3. 按一下要編輯的警示政策，以便使用區域指標。
4. 按一下「編輯」即可修改政策。

5. 編輯對應於要遷移的指標的篩選器：

   1. 在「Filter」欄位中選取 quota_metric。
   2. 在「Comparator」欄位中選取 =~。

   3. 在「Value」欄位中，指定區域 API 配額的指標名稱。舉例來說，篩選器 quota_metric =~ compute.googleapis.com/read_requests.* 會使用規則運算式，比對使用配額指標 compute.googleapis.com/read_requests.* 的所有時序資料。

      

      如要進一步瞭解指標，請參閱「區域指標的 API 使用頻率限制」。

   4. 按一下「完成」即可儲存篩選器中的變更。

   5. 選用：如要針對區域指標設定區域警示，請展開「Across time series」標題，然後在「Time series group by」欄位中選取 location。

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

更新 Cloud Monitoring 查詢，以便使用區域配額指標

如要變更 MQL 快訊政策或資訊主頁圖表中的配額指標，請使用查詢編輯器並編輯查詢篩選器。請參閱使用查詢編輯器。

開啟查詢編輯器，然後編輯查詢指標的篩選器，如以下範例所示：

您也可以使用 group-by 運算子，根據位置將警示分組：