VM で PMU を有効にする

gcloud

1. 空の YAML ファイルを作成します。

2. 作成したばかりの YAML ファイルに VM のプロパティをエクスポートするには、gcloud compute instances export コマンドを使用します。

   gcloud compute instances export VM_NAME \
       --destination=YAML_FILE \
       --zone=ZONE
   

   次のように置き換えます。

   • VM_NAME: VM の名前。

   • YAML_FILE: 前の手順で作成した YAML ファイルのパス。

   • ZONE: VM が配置されているゾーン。

3. YAML 構成ファイルに performanceMonitoringUnit フィールドを追加します。advancedMachineFeatures フィールドが存在しない場合は、次のように追加します。

   advancedMachineFeatures:
     performanceMonitoringUnit: PMU_TYPE
   

   PMU_TYPE は次のいずれかの値に置き換えます。

   • アーキテクチャの PMU タイプ: ARCHITECTURAL

   • 標準の PMU タイプ: STANDARD

   • 拡張 PMU タイプ: ENHANCED

4. VM を更新して再起動するには、--most-disruptive-allowed-action フラグを RESTART に設定して gcloud compute instances update-from-file コマンドを使用します。

   gcloud compute instances update-from-file VM_NAME \
       --most-disruptive-allowed-action=RESTART \
       --source=YAML_FILE \
       --zone=ZONE
   

   次のように置き換えます。

   • VM_NAME: VM の名前。

   • YAML_FILE: 前の手順で変更した構成データを含む YAML ファイルのパス。

   • ZONE: VM が配置されているゾーン。

REST

1. 空の JSON ファイルを作成します。

2. 既存の VM のプロパティを表示するには、instances.get メソッドに GET リクエストを送信します。

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME
   

   次のように置き換えます。

   • PROJECT_ID: VM が配置されているプロジェクトのプロジェクト ID。

   • ZONE: VM が配置されているゾーン。

   • VM_NAME: 既存の VM の名前。

3. 前の手順で作成した空の JSON ファイルで、次の操作を行います。

   1. GET リクエストの出力から VM プロパティを入力します。

   2. advancedMachineFeatures フィールドで、performanceMonitoringUnit フィールドを追加します。advancedMachineFeatures フィールドが存在しない場合は、次のように追加します。

      {
        "advancedMachineFeatures": {
          "performanceMonitoringUnit": "PMU_TYPE"
        },
        ...
      }
      

      PMU_TYPE は次のいずれかの値に置き換えます。

      • アーキテクチャの PMU タイプ: ARCHITECTURAL

      • 標準の PMU タイプ: STANDARD

      • 拡張 PMU タイプ: ENHANCED

4. VM を更新して再起動するには、instances.update メソッドに PUT リクエストを送信します。リクエストで、次の操作を行います。

   • リクエスト URL に、RESTART に設定された mostDisruptiveAllowedAction クエリ パラメータを含めます。

   • リクエスト本文には、前の手順で作成して更新した JSON ファイルの VM プロパティを使用します。

   出力は次のようになります。

   PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME?mostDisruptiveAllowedAction=RESTART
   
   {
     "advancedMachineFeatures": {
       "performanceMonitoringUnit": "PMU_TYPE"
     },
     ...
   }
   

gcloud

PMU を有効にして VM を作成するには、--performance-monitoring-unit フラグを指定して gcloud compute instances create コマンドを使用します。

gcloud compute instances create VM_NAME \
    --machine-type=MACHINE_TYPE \
    --performance-monitoring-unit=PMU_TYPE \
    --zone=ZONE

次のように置き換えます。

• VM_NAME: VM の名前。

• MACHINE_TYPE: C4A または C4 マシンタイプ。拡張 PMU タイプを有効にするには、96 個または 192 個の vCPU を持つ C4 マシンタイプを指定する必要があります。そうでないと、VM の作成に失敗します。

• PMU_TYPE: VM で有効にする PMU のタイプ。次のいずれかの値を指定します。

  • アーキテクチャの PMU タイプ: architectural

  • 標準の PMU タイプ: standard

  • 拡張 PMU タイプ: enhanced

• ZONE: VM インスタンスを作成するゾーン。

REST

