Menginstal dan mengelola Agen Operasional menggunakan kebijakan VM Extension Manager

Anda dapat menginstal dan mengelola Agen Operasional di fleet VM Compute Engine secara global atau dalam zona tertentu menggunakan kebijakan VM Extension Manager. Misalnya, Anda dapat menggunakan kebijakan ini untuk melakukan tugas seperti berikut:

  • Penginstalan di seluruh armada: Instal Agen Operasional di:

    • Semua VM di satu atau beberapa zona dalam project Google Cloud Anda.
    • Semua VM secara global (di project Google Cloud Anda).
    • Subkumpulan VM dalam zona, yang diidentifikasi berdasarkan label.
    • Subkumpulan VM di seluruh zona dalam project Google Cloud Anda, yang diidentifikasi berdasarkan label.

  • Kontrol versi:

    • Selalu update Agen Operasional ke versi terbaru.
    • Sematkan versi Agen Operasional ke rilis tertentu.

  • Pengelolaan konfigurasi: Terapkan konfigurasi kustom ke Agen Operasional di semua VM yang dikelola oleh kebijakan.

Dengan VM Extension Manager, Anda membuat kebijakan yang menyatakan ekstensi mana yang ingin Anda instal di VM. Agen Operasional adalah salah satu ekstensi yang tersedia. Kebijakan VM Extension Manager dapat mengelola Agen Operasional versi 2.58.0 atau yang lebih baru, jika Agen Operasional telah diinstal menggunakan VM Extension Manager. Kebijakan ini tidak dapat mengelola Agen Operasional versi 2.58.0 atau yang lebih lama, instance Agen Operasional yang diinstal menggunakan cara lain, atau versi Agen Monitoring lama atau Agen Logging lama.

Anda dapat membuat dan mengelola kebijakan ekstensi VM zonal menggunakan KonsolGoogle Cloud atau Google Cloud CLI, gcloud. Anda dapat membuat dan mengelola kebijakan ekstensi VM global menggunakan gcloud.

Sebelum memulai

Sebelum mulai menggunakan kebijakan ekstensi VM Extension Manager, lakukan hal berikut:

Meninjau sistem operasi yang didukung

Sebelum mencoba menggunakan kebijakan VM Extension Manager untuk mengelola Agen Operasional, pastikan sistem operasi target Anda kompatibel dengan Agen Operasional dan VM Extension Manager.

Pengelola Ekstensi VM mendukung semua sistem operasi yang didukung oleh Agen Operasional, kecuali SUSE Linux Enterprise Server (SLES) dan Ubuntu. Untuk mengetahui informasi selengkapnya tentang sistem operasi yang didukung oleh Agen Operasional, lihat Sistem operasi.

Jika sistem operasi Anda didukung oleh Agen Operasional dan VM Extension Manager, ikuti langkah-langkah selanjutnya dalam dokumen ini.

Mengaktifkan API yang diperlukan untuk menggunakan Agen Operasional

Untuk menggunakan Ops Agent dalam menulis log dan metrik, Anda harus mengaktifkan Cloud Logging API dan Cloud Monitoring API di project Google Cloud Anda.

Peran yang diperlukan untuk mengaktifkan API

Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

Aktifkan API

Memberikan peran yang diperlukan untuk menggunakan Agen Operasional

Untuk mendapatkan izin yang diperlukan untuk menggunakan Agen Operasi guna menulis log dan metrik, minta administrator untuk memberi Anda peran IAM berikut di akun layanan Anda:

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.

Untuk mengetahui informasi selengkapnya tentang peran dan Agen Operasi, lihat Memberi otorisasi Agen Operasi.

Memberikan peran yang diperlukan untuk menggunakan VM Extension Manager

Untuk mendapatkan izin yang diperlukan untuk membuat, melihat, mengubah, dan menghapus kebijakan ekstensi VM, minta administrator untuk memberi Anda peran IAM berikut 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 membuat, melihat, mengubah, dan menghapus kebijakan ekstensi VM. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk membuat, melihat, mengubah, dan menghapus kebijakan ekstensi VM:

  • Untuk membuat kebijakan ekstensi: compute.vmExtensionPolicies.create
  • Untuk melihat kebijakan ekstensi: compute.vmExtensionPolicies.list
  • Untuk melihat detail kebijakan ekstensi: compute.vmExtensionPolicies.get
  • Untuk mengubah kebijakan ekstensi: compute.vmExtensionPolicies.update
  • Untuk menghapus kebijakan ekstensi: compute.vmExtensionPolicies.delete

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

Untuk mengetahui informasi selengkapnya tentang peran dan izin IAM di Compute Engine, lihat Peran dan izin Compute Engine.

Menginstal Google Cloud CLI

Anda dapat membuat dan mengelola kebijakan ekstensi VM menggunakan Google Cloud konsol atau Google Cloud CLI, gcloud. Untuk menggunakan gcloud, Anda harus menginstal Google Cloud CLI terlebih dahulu.

Untuk melihat komponen yang telah Anda instal, jalankan perintah berikut:

gcloud components list

Untuk memverifikasi bahwa Anda memiliki versi terbaru, jalankan perintah berikut:

gcloud components update

Meng-uninstal agen kemampuan observasi

Sebelum membuat kebijakan VM Extension Manager untuk mengelola Agen Operasional di VM, pastikan tidak ada instance Agen Operasional atau agen Monitoring dan agen Logging lama yang sudah ada di VM. Menjalankan Agen Operasional dan agen lama di VM yang sama dapat menyebabkan penyerapan log duplikat atau konflik dalam penyerapan metrik.

Jika Anda menggunakan kebijakan ekstensi untuk menginstal Agen Operasional di VM tempat agen pemantauan lain sudah diinstal, kebijakan tersebut akan menginstal agen, tetapi agen gagal berjalan karena konflik terdeteksi.

Cara menghapus agen yang ada bergantung pada cara agen tersebut diinstal.

Menginstal Agen Operasional dengan membuat kebijakan ekstensi VM

Buat kebijakan ekstensi VM untuk menginstal dan mengelola Agen Operasional secara otomatis di fleet virtual machine (VM) Compute Engine. Dengan menentukan kebijakan, Anda dapat memastikan bahwa ekstensi tertentu, seperti Agen Operasional, diinstal dan dikelola di VM mana pun yang cocok dengan kriteria yang Anda tentukan, seperti label VM.

Konflik dan prioritas kebijakan

