Halaman ini diterjemahkan oleh Cloud Translation API.

Mengelola PMU di VM

Dokumen ini menjelaskan cara mengubah jenis unit pemantauan performa (PMU) mengaktifkan instance virtual machine (VM), atau menonaktifkan PMU di VM.

Setelah mengaktifkan PMU di VM dan menjalankan perangkat lunak pemantauan kinerja di VM, Anda dapat melakukan hal berikut:

Ubah jenis PMU yang diaktifkan di VM. Ini berguna ketika Anda ingin lagu berbagai jenis peristiwa CPU level rendah.
Nonaktifkan PMU di VM. Menonaktifkan PMU di VM berguna ketika Anda tidak perlu lagi mengakses penghitung performa PMU.

Sebelum memulai

Siapkan autentikasi jika Anda belum melakukannya. 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
  Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi baru dengan menjalankan gcloud components update.
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.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna mengubah jenis PMU yang diaktifkan di VM atau menonaktifkannya, 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 mengubah jenis PMU yang diaktifkan di VM atau menonaktifkannya. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk mengubah jenis PMU yang diaktifkan di VM atau menonaktifkannya:

Untuk mengupdate VM: compute.instances.update pada VM

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

Mengubah jenis PMU di VM

Sebelum mengubah jenis PMU yang diaktifkan di VM yang ada, melihat detail VM menggunakan Google Cloud CLI atau REST. Dalam output dari perintah atau permintaan API, pastikan hal berikut:

Untuk memverifikasi jenis PMU yang diaktifkan di VM, periksa nilai Kolom performanceMonitoringUnit.
Jika Anda ingin mengaktifkan jenis PMU yang Ditingkatkan, pastikan VM menggunakan jenis mesin C4 dengan 96 atau 192 vCPU dengan memeriksa nilai kolom machineType. Jika tidak, maka mengubah jenis mesin VM.

Anda tidak perlu menghentikan VM untuk mengubah jenis PMU yang diaktifkan di dalamnya. Namun, untuk membuat perubahan ini efektif, Anda harus memulai ulang VM seperti yang dijelaskan dalam bagian ini.

Untuk mengubah jenis PMU yang diaktifkan 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 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 yang telah dibuat di langkah sebelumnya.
- ZONE: zona tempat VM berada.
Dalam file konfigurasi YAML, cari performanceMonitoringUnit isian dan ubah nilainya untuk menentukan jenis PMU yang berbeda.
```
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 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 konfigurasi data yang telah diubah 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 ditemukan.
- ZONE: zona tempat VM berada.
- VM_NAME: nama VM yang ada.
Di file JSON kosong yang Anda buat di langkah sebelumnya, lakukan berikut ini:
1. Masukkan properti VM dari output permintaan GET.
2. Cari kolom performanceMonitoringUnit, lalu ubah untuk menentukan jenis PMU yang berbeda.
```
"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
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.

Menonaktifkan PMU di VM

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

Untuk menonaktifkan 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 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 yang telah dibuat di langkah sebelumnya.
- ZONE: zona tempat VM berada.
Dalam file konfigurasi YAML, cari performanceMonitoringUnit dan tetapkan nilainya ke NONE.
```
advancedMachineFeatures:
  performanceMonitoringUnit: NONE
```
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 konfigurasi data yang telah diubah 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 ditemukan.
- ZONE: zona tempat VM berada.
- VM_NAME: nama VM yang ada.
Di file JSON kosong yang Anda buat di langkah sebelumnya, lakukan berikut ini:
1. Masukkan properti VM dari output permintaan GET.
2. Cari kolom performanceMonitoringUnit, lalu ubah nilai ke NONE.
```
"advancedMachineFeatures": {
  "performanceMonitoringUnit": "NONE"
}
```
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.

Langkah selanjutnya

Pelajari cara menetapkan jumlah thread per core.