PMU を有効にして VM を作成するには、instances.insert メソッドに POST リクエストを送信します。リクエスト本文に、performanceMonitoringUnit フィールドを含めます。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
  "name": "VM_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ],
  "advancedMachineFeatures": {
    "performanceMonitoringUnit": "PMU_TYPE"
  }
}

次のように置き換えます。

• PROJECT_ID: VM を作成するプロジェクトの ID。

• ZONE: VM インスタンスを作成するゾーン。

• VM_NAME: VM の名前。

• MACHINE_TYPE: C4A または C4 マシンタイプ。拡張 PMU タイプを有効にするには、96 個または 192 個の vCPU を持つ C4 マシンタイプを指定する必要があります。そうでないと、VM の作成に失敗します。

• IMAGE_PROJECT: イメージを含むイメージ プロジェクト（例: debian-cloud）。サポートされているイメージ プロジェクトの詳細については、公開イメージをご覧ください。

• IMAGE: 次のいずれかを指定します。

  • OS イメージの特定のバージョン。例: debian-12-bookworm-v20240617。

  • イメージ ファミリー。family/IMAGE_FAMILY の形式にする必要があります。これにより、非推奨ではない最新の OS イメージが指定されます。たとえば、family/debian-12 を指定すると、Debian 12 イメージ ファミリーの最新バージョンが使用されます。イメージ ファミリーの使用の詳細については、イメージ ファミリーのベスト プラクティスをご覧ください。

• PMU_TYPE: VM で有効にする PMU のタイプ。次のいずれかの値を指定します。

  • アーキテクチャの PMU タイプ: ARCHITECTURAL

  • 標準の PMU タイプ: STANDARD

  • 拡張 PMU タイプ: ENHANCED

gcloud

PMU を有効にして VM を一括作成するには、--performance-monitoring-unit フラグを指定して gcloud compute instances bulk create コマンドを使用します。

たとえば、単一のゾーンで VM を一括作成し、名前パターンを指定するには、次のコマンドを実行します。

gcloud compute instances bulk create \
    --count=COUNT \
    --machine-type=MACHINE_TYPE \
    --name-pattern="NAME_PATTERN" \
    --performance-monitoring-unit=PMU_TYPE \
    --zone=ZONE

次のように置き換えます。

• COUNT: 作成する VM の数。

• MACHINE_TYPE: C4A または C4 マシンタイプ。拡張 PMU タイプを有効にするには、96 個または 192 個の vCPU を持つ C4 マシンタイプを指定する必要があります。そうでないと、VM の作成に失敗します。

• NAME_PATTERN: VM の名前パターン。VM 名の一連の数字を置き換えるには、一連のハッシュ（#）文字を使用します。たとえば、名前パターンに vm-# を使用すると、vm-1、vm-2 で始まり、COUNT で指定された VM の数まで続く名前の VM が生成されます。

• PMU_TYPE: VM で有効にする PMU のタイプ。次のいずれかの値を指定します。

  • アーキテクチャの PMU タイプ: architectural

  • 標準の PMU タイプ: standard

  • 拡張 PMU タイプ: enhanced

• ZONE: VM を一括作成するゾーン。

REST

PMU を有効にして VM を一括作成するには、instances.bulkInsert メソッドに POST リクエストを送信します。リクエスト本文に、performanceMonitoringUnit フィールドを含めます。

たとえば、単一のゾーンで VM を一括作成し、名前パターンを指定するには、次のように POST リクエストを送信します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert

{
  "count": COUNT,
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "machineType": "MACHINE_TYPE",
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "advancedMachineFeatures": {
      "performanceMonitoringUnit": "PMU_TYPE"
    }
  }
}

次のように置き換えます。

• PROJECT_ID: VM を一括作成するプロジェクトの ID。

• ZONE: VM を一括作成するゾーン。

• COUNT: 作成する VM の数。

• NAME_PATTERN: VM の名前パターン。VM 名の一連の数字を置き換えるには、一連のハッシュ（#）文字を使用します。たとえば、名前パターンに vm-# を使用すると、vm-1、vm-2 で始まり、COUNT で指定された VM の数まで続く名前の VM が生成されます。

• MACHINE_TYPE: C4A または C4 マシンタイプ。拡張 PMU タイプを有効にするには、96 個または 192 個の vCPU を持つ C4 マシンタイプを指定する必要があります。そうでないと、VM の作成に失敗します。

