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 がありません。したがって、リージョン 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. ナビゲーション パネルで [ダッシュボード] を選択します。
  3. リージョン指標を使用するように、編集するダッシュボードを選択します。
  4. [ダッシュボードを編集] をクリックします。

  5. 移行する指標に対応するフィルタを編集します。

    1. [フィルタ] フィールドで quota_metric を選択します。
    2. [コンパレータ] フィールドで [=~] を選択します。

    3. [値] フィールドに、リージョン API 割り当ての指標名を指定します。たとえば、フィルタ quota_metric =~ compute.googleapis.com/read_requests.* は、割り当て指標 compute.googleapis.com/read_requests.* を使用するすべての時系列データに一致する正規表現を使用します。

      リージョン指標を使用するように、フィルタ値を編集します。

      指標の詳細については、リージョン指標の API レート制限をご覧ください。

    4. [完了] をクリックして変更を保存します。

    5. 省略可: リージョンごとの割り当ての使用率を表示するには、[グループ化] ヘッダーを開き、[グループ条件] フィールドで location を選択します。

  6. [エディタを閉じる] をクリックします。

Cloud Monitoring アラート ポリシーを更新してリージョン API 割り当て指標を使用する

グローバル API 割り当て指標をモニタリングするアラート ポリシーをリージョン指標に変更するには、次のようにします。

  1. Google Cloud コンソールで [Monitoring] を選択します。
  2. ナビゲーション パネルで [アラート] を選択します。[アラート] ページには、概要情報、インシデント、アラート ポリシーが列挙されたペインが表示されます。
  3. リージョン指標を使用するように、編集するアラート ポリシーをクリックします。
  4. [編集] をクリックしてポリシーを変更します。

  5. 移行する指標に対応するフィルタを編集します。

    1. [フィルタ] フィールドで quota_metric を選択します。
    2. [コンパレータ] フィールドで [=~] を選択します。

    3. [値] フィールドに、リージョン API 割り当ての指標名を指定します。たとえば、フィルタ quota_metric =~ compute.googleapis.com/read_requests.* は、割り当て指標 compute.googleapis.com/read_requests.* を使用するすべての時系列データに一致する正規表現を使用します。

      リージョン指標を使用するように、アラートを編集します。

      指標の詳細については、リージョン指標の API レート制限をご覧ください。

    4. [完了] をクリックして、フィルタの変更を保存します。

    5. 省略可: リージョン指標にリージョンごとのアラートが必要な場合は、[時系列全体] ヘッダーを開いて、[時系列のグループ化の基準] フィールドで location を選択します。

  6. [ポリシーを保存] をクリックします。

リージョン割り当て指標を使用するように Cloud Monitoring のクエリを更新する

MQL ベースのアラート ポリシーの割り当て指標またはダッシュボードのグラフを変更するには、クエリエディタを使用してクエリフィルタを編集します。クエリエディタの使用をご覧ください。

次の例に示すように、クエリエディタを開き、クエリ指標のフィルタを編集します。

リージョン割り当て指標の正規表現

必要に応じて、group-by オペレーションを使用してロケーションに基づいてアラートをグループ化できます。

ロケーション別のグループ化