Kebijakan VM Extension Manager memungkinkan Anda menginstal Agen Operasional di armada VM Compute Engine. Kebijakan ekstensi dapat menginstal Agen Operasional secara global di seluruh project Google Cloud Anda atau dalam zona tertentu, terus mengupdate versi agen, dan menerapkan konfigurasi kustom ke agen.
Sebelum memulai
Sebelum membuat kebijakan ekstensi VM Extension Manager untuk mengelola Agen Operasional, lakukan hal berikut:
Tinjau sistem operasi yang didukung untuk memastikan bahwa Agen Operasional dan VM Extension Manager didukung di sistem operasi Anda.
Hapus semua agen kemampuan observasi yang sudah diinstal di VM Anda.
Aktifkan API yang digunakan oleh Agen Operasional dan oleh VM Extension Manager.
Berikan peran yang diperlukan untuk menggunakan VM Extension Manager.
Jika Anda ingin menggunakan antarmuka command line untuk membuat dan mengelola kebijakan ekstensi, instal Google Cloud CLI.
Anda dapat membuat dan mengelola kebijakan ekstensi VM zona menggunakan konsolGoogle Cloud atau Google Cloud CLI, gcloud. Anda membuat dan mengelola kebijakan ekstensi VM global menggunakan gcloud.
Menghapus agen kemampuan observasi yang ada
Sebelum membuat kebijakan VM Extension Manager untuk Agen Operasional, 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 yang sudah memiliki agen kemampuan observasi lain, kebijakan tersebut akan menginstal agen, tetapi agen akan gagal berjalan karena terdeteksi adanya konflik.
Cara menghapus agen yang ada bergantung pada cara agen tersebut diinstal.
Agen yang diinstal oleh kebijakan OS Config VM Manager, yang mencakup hal berikut:
- Agen Operasional diinstal menggunakan konsolGoogle Cloud selama pembuatan VM.
- Agen Operasional diinstal oleh kebijakan Konfigurasi OS VM Manager GA.
- Agen Operasional, atau agen Monitoring atau agen Logging lama yang diinstal oleh kebijakan OS Config VM Manager beta.
Untuk mengetahui informasi tentang cara mengidentifikasi VM menggunakan kebijakan ini, lihat Menemukan VM yang dicakup oleh kebijakan OS Agen Operasional.
Untuk mengetahui informasi tentang cara meng-uninstal agen dan menghapus kebijakan Konfigurasi OS, lihat Meng-uninstal Agen Operasional di VM yang tercakup dalam kebijakan OS Agen Operasional.
Agen yang diinstal secara manual menggunakan skrip penginstalan. Untuk mengetahui informasi tentang cara meng-uninstal agen, lihat referensi berikut:
- Agen Operasional: Uninstal agen.
- Agen Monitoring lama: Meng-uninstal agen.
- Agen Logging lama: Uninstal agen.
Mengaktifkan API yang diperlukan untuk menggunakan Agen Operasional
Untuk menggunakan Agen Operasional guna 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 Service Usage Admin (roles/serviceusage.serviceUsageAdmin).
Pelajari cara memberikan peran.
Memberikan peran yang diperlukan untuk menggunakan Agen Operasional
Untuk mendapatkan izin yang Anda perlukan untuk menggunakan Agen Operasional guna menulis log dan metrik, minta administrator untuk memberi Anda peran IAM berikut di akun layanan Anda:
-
Untuk menulis log:
Logging Logs Writer (
roles/logging.logWriter) -
Untuk menulis metrik:
Monitoring Metric Writer (
roles/monitoring.metricWriter)
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 Operasional, lihat Memberikan otorisasi Agen Operasional.
Mengaktifkan API yang digunakan oleh VM Extension Manager
VM Extension Manager menggunakan Compute Engine API. Aktifkan API ini di project Google Cloud Anda jika belum diaktifkan.
Mengaktifkan Compute Engine API
Memberikan peran yang diperlukan untuk menggunakan VM Extension Manager
Untuk mendapatkan izin yang Anda perlukan untuk membuat kebijakan ekstensi VM, minta administrator untuk memberi Anda peran IAM berikut pada project:
-
Untuk membuat kebijakan ekstensi:
VM Extension Policy Admin (
roles/compute.vmExtensionPolicyAdmin)
Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi izin yang diperlukan untuk membuat kebijakan ekstensi VM. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk membuat kebijakan ekstensi VM:
-
Untuk membuat kebijakan ekstensi:
compute.vmExtensionPolicies.create
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 konsol Google Cloud 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 memastikan Anda memiliki versi terbaru, jalankan perintah berikut:
gcloud components update
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 efektif 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 ditetapkan. Ada dua rencana peluncuran yang telah ditetapkan, yang dipilih berdasarkan nilai yang digunakan dengan opsi
--rollout-predefined-planuntuk 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 langsung men-deploy Agen Operasional ke semua VM yang ditargetkan di semua zona dan region.
Tentukan rencana peluncuran ini menggunakan opsi
--rollout-predefined-plan=fast_rollout.
Rencana peluncuran Kustom, yang ditentukan menggunakan opsi
--rollout-custom-planuntuk 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.
Membuat kebijakan ekstensi VM untuk menginstal Agen Operasional
Dengan VM Extension Manager, Anda membuat kebijakan yang mendeklarasikan ekstensi yang ingin diinstal di VM. Agen Operasional adalah salah satu ekstensi yang tersedia. Dengan menentukan kebijakan, Anda dapat memastikan bahwa ekstensi yang didukung, termasuk Agen Operasional, diinstal dan dikelola di VM mana pun yang sesuai dengan kriteria yang Anda tentukan, seperti label VM.
Anda dapat menggunakan kebijakan ekstensi untuk Agen Operasional guna melakukan tugas seperti berikut:
Penginstalan di seluruh fleet: Instal Agen Operasional pada hal berikut:
- Semua VM di satu atau beberapa zona dalam project Google Cloud Anda.
- Semua VM secara global (di project Google Cloud Anda).
- Sebagian VM di suatu zona, yang diidentifikasi dengan label.
- Sebagian VM di seluruh zona dalam project Google Cloud Anda, yang diidentifikasi dengan label.
Kontrol versi:
- Pastikan Agen Operasional diupdate ke versi terbaru.
- Sematkan versi Agen Operasional ke rilis tertentu.
Manajemen konfigurasi: Terapkan konfigurasi kustom ke Agen Operasional di semua VM yang dikelola oleh kebijakan.
Bagian berikut memberikan contoh kebijakan yang menginstal Agen Operasional sesuai dengan kriteria tertentu.
VM Extension Manager mendukung Agen Operasional versi 2.58.0 atau yang lebih baru, jika Agen Operasional telah diinstal oleh kebijakan ekstensi. VM Extension Manager tidak dapat mengelola Agen Operasional versi lama, instance Agen Operasional yang diinstal menggunakan cara lain, atau Agen Monitoring atau Agen Logging lama.
Menginstal Agen Operasional terbaru di semua VM
Untuk membuat kebijakan yang menginstal Agen Operasional versi terbaru di semua VM dalam suatu zona atau secara global, dan mengupdate Agen Operasional saat versi baru dirilis, lakukan hal berikut:
Konsol
Untuk membuat kebijakan zona, Anda dapat menggunakan konsol Google Cloud .
-
Di konsol Google Cloud , buka halaman Extension policies:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Compute Engine.
- Klik + Create.
- Di kolom Name, masukkan nama untuk kebijakan.
- Opsional: Di kolom Description, masukkan deskripsi untuk kebijakan.
- Di kolom Priority, tentukan nomor prioritas untuk menyelesaikan konflik antar-kebijakan. Angka yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1.000.
- Dalam daftar Zone, pilih zona tempat Anda ingin menerapkan kebijakan ini.
- Di bagian Kelola ekstensi, klik Tambahkan ekstensi
dan lakukan hal berikut:
- Dari daftar Extension, pilih
Google Cloud's Extension for Ops Agent. - Kosongkan kolom Version.
- Dari daftar Extension, pilih
- 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.
Perintah gcloud compute zone-vm-extension-policies create menggunakan 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.
Perintah gcloud compute global-vm-extension-policies create menggunakan 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 versi tertentu Agen Operasional di semua VM dalam zona atau secara global, lakukan hal berikut:
Konsol
Untuk membuat kebijakan zona, Anda dapat menggunakan konsol Google Cloud .
-
Di konsol Google Cloud , buka halaman Extension policies:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Compute Engine.
- Klik + Create.
- Di kolom Name, masukkan nama untuk kebijakan.
- Opsional: Di kolom Description, masukkan deskripsi untuk kebijakan.
- Di kolom Priority, tentukan nomor prioritas untuk menyelesaikan konflik antar-kebijakan. Angka yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1.000.
- Dalam daftar Zone, pilih zona tempat Anda ingin menerapkan kebijakan ini.
- Di bagian Kelola ekstensi, klik Tambahkan ekstensi
dan lakukan hal berikut:
- Dari daftar Extension, pilih
Google Cloud's Extension for Ops Agent. - Dari daftar Version, pilih versi yang akan diinstal. Gunakan versi 2.58.0 atau yang lebih baru.
- Dari daftar Extension, pilih
- 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, 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, 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 Operasional, lihat halaman rilis Agen Operasional 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 zona, Anda dapat menggunakan konsol Google Cloud .
-
Di konsol Google Cloud , buka halaman Extension policies:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Compute Engine.
- Klik + Create.
- Di kolom Name, masukkan nama untuk kebijakan.
- Opsional: Di kolom Description, masukkan deskripsi untuk kebijakan.
- Di kolom Priority, tentukan nomor prioritas untuk menyelesaikan konflik antar-kebijakan. Angka yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1.000.
- Dalam daftar Zone, pilih zona tempat Anda ingin menerapkan kebijakan ini.
- Di bagian Kelola ekstensi, klik Tambahkan ekstensi
dan lakukan hal berikut:
- Dari daftar Extension, pilih
Google Cloud's Extension for Ops Agent. - Kosongkan kolom Version.
- Dari daftar Extension, pilih
- Di bagian Target VM instances, pilih VM untuk kebijakan. Untuk memilih VM dengan label tertentu, klik Tambahkan label dan tambahkan pasangan nilai kunci.
- Klik Create.
gcloud
Untuk membuat kebijakan zona atau global, Anda dapat menggunakan gcloud CLI.
Zonal
Gunakan opsi --inclusion-labels ke perintah gcloud compute zone-vm-extension-policies create untuk menentukan daftar key-value pair 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_labelsbeberapa kali, kebijakan akan menargetkan VM yang cocok dengan semua label di salah satu pemilih (OR logis). Jika Anda menghapus opsi ini, kebijakan akan menargetkan semua VM di zona yang ditentukan.
Global
Gunakan opsi --inclusion-labels ke perintah gcloud compute global-vm-extension-policies create untuk menentukan daftar key-value pair 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_labelsbeberapa kali, kebijakan akan menargetkan VM yang cocok dengan semua label di salah satu pemilih (OR logis). 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 zona, Anda dapat menggunakan konsol Google Cloud .
-
Di konsol Google Cloud , buka halaman Extension policies:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Compute Engine.
- Klik + Create.
- Di kolom Name, masukkan nama untuk kebijakan.
- Opsional: Di kolom Description, masukkan deskripsi untuk kebijakan.
- Di kolom Priority, tentukan nomor prioritas untuk menyelesaikan konflik antar-kebijakan. Angka yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1.000.
- Dalam daftar Zone, pilih zona tempat Anda ingin menerapkan kebijakan ini.
- Di bagian Kelola ekstensi, klik Tambahkan ekstensi
dan lakukan hal berikut:
- Dari daftar Extension, pilih
Google Cloud's Extension for Ops Agent. - Kosongkan kolom Version.
- Di kolom Config file content, masukkan string konfigurasi YAML untuk Agen Operasional.
- Dari daftar Extension, pilih
- Klik Create.
gcloud
Untuk membuat kebijakan zona atau global, Anda dapat menggunakan gcloud CLI.
Zonal
Gunakan opsi --config-from-file ke 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 Operasional. 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 mengalami 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-policiesupdate.
Global
Gunakan opsi --config-from-file ke 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 Operasional. 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 mengalami 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-policiesupdate.
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, mengubah file konfigurasi tidak akan mengubah konfigurasi agen. Anda harus memperbarui konfigurasi
yang disimpan dengan kebijakan menggunakan perintah
gcloud yang sesuai:
- Untuk kebijakan zona, gunakan perintah
gcloud compute zone-vm-extension-policiesupdate. - Untuk kebijakan global, gunakan perintah
gcloud compute global-vm-extension-policiesupdate.
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 cara menggunakan konsolGoogle Cloud dan gcloud CLI untuk membuat kebijakan ekstensi VM, lihat Menginstal ekstensi VM menggunakan 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 subgrup 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 mengetahui informasi tentang cara membuat
rencana peluncuran kustom, lihat
Tentang rencana peluncuran.
Untuk menentukan kumpulan 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.
Memverifikasi penginstalan Agen Operasional
Bagian ini menjelaskan cara melakukan hal berikut:
- Memverifikasi status atau versi penginstalan Agen Operasional
- Memastikan Agen Operasional mengumpulkan telemetri
Memverifikasi status atau versi penginstalan Agen Operasional
Untuk menentukan status atau versi Agen Operasional, gunakan salah satu halaman konsolGoogle Cloud berikut:
Compute Engine
-
Di konsol Google Cloud , buka halaman VM instances.
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Compute Engine.
- Pilih VM dari daftar.
- Klik tab Observability.
Cloud Monitoring
-
Di konsol Google Cloud , buka halaman VM Instances:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
- Pilih tampilan Daftar.
Setelah Agen Operasional diinstal di VM dan mengumpulkan log serta metrik, status agen ditandai dengan tanda centang hijau di samping label Ops Agent.
Untuk menentukan versi Agen Operasional yang diinstal, arahkan kursor ke label Ops Agent di dasbor Compute Engine atau Pemantauan.
Memastikan Agen Operasional mengumpulkan telemetri
Jika Agen Operasional telah berhasil diinstal dan berjalan dengan benar, agen tersebut akan mengirimkan metrik ke Cloud Monitoring dan log ke Cloud Logging.
- Untuk mengetahui informasi tentang cara memverifikasi pengumpulan metrik, lihat Agen berjalan, tetapi data tidak diserap.
- Untuk mengetahui informasi tentang cara memverifikasi pengumpulan log, lihat Memverifikasi keberhasilan pengumpulan log.
Langkah berikutnya
- Ubah penginstalan dengan memperbarui kebijakan ekstensi Anda.
- Memecahkan masalah dalam kebijakan ekstensi.
- Pelajari VM Extension Manager lebih lanjut.
- Lihat informasi mendetail tentang cara mengonfigurasi Agen Operasional.