Mengaktifkan PMU di instance Compute Engine

Dokumen ini menjelaskan cara mengaktifkan unit pemantauan performa (PMU) di instance Compute Engine A4X, C4A, C4, atau M4. Setelah mengaktifkan PMU, Anda dapat menggunakannya untuk mengoptimalkan workload yang sensitif terhadap performa, seperti komputasi berperforma tinggi (HPC) atau machine learning (ML), dengan mengidentifikasi dan mengatasi bottleneck aplikasi.

Untuk mempelajari lebih lanjut persyaratan dan batasan yang Anda terapkan saat mengaktifkan PMU di instance komputasi, lihat Ringkasan PMU.

Sebelum memulai

  • Siapkan autentikasi jika Anda belum melakukannya. Autentikasi memverifikasi identitas Anda untuk mengakses layanan Google Cloud 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. Instal Google Cloud CLI. Setelah penginstalan, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut: 

      gcloud init

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

    2. Set a default region and zone.

    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. Setelah penginstalan, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut: 

      gcloud init

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

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

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengaktifkan PMU di instance komputasi 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 instance komputasi baru atau yang sudah ada. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

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

  • Untuk membuat instance komputasi:
    • 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 pada project
    • Untuk menentukan alamat IP statis untuk VM: compute.addresses.use di 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 pada project atau pada 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 menyetel tag untuk VM: compute.instances.setTags di VM
    • Untuk menyetel label VM: compute.instances.setLabels di VM
    • Untuk menyetel akun layanan yang akan digunakan VM: compute.instances.setServiceAccount di VM
    • Untuk membuat disk baru untuk VM: compute.disks.create di 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 instance komputasi: compute.instances.update di instance komputasi

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

Mengaktifkan PMU di instance komputasi

Untuk mengaktifkan PMU di satu atau beberapa instance komputasi, gunakan salah satu metode berikut:

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

Mengaktifkan PMU di instance komputasi yang ada

Sebelum mengaktifkan PMU di instance komputasi yang ada, Anda harus memverifikasi bahwa instance komputasi menggunakan platform CPU dan seri mesin yang didukung. Untuk memverifikasi rangkaian mesin dan platform CPU yang digunakan instance komputasi Anda, lihat detail instance komputasi.

Jika instance komputasi Anda tidak menggunakan rangkaian mesin yang didukung, ganti jenis mesin instance komputasi. Anda dapat melakukannya dengan memigrasikan beban kerja ke instance komputasi baru yang menggunakan jenis mesin yang didukung, atau dengan mengubah jenis mesin untuk konfigurasi yang didukung:

  • Jika Anda perlu memindahkan instance komputasi yang ada ke instance komputasi baru untuk mengubah jenis mesin, maka buat instance komputasi baru yang mengaktifkan PMU di zona yang menawarkan platform CPU yang ingin Anda gunakan dengan peristiwa PMU.

  • Jika Anda dapat mengubah jenis mesin, selesaikan langkah-langkah berikut:

    1. Pastikan platform CPU yang didukung tersedia di zona tempat instance komputasi Anda berada dengan meninjau region dan zona yang tersedia.

    2. Jika platform CPU yang didukung tidak tersedia di zona instance komputasi Anda, maka migrasikan instance komputasi ke zona yang memiliki platform CPU yang didukung.

    3. Ubah jenis mesin. Untuk mengaktifkan jenis PMU arsitektur atau standar, Anda dapat menentukan jenis mesin A4X, C4A, C4, atau M4. Namun, untuk mengaktifkan jenis PMU yang ditingkatkan, Anda harus menentukan salah satu jenis mesin C4 atau M4 berikut:

      • Jenis mesin C4 apa pun dengan 144 atau 288 vCPU

      • Salah satu jenis mesin M4 berikut:

        • m4-megamem-112

        • m4-megamem-224

        • m4-ultramem-56

        • m4-ultramem-112

        • m4-ultramem-224

Anda tidak perlu menghentikan instance komputasi untuk mengaktifkan PMU. Namun, agar perubahan diterapkan, Anda harus memulai ulang instance komputasi seperti yang dijelaskan di bagian ini.

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

gcloud

  1. Buat file YAML kosong.

  2. Untuk mengekspor properti instance Compute ke file YAML yang baru saja Anda buat, gunakan perintah gcloud compute instances export:

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

    Ganti kode berikut:

    • INSTANCE_NAME: nama untuk instance Compute.

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

    • ZONE: zona tempat instance komputasi berada.

  3. Dalam file konfigurasi YAML, 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 memperbarui instance komputasi dan memulai ulang, gunakan perintah gcloud compute instances update-from-file dengan flag --most-disruptive-allowed-action yang ditetapkan ke RESTART:

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

    Ganti YAML_FILE dengan jalur ke file YAML dengan data konfigurasi yang Anda ubah pada langkah sebelumnya.

REST

  1. Untuk melihat properti instance komputasi yang ada, buat permintaan GET ke metode instances.get:

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

    Ganti kode berikut:

    • PROJECT_ID: ID project tempat Anda membuat instance komputasi.

    • ZONE: zona tempat instance komputasi berada.

    • INSTANCE_NAME: nama untuk instance Compute.

  2. Untuk mengupdate instance Compute dan memulainya ulang, buat permintaan PUT ke metode instances.update sebagai berikut:

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

    • Untuk isi permintaan, gunakan output permintaan GET dari langkah sebelumnya. Namun, di kolom advancedMachineFeatures, Anda harus menambahkan kolom performanceMonitoringUnit untuk mengaktifkan PMU. Jika kolom advancedMachineFeatures tidak ada dalam output permintaan, tambahkan juga:

    Permintaan PUT mirip dengan berikut ini:

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

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

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

