Memantau ekstensi VM

Memantau kondisi dan performa ekstensi VM membantu Anda mengelola penggunaan resource dan menyelesaikan masalah di seluruh fleet instance Compute Engine. Anda dapat menggunakan dasbor Cloud Monitoring untuk memvisualisasikan penggunaan resource seperti penggunaan CPU atau memori, dan mengonfigurasi kebijakan pemberitahuan untuk menerima notifikasi saat terjadi peristiwa, seperti kegagalan penginstalan.

Dokumen ini menjelaskan cara memantau ekstensi VM yang dikelola oleh VM Extension Manager di instance Compute Engine Anda menggunakan Cloud Monitoring, dan membantu Anda melakukan hal berikut:

Sebelum memulai

  • Siapkan autentikasi jika Anda belum melakukannya. Autentikasi memverifikasi identitas Anda untuk mengakses Google Cloud layanan 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 Google Cloud konsol untuk mengakses Google Cloud layanan dan API, Anda tidak perlu menyiapkan autentikasi.

    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

Sebelum memulai

Sebelum memantau ekstensi, pastikan Anda telah menyelesaikan hal berikut:

Peran IAM yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk memantau metrik dan membuat dasbor, minta administrator untuk memberi Anda peran IAM berikut di project Anda.

Untuk mendapatkan izin yang diperlukan untuk memantau metrik dan mengelola dasbor, minta administrator untuk memberi Anda peran IAM berikut:

  • Untuk melihat metrik dan dasbor: Monitoring Viewer (roles/monitoring.viewer) di project
  • Untuk membuat dan mengelola dasbor dan kebijakan pemberitahuan: Monitoring Editor (roles/monitoring.editor) di 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 dan mengelola dasbor. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk memantau metrik dan mengelola dasbor:

  • Untuk melihat dasbor: monitoring.dashboards.get di project
  • Untuk membuat dasbor: monitoring.dashboards.create di project
  • Untuk menyiapkan pemberitahuan: monitoring.alertPolicies.create di 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 mungkin untuk status adalah sebagai berikut:

  • ENFORCEMENT_STATE_UNSPECIFIED
  • INSTALLING
  • INSTALL_FAILED
  • INSTALLED
  • ROLLING_BACK
  • ROLLBACK_FAILED
  • ROLLED_BACK
  • INCOMPATIBLE
  • REMOVING
  • SERVICE_DISABLED
  • APPLYING_CONFIG
Status Kondisi Ekstensi VM compute.googleapis.com/vm_extensions/extension/health_status Status kondisi ekstensi VM. Label mencakup extension_name dan status.

Untuk mengetahui daftar nama ekstensi, lihat ekstensi yang didukung.

Nilai yang mungkin untuk status adalah sebagai 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 oleh ekstensi VM yang dinyatakan sebagai persentase.
Byte Maksimum Memori Ekstensi VM yang Digunakan compute.googleapis.com/vm_extensions/extension/memory/used_bytes Penggunaan memori maksimum ekstensi VM dalam byte.

Membuat dasbor pemantauan kustom

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

  1. Di konsol, pilih Monitoring: Google Cloud

    Buka Monitoring

  2. Di panel navigasi, pilih Dashboards.
  3. Klik Create dashboard.
  4. Klik Add widget.
  5. Di jendela Add widget, untuk Data, pilih Metric.
  6. Untuk memilih metrik, luaskan menu Select a metric , lalu lakukan tindakan 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 memantau ekstensi VM.
    4. Klik Apply.

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

Menyiapkan kebijakan pemberitahuan

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

  1. Di Google Cloud konsol, pilih Monitoring.

    Buka Monitoring

  2. Di panel navigasi, pilih Alerting.
  3. Klik Create policy.
  4. Di halaman Create alerting policy, tentukan kondisi pemberitahuan dan saluran notifikasi.
    1. Untuk memilih metrik, luaskan menu Select a metric , lalu lakukan tindakan 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 memantau ekstensi VM.
      4. Klik Apply.
    2. Konfigurasi kondisi pemicu, seperti memeriksa apakah label status adalah INSTALL_FAILED.
  5. Ikuti perintah untuk menambahkan saluran notifikasi dan memberi nama kebijakan.
  6. Klik Create policy.

Untuk mengetahui informasi selengkapnya, lihat Membuat kebijakan pemberitahuan.

Langkah berikutnya