VM Extension Manager mengaitkan prioritas dengan setiap kebijakan baru, dengan angka yang lebih rendah menunjukkan prioritas yang lebih tinggi; prioritas defaultnya adalah 1000. VM dapat dicakup oleh beberapa kebijakan untuk ekstensi seperti Agen Operasional, tetapi hanya satu kebijakan untuk ekstensi Agen Operasional yang berlaku di VM.

VM Extension Manager menggunakan prioritas untuk menyelesaikan konflik di antara kebijakan yang diterapkan ke VM. Untuk mengetahui informasi selengkapnya tentang proses penyelesaian, lihat Prioritas kebijakan dan penyelesaian konflik.

Rencana peluncuran kebijakan untuk kebijakan global

Kebijakan global VM Extension Manager menggunakan rencana peluncuran untuk menentukan cara kebijakan didistribusikan ke VM target. Ada dua jenis rencana peluncuran:

  • Rencana peluncuran yang telah ditentukan sebelumnya. Ada dua rencana peluncuran yang telah ditentukan sebelumnya, yang dipilih berdasarkan nilai yang digunakan dengan opsi --rollout-predefined-plan untuk perintah gcloud CLI.

    • Peluncuran lambat, yang men-deploy Agen Operasional secara bertahap di berbagai zona selama jangka waktu tertentu. Rencana peluncuran ini direkomendasikan.

      Tentukan rencana peluncuran ini menggunakan opsi --rollout-predefined-plan=slow_rollout.

    • Peluncuran cepat, yang men-deploy Agen Operasional ke semua VM yang ditargetkan di semua zona dan region secara langsung.

      Tentukan rencana peluncuran ini menggunakan opsi --rollout-predefined-plan=fast_rollout.

  • Rencana peluncuran kustom, yang ditentukan dengan menggunakan opsi --rollout-custom-plan untuk perintah gcloud CLI.

    Buat rencana peluncuran kustom dengan menambahkannya ke kumpulan rencana peluncuran di project Google Cloud Anda; untuk mengetahui informasi selengkapnya, lihat metode Compute Engine API rolloutPlans.insert.

Untuk mengetahui informasi selengkapnya tentang rencana peluncuran, lihat Rencana peluncuran untuk kebijakan global.

Instal Agen Operasional terbaru di semua VM

Untuk membuat kebijakan yang menginstal Agen Operasional versi terbaru di semua VM dalam zona atau secara global, dan mengupdate Agen Operasional saat versi baru dirilis, lakukan hal berikut:

Konsol

Untuk membuat kebijakan zonal, Anda dapat menggunakan konsol Google Cloud .

  1. Di konsol Google Cloud , buka halaman Extension policies:

    Buka Kebijakan ekstensi

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Compute Engine.

  2. Klik + Buat.
  3. Di kolom Name, masukkan nama untuk kebijakan.
  4. Opsional: Pada kolom Deskripsi, masukkan deskripsi untuk kebijakan tersebut.
  5. Di kolom Priority, tentukan nomor prioritas untuk menyelesaikan konflik antar-kebijakan. Angka yang lebih rendah menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000.

  6. Dalam daftar Zone, pilih zona tempat Anda ingin menerapkan kebijakan ini.

  7. Di bagian Kelola ekstensi, klik Tambahkan ekstensi, lalu lakukan hal berikut:

    1. Dari daftar Ekstensi, pilih Google Cloud's Extension for Ops Agent.
    2. Biarkan kolom Version kosong.

  8. Klik Create.

gcloud

Untuk membuat kebijakan zona atau global, Anda dapat menggunakan gcloud CLI.

Zonal

Gunakan perintah gcloud compute zone-vm-extension-policies create berikut untuk membuat kebijakan:

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent

Ganti variabel berikut dalam perintah:

  • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
  • PROJECT_ID: ID project.
  • ZONE: Zona target; misalnya, us-central1-f.

gcloud compute zone-vm-extension-policies create mengambil opsi --version. Jika Anda menghilangkan opsi --version, kebijakan akan menginstal versi terbaru dan mengupdate Agen Operasional saat versi baru dirilis.

Global

Gunakan perintah gcloud compute global-vm-extension-policies create berikut untuk membuat kebijakan:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout

Ganti variabel berikut dalam perintah:

  • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
  • PROJECT_ID: ID project.

gcloud compute global-vm-extension-policies create mengambil opsi --version. Jika Anda menghilangkan opsi --version, kebijakan akan menginstal versi terbaru dan mengupdate Agen Operasional saat versi baru dirilis.

Menyematkan Agen Operasional ke versi tertentu di semua VM

Untuk membuat kebijakan yang menginstal Agen Operasional versi tertentu di semua VM dalam zona atau secara global, lakukan langkah berikut:

Konsol

Untuk membuat kebijakan zonal, Anda dapat menggunakan konsol Google Cloud .

  1. Di konsol Google Cloud , buka halaman Extension policies:

    Buka Kebijakan ekstensi

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Compute Engine.

  2. Klik + Buat.
  3. Di kolom Name, masukkan nama untuk kebijakan.
  4. Opsional: Pada kolom Deskripsi, masukkan deskripsi untuk kebijakan tersebut.
  5. Di kolom Priority, tentukan nomor prioritas untuk menyelesaikan konflik antar-kebijakan. Angka yang lebih rendah menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000.

  6. Dalam daftar Zone, pilih zona tempat Anda ingin menerapkan kebijakan ini.

  7. Di bagian Kelola ekstensi, klik Tambahkan ekstensi, lalu lakukan hal berikut:

    1. Dari daftar Ekstensi, pilih Google Cloud's Extension for Ops Agent.
    2. Dari daftar Versi, pilih versi yang akan diinstal. Gunakan versi 2.58.0 atau yang lebih baru.

  8. Klik Create.

gcloud

Untuk membuat kebijakan zona atau global, Anda dapat menggunakan gcloud CLI.

Zonal

Gunakan perintah gcloud compute zone-vm-extension-policies create berikut untuk membuat kebijakan:

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent  \
  --version=ops-agent=VERSION

Ganti variabel berikut dalam perintah:

  • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
  • PROJECT_ID: ID project.
  • ZONE: Zona target; misalnya, us-central1-f.

  • VERSION: Versi Agen Operasional yang akan diinstal. Gunakan versi 2.58.0 atau yang lebih baru.

    Jika Anda menghilangkan opsi --version, maka kebijakan akan menginstal versi terbaru dan mengupdate Agen Operasional saat versi baru dirilis, seperti yang ditunjukkan dalam contoh yang menginstal versi terbaru.

Global

Gunakan perintah gcloud compute global-vm-extension-policies create berikut untuk membuat kebijakan:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --version=ops-agent=VERSION

