Menginstal dan mengelola Agen Operasional menggunakan kebijakan VM Extension Manager

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

  • Penginstalan di seluruh fleet: Instal Agen Operasional di semua VM dalam zona atau di sekumpulan subset VM yang diidentifikasi oleh label dalam zona.

  • 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. Ops Agent 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 yang lebih lama dari versi 2.58.0, instance Agen Operasional yang diinstal menggunakan cara lain, atau versi Agen Monitoring atau Agen Logging lama.

Anda dapat membuat dan mengelola kebijakan ekstensi VM menggunakan Google Cloud konsol atau Google Cloud CLI, 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 Operasi, pastikan sistem operasi target Anda kompatibel dengan Agen Operasi 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.

Aktifkan API yang diperlukan untuk menggunakan Ops Agent

Untuk menggunakan Agen Operasi guna menulis log dan metrik, Anda harus mengaktifkan Cloud Logging API dan Cloud Monitoring API di project Anda. Google Cloud

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Memberikan peran yang diperlukan untuk menggunakan Ops Agent

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 menginstalnya terlebih dahulu dengan melakukan langkah-langkah berikut:

  1. Jika Anda belum melakukannya, instal Google Cloud CLI.

    Kebijakan ekstensi yang dijelaskan dalam dokumen ini menggunakan grup perintah beta.

  1. Jika Anda belum melakukannya, instal komponen beta gcloud CLI dengan menjalankan perintah berikut:

    gcloud components install beta

    Untuk memeriksa apakah Anda telah menginstal komponen beta, jalankan perintah berikut:

    gcloud components list

    Jika sebelumnya Anda telah menginstal komponen beta, pastikan Anda memiliki versi terbaru:

    gcloud components update

Uninstal semua 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 Anda 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.

Menginstal Agen Operasional terbaru di semua VM dalam zona

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

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. Klik + Buat.
  3. Di kolom Name, masukkan nama untuk kebijakan.
  4. Opsional: Di kolom Description, masukkan deskripsi untuk kebijakan.
  5. Di kolom Priority, tentukan nomor prioritas untuk menyelesaikan konflik antar-kebijakan. Angka yang lebih rendah menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1.000.

  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

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

gcloud beta 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 beta 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.

Menyematkan Agen Operasional ke versi tertentu di semua VM dalam zona

Untuk membuat kebijakan yang menginstal Agen Operasional versi tertentu di semua VM dalam zona, lakukan hal berikut:

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. Klik + Buat.
  3. Di kolom Name, masukkan nama untuk kebijakan.
  4. Opsional: Di kolom Description, masukkan deskripsi untuk kebijakan.
  5. Di kolom Priority, tentukan nomor prioritas untuk menyelesaikan konflik antar-kebijakan. Angka yang lebih rendah menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1.000.

  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

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

gcloud beta 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.

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

Menginstal Agen Operasional di VM dalam zona dengan label tertentu

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

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. Klik + Buat.
  3. Di kolom Name, masukkan nama untuk kebijakan.
  4. Opsional: Di kolom Description, masukkan deskripsi untuk kebijakan.
  5. Di kolom Priority, tentukan nomor prioritas untuk menyelesaikan konflik antar-kebijakan. Angka yang lebih rendah menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1.000.

  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

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

gcloud beta 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 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 dalam satu zona

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

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. Klik + Buat.
  3. Di kolom Name, masukkan nama untuk kebijakan.
  4. Opsional: Di kolom Description, masukkan deskripsi untuk kebijakan.
  5. Di kolom Priority, tentukan nomor prioritas untuk menyelesaikan konflik antar-kebijakan. Angka yang lebih rendah menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1.000.

  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

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

gcloud beta 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 Ops Agent. 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 beta compute zone-vm-extension-policies update.

Jika Anda memberikan konfigurasi kustom untuk Agen Operasional saat membuat atau memperbarui kebijakan ekstensi, kebijakan tersebut 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 beta compute zone-vm-extension-policies update.

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 .

Mengelola Agen Operasional dengan mengupdate kebijakan ekstensi VM

Untuk mengubah cara kebijakan mengelola Ops Agent, 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

  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

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

Saat Anda mengupdate kebijakan menggunakan gcloud, permintaan akan bertindak sebagai penggantian lengkap. Bidang opsional yang Anda abaikan 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 beta 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 Ops Agent 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 dalam zona

Untuk mengubah konfigurasi Agen Operasional di semua VM dalam zona, lakukan hal berikut:

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 perbarui.
  3. Klik Edit.
  4. Di bagian Kelola ekstensi, lakukan hal berikut:
    1. Pilih Google Cloud's Extension for Ops Agent.
    2. Ubah kolom Config file content.
    3. Klik Done.
  5. Klik Save.

gcloud

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

Saat Anda mengupdate kebijakan menggunakan gcloud, permintaan akan bertindak sebagai penggantian lengkap. Bidang opsional yang Anda abaikan 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 beta 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 Ops Agent. 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 tersebut 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 beta compute zone-vm-extension-policies update.

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.

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

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

gcloud beta 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.

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

Mencantumkan kebijakan ekstensi VM

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

gcloud beta 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 beta compute zone-vm-extension-policies list.

Menjelaskan kebijakan ekstensi VM bernama

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

gcloud beta 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.

Untuk mengetahui 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 dan 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 Ops Agent 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 Ops Agent diinstal dan dikelola oleh VM Extension Manager, Ops Agent tidak dikelola oleh layanan pengelolaan sistem operasi, yaitu systemd di Linux atau Windows Service Manager di Windows. Oleh karena itu, perintah Linux systemctl dan perintah Windows *-Service tidak berfungsi dengan Agen Operasi 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 Ops Agent.

    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 Ops Agent 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:

    gcloud beta 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.

    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 Ops Agent:

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

Perintah gcloud beta compute zone-vm-extension-policies gagal

Jika perintah gcloud beta 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 Memberikan 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 Operasional menampilkan status "tidak terdeteksi" di VM.

Ops Agent 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 Ops Agent. 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 Ops Agent. 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 dari 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.

Ops Agent 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 mengetahui informasi tentang struktur file konfigurasi Agen Operasional.

  • Perbarui kebijakan ekstensi dengan konfigurasi yang telah dikoreksi.

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 Ops Agent diinstal dan dikelola oleh VM Extension Manager, Ops Agent tidak dikelola oleh layanan pengelolaan sistem operasi, yaitu systemd di Linux atau Windows Service Manager 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 Ops Agent diinstal dan dikelola oleh VM Extension Manager, Ops Agent tidak dikelola oleh layanan pengelolaan sistem operasi, yaitu systemd di Linux atau Windows Service Manager 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 pemecahan 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 Kuota.

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