Agen Ops mengumpulkan log dan metrik di instance Compute Engine, yang mengirim log ke Cloud Logging dan metrik ke Cloud Monitoring.
Sebelum memulai
Untuk menginstal agen, pastikan Anda memiliki hal berikut:
Instance VM yang didukung dalam project Google Cloud.
Kredensial di instance VM yang memberikan otorisasi komunikasi dengan Cloud Logging dan Cloud Monitoring. Instance VM Compute Engine umumnya memiliki kredensial yang benar secara default. Jika Anda menjalankan instance Compute Engine yang sangat lama atau jika Anda membuat instance Compute Engine tanpa kredensial default, Anda mungkin tidak memiliki kredensial yang tepat. Anda harus menyelesaikan prosedur Memberikan Otorisasi pada Agen Operasional.
Pastikan Anda mengaktifkan layanan untuk Cloud Logging API dan Cloud Monitoring API.
Pastikan VM Anda tidak menginstal agen Cloud Logging lama atau agen Cloud Monitoring. Hal ini dapat menyebabkan penyerapan log duplikat atau konflik dalam penyerapan metrik. Selain itu, agen ini menggunakan file konfigurasi baru yang tidak kompatibel dengan agen lama.
Jika Anda telah menginstal agen lama, simpan file konfigurasi kustom untuk agen Cloud Monitoring dan file konfigurasi kustom untuk agen Cloud Logging, lalu selesaikan langkah-langkah penguninstalan untuk agen Cloud Monitoring dan langkah-langkah penguninstalan untuk agen Cloud Logging.
Untuk pengguna dengan VM yang tidak memiliki akses ke repositori paket jarak jauh, lihat bagian VM tanpa akses paket jarak jauh untuk mengetahui informasi selengkapnya.
Menginstal agen secara otomatis selama pembuatan VM
Untuk mengetahui informasi selengkapnya, lihat Menginstal Agen Operasional selama pembuatan VM.
Menginstal agen dari command line
Untuk menginstal agen menggunakan command line, gunakan petunjuk berikut.
Menginstal agen versi terbaru
Untuk menginstal versi terbaru agen, selesaikan langkah-langkah berikut.
Linux
Buka koneksi terminal ke instance VM Anda menggunakan SSH atau alat serupa dan pastikan Anda memiliki akses
sudo.Ubah ke direktori yang memiliki akses tulis, misalnya direktori utama Anda.
Download dan jalankan skrip penginstalan agen menggunakan perintah berikut:
curl -sSO https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.sh sudo bash add-google-cloud-ops-agent-repo.sh --also-installSetelah diinstal, agen akan otomatis dimulai.
Windows
Hubungkan ke instance Anda menggunakan RDP atau alat serupa, lalu login ke Windows.
Buka terminal PowerShell dengan hak istimewa administrator dengan mengklik kanan ikon PowerShell, lalu pilih Run as Administrator.
Jalankan perintah PowerShell berikut:
(New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.ps1", "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1") Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall"
Menginstal agen versi tertentu
Untuk menginstal versi agen tertentu, selesaikan langkah-langkah berikut.
Linux
Buka koneksi terminal ke instance VM Anda menggunakan SSH atau alat serupa dan pastikan Anda memiliki akses
sudo.Ubah ke direktori yang memiliki akses tulis, misalnya direktori utama Anda.
Download skrip penginstalan agen:
curl -sSO https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.shSaat menjalankan skrip
add-google-cloud-ops-agent-repo.sh, Anda juga dapat menetapkan flag berikut:--verbose: Mengaktifkan logging panjang selama eksekusi skrip.--also-install: Menginstal agen setelah menambahkan repositori paket agen.--version: Menetapkan versi agen untuk skrip yang akan diinstal. Untuk informasi versi, lihat Mencantumkan semua versi agen.--uninstall: Meng-uninstal agen.--remove-repo: Menghapus repositori paket agen yang sesuai setelah menginstal atau meng-uninstal agen.--dry-run: Hanya memicu dry run eksekusi skrip dan mencetak perintah yang seharusnya dijalankan.
--uninstall-standalone-logging-agent: Meng-uninstal agen Logging lama (StackdriverLogging).--uninstall-standalone-monitoring-agent: Meng-uninstal agen Pemantauan lama (StackdriverMonitoring).
Lihat komentar skrip untuk informasi selengkapnya dan contoh penggunaan.
Tambahkan repositori paket agen dan instal agen:
Untuk mencantumkan versi agen yang tersedia, lihat Mencantumkan semua versi agen.
Untuk lingkungan produksi, sebaiknya Anda menyematkan ke versi utama untuk menghindari penginstalan versi utama yang mungkin menyertakan perubahan yang tidak kompatibel dengan versi sebelumnya. Untuk menyematkan ke versi utama, jalankan:
sudo bash add-google-cloud-ops-agent-repo.sh --also-install \ --version=MAJOR_VERSION.*.*Misalnya, untuk menyematkan ke 1.x.x agen, jalankan:
sudo bash add-google-cloud-ops-agent-repo.sh --also-install \ --version=1.*.*Untuk menginstal versi agen tertentu, jalankan:
sudo bash add-google-cloud-ops-agent-repo.sh --also-install \ --version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION
Anda dapat menghapus skrip penginstalan setelah berhasil dijalankan.
Untuk memastikan bahwa agen berfungsi seperti yang diharapkan, jalankan:
sudo systemctl status google-cloud-ops-agent"*"Pastikan komponen "Logging Agent" dan "Metrics Agent" sedang berjalan.
Jika Anda mengalami masalah dengan penginstalan, lihat halaman Pemecahan masalah.
Windows
Hubungkan ke instance Anda menggunakan RDP atau alat serupa, lalu login ke Windows.
Buka terminal PowerShell dengan hak istimewa administrator dengan mengklik kanan ikon PowerShell, lalu pilih Run as Administrator.
Download skrip penginstalan agen:
(New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.ps1", "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1")Saat menjalankan skrip
add-google-cloud-ops-agent-repo.ps1, Anda juga dapat menetapkan flag berikut:-Verbose: Mengaktifkan logging panjang selama eksekusi skrip.-AlsoInstall: Menginstal agen setelah menambahkan repositori paket agen.-Version: Menetapkan versi agen untuk skrip yang akan diinstal. Untuk informasi versi, lihat Mencantumkan semua versi agen.-Uninstall: Meng-uninstal agen.-RemoveRepo: Menghapus repositori paket agen yang sesuai setelah menginstal atau meng-uninstal agen.-WhatIf: Hanya memicu dry run eksekusi skrip dan mencetak perintah yang seharusnya dijalankan.-UninstallStandaloneLoggingAgent: Meng-uninstal agen Logging lama (StackdriverLogging).-UninstallStandaloneMonitoringAgent: Meng-uninstal agen Pemantauan lama (StackdriverMonitoring).
Lihat komentar skrip untuk informasi selengkapnya dan contoh penggunaan.
Tambahkan repositori paket agen dan instal agen:
Untuk mencantumkan versi agen yang tersedia, lihat Mencantumkan semua versi agen.
Untuk lingkungan produksi, sebaiknya Anda menyematkan ke versi utama untuk menghindari penginstalan versi utama yang mungkin menyertakan perubahan yang tidak kompatibel dengan versi sebelumnya. Untuk menyematkan ke versi utama, jalankan:
Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version MAJOR_VERSION.*.*"Misalnya, untuk menyematkan ke 1.x.x agen, jalankan:
Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version 1.*.*"Untuk menginstal versi agen tertentu, jalankan:
Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version version-number"Contoh:
Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version 1.0.1"
Anda dapat menghapus skrip penginstalan setelah berhasil dijalankan.
Untuk memastikan bahwa agen berfungsi seperti yang diharapkan, jalankan:
Get-Service google-cloud-ops-agentStatus agen harus
Running.
Jika Anda mengalami masalah dengan penginstalan, lihat halaman Pemecahan masalah.
Menginstal agen menggunakan Konsol Google Cloud
Anda dapat menginstal Agen Operasional di satu atau beberapa VM Compute Engine menggunakan Konsol Google Cloud dari halaman Cloud Monitoring atau Compute Engine.
Cloud Monitoring
Di konsol Google Cloud, buka halaman Dasbor Instance VM:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
Tampilan Daftar di tab Inventaris di dasbor mencantumkan semua VM dan menyertakan kolom status untuk agen Anda, seperti yang ditunjukkan dalam screenshot berikut:
Kolom Agen melaporkan nilai berikut:
Tidak terdeteksi: Anda tidak menginstal agen atau agen tersebut tidak berjalan. Jika tidak yakin apakah telah menginstal agen, Anda dapat mengirim kueri untuk versi yang diinstal. Jika telah menginstal agen, Anda dapat memulai ulang agen. Jika Anda telah menginstal dan memulai Ops Agent, tetapi statusnya tetap Tidak terdeteksi, berarti agen mungkin tidak dimulai dengan benar atau tidak dapat mengirim metrik.
Untuk memecahkan masalah pengaktifan, lihat Agen diinstal, tetapi tidak berjalan. Untuk memecahkan masalah penyerapan metrik, lihat Memecahkan masalah penyerapan data. Skrip diagnostik agen dan health check umum juga dapat membantu.
Ops Agent: Anda menjalankan Ops Agent. Jika Anda tidak melihat tanda centang hijau di samping entri, berarti ada upgrade agen yang tersedia, berdasarkan sistem operasi VM Anda yang terdeteksi.
Saat mengarahkan kursor ke indikator Agen Operasional di tabel, Anda akan melihat informasi tentang versi Agen Operasional. Jika menjalankan versi lama, Anda juga akan melihat rekomendasi untuk mengupgrade agen.
Tertunda: Agen Operasional sedang diinstal atau diupgrade.
Jika penginstalan agen tetap Tertunda selama lebih dari 10 menit, mungkin ada masalah dalam menerapkan kebijakan OS Ops Agent atau memulai agen. Untuk informasi pemecahan masalah, lihat Alat diagnostik agen untuk kebijakan penginstalan otomatis.
Agen Lama: Anda menjalankan agen Monitoring atau Logging lama. Lihat Bermigrasi dari agen lama ke Agen Ops untuk mengetahui informasi tentang transisi ke Agen Ops.
Tidak berlaku: VM ini bukan platform yang didukung untuk menjalankan agen.
Tidak diketahui: VM tidak berjalan, sehingga status agen tidak diketahui.
Anda dapat menginstal Agen Operasional dengan melakukan hal berikut:
- Pilih instance VM tempat Anda ingin menginstal agen.
- Klik opsi Install/Update Ops Agent pada tabel Instances.
Anda juga dapat menginstal atau mengupdate Agen Operasional dari halaman Detail VM untuk VM tertentu.
Jika memungkinkan, agen diinstal menggunakan kebijakan OS Agen Operasional. Untuk informasi selengkapnya, lihat Mengelola VM yang dicakup dalam kebijakan OS Agen Operasional. Kebijakan OS Agen Ops tidak didukung di semua versi semua sistem operasi. Dalam hal ini, mengklik Install/Update Ops Agent akan memberikan serangkaian perintah untuk dijalankan di Cloud Shell.
Agen Operasional mengumpulkan metrik dan log secara default. Anda dapat mengubah perilaku default ini dengan mengonfigurasi Agen Operasional.
Compute Engine
-
Di Konsol Google Cloud, buka halaman Instance VM:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Compute Engine.
Klik nama VM tempat Anda ingin menginstal agen.
Klik tab Kemampuan observasi.
Klik Instal Agen Operasional.
Jika memungkinkan, agen diinstal menggunakan kebijakan OS Agen Operasional. Untuk informasi selengkapnya, lihat Mengelola VM yang dicakup dalam kebijakan OS Agen Operasional. Kebijakan OS Agen Ops tidak didukung di semua versi semua sistem operasi. Dalam hal ini, mengklik Install/Update Ops Agent akan memberikan serangkaian perintah untuk dijalankan di Cloud Shell.
Agen Operasional mengumpulkan metrik dan log secara default. Anda dapat mengubah perilaku default ini dengan mengonfigurasi Agen Operasional.
Jika penginstalan agen tetap Tertunda selama lebih dari 10 menit, mungkin ada masalah dalam menerapkan kebijakan OS Ops Agent atau memulai agen. Untuk informasi pemecahan masalah, lihat Alat diagnostik agen untuk kebijakan penginstalan otomatis.
Memverifikasi bahwa Ops Agent sedang berjalan
Untuk memverifikasi bahwa Agen Operasional sedang berjalan, Anda dapat menggunakan salah satu dari opsi berikut:
Dasbor Instance VM: Dasbor ini memungkinkan Anda melihat status penginstalan agen di seluruh kumpulan VM. Namun, status tersebut mungkin tidak akurat jika VM tidak memiliki cakupan akses yang diperlukan atau jika akun layanan terkait tidak memiliki peran IAM yang memadai.
gcpdiag: gcpdiag memberikan informasi yang lebih andal dan andal tentang status agen daripada dasbor Instance VM, yang memverifikasi penginstalan agen dan transmisi telemetri dari VM. Penggunaan gcpdiag memiliki beberapa prasyarat, dan memberikan cara yang lebih baik untuk memantau status agen.
Menggunakan dasbor Instance VM
Di konsol Google Cloud, buka halaman Dasbor Instance VM:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
Kemudian, pastikan kolom Agen untuk VM ini menunjukkan Agen Operasional.
Menggunakan gcpdiag
Untuk informasi tentang cara menggunakan gcpdiag, lihat Memverifikasi status agen menggunakan gcpdiag.
Tugas opsional
Bagian ini menjelaskan cara melakukan tugas pemeliharaan umum.
Mengonfigurasi Proxy HTTP
Jika Anda menggunakan proxy HTTP untuk melakukan proxy permintaan ke Logging dan Monitoring API, lakukan tindakan berikut:
Linux
Edit file konfigurasi berikut (buat file jika belum ada):
/etc/systemd/system.confTambahkan kode berikut ke file:
DefaultEnvironment="HTTP_PROXY=http://proxy-ip:proxy-port" "HTTPS_PROXY=http://proxy-ip:proxy-port" "NO_PROXY=http://metadata.google.internal" # Skip proxy for the local Metadata Server.Muat ulang variabel lingkungan:
sudo systemctl daemon-reloadMulai ulang agen dengan menjalankan perintah berikut di instance VM Anda:
sudo systemctl restart google-cloud-ops-agent"*"
Windows
Jika Anda menggunakan proxy HTTP, jalankan perintah berikut dari command prompt administrator. Tindakan ini akan menetapkan variabel lingkungan
HTTP_PROXYdanHTTPS_PROXYsehingga agen dapat mengirim data menggunakan HTTPS keluar:setx HTTP_PROXY http://proxy-ip:proxy-port /m setx HTTPS_PROXY http://proxy-ip:proxy-port /m setx no_proxy metadata.google.internal /m
Menentukan versi agen
Untuk menentukan versi Agen Operasi di sistem Anda, jalankan perintah berikut di instance VM Anda:
Konsol Google Cloud
Untuk melihat versi Agen Operasional di VM:
Temukan entri untuk VM di tabel Instances di halaman VM Instances Pemantauan. Untuk informasi navigasi, lihat Menginstal agen menggunakan konsol Google Cloud.
Arahkan kursor ke indikator Ops Agent di entri tabel.
CENTOS / RHEL
Jalankan perintah berikut di Red Hat atau CentOS Linux:
rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' google-cloud-ops-agent
DEBIAN / UBUNTU
Jalankan perintah berikut di Debian atau Ubuntu:
dpkg-query --show --showformat '${Package} ${Version} ${Architecture} ${Status}\n' google-cloud-ops-agent
SLES / SUSE
Jalankan perintah berikut di SUSE:
rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' google-cloud-ops-agent
WINDOWS
Jalankan perintah berikut di Windows:
googet installed google-cloud-ops-agent
Memulai ulang agen
Anda harus memulai ulang Ops Agent untuk mengambil perubahan dalam file konfigurasi. Untuk memulai ulang agen, gunakan petunjuk berikut.
LINUX
Jalankan perintah berikut di instance Anda:
sudo systemctl restart google-cloud-ops-agent
Windows
Hubungkan ke instance Anda menggunakan RDP atau alat serupa, lalu login ke Windows.
Buka terminal PowerShell dengan hak istimewa administrator dengan mengklik kanan ikon PowerShell, lalu pilih Run as Administrator.
Jalankan perintah PowerShell berikut:
Restart-Service google-cloud-ops-agent -Force
Mengupgrade agen
Untuk mengupgrade Agen Operasional ke rilis terbaru, gunakan petunjuk berikut:
Konsol Google Cloud
Anda dapat mengupgrade Ops Agent menggunakan petunjuk penginstalan Cloud Monitoring. Untuk mengetahui informasi selengkapnya, lihat Menginstal agen menggunakan konsol Google Cloud.
Linux
Untuk mengupgrade agen ke versi terbaru, jalankan perintah berikut:
sudo bash add-google-cloud-ops-agent-repo.sh --also-install
Untuk mengupgrade agen ke rilis titik terbaru dari versi utama tertentu, jalankan perintah berikut:
sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
--version=MAJOR_VERSION.*.*
Windows
Untuk mengupgrade ke rilis agen terbaru:
Hubungkan ke instance Anda menggunakan RDP atau alat serupa, lalu login ke Windows.
Buka terminal PowerShell dengan hak istimewa administrator dengan mengklik kanan ikon PowerShell, lalu pilih Run as Administrator.
Copy-Item -Path "C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml" -Destination "C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.bak"Jalankan perintah PowerShell berikut untuk menghapus agen yang diinstal dan menjalankan perintah penginstalan:
googet -noconfirm remove google-cloud-ops-agent googet -noconfirm install google-cloud-ops-agent
Mencantumkan semua versi agen
Untuk menampilkan versi agen yang tersedia, jalankan perintah berikut:
CENTOS / RHEL
Cantumkan versi agen yang tersedia:
sudo yum list --showduplicates google-cloud-ops-agent
DEBIAN / UBUNTU
Cantumkan versi agen yang tersedia:
sudo apt-cache madison google-cloud-ops-agent
SLES / SUSE
Cantumkan versi agen yang tersedia:
sudo zypper search -s google-cloud-ops-agent
WINDOWS
Cantumkan versi agen yang tersedia:
googet available google-cloud-ops-agent
Meng-uninstal agen
Untuk menghapus Ops Agent dan file konfigurasinya, gunakan petunjuk berikut.
Setelah Anda meng-uninstal agen, konsol Google Cloud mungkin memerlukan waktu hingga satu jam untuk melaporkan perubahan ini.
Linux
Jalankan perintah berikut:
sudo bash add-google-cloud-ops-agent-repo.sh --uninstall
Secara opsional, untuk menghapus repositori selain meng-uninstal agen,
tambahkan --remove-repo ke perintah sebelumnya.
Windows
Untuk meng-uninstal Agen Operasional, ikuti langkah-langkah berikut:
Hubungkan ke instance Anda menggunakan RDP atau alat serupa, lalu login ke Windows.
Buka terminal PowerShell dengan hak istimewa administrator dengan mengklik kanan ikon PowerShell, lalu pilih Run as Administrator.
Jalankan perintah PowerShell berikut:
googet -noconfirm remove google-cloud-ops-agent
VM tanpa akses paket jarak jauh
Menginstal Agen Operasional memerlukan akses ke repositori paket jarak jauh, baik untuk paket agen maupun (di Linux) dependensinya.
Jika Anda menggunakan VPC-SC atau jaringan pribadi, konfigurasi jaringan juga dapat memengaruhi kemampuan Anda untuk menginstal dependensi agen dari repositori upstream. Paket agen itu sendiri dapat diakses menggunakan Akses Google Pribadi. Hal ini dapat dikonfigurasi setelah Mengaktifkan Akses Google Pribadi.
Jika kebijakan keamanan host VM Anda menolak akses ke repositori paket jarak jauh, sebaiknya buat image VM kustom dengan agen yang telah diinstal sebelumnya dan nonaktifkan pengelolaan paket dalam image tersebut.