Ganti variabel berikut dalam perintah:

  • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
  • PROJECT_ID: ID project.

  • VERSION: Versi Agen Operasional yang akan diinstal. Gunakan versi 2.58.0 atau yang lebih baru.

    Jika Anda menghilangkan opsi --version, maka kebijakan akan menginstal versi terbaru dan mengupdate Agen Operasional saat versi baru dirilis, seperti yang ditunjukkan dalam contoh yang menginstal versi terbaru.

Untuk mengetahui daftar versi Agen Operasi, lihat halaman rilis Agen Operasi di GitHub.

Menginstal Agen Operasional di VM yang memiliki label tertentu

Untuk membuat kebijakan yang menginstal Agen Operasional versi terbaru di VM dalam zona atau secara global yang memiliki label tertentu, lakukan hal berikut:

Konsol

Untuk membuat kebijakan zonal, Anda dapat menggunakan konsol Google Cloud .

  1. Di konsol Google Cloud , buka halaman Extension policies:

    Buka Kebijakan ekstensi

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Compute Engine.

  2. Klik + Buat.
  3. Di kolom Name, masukkan nama untuk kebijakan.
  4. Opsional: Pada kolom Deskripsi, masukkan deskripsi untuk kebijakan tersebut.
  5. Di kolom Priority, tentukan nomor prioritas untuk menyelesaikan konflik antar-kebijakan. Angka yang lebih rendah menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000.

  6. Dalam daftar Zone, pilih zona tempat Anda ingin menerapkan kebijakan ini.

  7. Di bagian Ekstensi, klik Tambahkan ekstensi dan lakukan hal berikut:

    1. Dari daftar Ekstensi, pilih Google Cloud's Extension for Ops Agent.
    2. Biarkan kolom Version kosong.

  8. Di bagian Target VM instances, pilih VM untuk kebijakan. Untuk memilih VM dengan label tertentu, klik Tambahkan label dan tambahkan pasangan nilai kunci.

  9. Klik Create.

gcloud

Untuk membuat kebijakan zona atau global, Anda dapat menggunakan gcloud CLI.

Zonal

Gunakan opsi --inclusion-labels pada perintah gcloud compute zone-vm-extension-policies create untuk menentukan daftar pasangan nilai kunci yang dipisahkan koma:

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --inclusion-labels=KEY1=VALUE1,KEY2=VALUE2

Ganti variabel berikut dalam perintah:

  • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
  • PROJECT_ID: ID project.
  • ZONE: Zona target; misalnya, us-central1-f.

  • KEY1=VALUE1,KEY2=VALUE2: Daftar pasangan nilai kunci yang dipisahkan koma yang menentukan label penyertaan untuk pemilih. VM harus memiliki semua label yang ditentukan dalam pemilih (AND logis) agar dapat disertakan. Jika Anda menentukan opsi --inclusion_labels beberapa kali, kebijakan akan menargetkan VM yang cocok dengan semua label di salah satu pemilih (logika OR). Jika Anda menghapus opsi ini, kebijakan akan menargetkan semua VM di zona yang ditentukan.

Global

Gunakan opsi --inclusion-labels pada perintah gcloud compute global-vm-extension-policies create untuk menentukan daftar pasangan nilai kunci yang dipisahkan koma:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --inclusion-labels=KEY1=VALUE1,KEY2=VALUE2

Ganti variabel berikut dalam perintah:

  • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
  • PROJECT_ID: ID project.

  • KEY1=VALUE1,KEY2=VALUE2: Daftar pasangan nilai kunci yang dipisahkan koma yang menentukan label penyertaan untuk pemilih. VM harus memiliki semua label yang ditentukan dalam pemilih (AND logis) agar dapat disertakan. Jika Anda menentukan opsi --inclusion_labels beberapa kali, kebijakan akan menargetkan VM yang cocok dengan semua label di salah satu pemilih (logika OR). Jika Anda menghapus opsi ini, kebijakan akan menargetkan semua VM di zona yang ditentukan.

Menginstal Agen Operasional dengan konfigurasi kustom di semua VM

Untuk membuat kebijakan yang menginstal Agen Operasional versi terbaru di semua VM dalam zona atau secara global, dan menyediakan konfigurasi kustom untuk Agen Operasional, lakukan hal berikut:

Konsol

Untuk membuat kebijakan zonal, Anda dapat menggunakan konsol Google Cloud .

  1. Di konsol Google Cloud , buka halaman Extension policies:

    Buka Kebijakan ekstensi

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Compute Engine.

  2. Klik + Buat.
  3. Di kolom Name, masukkan nama untuk kebijakan.
  4. Opsional: Pada kolom Deskripsi, masukkan deskripsi untuk kebijakan tersebut.
  5. Di kolom Priority, tentukan nomor prioritas untuk menyelesaikan konflik antar-kebijakan. Angka yang lebih rendah menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000.

  6. Dalam daftar Zone, pilih zona tempat Anda ingin menerapkan kebijakan ini.

  7. Di bagian Ekstensi, klik Tambahkan ekstensi dan lakukan hal berikut:

    1. Dari daftar Ekstensi, pilih Google Cloud's Extension for Ops Agent.
    2. Biarkan kolom Version kosong.
    3. Di kolom Config file content, masukkan string konfigurasi YAML untuk Agen Operasional.

  8. Klik Create.

gcloud

Untuk membuat kebijakan zona atau global, Anda dapat menggunakan gcloud CLI.

Zonal

Gunakan opsi --config-from-file pada perintah gcloud compute zone-vm-extension-policies create untuk menentukan file konfigurasi:

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

Ganti variabel berikut dalam perintah:

  • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
  • PROJECT_ID: ID project.
  • ZONE: Zona target; misalnya, us-central1-f.

  • OPS_AGENT_CONFIG_PATH: Jalur ke file yang berisi string konfigurasi YAML untuk Agen Operasi. File ini harus ada di lingkungan tempat Anda menjalankan perintah gcloud.

    YAML konfigurasi untuk Agen Operasional bisa panjang. Menempatkan konfigurasi ke dalam file dan meneruskan file ke gcloud CLI jauh lebih kecil kemungkinannya menimbulkan error daripada mencoba memasukkan YAML yang diformat dengan benar di command line. Mengubah file ini setelah membuat kebijakan tidak akan memperbarui kebijakan; untuk memperbarui kebijakan, gunakan perintah gcloud compute zone-vm-extension-policies update.

Global

Gunakan opsi --config-from-file pada perintah gcloud compute global-vm-extension-policies create untuk menentukan file konfigurasi:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

