Mengaktifkan PMU di VM

Dokumen ini menjelaskan cara mengaktifkan unit pemantauan performa (PMU) di instance virtual machine (VM) baru atau yang sudah ada.

Setelah mengaktifkan PMU di VM C4 dan terhubung ke VM, Anda dapat menjalankan dan menginstal software pemantauan performa di VM untuk menganalisis dan mengoptimalkan performa software yang berjalan di VM. Hal ini berguna saat menjalankan workload yang sensitif terhadap performa, seperti komputasi berperforma tinggi (HPC) atau workload machine learning (ML).

Sebelum memulai

  • Jika Anda belum melakukannya, siapkan autentikasi. Authentication adalah proses yang digunakan untuk memverifikasi identitas Anda agar dapat mengakses layanan dan API Google Cloud. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat mengautentikasi ke Compute Engine sebagai berikut.

    Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

    gcloud

    1. Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut: 

      gcloud init
    2. Menetapkan region dan zona default.

    REST

    Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

      Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut: 

      gcloud init

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk mengaktifkan PMU di VM baru atau yang sudah ada, minta administrator untuk memberi Anda Peran IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk mengaktifkan PMU di VM baru atau yang sudah ada. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk mengaktifkan PMU di VM baru atau yang sudah ada:

  • Untuk membuat VM:
    • compute.instances.create pada project
    • Untuk menggunakan image kustom guna membuat VM: compute.images.useReadOnly pada gambar
    • Untuk menggunakan snapshot guna membuat VM: compute.snapshots.useReadOnly pada snapshot
    • Untuk menggunakan template instance guna membuat VM: compute.instanceTemplates.useReadOnly pada template instance
    • Untuk menetapkan jaringan lama ke VM: compute.networks.use di project
    • Untuk menentukan alamat IP statis untuk VM: compute.addresses.use pada project
    • Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan lama: compute.networks.useExternalIp pada project
    • Untuk menentukan subnet VM: compute.subnetworks.use pada project atau subnet yang dipilih
    • Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan VPC: compute.subnetworks.useExternalIp pada project atau subnet yang dipilih
    • Untuk menyetel metadata instance VM bagi VM: compute.instances.setMetadata pada project
    • Guna menyetel tag untuk VM: compute.instances.setTags pada VM
    • Untuk menetapkan label pada VM: compute.instances.setLabels pada VM
    • Untuk menetapkan akun layanan yang akan digunakan VM: compute.instances.setServiceAccount di VM
    • Untuk membuat disk baru bagi VM: compute.disks.create pada project
    • Untuk memasang disk yang ada dalam mode hanya baca atau baca-tulis: compute.disks.use pada disk
    • Untuk memasang disk yang ada dalam mode hanya baca: compute.disks.useReadOnly pada disk
  • Untuk membuat template instance: compute.instanceTemplates.create pada project
  • Untuk mengupdate VM: compute.instances.update pada VM

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Mengaktifkan PMU di VM

Untuk mengaktifkan PMU di satu atau beberapa VM C4, pilih salah satu metode berikut:

Setelah mengaktifkan PMU di satu atau beberapa VM, Anda dapat menginstal dan menggunakan software pemantauan performa pada VM.

Mengaktifkan PMU di VM yang ada

Sebelum mengaktifkan PMU di VM yang ada, pastikan VM menggunakan jenis mesin dan platform CPU yang didukung dengan melakukan hal berikut:

  1. Untuk memverifikasi jenis mesin dan platform CPU VM, lihat detail VM.

  2. Jika Anda perlu mengubah jenis mesin VM, lakukan hal berikut:

    1. Untuk memverifikasi bahwa platform CPU yang didukung tersedia di zona tempat VM berada, lihat Region dan zona yang tersedia.

    2. Ubah jenis mesin seperti berikut:

      • Untuk mengaktifkan jenis PMU Enhanced, Anda harus menentukan Jenis mesin C4 dengan 96 atau 192 vCPU.

      • Jika tidak, untuk mengaktifkan jenis PMU Arsitektur atau Standar, tentukan jenis mesin C4 apa pun.

Anda tidak perlu menghentikan VM untuk mengaktifkan PMU. Namun, untuk membuat perubahan Anda harus memulai ulang VM seperti yang dijelaskan dalam bagian ini.

Untuk mengaktifkan PMU di VM yang ada, pilih salah satu opsi berikut:

