Menginstal Agen Operasional di masing-masing VM

Agen Operasional mengumpulkan log dan metrik pada instance Compute Engine, mengirimkan log Anda ke Cloud Logging dan metrik Anda ke Cloud Monitoring.

Sebelum memulai

Untuk menginstal agen, pastikan Anda memiliki hal berikut:

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.

Instal agen versi terbaru

Untuk menginstal agen versi terbaru, selesaikan langkah-langkah berikut.

Linux

  1. Buka koneksi terminal ke instance VM Anda menggunakan SSH atau alat serupa dan pastikan Anda memiliki akses sudo.

  2. Ubah ke direktori yang memiliki akses tulis, misalnya direktori beranda Anda.

  3. 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-install
    

    Setelah diinstal, agen akan dimulai secara otomatis.

Windows

  1. Hubungkan ke instance Anda menggunakan RDP atau alat serupa dan login ke Windows.

  2. Buka terminal PowerShell dengan hak istimewa administrator dengan mengklik kanan ikon PowerShell dan memilih Run as Administrator.

  3. 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 agen versi tertentu, selesaikan langkah-langkah berikut.

Linux

  1. Buka koneksi terminal ke instance VM Anda menggunakan SSH atau alat serupa dan pastikan Anda memiliki akses sudo.

  2. Ubah ke direktori yang memiliki akses tulis, misalnya direktori beranda Anda.

  3. Download skrip penginstalan agen:

    curl -sSO https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.sh
    

    Saat menjalankan skrip add-google-cloud-ops-agent-repo.sh, Anda juga dapat menetapkan flag berikut:

    • --verbose: Mengaktifkan logging verbose selama eksekusi skrip.
    • --also-install: Menginstal agen setelah menambahkan repositori paket agen.
    • --version: Menetapkan versi agen untuk skrip yang akan diinstal. Untuk mengetahui 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 uji coba 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 Monitoring lama (StackdriverMonitoring).

    Lihat komentar skrip untuk mengetahui informasi selengkapnya dan contoh penggunaan.

  4. Tambahkan repositori paket agen dan instal agen:

    1. Untuk mencantumkan versi agen yang tersedia, lihat Mencantumkan semua versi agen.

    2. Untuk lingkungan produksi, Anda mungkin ingin membatasi ke versi utama untuk menghindari penginstalan versi utama yang mungkin mencakup 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.*.*
      
    3. Untuk menginstal agen versi 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

  1. Hubungkan ke instance Anda menggunakan RDP atau alat serupa dan login ke Windows.

  2. Buka terminal PowerShell dengan hak istimewa administrator dengan mengklik kanan ikon PowerShell dan memilih Run as Administrator.

  3. 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 verbose selama eksekusi skrip.
    • -AlsoInstall: Menginstal agen setelah menambahkan repositori paket agen.
    • -Version: Menetapkan versi agen untuk skrip yang akan diinstal. Untuk mengetahui 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 uji coba eksekusi skrip dan mencetak perintah yang seharusnya dijalankan.
    • -UninstallStandaloneLoggingAgent: Meng-uninstal agen Logging lama (StackdriverLogging).
    • -UninstallStandaloneMonitoringAgent: Meng-uninstal agen Monitoring lama (StackdriverMonitoring).

    Lihat komentar skrip untuk mengetahui informasi selengkapnya dan contoh penggunaan.

  4. Tambahkan repositori paket agen dan instal agen:

    1. Untuk mencantumkan versi agen yang tersedia, lihat Mencantumkan semua versi agen.

    2. Untuk lingkungan produksi, Anda mungkin ingin membatasi ke versi utama untuk menghindari penginstalan versi utama yang mungkin mencakup 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.*.*"
      
    3. Untuk menginstal agen versi 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-agent
    

    Status agen harus Running.

Jika Anda mengalami masalah dengan penginstalan, lihat halaman Pemecahan masalah.

Instal agen menggunakan konsol Google Cloud

Anda dapat menginstal Agen Operasional di satu atau beberapa VM Compute Engine menggunakan Google Cloud konsol dari halaman Cloud Monitoring atau Compute Engine.

Cloud Monitoring

Di Google Cloud konsol, buka halaman dasbor VM Instances:

Buka dasbor Instance VM

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

Tampilan Daftar di tab Inventaris pada dasbor mencantumkan semua VM dan menyertakan kolom status untuk agen Anda, seperti yang ditunjukkan dalam screenshot berikut:

Dasbor Instance VM di Monitoring menampilkan status
agen.