Ganti variabel berikut dalam perintah:

  • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
  • PROJECT_ID: ID project.

  • OPS_AGENT_CONFIG_PATH: Jalur ke file yang berisi string konfigurasi YAML untuk Agen Operasi. File ini harus ada di lingkungan tempat Anda menjalankan perintah gcloud.

    YAML konfigurasi untuk Agen Operasional bisa panjang. Menempatkan konfigurasi ke dalam file dan meneruskan file ke gcloud CLI jauh lebih kecil kemungkinannya menimbulkan error daripada mencoba memasukkan YAML yang diformat dengan benar di command line. Mengubah file ini setelah membuat kebijakan tidak akan memperbarui kebijakan; untuk memperbarui kebijakan, gunakan perintah gcloud compute global-vm-extension-policies update.

Jika Anda memberikan konfigurasi kustom untuk Agen Operasional saat membuat atau memperbarui kebijakan ekstensi, kebijakan akan men-deploy Agen Operasional dengan konfigurasi kustom. Anda tidak perlu memulai ulang agen secara manual.

Konfigurasi disimpan dengan kebijakan ekstensi, jadi jangan sertakan data sensitif seperti sandi dalam konfigurasi. Karena konfigurasi disimpan dengan kebijakan ekstensi, memodifikasi file konfigurasi tidak akan mengubah konfigurasi agen. Anda harus memperbarui konfigurasi yang disimpan dengan kebijakan menggunakan perintah gcloud yang sesuai:

Saat Anda memberikan konfigurasi kustom untuk Agen Operasional, VM Extension Manager akan menyalin konfigurasi ke lokasi yang digunakan oleh Agen Operasional untuk file konfigurasi yang ditentukan pengguna di VM target:

  • Linux: /etc/google-cloud-ops-agent/config.yaml
  • Windows: C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml

Jika ada file config.yaml di VM, kebijakan ekstensi akan menimpanya.

Untuk mengetahui informasi umum tentang penggunaan konsolGoogle Cloud dan gcloud CLI untuk membuat kebijakan ekstensi VM, lihat Menginstal ekstensi VM dengan membuat kebijakan ekstensi .

Menginstal Agen Operasional dengan rencana peluncuran cepat pada prioritas yang lebih tinggi (khusus global)

Untuk membuat kebijakan global yang menginstal Agen Operasional versi terbaru dengan menggunakan prioritas yang lebih tinggi dari default dan rencana peluncuran cepat, gunakan perintah gcloud compute global-vm-extension-policies create berikut:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=fast_rollout \
  --priority=500

Ganti variabel berikut dalam perintah:

  • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
  • PROJECT_ID: ID project.

Menginstal Agen Operasional di subset zona dalam project Google Cloud (khusus global)

Untuk membuat kebijakan global yang hanya berlaku untuk sebagian zona dalam projectGoogle Cloud , Anda harus menggunakan rencana peluncuran kustom yang menentukan zona tempat kebijakan akan diterapkan. Untuk informasi tentang cara membuat rencana peluncuran kustom, lihat Tentang rencana peluncuran. Untuk menentukan sekumpulan zona, gunakan kolom locationSelector.includedLocations saat membuat rencana peluncuran.

Untuk membuat kebijakan ekstensi yang menggunakan rencana peluncuran kustom, gunakan perintah gcloud compute global-vm-extension-policies create berikut:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/CUSTOM_PLAN_NAME

Ganti variabel berikut dalam perintah:

  • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
  • PROJECT_ID: ID project.

  • CUSTOM_PLAN_NAME: Nama yang terkait dengan rencana peluncuran kustom Anda.

Mengelola Agen Operasional dengan mengupdate kebijakan ekstensi VM

Untuk mengubah cara kebijakan mengelola Agen Operasi, perbarui kebijakan. Saat Anda mengupdate kebijakan, VM Extension Manager akan meluncurkan perubahan ke semua VM yang berlaku, biasanya dalam waktu satu menit. Jika Anda mengubah label penyertaan, Agen Operasional mungkin diinstal di VM baru atau di-uninstal dari VM yang ada berdasarkan apakah VM cocok dengan label yang diperbarui.

Bagian berikut menunjukkan cara mengelola Agen Operasi untuk melakukan hal berikut:

Memperbarui versi Agen Operasional yang disematkan di semua VM dalam zona

Untuk mengubah versi Agen Operasional yang disematkan di semua VM dalam zona, lakukan hal berikut:

Konsol

Untuk membuat kebijakan zonal, Anda dapat menggunakan konsol Google Cloud .

  1. Di konsol Google Cloud , buka halaman Extension policies:

    Buka Kebijakan ekstensi

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Compute Engine.

  2. Pilih kebijakan yang ingin Anda perbarui.
  3. Klik Edit.
  4. Di bagian Kelola ekstensi, lakukan hal berikut:
    1. Pilih Google Cloud's Extension for Ops Agent.
    2. Ubah kolom Versi. Gunakan versi 2.58.0 atau yang lebih baru.
    3. Klik Done.
  5. Klik Save.

gcloud

Untuk membuat kebijakan zona atau global, Anda dapat menggunakan gcloud CLI.

Zonal

Gunakan gcloud compute zone-vm-extension-policies update dengan perintah opsi --version untuk mengubah versi agen yang disematkan.

Saat Anda memperbarui kebijakan menggunakan gcloud, permintaan akan bertindak sebagai penggantian lengkap. Kolom opsional yang Anda hapus akan kembali ke nilai defaultnya, bukan mempertahankan nilai yang ada dari kebijakan yang diubah.

Untuk mengubah versi Agen Operasional yang diinstal di semua VM dalam zona berdasarkan kebijakan, gunakan perintah berikut:

gcloud compute zone-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --version=ops-agent=VERSION

Ganti variabel berikut dalam perintah:

  • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
  • PROJECT_ID: ID project.
  • ZONE: Zona target; misalnya, us-central1-f.

  • VERSION: Versi Agen Operasional yang akan diinstal. Gunakan versi 2.58.0 atau yang lebih baru. Untuk mengetahui daftar versi, lihat halaman rilis Agen Operasional di GitHub.

    Jika Anda menghilangkan opsi --version, maka kebijakan akan menginstal versi terbaru dan mengupdate Agen Operasional saat versi baru dirilis, seperti yang ditunjukkan dalam contoh yang menginstal versi terbaru.

Global

Gunakan gcloud compute global-vm-extension-policies update dengan perintah opsi --version untuk mengubah versi agen yang disematkan.

