Halaman ini diterjemahkan oleh Cloud Translation API.

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, lihat cara kerja PMU.
Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses verifikasi identitas Anda untuk mengakses layanan dan API Google Cloud. 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
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

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&colon; compute.images.useReadOnly pada image
- Untuk menggunakan snapshot guna membuat VM&colon; compute.snapshots.useReadOnly pada snapshot
- Untuk menggunakan template instance guna membuat VM&colon; compute.instanceTemplates.useReadOnly di template instance
- Untuk menetapkan jaringan lama ke VM&colon; compute.networks.use di project
- Untuk menentukan alamat IP statis untuk VM&colon; compute.addresses.use pada project
- Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan lama&colon; compute.networks.useExternalIp di project
- Untuk menentukan subnet bagi VM&colon; compute.subnetworks.use di project atau di subnet yang dipilih
- Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan VPC&colon; compute.subnetworks.useExternalIp di project atau di subnet yang dipilih
- Untuk menetapkan metadata instance VM untuk VM&colon; compute.instances.setMetadata pada project
- Untuk menetapkan tag untuk VM&colon; compute.instances.setTags di VM
- Untuk menetapkan label untuk VM&colon; compute.instances.setLabels di VM
- Untuk menetapkan akun layanan yang akan digunakan VM&colon; compute.instances.setServiceAccount di VM
- Untuk membuat disk baru bagi VM&colon; compute.disks.create pada project
- Untuk memasang disk yang ada dalam mode hanya baca atau baca-tulis&colon; compute.disks.use pada disk
- Untuk memasang disk yang ada dalam mode hanya baca&colon; 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 C4, pilih salah satu metode berikut:

Mengaktifkan PMU di VM yang ada
Mengaktifkan PMU saat membuat VM
Mengaktifkan PMU saat membuat VM secara massal
Mengaktifkan PMU saat membuat template instance

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:

Untuk memverifikasi jenis mesin dan platform CPU VM, lihat detail VM.
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.
  
  Catatan: Jika platform CPU yang didukung tidak tersedia di zona VM, Anda harus memigrasikan VM ke zona lain atau membuat VM baru dengan PMU diaktifkan seperti yang dijelaskan dalam dokumen ini.
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 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

Buat file YAML kosong.
Untuk mengekspor properti VM ke 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.
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
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

Buat file JSON kosong.
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.
Dalam file JSON kosong yang Anda buat di langkah sebelumnya, lakukan hal berikut:
1. Masukkan properti VM dari output permintaan GET.
2. 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
Untuk mengupdate VM dan memulai ulang, buat permintaan PUT ke metode instances.update. Dalam permintaan, lakukan hal berikut:
- Di URL permintaan, sertakan parameter kueri most_disruptive_allowed_action yang ditetapkan ke RESTART.
- Untuk isi permintaan, gunakan properti VM dari file JSON 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 mengetahui informasi selengkapnya tentang cara memperbarui properti VM, lihat artikel Memperbarui properti VM.

Mengaktifkan PMU saat membuat VM

Anda hanya dapat membuat VM dengan PMU yang diaktifkan 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 dengan PMU diaktifkan, pilih salah satu opsi berikut:

gcloud

Untuk membuat VM dengan PMU 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: 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 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: 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 dengan PMU yang diaktifkan 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 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 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: 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 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://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: 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
ZONE: zona tempat membuat VM secara massal.

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 dengan PMU diaktifkan, 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 dengan PMU diaktifkan, Anda dapat menggunakan template untuk melakukan hal berikut:

Aktifkan PMU di VM grup instance terkelola (MIG) saat Anda melakukan tindakan berikut:
- Buat MIG.
- Menerapkan konfigurasi VM baru di MIG.
Buat VM dengan PMU diaktifkan.

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

gcloud

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

Misalnya, untuk membuat template instance global dengan PMU yang 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 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 dengan PMU diaktifkan, buat permintaan POST ke salah satu metode berikut:

Untuk membuat template instance global: metode instanceTemplates.insert.
Untuk membuat template instance regional: metode regionInstanceTemplates.insert.

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 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: 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 selanjutnya

Pelajari cara terhubung ke VM.
Pelajari cara mengubah jenis PMU di VM atau menonaktifkan PMU.