Kolom Agen melaporkan nilai berikut:

  • Tidak terdeteksi: Anda belum menginstal agen atau agen tidak berjalan. Jika tidak yakin apakah Anda telah menginstal agen, Anda dapat mengirim kueri untuk versi yang diinstal. Jika Anda telah menginstal agen, Anda dapat memulai ulang agen. Jika Anda telah menginstal dan memulai Agen Operasi, tetapi statusnya tetap Tidak terdeteksi, berarti agen mungkin belum 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 umum dan pemeriksaan kondisi juga dapat membantu.

  • Agen Operasional: Anda menjalankan Agen Operasional. Jika Anda tidak melihat tanda centang hijau di samping entri, berarti ada upgrade agen yang tersedia, berdasarkan sistem operasi VM yang terdeteksi.

    Saat mengarahkan kursor ke indikator Agen Operasional dalam 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, maka mungkin ada masalah dalam menerapkan kebijakan OS Ops Agent atau memulai agen. Untuk informasi pemecahan masalah, lihat Alat diagnostik agen untuk kebijakan penginstalan otomatis.

  • Penginstalan agen gagal: Penginstalan Agen Operasional gagal. Untuk mengetahui informasi pemecahan masalah, lihat Agen gagal diinstal.

  • Tidak Mengumpulkan Telemetri: Penginstalan Agen Operasi berhasil, tetapi agen belum mengirim telemetri.

    Biasanya diperlukan waktu sekitar 10 menit agar telemetri mengalir dari agen baru. Anda dapat memuat ulang halaman untuk memperbarui status. Jika status ini berlanjut selama lebih dari 10 menit, hal ini mungkin menunjukkan masalah pada penyerapan telemetri. Untuk mengetahui informasi selengkapnya, lihat Agen diinstal, tetapi tidak berjalan.

  • Agen Lama: Anda menjalankan agen Monitoring atau Logging lama. Lihat Bermigrasi dari agen lama ke Agen Operasional untuk mengetahui informasi tentang transisi ke Agen Operasional.

  • Tidak berlaku: VM ini bukan platform yang didukung untuk menjalankan agen.

  • VM Dihentikan: 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 di 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 mengetahui informasi selengkapnya, lihat Mengelola VM yang dicakup dalam kebijakan OS Agen Operasional. Kebijakan OS Ops Agent 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

  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. Klik nama VM tempat Anda ingin menginstal agen.

  3. Klik tab Observability.

  4. Klik Instal Agen Operasional.

    Jika memungkinkan, agen diinstal menggunakan kebijakan OS Agen Operasional. Untuk mengetahui informasi selengkapnya, lihat Mengelola VM yang dicakup dalam kebijakan OS Agen Operasional. Kebijakan OS Ops Agent 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, maka mungkin ada masalah dalam menerapkan kebijakan OS Ops Agent atau memulai agen. Untuk informasi pemecahan masalah, lihat Alat diagnostik agen untuk kebijakan penginstalan otomatis.

Pastikan Ops Agent sedang berjalan

Untuk memverifikasi bahwa Agen Operasional sedang berjalan, Anda dapat menggunakan salah satu opsi berikut:

  • Dasbor Instance VM: Dasbor ini memungkinkan Anda melihat status penginstalan agen di seluruh fleet VM Anda. Namun, status mungkin tidak akurat jika VM tidak memiliki cakupan akses yang diperlukan atau jika akun layanan terkait memiliki peran IAM yang tidak memadai.

  • gcpdiag: gcpdiag memberikan informasi yang lebih andal dan kuat tentang status agen daripada dasbor VM Instances, 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 Google Cloud konsol, buka halaman dasbor VM Instances:

Buka dasbor Instance VM

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

Tampilan Daftar di tab Inventaris pada dasbor mencantumkan semua VM dan menyertakan kolom status untuk agen Anda.

Kolom Agen melaporkan nilai berikut:

  • Tidak terdeteksi: Anda belum menginstal agen atau agen tidak berjalan. Jika tidak yakin apakah Anda telah menginstal agen, Anda dapat mengirim kueri untuk versi yang diinstal. Jika Anda telah menginstal agen, Anda dapat memulai ulang agen. Jika Anda telah menginstal dan memulai Agen Operasi, tetapi statusnya tetap Tidak terdeteksi, berarti agen mungkin belum 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 umum dan pemeriksaan kondisi juga dapat membantu.

  • Agen Operasional: Anda menjalankan Agen Operasional. Jika Anda tidak melihat tanda centang hijau di samping entri, berarti ada upgrade agen yang tersedia, berdasarkan sistem operasi VM yang terdeteksi.

    Saat mengarahkan kursor ke indikator Agen Operasional dalam 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, maka mungkin ada masalah dalam menerapkan kebijakan OS Ops Agent atau memulai agen. Untuk informasi pemecahan masalah, lihat Alat diagnostik agen untuk kebijakan penginstalan otomatis.

  • Penginstalan agen gagal: Penginstalan Agen Operasional gagal. Untuk mengetahui informasi pemecahan masalah, lihat Agen gagal diinstal.

  • Tidak Mengumpulkan Telemetri: Penginstalan Agen Operasi berhasil, tetapi agen belum mengirim telemetri.

    Biasanya diperlukan waktu sekitar 10 menit agar telemetri mengalir dari agen baru. Anda dapat memuat ulang halaman untuk memperbarui status. Jika status ini berlanjut selama lebih dari 10 menit, hal ini mungkin menunjukkan masalah pada penyerapan telemetri. Untuk mengetahui informasi selengkapnya, lihat Agen diinstal, tetapi tidak berjalan.

  • Agen Lama: Anda menjalankan agen Monitoring atau Logging lama. Lihat Bermigrasi dari agen lama ke Agen Operasional untuk mengetahui informasi tentang transisi ke Agen Operasional.

  • Tidak berlaku: VM ini bukan platform yang didukung untuk menjalankan agen.

  • VM Dihentikan: VM tidak berjalan, sehingga status agen tidak diketahui.