Saat Anda memperbarui kebijakan menggunakan gcloud, permintaan akan bertindak sebagai penggantian lengkap. Kolom opsional yang Anda hapus akan kembali ke nilai defaultnya, bukan mempertahankan nilai yang ada dari kebijakan yang diubah.

Untuk mengubah versi Agen Operasional yang diinstal di semua VM berdasarkan kebijakan global, gunakan perintah berikut:

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --version=ops-agent=VERSION

Ganti variabel berikut dalam perintah:

  • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
  • PROJECT_ID: ID project.

  • VERSION: Versi Agen Operasional yang akan diinstal. Gunakan versi 2.58.0 atau yang lebih baru. Untuk mengetahui daftar versi, lihat halaman rilis Agen Operasional di GitHub.

    Jika Anda menghilangkan opsi --version, maka kebijakan akan menginstal versi terbaru dan mengupdate Agen Operasional saat versi baru dirilis, seperti yang ditunjukkan dalam contoh yang menginstal versi terbaru.

Mengubah konfigurasi Agen Operasional di semua VM

Untuk mengubah konfigurasi Agen Operasional, lakukan hal berikut:

Konsol

Untuk membuat kebijakan zonal, Anda dapat menggunakan konsol Google Cloud .

  1. Di konsol Google Cloud , buka halaman Extension policies:

    Buka Kebijakan ekstensi

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Compute Engine.

  2. Pilih kebijakan yang ingin Anda perbarui.
  3. Klik Edit.
  4. Di bagian Kelola ekstensi, lakukan hal berikut:
    1. Pilih Google Cloud's Extension for Ops Agent.
    2. Ubah kolom konten file konfigurasi.
    3. Klik Done.
  5. Klik Save.

gcloud

Untuk membuat kebijakan zona atau global, Anda dapat menggunakan gcloud CLI.

Zonal

Gunakan gcloud compute zone-vm-extension-policies update dengan opsi --config-from-file atau opsi --config untuk menentukan konfigurasi baru.

Saat Anda memperbarui kebijakan menggunakan gcloud, permintaan akan bertindak sebagai penggantian lengkap. Kolom opsional yang Anda hapus akan kembali ke nilai defaultnya, bukan mempertahankan nilai yang ada dari kebijakan yang diubah.

Untuk mengubah konfigurasi Agen Operasional yang diinstal di semua VM dalam zona berdasarkan kebijakan, gunakan perintah berikut:

gcloud compute zone-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

Ganti variabel berikut dalam perintah:

  • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
  • PROJECT_ID: ID project.
  • ZONE: Zona target; misalnya, us-central1-f.

  • OPS_AGENT_CONFIG_PATH: Jalur ke file yang berisi string konfigurasi YAML untuk Agen Operasi. File ini harus ada di lingkungan tempat Anda menjalankan perintah gcloud.

    YAML konfigurasi untuk Agen Operasional bisa panjang. Menempatkan konfigurasi ke dalam file dan meneruskan file ke gcloud CLI jauh lebih kecil kemungkinannya menimbulkan error daripada mencoba memasukkan YAML yang diformat dengan benar di command line.

Global

Gunakan gcloud compute global-vm-extension-policies update dengan opsi --config-from-file atau opsi --config untuk menentukan konfigurasi baru.

Saat Anda memperbarui kebijakan menggunakan gcloud, permintaan akan bertindak sebagai penggantian lengkap. Kolom opsional yang Anda hapus akan kembali ke nilai defaultnya, bukan mempertahankan nilai yang ada dari kebijakan yang diubah.

Untuk mengubah konfigurasi Agen Operasional yang diinstal di semua VM berdasarkan kebijakan, gunakan perintah berikut:

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

Ganti variabel berikut dalam perintah:

  • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
  • PROJECT_ID: ID project.

  • OPS_AGENT_CONFIG_PATH: Jalur ke file yang berisi string konfigurasi YAML untuk Agen Operasi. File ini harus ada di lingkungan tempat Anda menjalankan perintah gcloud.

    YAML konfigurasi untuk Agen Operasional bisa panjang. Menempatkan konfigurasi ke dalam file dan meneruskan file ke gcloud CLI jauh lebih kecil kemungkinannya menimbulkan error daripada mencoba memasukkan YAML yang diformat dengan benar di command line.

Jika Anda memberikan konfigurasi kustom untuk Agen Operasional saat membuat atau memperbarui kebijakan ekstensi, kebijakan akan men-deploy Agen Operasional dengan konfigurasi kustom. Anda tidak perlu memulai ulang agen secara manual.

Konfigurasi disimpan dengan kebijakan ekstensi, jadi jangan sertakan data sensitif seperti sandi dalam konfigurasi. Karena konfigurasi disimpan dengan kebijakan ekstensi, memodifikasi file konfigurasi tidak akan mengubah konfigurasi agen. Anda harus memperbarui konfigurasi yang disimpan dengan kebijakan menggunakan perintah gcloud yang sesuai:

Saat Anda memberikan konfigurasi kustom untuk Agen Operasional, VM Extension Manager akan menyalin konfigurasi ke lokasi yang digunakan oleh Agen Operasional untuk file konfigurasi yang ditentukan pengguna di VM target:

  • Linux: /etc/google-cloud-ops-agent/config.yaml
  • Windows: C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml

Jika ada file config.yaml di VM, kebijakan ekstensi akan menimpanya.

Untuk informasi umum tentang penggunaan konsolGoogle Cloud dan gcloud CLI untuk mengelola kebijakan ekstensi VM, lihat Mengubah ekstensi dengan memperbarui kebijakan ekstensi VM.

Memperluas kebijakan global yang ada untuk menyertakan zona baru (khusus global)

Saat VM dibuat di zona baru setelah kebijakan global dibuat dan diluncurkan, VM Extension Manager tidak otomatis menerapkan kebijakan ke VM di zona baru. Untuk menyertakan VM di zona baru, Anda harus memulai ulang peluncuran kebijakan global.

Untuk memulai ulang peluncuran kebijakan global, gunakan perintah gcloud compute global-vm-extension-policies update dan berikan opsi --rollout-retry-uuid=UUID.

Misalnya, Anda membuat dan meluncurkan kebijakan global menggunakan perintah berikut:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --version=ops-agent=2.61.0 \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml"

Untuk memperluas kebijakan ke VM yang dibuat di zona yang sebelumnya tidak digunakan, mulai ulang peluncuran menggunakan perintah berikut:

gcloud compute global-vm-extension-policies update test-policy POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --version=ops-agent=2.61.0 \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml" \
  --rollout-retry-uuid=UUID