gcloud

  1. Buat file YAML kosong.

  2. Untuk mengekspor properti VM ke file YAML yang baru saja Anda dibuat, gunakan Perintah gcloud compute instances export.

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

    Ganti kode berikut:

    • VM_NAME: nama VM.

    • YAML_FILE: jalur ke file YAML yang Anda buat di langkah sebelumnya.

    • ZONE: zona tempat VM berada.

  3. Dalam file konfigurasi YAML, tambahkan kolom performanceMonitoringUnit.

    advancedMachineFeatures:
  performanceMonitoringUnit: PMU_TYPE

    Ganti PMU_TYPE dengan salah satu nilai berikut:

    • Jenis PMU arsitektur: ARCHITECTURAL

    • Jenis PMU standar: STANDARD

    • Jenis PMU yang ditingkatkan: ENHANCED

  4. Untuk mengupdate VM dan memulai ulang, gunakan Perintah gcloud compute instances update-from-file dengan tanda --most-disruptive-allowed-action disetel ke RESTART.

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

    Ganti kode berikut:

    • VM_NAME: nama VM.

    • YAML_FILE: jalur ke file YAML dengan data konfigurasi yang Anda ubah di langkah sebelumnya.

    • ZONE: zona tempat VM berada.

REST

  1. Buat file JSON kosong.

  2. Untuk melihat properti VM yang ada, buat permintaan GET ke Metode instances.get.

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

    Ganti kode berikut:

    • PROJECT_ID: ID project tempat VM berada ditemukan.

    • ZONE: zona tempat VM berada.

    • VM_NAME: nama VM yang ada.

  3. Di file JSON kosong yang Anda buat di langkah sebelumnya, lakukan berikut ini:

    1. Masukkan properti VM dari output permintaan GET.

    2. Tambahkan kolom performanceMonitoringUnit.

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

      Ganti PMU_TYPE dengan salah satu opsi berikut nilai-nilai:

      • Jenis PMU arsitektur: ARCHITECTURAL

      • Jenis PMU standar: STANDARD

      • Jenis PMU yang ditingkatkan: ENHANCED

  4. Untuk mengupdate VM dan memulai ulang, buat permintaan PUT ke metode instances.update. Dalam permintaan, lakukan hal berikut:

    • Dalam URL permintaan, sertakan most_disruptive_allowed_action parameter kueri yang disetel ke RESTART.

    • Untuk isi permintaan, gunakan properti VM dari file JSON yang yang Anda buat dan perbarui di langkah sebelumnya.

    PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME?most_disruptive_allowed_action=RESTART

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

Untuk informasi selengkapnya tentang memperbarui properti VM, lihat Memperbarui properti VM.

Mengaktifkan PMU saat membuat VM

Anda hanya dapat membuat VM dengan PMU diaktifkan di zona yang berisi platform CPU yang didukung. Untuk daftar yang tersedia berdasarkan zona, lihat Region dan zona yang tersedia.

Untuk membuat VM dengan PMU yang diaktifkan, pilih salah satu opsi berikut:

gcloud

Untuk membuat VM dengan PMU yang diaktifkan, gunakan Perintah gcloud compute instances create dengan flag --performance-monitoring-unit.

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

Ganti kode berikut:

  • VM_NAME: nama VM.

  • MACHINE_TYPE: a Jenis mesin C4. Jika ingin mengaktifkan jenis Enhanced PMU, Anda harus menentukan C4 jenis mesin dengan 96 atau 192 vCPU. Jika tidak, pembuatan VM akan gagal.

  • PMU_TYPE: jenis PMU yang akan diaktifkan di VM. Tentukan salah satu nilai berikut:

    • Jenis PMU arsitektur: architectural

    • Jenis PMU standar: standard

    • Jenis PMU yang ditingkatkan: enhanced

  • ZONE: zona tempat untuk membuat VM.

REST

Untuk membuat VM dengan PMU diaktifkan, buat permintaan POST ke metode instances.insert. Dalam isi permintaan, sertakan kolom 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"
  }
}