Menggunakan gcpdiag

Untuk mengetahui 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 memproksi permintaan ke Logging API dan Monitoring API, lakukan hal berikut:

Linux

  1. Edit file konfigurasi berikut (buat file jika belum ada):

     /etc/systemd/system.conf
    
  2. Tambahkan 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.
    
  3. Muat ulang variabel lingkungan:

     sudo systemctl daemon-reload
    
  4. Mulai ulang agen dengan menjalankan perintah berikut pada instance VM Anda:

     sudo systemctl restart google-cloud-ops-agent"*"
    

Windows

  1. Jika Anda menggunakan proxy HTTP, jalankan perintah berikut dari command prompt administrator. Tindakan ini menetapkan variabel lingkungan HTTP_PROXY dan HTTPS_PROXY sehingga 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,169.254.169.254" /m
    

Menentukan versi agen

Untuk menentukan versi Agen Operasional di sistem Anda, jalankan perintah berikut di instance VM Anda:

Google Cloud console

Untuk melihat versi Agen Operasional di VM:

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 Agen Operasi 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

  1. Hubungkan ke instance Anda menggunakan RDP atau alat serupa dan login ke Windows.

  2. Buka terminal PowerShell dengan hak istimewa administrator dengan mengklik kanan ikon PowerShell dan memilih Run as Administrator.

  3. Jalankan perintah PowerShell berikut:

Restart-Service google-cloud-ops-agent -Force

Mengupgrade agen

Untuk mengupgrade Agen Operasional ke rilis terbaru, gunakan petunjuk berikut:

Google Cloud console

Anda dapat mengupgrade Agen Operasi menggunakan petunjuk penginstalan Cloud Monitoring. Untuk mengetahui informasi selengkapnya, lihat Menginstal agen menggunakan Google Cloud konsol.

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 poin 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:

  1. Hubungkan ke instance Anda menggunakan RDP atau alat serupa dan login ke Windows.

  2. Buka terminal PowerShell dengan hak istimewa administrator dengan mengklik kanan ikon PowerShell dan memilih 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"
    
  3. 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 mencantumkan versi agen yang tersedia, jalankan perintah berikut:

CENTOS / RHEL

Mencantumkan versi agen yang tersedia:

sudo yum list --showduplicates google-cloud-ops-agent

DEBIAN / UBUNTU

Mencantumkan versi agen yang tersedia:

sudo apt-cache madison google-cloud-ops-agent

SLES / SUSE

Mencantumkan versi agen yang tersedia:

sudo zypper search -s google-cloud-ops-agent

WINDOWS

Mencantumkan versi agen yang tersedia:

googet available google-cloud-ops-agent

Meng-uninstal agen

Untuk menghapus Agen Operasi dan file konfigurasinya, gunakan petunjuk berikut.

Setelah Anda meng-uninstal agen, Google Cloud konsol mungkin memerlukan waktu hingga satu jam untuk melaporkan perubahan ini.

Linux

Jalankan perintah berikut:

sudo bash add-google-cloud-ops-agent-repo.sh --uninstall

Jika ingin menghapus repositori selain menghapus instalasi agen, tambahkan --remove-repo ke perintah sebelumnya.

Windows

Untuk meng-uninstal Agen Operasional, ikuti langkah-langkah berikut:

  1. Hubungkan ke instance Anda menggunakan RDP atau alat serupa dan login ke Windows.

  2. Buka terminal PowerShell dengan hak istimewa administrator dengan mengklik kanan ikon PowerShell dan memilih Run as Administrator.

  3. Jalankan perintah PowerShell berikut:

    googet -noconfirm remove google-cloud-ops-agent
    

VM tanpa akses paket jarak jauh

Penginstalan Agen Operasi 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. Opsi ini dapat dikonfigurasi dengan mengikuti langkah-langkah di 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 di image tersebut.

Langkah berikutnya