Ganti variabel berikut dalam perintah:

  • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
  • PROJECT_ID: ID project.

  • UUID: ID unik universal (UUID) yang mengidentifikasi permintaan percobaan ulang. Anda dapat menggunakan generator UUID apa pun untuk membuatnya. Untuk mengetahui informasi selengkapnya, lihat Mencoba ulang peluncuran .

Memperbarui kebijakan global untuk mengecualikan sekumpulan zona (khusus global)

Untuk memperbarui zona tempat kebijakan global yang mengecualikan beberapa zona dalam projectGoogle Cloud , Anda harus menggunakan rencana peluncuran kustom baru yang menentukan zona tempat kebijakan akan diterapkan. Untuk informasi tentang cara membuat rencana peluncuran kustom, lihat Tentang rencana peluncuran. Untuk menentukan sekumpulan zona, gunakan kolom locationSelector.includedLocations saat membuat rencana peluncuran.

Untuk memperbarui kebijakan ekstensi yang menggunakan rencana peluncuran kustom, gunakan perintah gcloud compute global-vm-extension-policies update berikut:

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/NEW_CUSTOM_PLAN_NAME \
  --rollout-retry-uuid=UUID

Ganti variabel berikut dalam perintah:

  • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
  • PROJECT_ID: ID project.

  • NEW_CUSTOM_PLAN_NAME: Nama yang terkait dengan rencana peluncuran kustom yang diperbarui.
  • UUID: ID unik universal (UUID) yang mengidentifikasi permintaan percobaan ulang. Anda dapat menggunakan generator UUID apa pun untuk membuatnya. Untuk mengetahui informasi selengkapnya, lihat Mencoba ulang peluncuran .

Meng-uninstal Agen Operasional dengan menghapus kebijakan ekstensi VM

Untuk meng-uninstal Agen Operasional, hapus kebijakan ekstensi VM yang mengelola agen. Jika kebijakan lain yang aktif dan berprioritas lebih rendah diterapkan ke VM dan juga mengelola Agen Operasional, maka agen akan tetap diinstal di VM tersebut berdasarkan kebijakan berprioritas lebih rendah.

VM Extension Manager akan menghapus Agen Operasional dari semua VM yang dapat diakses dalam waktu satu menit setelah penghapusan kebijakan. Jika VM tidak dapat diakses, maka VM Extension Manager akan melewati penghapusan agen. Jika VM tersedia kembali, VM Extension Manager akan menghapus agen pada saat itu.

Konsol

  1. Di konsol Google Cloud , buka halaman Extension policies:

    Buka Kebijakan ekstensi

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Compute Engine.

  2. Pilih kebijakan yang ingin Anda hapus.
  3. Klik Hapus.
  4. Pada dialog konfirmasi, klik Delete.

gcloud

Zonal

Untuk menghapus kebijakan ekstensi VM yang mengelola Agen Operasi, gunakan perintah gcloud compute zone-vm-extension-policies delete:

gcloud compute zone-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Ganti variabel berikut dalam perintah:

  • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
  • PROJECT_ID: ID project.
  • ZONE: Zona target; misalnya, us-central1-f.

Global

Untuk menghapus kebijakan ekstensi VM global yang mengelola Agen Operasional, gunakan perintah gcloud compute global-vm-extension-policies delete:

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=slow_rollout

Ganti variabel berikut dalam perintah:

  • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
  • PROJECT_ID: ID project.

Untuk mempercepat peluncuran penghapusan yang sudah dimulai, keluarkan perintah penghapusan baru yang menggunakan paket fast_rollout. Anda juga harus menentukan opsi --rollout-retry-uuid=UUID:

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=fast_rollout \
  --rollout-retry-uuid=UUID

Ganti variabel berikut dalam perintah:

  • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
  • PROJECT_ID: ID project.

  • UUID: ID unik universal (UUID) yang mengidentifikasi permintaan percobaan ulang. Anda dapat menggunakan generator UUID apa pun untuk membuatnya. Untuk mengetahui informasi selengkapnya, lihat Mencoba ulang peluncuran .

Mengambil informasi tentang kebijakan ekstensi VM

Anda dapat mengambil informasi berikut tentang kebijakan ekstensi VM yang ada:

  • Daftar semua kebijakan dalam project Google Cloud Anda.
  • Informasi konfigurasi tentang kebijakan tertentu.

Konsol

  1. Di konsol Google Cloud , buka halaman Extension policies:

    Buka Kebijakan ekstensi

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Compute Engine.

    Halaman ini mencantumkan semua kebijakan ekstensi VM dalam project Anda.
  2. Untuk melihat detail kebijakan ekstensi tertentu, klik nama kebijakan.

gcloud

Zonal

Mencantumkan kebijakan ekstensi VM

Untuk mencantumkan informasi tentang semua kebijakan ekstensi VM dalam zona, gunakan gcloud compute zone-vm-extension-policies list:

gcloud compute zone-vm-extension-policies list \
  --project=PROJECT_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE_INTEGER

Ganti variabel berikut dalam perintah:

  • PROJECT_ID: ID project.
  • ZONE: Zona target; misalnya, us-central1-f.
  • PAGE_SIZE_INTEGER: Jumlah kebijakan yang akan dicantumkan per halaman; misalnya, 2. Untuk mengetahui informasi selengkapnya tentang opsi pengurutan dan pemfilteran, lihat gcloud compute zone-vm-extension-policies list.

Menjelaskan kebijakan ekstensi VM bernama

Untuk mengambil konfigurasi kebijakan bernama di zona, gunakan gcloud compute zone-vm-extension-policies describe:

gcloud compute zone-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Ganti variabel berikut dalam perintah:

  • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
  • PROJECT_ID: ID project.
  • ZONE: Zona target; misalnya, us-central1-f.

Global

Mencantumkan kebijakan ekstensi VM global

Untuk mencantumkan informasi tentang kebijakan ekstensi VM global, gunakan gcloud compute global-vm-extension-policies list:

gcloud compute global-vm-extension-policies list \
  --project=PROJECT_ID \
  --page-size=PAGE_SIZE_INTEGER

Ganti variabel berikut dalam perintah:

  • PROJECT_ID: ID project.
  • PAGE_SIZE_INTEGER: Jumlah kebijakan yang akan dicantumkan per halaman; misalnya, 2. Untuk mengetahui informasi selengkapnya tentang opsi pengurutan dan pemfilteran, lihat gcloud compute global-vm-extension-policies list.

Menjelaskan kebijakan ekstensi VM global bernama

Untuk mengambil konfigurasi kebijakan bernama di zona, gunakan gcloud compute global-vm-extension-policies describe:

gcloud compute global-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID

Ganti variabel berikut dalam perintah:

  • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
  • PROJECT_ID: ID project.

Untuk informasi umum tentang penggunaan konsolGoogle Cloud dan gcloud CLI untuk mengambil informasi tentang kebijakan ekstensi VM, lihat Melihat kebijakan ekstensi.

Memverifikasi penginstalan Agen Operasional

Bagian ini menjelaskan cara melakukan hal berikut:

Memverifikasi status atau versi penginstalan Agen Operasional

Untuk menentukan status atau versi Agen Operasional, gunakan salah satu halaman konsol Google Cloud berikut:

Compute Engine

  1. Di konsol Google Cloud , buka halaman VM instances.

    Buka instance VM

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Compute Engine.

  2. Pilih VM dari daftar.
  3. Klik tab Observability.

Cloud Monitoring

  1. Di konsol Google Cloud , buka halaman VM Instances:

    Buka Instance VM

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

  2. Pilih tampilan Daftar.

Setelah Agen Operasional diinstal di VM dan mengumpulkan log serta metrik, status agen akan ditandai dengan tanda centang hijau di samping label Ops Agent.

Untuk menentukan versi agen yang diinstal, arahkan kursor ke label Agen Operasional di dasbor Compute Engine atau Monitoring.

Memastikan bahwa Agen Operasional mengumpulkan telemetri

Jika Agen Operasional telah berhasil diinstal dan berjalan dengan benar, maka agen akan mengirimkan metrik ke Cloud Monitoring dan log ke Cloud Logging.

Memulai ulang Agen Operasional yang diinstal oleh kebijakan ekstensi

Jika diinstal dan dikelola oleh Pengelola Ekstensi VM, Agen Operasi tidak dikelola oleh layanan pengelolaan sistem dari sistem operasi, yaitu systemd di Linux atau Pengelola Layanan Windows di Windows. Oleh karena itu, perintah Linux systemctl dan perintah Windows *-Service tidak berfungsi dengan Agen Operasional yang diinstal oleh kebijakan ekstensi.

Untuk memulai ulang Agen Operasional yang diinstal oleh kebijakan ekstensi, lakukan salah satu hal berikut:

  • Buat ulang kebijakan.

    1. Hapus kebijakan. Menghapus kebijakan akan menghentikan dan meng-uninstal Agen Operasional.

    2. Buat kebijakan baru. Kebijakan baru akan menginstal Agen Operasional dan memulainya.

  • Gunakan kebijakan sementara dengan prioritas lebih tinggi. Jika kebijakan asli memengaruhi sejumlah besar VM, tetapi Anda hanya ingin memulai ulang Agen Operasional pada sejumlah kecil VM, tambahkan label ke VM tersebut dan konfigurasi kebijakan baru untuk memfilter label.

    Misalnya, jika kebijakan dengan prioritas 1000 gagal memulai Agen Operasi di VM, Anda dapat menambahkan label seperti status=failed ke VM. Kemudian, buat kebijakan baru dengan prioritas yang lebih tinggi, seperti 500. Misalnya, perintah Google Cloud CLI mungkin terlihat seperti berikut:

    Zonal 

    gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent  \
  --inclusion-labels=status=failed \
  --priority=500 \
  --config-from-file=ops-agent=/usr/ops-agent-config.yaml

    Ganti variabel berikut dalam perintah:

    • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
    • PROJECT_ID: ID project.
    • ZONE: Zona target; misalnya, us-central1-f.

    Global 

    gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --inclusion-labels=status=failed \
  --priority=500 \
  --config-from-file=ops-agent=/usr/ops-agent-config.yaml \
  --rollout-predefined-plan=fast_rollout

    Ganti variabel berikut dalam perintah:

    • POLICY_NAME: Nama untuk kebijakan ekstensi VM.
    • PROJECT_ID: ID project.

    Setelah kebijakan baru berhasil menginstal Agen Operasi, hapus kebijakan dan hapus label dari VM. Agen Operasional tetap diinstal di VM karena kebijakan asli masih aktif.

Mengaktifkan log debug agen tamu di VM

Kebijakan VM Extension Manager menggunakan agen tamu Compute Engine untuk mengelola Agen Operasional sebagai ekstensi VM. Untuk mengetahui informasi tentang cara mengaktifkan logging debug untuk agen tamu, lihat Melihat log debug untuk agen tamu.

Memecahkan masalah kebijakan ekstensi

Bagian ini memberikan informasi tentang pemecahan masalah penggunaan kebijakan ekstensi untuk mengelola Agen Operasional:

Untuk mengetahui informasi tentang cara memecahkan masalah Agen Operasional, lihat Memecahkan masalah Agen Operasional.

Perintah gcloud compute zone-vm-extension-policies gagal

Jika perintah gcloud compute zone-vm-extension-policies gagal, respons akan menyertakan saran pemecahan masalah. Perbaiki error apa pun dalam flag atau argumen perintah yang disarankan oleh pesan error.

Jika output perintah menyebutkan izin IAM yang tidak memadai, tinjau peran dan izin yang diperlukan yang dijelaskan dalam Memberi peran yang diperlukan untuk menggunakan VM Extension Manager.

Kebijakan ekstensi dibuat, tetapi status Agen Operasi adalah "tidak terdeteksi"

Anda berhasil membuat kebijakan ekstensi, tetapi Agen Operasi menampilkan status "tidak terdeteksi" di VM.

Agen Operasional mungkin ditampilkan sebagai "tidak terdeteksi" jika salah satu hal berikut terjadi:

  • Kebijakan ekstensi gagal menginstal Agen Operasional.
  • Ops Agent yang diinstal mengalami kondisi error yang mencegahnya berjalan.

Bagian berikut menjelaskan cara mendiagnosis kasus ini.

Pastikan Agen Operasional diinstal oleh kebijakan

Kebijakan VM Extension Manager menggunakan agen tamu Compute Engine untuk mengelola Agen Operasional sebagai ekstensi VM.

Untuk menentukan apakah Agen Operasional diinstal oleh kebijakan ekstensi, gunakan salah satu cara berikut untuk mencari entri log dari agen tamu:

Logs Explorer

  1. Di konsol Google Cloud , buka halaman Logs Explorer:

    Buka Logs Explorer

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Logging.

  2. Masukkan kueri berikut, lalu klik Run query:

    log_id("GCEGuestAgentManager")

Linux

Jalankan perintah berikut di VM Compute Engine:

journalctl -u google-guest-agent-manager

Windows

Jalankan perintah berikut di VM Compute Engine:

Get-Eventlog -Source google_guest_agent_manager -LogName Application