Mengaktifkan PMU saat membuat instance komputasi

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

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

gcloud

Untuk membuat instance komputasi yang mengaktifkan PMU, gunakan perintah gcloud compute instances create dengan flag --performance-monitoring-unit:

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

Ganti kode berikut:

  • INSTANCE_NAME: nama untuk instance Compute.

  • MACHINE_TYPE: jenis mesin untuk instance komputasi. Jika Anda ingin mengaktifkan jenis PMU yang ditingkatkan di instance komputasi, Anda dapat mengaktifkannya hanya jika instance komputasi Anda menggunakan jenis mesin yang didukung.

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

    • Jenis PMU arsitektur: architectural

    • Jenis PMU standar: standard

    • Jenis PMU yang ditingkatkan: enhanced

  • ZONE: zona tempat membuat instance komputasi.

REST

Untuk membuat instance komputasi 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": "INSTANCE_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 instance komputasi dibuat.

  • ZONE: zona tempat membuat instance komputasi.

  • INSTANCE_NAME: nama untuk instance Compute.

  • MACHINE_TYPE: jenis mesin untuk instance komputasi. Jika Anda ingin mengaktifkan jenis PMU yang ditingkatkan di instance komputasi, Anda dapat mengaktifkannya hanya jika instance komputasi Anda menggunakan jenis mesin yang didukung.

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

  • IMAGE: tentukan salah satu dari berikut ini:

    • Versi tertentu dari OS image—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 cara menggunakan kelompok image, lihat Praktik terbaik kelompok image.

  • PMU_TYPE: jenis PMU yang akan diaktifkan di instance compute. 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 instance komputasi, lihat Membuat dan memulai instance Compute Engine.

Mengaktifkan PMU saat membuat instance komputasi secara massal

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

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

gcloud

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

Misalnya, untuk membuat instance komputasi secara massal dalam 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 instance komputasi yang akan dibuat.

  • MACHINE_TYPE: jenis mesin untuk instance komputasi. Jika Anda ingin mengaktifkan jenis PMU yang ditingkatkan di instance komputasi, Anda dapat mengaktifkannya hanya jika instance komputasi Anda menggunakan jenis mesin yang didukung.

  • NAME_PATTERN: pola nama untuk instance compute. Untuk mengganti urutan angka dalam nama instance komputasi, gunakan urutan karakter hash (#). Misalnya, menggunakan instance-# untuk pola nama akan menghasilkan instance komputasi dengan nama yang dimulai dengan instance-1, instance-2, dan berlanjut hingga jumlah instance komputasi yang ditentukan oleh COUNT.

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

    • Jenis PMU arsitektur: architectural

    • Jenis PMU standar: standard

    • Jenis PMU yang ditingkatkan: enhanced

  • ZONE: zona tempat membuat instance komputasi secara massal.

REST

Untuk membuat instance komputasi secara massal yang mengaktifkan PMU, buat permintaan POST ke metode instances.bulkInsert. Dalam isi permintaan, sertakan kolom performanceMonitoringUnit.

Misalnya, untuk membuat instance komputasi 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 instance compute akan dibuat secara massal.

  • ZONE: zona tempat membuat instance komputasi secara massal.

  • COUNT: jumlah instance komputasi yang akan dibuat.

  • NAME_PATTERN: pola nama untuk instance compute. Untuk mengganti urutan angka dalam nama instance komputasi, gunakan urutan karakter hash (#). Misalnya, menggunakan instance-# untuk pola nama akan menghasilkan instance komputasi dengan nama yang dimulai dengan instance-1, instance-2, dan berlanjut hingga jumlah instance komputasi yang ditentukan oleh COUNT.

  • MACHINE_TYPE: jenis mesin untuk instance komputasi. Jika Anda ingin mengaktifkan jenis PMU yang ditingkatkan di instance komputasi, Anda dapat mengaktifkannya hanya jika instance komputasi Anda menggunakan jenis mesin yang didukung.

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

  • IMAGE: tentukan salah satu dari berikut ini:

    • Versi tertentu dari OS image—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 cara menggunakan kelompok image, lihat Praktik terbaik kelompok image.

  • PMU_TYPE: jenis PMU yang akan diaktifkan di instance komputasi. 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 instance komputasi 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 ada satu zona dalam region yang dipilih yang 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.

Misalnya, gunakan perintah berikut untuk membuat template instance regional. Jika Anda ingin membuat template instance global, gunakan perintah yang sama tanpa flag --instance-template-region.

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 untuk template instance.

  • REGION: region tempat membuat template instance.

  • MACHINE_TYPE: jenis mesin untuk instance komputasi. Jika Anda ingin mengaktifkan jenis PMU yang ditingkatkan di instance komputasi, Anda dapat mengaktifkannya hanya jika instance komputasi Anda menggunakan jenis mesin yang didukung.

  • 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 template instance akan dibuat.

  • REGION: region tempat membuat template instance.

  • INSTANCE_TEMPLATE_NAME: nama template instance.

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

  • IMAGE: tentukan salah satu dari berikut ini:

    • Versi tertentu dari OS image—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 cara menggunakan kelompok image, lihat Praktik terbaik kelompok image.

  • MACHINE_TYPE: jenis mesin untuk instance komputasi. Jika Anda ingin mengaktifkan jenis PMU yang ditingkatkan di instance komputasi, Anda dapat mengaktifkannya hanya jika instance komputasi Anda menggunakan jenis mesin yang didukung.

  • 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