• IMAGE_PROJECT: イメージを含むイメージ プロジェクト（例: debian-cloud）。サポートされているイメージ プロジェクトの詳細については、公開イメージをご覧ください。

• IMAGE: 次のいずれかを指定します。

  • OS イメージの特定のバージョン。例: debian-12-bookworm-v20240617。

  • イメージ ファミリー。family/IMAGE_FAMILY の形式にする必要があります。これにより、非推奨ではない最新の OS イメージが指定されます。たとえば、family/debian-12 を指定すると、Debian 12 イメージ ファミリーの最新バージョンが使用されます。イメージ ファミリーの使用の詳細については、イメージ ファミリーのベスト プラクティスをご覧ください。

• PMU_TYPE: VM で有効にする PMU のタイプ。次のいずれかの値を指定します。

  • アーキテクチャの PMU タイプ: ARCHITECTURAL

  • 標準の PMU タイプ: STANDARD

  • 拡張 PMU タイプ: ENHANCED

gcloud

PMU を有効にしてインスタンス テンプレートを作成するには、--performance-monitoring-unit フラグを指定して gcloud compute instance-templates create コマンドを使用します。リージョン インスタンス テンプレートを作成するには、--instance-template-region フラグも指定する必要があります。

たとえば、PMU が有効になっているリージョン インスタンス テンプレートを作成するには、次のコマンドを実行します。

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE \
    --performance-monitoring-unit=PMU_TYPE

次のように置き換えます。

• INSTANCE_TEMPLATE_NAME: インスタンス テンプレートの名前。

• REGION: インスタンス テンプレートを作成するリージョン。

• MACHINE_TYPE: C4A または C4 マシンタイプ。拡張 PMU タイプを有効にするには、96 個または 192 個の vCPU を持つ C4 マシンタイプを指定する必要があります。そうでないと、VM の作成に失敗します。

• PMU_TYPE: インスタンス テンプレートに含める PMU のタイプ。次のいずれかの値を指定します。

  • アーキテクチャの PMU タイプ: architectural

  • 標準の PMU タイプ: standard

  • 拡張 PMU タイプ: enhanced

REST

PMU が有効になっているインスタンス テンプレートを作成するには、次のいずれかのメソッドに POST リクエストを送信します。

• グローバル インスタンス テンプレートを作成するには: instanceTemplates.insert メソッド。

• リージョン インスタンス テンプレートを作成するには: regionInstanceTemplates.insert メソッド。

リクエスト本文に、performanceMonitoringUnit フィールドを含めます。

たとえば、PMU が有効になっているリージョン インスタンス テンプレートを作成するには、次のように POST リクエストを送信します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "advancedMachineFeatures": {
      "performanceMonitoringUnit": "PMU_TYPE"
    }
  }
}

次のように置き換えます。

• PROJECT_ID: インスタンス テンプレートを作成するプロジェクトの ID。

• REGION: インスタンス テンプレートを作成するリージョン。

• INSTANCE_TEMPLATE_NAME: インスタンス テンプレートの名前。

• IMAGE_PROJECT: イメージを含むイメージ プロジェクト（例: debian-cloud）。サポートされているイメージ プロジェクトの詳細については、公開イメージをご覧ください。

• IMAGE: 次のいずれかを指定します。

  • OS イメージの特定のバージョン。例: debian-12-bookworm-v20240617。

  • イメージ ファミリー。family/IMAGE_FAMILY の形式にする必要があります。これにより、非推奨ではない最新の OS イメージが指定されます。たとえば、family/debian-12 を指定すると、Debian 12 イメージ ファミリーの最新バージョンが使用されます。イメージ ファミリーの使用の詳細については、イメージ ファミリーのベスト プラクティスをご覧ください。

• MACHINE_TYPE: C4A または C4 マシンタイプ。拡張 PMU タイプを有効にするには、96 個または 192 個の vCPU を持つ C4 マシンタイプを指定する必要があります。そうでないと、VM の作成に失敗します。

• PMU_TYPE: インスタンス テンプレートに含める PMU のタイプ。次のいずれかの値を指定します。

  • アーキテクチャの PMU タイプ: ARCHITECTURAL

  • 標準の PMU タイプ: STANDARD

  • 拡張 PMU タイプ: ENHANCED