Mengaktifkan PMU di VM

Dokumen ini menjelaskan cara mengaktifkan unit pemantauan performa (PMU) di instance virtual machine (VM) baru atau yang sudah ada. Untuk mempelajari PMU lebih lanjut, lihat ringkasan PMU.

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

Sebelum memulai

  • Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses yang digunakan untuk memverifikasi identitas Anda agar dapat mengakses Google Cloud layanan dan API. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

    Select the tab for how you plan to use the samples on this page:

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

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

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Untuk informasi selengkapnya, lihat Mengautentikasi untuk menggunakan REST dalam Google Cloud dokumentasi autentikasi.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna 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 image
    • Untuk menggunakan snapshot guna membuat VM: compute.snapshots.useReadOnly pada snapshot
    • Untuk menggunakan template instance guna membuat VM: compute.instanceTemplates.useReadOnly di 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 di project
    • Untuk menentukan subnet bagi VM: compute.subnetworks.use di project atau di subnet yang dipilih
    • Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan VPC: compute.subnetworks.useExternalIp di project atau di subnet yang dipilih
    • Untuk menetapkan metadata instance VM untuk VM: compute.instances.setMetadata di project
    • Untuk menetapkan tag untuk VM: compute.instances.setTags di VM
    • Untuk menetapkan label untuk VM: compute.instances.setLabels di 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 di 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 C4A atau C4, gunakan salah satu metode berikut:

Setelah mengaktifkan PMU di satu atau beberapa VM, Anda dapat menginstal dan menggunakan software pemantauan performa di 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 tindakan 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 yang Ditingkatkan, Anda harus menentukan jenis mesin C4 dengan 96 atau 192 vCPU.

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

Anda tidak perlu menghentikan VM untuk mengaktifkan PMU. Namun, agar perubahan berlaku, Anda harus memulai ulang VM seperti yang dijelaskan di 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 dalam file YAML yang baru saja Anda buat, 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. Jika kolom advancedMachineFeatures tidak ada, tambahkan juga:

    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 flag --most-disruptive-allowed-action ditetapkan 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.

    • ZONE: zona tempat VM berada.

    • VM_NAME: nama VM yang ada.

  3. Dalam file JSON kosong yang Anda buat di langkah sebelumnya, lakukan hal berikut:

    1. Masukkan properti VM dari output permintaan GET.

    2. Di kolom advancedMachineFeatures, tambahkan kolom performanceMonitoringUnit. Jika kolom advancedMachineFeatures tidak ada, tambahkan juga:

      {
  "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, buat permintaan PUT ke metode instances.update. Dalam permintaan, lakukan hal berikut:

    • Di URL permintaan, sertakan parameter kueri mostDisruptiveAllowedAction yang ditetapkan ke RESTART.

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

    Permintaannya mirip dengan berikut ini:

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

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

Untuk mengetahui informasi selengkapnya tentang cara memperbarui properti VM, lihat Memperbarui properti instance.

Mengaktifkan PMU saat membuat VM

Anda hanya dapat membuat VM yang mengaktifkan PMU di zona yang berisi platform CPU yang didukung. Untuk mengetahui daftar CPU yang tersedia menurut zona, lihat Region dan zona yang tersedia.

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

gcloud

Untuk membuat VM yang mengaktifkan PMU, 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: C4A atau jenis mesin C4. Jika ingin mengaktifkan jenis PMU yang Ditingkatkan, Anda harus menentukan jenis mesin C4 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 yang mengaktifkan PMU, 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: C4A atau jenis mesin C4. Jika ingin mengaktifkan jenis PMU yang Ditingkatkan, Anda harus menentukan jenis mesin C4 dengan 96 atau 192 vCPU. Jika tidak, pembuatan VM akan gagal.

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

  • IMAGE: tentukan salah satu dari hal berikut:

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

    • Kelompok image, yang harus diformat sebagai family/IMAGE_FAMILY. Tindakan ini menentukan image OS terbaru yang masih digunakan. Misalnya, jika Anda menentukan family/debian-12, versi terbaru dalam kelompok image Debian 12 akan 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 mengetahui informasi selengkapnya tentang cara membuat VM, lihat Membuat dan memulai instance Compute Engine.

Mengaktifkan PMU saat membuat VM secara massal

Anda hanya dapat membuat VM secara massal yang mengaktifkan PMU di zona yang berisi platform CPU yang didukung. Untuk mengetahui daftar CPU yang tersedia menurut zona, lihat Region dan zona yang tersedia.

Untuk membuat VM secara massal yang mengaktifkan PMU, pilih salah satu opsi berikut:

gcloud

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

Misalnya, untuk membuat VM secara massal di satu zona dan menentukan pola 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: C4A atau jenis mesin C4. Jika ingin mengaktifkan jenis PMU yang Ditingkatkan, Anda harus menentukan jenis mesin C4 dengan 96 atau 192 vCPU. Jika tidak, pembuatan VM akan gagal.

  • 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 berlanjut hingga jumlah 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 yang mengaktifkan PMU, 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://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"
    }
  }
}

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 berlanjut hingga jumlah VM yang ditentukan oleh COUNT.

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

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

  • IMAGE: tentukan salah satu dari hal berikut:

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

    • Kelompok image, yang harus diformat sebagai family/IMAGE_FAMILY. Tindakan ini menentukan image OS terbaru yang masih digunakan. Misalnya, jika Anda menentukan family/debian-12, versi terbaru dalam kelompok image Debian 12 akan 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 mengetahui informasi selengkapnya tentang cara membuat VM secara massal, lihat Membuat VM secara massal.

Mengaktifkan PMU saat membuat template instance

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

Setelah membuat template instance yang mengaktifkan PMU, Anda dapat menggunakan template tersebut untuk melakukan hal berikut:

Untuk membuat template instance yang mengaktifkan PMU, pilih salah satu opsi berikut:

gcloud

Untuk membuat template instance yang mengaktifkan PMU, gunakan perintah gcloud compute instance-templates create dengan flag --performance-monitoring-unit. Untuk membuat template instance regional, Anda juga harus menyertakan flag --instance-template-region.

Misalnya, untuk membuat template instance regional yang mengaktifkan PMU, jalankan perintah berikut:

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

Ganti kode berikut:

  • INSTANCE_TEMPLATE_NAME: nama template instance.

  • REGION: region tempat membuat template instance.

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

  • PMU_TYPE: jenis PMU yang akan disertakan dalam template instance. Tentukan salah satu nilai berikut:

    • Jenis PMU arsitektur: architectural

    • Jenis PMU standar: standard

    • Jenis PMU yang ditingkatkan: enhanced

REST

Untuk membuat template instance yang mengaktifkan PMU, buat permintaan POST ke salah satu metode berikut:

Dalam isi permintaan, sertakan kolom performanceMonitoringUnit.

Misalnya, untuk membuat template instance regional yang mengaktifkan PMU, buat permintaan POST sebagai berikut:

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"
    }
  }
}

Ganti kode berikut:

  • PROJECT_ID: ID project tempat membuat template instance.

  • REGION: region tempat membuat template instance.

  • INSTANCE_TEMPLATE_NAME: nama template instance.

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

  • IMAGE: tentukan salah satu dari hal berikut:

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

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

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

  • PMU_TYPE: jenis PMU yang akan disertakan dalam template instance. 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, lihat Membuat template instance.

Langkah berikutnya