Memecahkan masalah kebijakan VM Extension Manager untuk Agen Operasional

Untuk mendiagnosis masalah terkait kebijakan VM Extension Manager yang mengelola Agen Operasional, gunakan teknik pemecahan masalah yang dijelaskan dalam dokumen ini. 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 Memberikan peran yang diperlukan untuk menggunakan VM Extension Manager.

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

Anda berhasil membuat kebijakan ekstensi, tetapi Agen Operasional 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.
  • Agen Operasional yang diinstal mengalami kondisi error yang mencegahnya berjalan.

Bagian berikut menjelaskan cara mendiagnosis kasus ini.

Memastikan Agen Operasional telah 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 terpenuhi:

  • 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 memastikan bahwa google-guest-agent disertakan.

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

  • Agen tamu telah diinstal, tetapi sudah usang. 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, 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 Operasional dapat memiliki status "tidak terdeteksi" jika salah satu hal berikut benar:

Memastikan konfigurasi Agen Operasional valid

Anda memberikan konfigurasi kustom ke Agen Operasional dengan membuat atau mengupdate kebijakan ekstensi, tetapi status agen adalah "tidak terdeteksi". Masalahnya mungkin adalah 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, konfigurasi kustom untuk Agen Operasional yang Anda berikan saat membuat atau memperbarui kebijakan ekstensi tidak valid.

Untuk memperbaiki masalah ini, lakukan hal berikut:

  • Perbaiki konfigurasi dengan mengacu pada Mengonfigurasi Agen Operasional. Untuk mengetahui informasi tentang struktur file konfigurasi Agen Operasional.

  • Perbarui kebijakan ekstensi dengan konfigurasi yang telah diperbaiki.

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.

Saat Agen Operasional diinstal dan dikelola oleh VM Extension Manager, Agen Operasional tidak dikelola oleh layanan pengelolaan sistem dari 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 referensi 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.

Saat Agen Operasional diinstal dan dikelola oleh VM Extension Manager, Agen Operasional tidak dikelola oleh layanan pengelolaan sistem dari 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 Operasional yang dikelola oleh VM Extension Manager, 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 Memecahkan masalah Agen Operasional.