Jika Anda melihat log yang berisi string seperti Failed to install plugin "ops-agent-plugin" ..., atau kueri tidak menampilkan log, berarti kebijakan ekstensi gagal menginstal Agen Operasional. Untuk langkah selanjutnya, lihat Kebijakan ekstensi gagal menginstal Agen Operasional.

Jika Anda melihat log yang berisi string seperti Successfully installed plugin "ops-agent_nnnnnnnn", berarti kebijakan ekstensi berhasil menginstal Agen Operasional. Untuk langkah selanjutnya, lihat Agen Operasional yang diinstal "tidak terdeteksi".

Kebijakan ekstensi gagal menginstal Agen Operasional

Kebijakan ekstensi mungkin tidak efektif jika salah satu hal berikut berlaku:

  • Agen tamu tidak diinstal di VM. Untuk mendiagnosis dan memperbaiki kondisi ini, lakukan hal berikut:

    1. Pastikan VM menggunakan salah satu sistem operasi yang didukung untuk lingkungan tamu Compute Engine.

    2. Lihat paket yang diinstal di VM untuk memverifikasi bahwa google-guest-agent disertakan.

    3. Jika google-guest-agent tidak diinstal, maka instal agen tamu.

  • Agen tamu diinstal, tetapi sudah tidak berlaku. Untuk mendiagnosis dan memperbaiki kondisi ini, lakukan hal berikut:

    1. Validasi lingkungan tamu untuk menentukan versi paket google-guest-agent. VM Extension Manager memerlukan versi 20241209.01 atau yang lebih baru.

    2. Jika versi google-guest-agent lebih lama daripada 20241209.01, maka perbarui lingkungan tamu.

  • Sistem operasi VM tidak didukung oleh VM Extension Manager. Untuk mengetahui informasi selengkapnya, lihat Meninjau sistem operasi yang didukung.

Agen Operasional yang diinstal memiliki status "tidak terdeteksi"

Agen Operasi dapat memiliki status "tidak terdeteksi" jika salah satu kondisi berikut terpenuhi:

Memastikan konfigurasi Agen Operasional valid

Anda memberikan konfigurasi kustom ke Agen Operasi dengan membuat atau memperbarui kebijakan ekstensi, tetapi status agen adalah "tidak terdeteksi". Masalahnya mungkin berupa error dalam konfigurasi kustom Anda. Gunakan log debug agen tamu untuk mencari error konfigurasi.

Mengaktifkan logging debug agen tamu

Untuk mengetahui informasi tentang cara mengaktifkan logging debug untuk agen tamu, lihat Melihat log debug untuk agen tamu.

Memeriksa log debug

Logs Explorer

  1. Di konsol Google Cloud , buka halaman Logs Explorer:

    Buka Logs Explorer

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Logging.

  2. Masukkan kueri berikut, lalu klik Run query:

    severity>=DEBUG log_id("GCEGuestAgentManager") "The agent config file is not valid"

Linux

Jalankan perintah berikut di VM Compute Engine Linux:

journalctl -u google-guest-agent-manager | grep "The agent config file is not valid"

Windows

Jalankan perintah berikut di VM Compute Engine Windows:

Get-Eventlog -Source google_guest_agent_manager -LogName Application | Where-Object {$_.Message -like "*The agent config file is not valid*"}

Jika Anda melihat log yang berisi string The agent config file is not valid, maka konfigurasi kustom untuk Agen Operasi yang Anda berikan saat membuat atau mengupdate kebijakan ekstensi tidak valid.

Untuk memperbaiki masalah ini, lakukan langkah-langkah berikut:

  • Perbaiki konfigurasi dengan melihat Mengonfigurasi Agen Operasional. Untuk informasi tentang struktur file konfigurasi Agen Operasional.

  • Perbarui kebijakan ekstensi dengan konfigurasi yang benar.

Perintah Linux systemctl status dan Windows Get-Service tidak berfungsi dengan Agen Operasional

Anda menjalankan perintah seperti sudo systemctl status google-cloud-ops-agent"*" tetapi tidak menampilkan informasi apa pun.

Jika diinstal dan dikelola oleh Pengelola Ekstensi VM, Agen Operasi tidak dikelola oleh layanan pengelolaan sistem dari sistem operasi, yaitu systemd di Linux atau Pengelola Layanan Windows di Windows.

Untuk menemukan informasi status Agen Operasional yang dikelola oleh VM Extension Manager, lihat hal berikut:

Perintah Linux systemctl restart dan Windows Restart-Service tidak berfungsi dengan Agen Operasional

Anda menjalankan perintah seperti sudo systemctl restart google-cloud-ops-agent tetapi Agen Operasional tidak dimulai ulang.

Jika diinstal dan dikelola oleh Pengelola Ekstensi VM, Agen Operasi tidak dikelola oleh layanan pengelolaan sistem dari sistem operasi, yaitu systemd di Linux atau Pengelola Layanan Windows di Windows. Oleh karena itu, Anda tidak dapat menghentikan atau memulai Agen Operasional secara manual, dan perintah seperti berikut tidak berfungsi dengan Agen Operasional:

  • Linux: sudo systemctl [stop|start|restart]
  • Windows: Stop-Service, Start-Service, Restart-Service

Untuk menghentikan atau memulai ulang Agen Operasi yang dikelola oleh Pengelola Ekstensi VM, Anda harus meng-uninstal agen dengan menghapus kebijakan ekstensi. Untuk mengetahui informasi selengkapnya tentang cara menghentikan atau memulai ulang Agen Operasional, lihat Memulai ulang Agen Operasional yang diinstal oleh kebijakan ekstensi.

Informasi pemecahan masalah tambahan

Untuk mengetahui informasi selengkapnya tentang cara memecahkan masalah pembuatan dan penggunaan kebijakan VM Extension Manager, lihat Memecahkan masalah ekstensi VM.

Untuk mengetahui informasi selengkapnya tentang cara memecahkan masalah Agen Operasional, lihat artikel Memecahkan masalah Agen Operasional.

Kuota

Untuk mengetahui informasi tentang jumlah kebijakan ekstensi yang dapat Anda buat dalam Google Cloud project, lihat Quota.

Harga

Untuk mengetahui informasi tentang biaya terkait penggunaan VM Extension Manager, lihat Harga.

Jika Anda menginstal Agen Operasional, Anda mungkin akan dikenai biaya untuk metrik, log, atau rekaman aktivitas yang dikirimkan oleh agen tersebut ke project Google Cloud Anda. Untuk mengetahui informasi harga, lihat Harga Google Cloud Observability.

Langkah berikutnya