Ganti kode berikut:

  • PROJECT_ID: ID project tempat VM akan dibuat.

  • ZONE: zona tempat untuk membuat VM.

  • VM_NAME: nama VM.

  • MACHINE_TYPE: a Jenis mesin C4. Jika ingin mengaktifkan jenis Enhanced PMU, Anda harus menentukan C4 jenis mesin dengan 96 atau 192 vCPU. Jika tidak, pembuatan VM akan gagal.

  • IMAGE_PROJECT: project gambar yang berisi gambar—misalnya, debian-cloud. Untuk informasi selengkapnya tentang project gambar yang didukung, lihat Gambar publik.

  • IMAGE: tentukan salah satu opsi berikut:

    • Versi OS image tertentu—misalnya, debian-12-bookworm-v20240617.

    • Kelompok gambar, yang harus diformat sebagai family/IMAGE_FAMILY. Ini menentukan OS image terbaru yang masih digunakan. Misalnya, jika Anda menentukan family/debian-12, versi terbaru di Debian 12 kelompok gambar yang digunakan. Untuk mengetahui informasi selengkapnya tentang penggunaan kelompok image, lihat Praktik terbaik kelompok image.

  • PMU_TYPE: jenis PMU yang akan diaktifkan di VM. Tentukan salah satu nilai berikut:

    • Jenis PMU arsitektur: ARCHITECTURAL

    • Jenis PMU standar: STANDARD

    • Jenis PMU yang ditingkatkan: ENHANCED

Untuk informasi lebih lanjut tentang membuat VM, lihat Buat dan mulai instance Compute Engine.

Mengaktifkan PMU saat membuat VM secara massal

Anda hanya dapat membuat VM secara massal dengan PMU diaktifkan di zona yang berisi platform CPU yang didukung. Untuk daftar yang tersedia berdasarkan zona, lihat Region dan zona yang tersedia.

Untuk membuat VM secara massal dengan PMU diaktifkan, pilih salah satu opsi berikut:

gcloud

Untuk membuat VM secara massal dengan PMU yang diaktifkan, gunakan Perintah gcloud compute instances bulk create dengan flag --performance-monitoring-unit.

Misalnya, untuk membuat VM secara massal di satu zona dan menentukan nama , jalankan perintah berikut:

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

Ganti kode berikut:

  • COUNT: jumlah VM yang akan dibuat.

  • MACHINE_TYPE: a Jenis mesin C4. Jika ingin mengaktifkan jenis Enhanced PMU, Anda harus menentukan C4 jenis mesin dengan 96 atau 192 vCPU. Jika tidak, pembuatan VM akan gagal.

  • NAME_PATTERN: pola nama untuk VM. Kepada mengganti urutan angka dalam nama VM, menggunakan urutan hash (#) karakter. Misalnya, menggunakan vm-# untuk pola nama akan menghasilkan VM dengan nama yang dimulai dengan vm-1, vm-2, dan terus hingga nomor VM yang ditentukan oleh COUNT.

  • PMU_TYPE: jenis PMU yang akan diaktifkan di VM. Tentukan salah satu nilai berikut:

    • Jenis PMU arsitektur: architectural

    • Jenis PMU standar: standard

    • Jenis PMU yang ditingkatkan: enhanced

  • ZONE: zona tempat membuat VM secara massal.

REST

Untuk membuat VM secara massal dengan PMU diaktifkan, buat permintaan POST ke metode instances.bulkInsert. Dalam isi permintaan, sertakan kolom performanceMonitoringUnit.

Misalnya, untuk membuat VM secara massal dalam satu zona dan menentukan pola nama, buat permintaan POST sebagai berikut:

POST https://www.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"
    }
  }
}

