Mengelola PMU di instance Compute Engine

Setelah mengaktifkan PMU di instance komputasi dan menjalankan software pemantauan performa di instance komputasi, Anda dapat melakukan hal berikut:

  • Ubah jenis PMU yang diaktifkan di instance komputasi. Perubahan ini berguna saat Anda ingin melacak berbagai jenis peristiwa CPU tingkat rendah.

  • Nonaktifkan PMU di instance komputasi. Tindakan ini berguna jika Anda tidak lagi perlu mengakses penghitung performa di PMU.

Dokumen ini menjelaskan cara mengubah jenis unit pemantauan performa (PMU) yang diaktifkan di instance Compute Engine, atau menonaktifkannya. Untuk mempelajari PMU lebih lanjut, 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 sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

    Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

    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.

  • Tetapkan 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.

      Instal Google Cloud CLI.

      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 mengubah jenis PMU yang diaktifkan di instance komputasi 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 instance komputasi atau menonaktifkannya. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

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

  • Untuk mengupdate instance komputasi: compute.instances.update di instance komputasi

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

Mengubah jenis PMU di instance komputasi

Sebelum mengubah jenis PMU untuk instance A4X, C4A, C4, atau M4 yang ada, lihat detail instance komputasi menggunakan Google Cloud CLI atau REST API. Di output dari perintah atau permintaan API, verifikasi hal berikut:

  1. Untuk memverifikasi bahwa jenis PMU diaktifkan di instance komputasi, periksa nilai kolom performanceMonitoringUnit. Jika kolom tidak ada, PMU akan dinonaktifkan.

  2. Jika Anda ingin mengaktifkan jenis PMU yang ditingkatkan, Anda harus memverifikasi bahwa instance komputasi menggunakan salah satu jenis mesin berikut dengan memeriksa nilai kolom machineType:

    • Jenis mesin C4 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

    Jika instance komputasi Anda menggunakan jenis mesin yang berbeda, Anda harus mengubah jenis mesin yang digunakan instance komputasi sebelum dapat memantau jenis PMU yang ditingkatkan.

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

Untuk mengubah jenis PMU yang diaktifkan dalam 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 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, temukan kolom performanceMonitoringUnit 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

  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 kode berikut:

    • INSTANCE_NAME: nama instance Compute.

    • YAML_FILE: jalur ke file YAML dengan data konfigurasi yang Anda ubah di langkah sebelumnya.

    • ZONE: zona tempat instance komputasi berada.

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 instance komputasi berada.

    • ZONE: zona tempat instance komputasi berada.

    • INSTANCE_NAME: nama instance compute yang ada.

  2. Untuk memperbarui instance komputasi dan memulainya ulang, buat permintaan PUT ke metode instances.update seperti 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 mengubah nilai kolom performanceMonitoringUnit ke jenis PMU yang Anda pilih.

    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.

Menonaktifkan PMU di instance komputasi

Anda dapat menonaktifkan PMU di instance komputasi tanpa menghentikan instance komputasi. Namun, agar perubahan diterapkan, Anda harus memulai ulang instance komputasi seperti yang dijelaskan di bagian ini.

Untuk menonaktifkan 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 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, hapus kolom performanceMonitoringUnit. Jika kolom advancedMachineFeatures kosong, hapus juga kolom tersebut.

    advancedMachineFeatures:
  performanceMonitoringUnit: PMU_TYPE

  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 kode berikut:

    • INSTANCE_NAME: nama instance Compute.

    • YAML_FILE: jalur ke file YAML dengan data konfigurasi yang Anda ubah di langkah sebelumnya.

    • ZONE: zona tempat instance komputasi berada.

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 instance compute berada.

    • ZONE: zona tempat instance komputasi berada.

    • INSTANCE_NAME: nama instance compute yang ada.

  2. Untuk memperbarui instance komputasi 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 output permintaan GET dari langkah sebelumnya. Namun, Anda harus menghapus kolom performanceMonitoringUnit dan, jika tidak ada kolom lain di kolom advancedMachineFeatures, kolom advancedMachineFeatures 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": {
    ...
  }~,
  ...
}

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

Langkah berikutnya