Memantau ekstensi VM

Dokumen ini menjelaskan cara memantau ekstensi VM yang dikelola oleh VM Extension Manager di instance Compute Engine Anda menggunakan Cloud Monitoring. Memantau kondisi ekstensi dan konsumsi resource membantu Anda melacak penggunaan CPU dan memori serta mendeteksi kegagalan penginstalan atau runtime di seluruh fleet VM Anda.

Dalam dokumen ini, Anda akan mempelajari cara menyelesaikan tugas-tugas berikut:

• Tinjau metrik yang tersedia untuk ekstensi VM
• Membangun dasbor pemantauan kustom
• Menyiapkan kebijakan pemberitahuan

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 melakukan autentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

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

  Konsol

  Saat menggunakan konsol Google Cloud untuk mengakses layanan dan API Google Cloud , Anda tidak perlu menyiapkan autentikasi.

  gcloud

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

     gcloud init

     Catatan: Jika sudah pernah menginstal gcloud CLI, pastikan Anda memiliki versi terbaru dengan menjalankan gcloud components update.
• 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, lalu login ke gcloud CLI dengan identitas gabungan Anda.

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

Sebelum memulai

Sebelum memantau ekstensi, selesaikan prasyarat berikut:

• Instal ekstensi VM dengan membuat kebijakan ekstensi.
• Tinjau dasar-dasar tentang VM Extension Manager.
• Tinjau Periode retensi Monitoring dan Harga Monitoring.

Izin IAM yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk memantau metrik, membuat dasbor, dan mengonfigurasi kebijakan pemberitahuan, minta administrator untuk memberi Anda peran IAM berikut pada project Anda:

Untuk mendapatkan izin yang Anda perlukan untuk memantau metrik, membuat dasbor, dan mengonfigurasi kebijakan pemberitahuan, minta administrator untuk memberi Anda peran IAM berikut:

• Untuk melihat metrik dan dasbor: Monitoring Viewer (roles/monitoring.viewer) pada project
• Untuk membuat dan mengelola dasbor dan kebijakan pemberitahuan: Monitoring Editor (roles/monitoring.editor) pada project

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk memantau metrik, membuat dasbor, dan mengonfigurasi kebijakan pemberitahuan. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk memantau metrik, membuat dasbor, dan mengonfigurasi kebijakan pemberitahuan:

• Untuk melihat dasbor: monitoring.dashboards.get pada project
• Untuk membuat dasbor: monitoring.dashboards.create pada project
• Untuk menyiapkan pemberitahuan: monitoring.alertPolicies.create pada project

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

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Metrik yang tersedia untuk ekstensi VM

Metrik berikut tersedia untuk memantau ekstensi VM Anda di Monitoring:

Nama metrik	Jenis metrik	Deskripsi
Status Penerapan Ekstensi VM	compute.googleapis.com/vm_extensions/extension/enforcement_status	Status penerapan ekstensi VM Compute Engine. Label mencakup extension_name dan status. Untuk mengetahui daftar nama ekstensi, lihat Ekstensi yang didukung. Nilai yang memungkinkan untuk status mencakup hal berikut: ENFORCEMENT_STATE_UNSPECIFIED INSTALLING INSTALL_FAILED INSTALLED ROLLING_BACK ROLLBACK_FAILED ROLLED_BACK INCOMPATIBLE REMOVING SERVICE_DISABLED APPLYING_CONFIG
Status Kesehatan Ekstensi VM	compute.googleapis.com/vm_extensions/extension/health_status	Status respons ekstensi VM. Label mencakup extension_name dan status. Untuk mengetahui daftar nama ekstensi, lihat Ekstensi yang didukung. Nilai yang memungkinkan untuk status mencakup hal berikut: HEALTH_STATUS_UNSPECIFIED STARTING RUNNING STOPPING STOPPED CRASHED
Penggunaan Maksimum CPU Ekstensi VM	compute.googleapis.com/vm_extensions/extension/cpu/max_usage	Waktu CPU maksimum yang digunakan ekstensi VM, dinyatakan sebagai persentase.
Byte Maksimum yang Digunakan Memori Ekstensi VM	compute.googleapis.com/vm_extensions/extension/memory/used_bytes	Memori maksimum yang digunakan ekstensi VM, dalam byte.

Membangun dasbor pemantauan kustom

Anda dapat membuat dasbor Monitoring dengan diagram ekstensi VM yang paling relevan untuk kasus penggunaan Anda. Untuk menambahkan diagram ke dasbor, selesaikan langkah-langkah berikut:

1. Di konsol Google Cloud , pilih Monitoring:

   Buka Monitoring

2. Di panel navigasi, pilih Dashboards.
3. Klik Buat Dasbor.
4. Klik Add widget.
5. Di jendela Add widget, untuk Data, pilih Metric.
6. Untuk memilih metrik, luaskan menu Select a metric dan selesaikan langkah-langkah berikut:
   1. Untuk Active resources, pilih VM Instance.
   2. Untuk Metric category, pilih Vm_extensions.
   3. Untuk Metric, pilih metrik, seperti VM Extension Health Status. Untuk mengetahui daftar metrik yang tersedia, lihat Metrik yang tersedia untuk ekstensi VM.
   4. Klik Terapkan.

Anda dapat menambahkan diagram sebanyak yang Anda inginkan ke dasbor. Untuk mengetahui informasi selengkapnya, lihat Membuat dan mengelola dasbor kustom.

Siapkan kebijakan pemberitahuan

Monitoring memungkinkan Anda membuat pemberitahuan dan menerima notifikasi saat metrik melewati batas yang ditentukan. Misalnya, Anda dapat menerima notifikasi saat status responsivitas ekstensi berubah menjadi CRASHED.

Untuk membuat kebijakan pemberitahuan, selesaikan langkah-langkah berikut:

1. Di konsol Google Cloud , pilih Monitoring.

   Buka Monitoring

2. Di panel navigasi, pilih Alerting.
3. Klik Create policy.
4. Di halaman Create alerting policy, konfigurasikan kondisi pemberitahuan dengan menyelesaikan langkah-langkah berikut:
   1. Untuk memilih metrik, luaskan menu Select a metric dan selesaikan langkah-langkah berikut:
      1. Untuk Active resources, pilih VM Instance.
      2. Untuk Metric category, pilih Vm_extensions.
      3. Untuk Metric, pilih metrik, seperti VM Extension Enforcement Status. Untuk mengetahui daftar metrik yang tersedia, lihat Metrik yang tersedia untuk ekstensi VM.
      4. Klik Terapkan.
   2. Konfigurasikan kondisi pemicu, seperti apakah label status sama dengan INSTALL_FAILED.
5. Ikuti petunjuk untuk menambahkan saluran notifikasi dan memberi nama kebijakan.
6. Klik Create policy.

Untuk mengetahui informasi selengkapnya, lihat Membuat kebijakan pemberitahuan.

Langkah berikutnya

• Untuk memeriksa progres peluncuran dan status respons ekstensi, lihat Melihat detail dan status ekstensi VM.
• Untuk mengkueri peristiwa penerapan historis dan mengaudit data penginstalan atau error di Cloud Logging, lihat Melihat log ekstensi VM.
• Untuk mendiagnosis peluncuran yang gagal, memeriksa proses tamu yang berjalan, atau memeriksa log debug agen tamu, lihat Memecahkan masalah ekstensi VM.
• Untuk mengubah setelan konfigurasi, mengubah versi yang disematkan, atau menghapus agen yang di-deploy, lihat Mengelola ekstensi VM menggunakan kebijakan ekstensi.