Ganti kode berikut:

  • PROJECT_ID: ID project tempat membuat VM secara massal.

  • ZONE: zona tempat membuat VM secara massal.

  • COUNT: jumlah VM yang akan dibuat.

  • NAME_PATTERN: pola nama untuk VM. Untuk mengganti urutan angka dalam nama VM, gunakan urutan karakter hash (#). Misalnya, menggunakan vm-# untuk pola nama akan menghasilkan VM dengan nama yang dimulai dengan vm-1, vm-2, dan terus hingga nomor VM yang ditentukan oleh COUNT.

  • MACHINE_TYPE: a Jenis mesin C4. Jika ingin mengaktifkan jenis Enhanced PMU, Anda harus menentukan C4 jenis mesin dengan 96 atau 192 vCPU. Jika tidak, pembuatan VM akan gagal.

  • IMAGE_PROJECT: project gambar yang berisi gambar—misalnya, debian-cloud. Untuk informasi selengkapnya tentang project gambar yang didukung, lihat Gambar publik.

  • IMAGE: tentukan salah satu opsi berikut:

    • Versi tertentu dari image OS—misalnya, debian-12-bookworm-v20240617.

    • Kelompok image, yang harus diformat sebagai family/IMAGE_FAMILY. Ini menentukan OS image terbaru yang masih digunakan. Misalnya, jika Anda menentukan family/debian-12, versi terbaru dalam kelompok image Debian 12 akan digunakan. Untuk informasi selengkapnya tentang penggunaan gambar keluarga, lihat Praktik terbaik kelompok gambar.

  • PMU_TYPE: jenis PMU yang akan diaktifkan di VM. Tentukan salah satu nilai berikut:

    • Jenis PMU arsitektur: ARCHITECTURAL

    • Jenis PMU standar: STANDARD

    • Jenis PMU yang ditingkatkan: ENHANCED

  • ZONE: zona tempat membuat VM secara massal.

Untuk informasi selengkapnya tentang cara membuat VM secara massal, lihat Buat VM secara massal.

Mengaktifkan PMU saat membuat template instance

Jika Anda ingin membuat template instance regional dengan PMU diaktifkan, pastikan setidaknya satu zona dalam region yang dipilih berisi platform CPU yang didukung. Untuk daftar yang tersedia berdasarkan zona, lihat Region dan zona yang tersedia.

Setelah membuat template instance dengan PMU diaktifkan, Anda dapat menggunakan untuk melakukan tindakan berikut:

Untuk membuat template instance dengan PMU diaktifkan, pilih salah satu opsi berikut opsi:

gcloud

Untuk membuat template instance dengan PMU yang diaktifkan, gunakan Perintah gcloud compute instance-templates create dengan flag --performance-monitoring-unit.

Misalnya, untuk membuat template instance global dengan PMU diaktifkan, jalankan perintah berikut:

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

Ganti kode berikut:

  • INSTANCE_TEMPLATE_NAME: nama template instance.

  • MACHINE_TYPE: Jenis mesin C4. Jika ingin mengaktifkan jenis Enhanced PMU, Anda harus menentukan C4 jenis mesin dengan 96 atau 192 vCPU. Jika tidak, pembuatan VM akan gagal.

  • PMU_TYPE: jenis PMU yang akan disertakan dalam instance {i>template<i}. Tentukan salah satu nilai berikut:

    • Jenis PMU arsitektur: architectural

    • Jenis PMU standar: standard

    • Jenis PMU yang ditingkatkan: enhanced

REST

Untuk membuat template instance dengan PMU diaktifkan, buat permintaan POST ke salah satu metode berikut:

Dalam isi permintaan, sertakan kolom performanceMonitoringUnit.

Misalnya, untuk membuat template instance global dengan PMU diaktifkan, buat permintaan POST sebagai berikut:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/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"
    }
  }
}

Ganti kode berikut:

  • PROJECT_ID: ID project tempat membuat template instance.

  • INSTANCE_TEMPLATE_NAME: nama template instance.

  • IMAGE_PROJECT: project gambar yang berisi gambar—misalnya, debian-cloud. Untuk informasi selengkapnya tentang project gambar yang didukung, lihat Gambar publik.

  • IMAGE: tentukan salah satu opsi berikut:

    • Versi tertentu dari image OS—misalnya, debian-12-bookworm-v20240617.

    • Kelompok gambar, yang harus diformat sebagai family/IMAGE_FAMILY. Ini menentukan OS image terbaru yang masih digunakan. Misalnya, jika Anda menentukan family/debian-12, versi terbaru di Debian 12 kelompok gambar yang digunakan. Untuk mengetahui informasi selengkapnya tentang penggunaan kelompok image, lihat Praktik terbaik kelompok image.

  • MACHINE_TYPE: a Jenis mesin C4. Jika ingin mengaktifkan jenis Enhanced PMU, Anda harus menentukan C4 jenis mesin dengan 96 atau 192 vCPU. Jika tidak, pembuatan VM akan gagal.

  • PMU_TYPE: jenis PMU yang akan disertakan dalam instance {i>template<i}. Tentukan salah satu nilai berikut:

    • Jenis PMU arsitektur: ARCHITECTURAL

    • Jenis PMU standar: STANDARD

    • Jenis PMU yang ditingkatkan: ENHANCED

Untuk mengetahui informasi selengkapnya tentang cara membuat template instance, baca Membuat template instance.

Langkah selanjutnya