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, 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 untuk mengakses Trusted Cloud by S3NS layanan dan API. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi 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, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut: 

      gcloud init
    2. Set a default region and zone.

    REST

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

      Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut: 

      gcloud init

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

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan 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 image
    • Untuk menggunakan snapshot untuk 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 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 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 langkah-langkah 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 sebagai 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 memperbarui VM dan memulainya 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 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.s3nsapis.fr/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. Di 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 memperbarui VM dan memulainya 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.s3nsapis.fr/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: jenis mesin C4A atau 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.s3nsapis.fr/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: jenis mesin C4A atau 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 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 image OS—misalnya, debian-12-bookworm-v20240617.

    • Kelompok image, yang harus diformat sebagai family/IMAGE_FAMILY. Tindakan ini menentukan image OS terbaru yang tidak digunakan lagi. 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 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. 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: jenis mesin C4A atau 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.s3nsapis.fr/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 image OS—misalnya, debian-12-bookworm-v20240617.

    • Kelompok image, yang harus diformat sebagai family/IMAGE_FAMILY. Tindakan ini menentukan image OS terbaru yang tidak digunakan lagi. 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: jenis mesin C4A atau 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