Menginstal Agen Operasional di VM individu

Agen Operasional mengumpulkan log dan metrik di 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:

• Instance VM yang didukung dalam project Google Cloud.

• Sistem operasi yang didukung.

• Kredensial pada instance VM yang mengizinkan 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 sudah sangat lama atau jika Anda membuat instance Compute Engine tanpa kredensial default, Anda mungkin tidak memiliki kredensial yang tepat. Anda harus menyelesaikan prosedur Mengizinkan Agen Operasional.

• Pastikan Anda mengaktifkan layanan untuk Cloud Logging API dan Cloud Monitoring API.

• Pastikan VM Anda tidak menginstal agen Cloud Logging atau agen Cloud Monitoring lama. 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 sudah menginstal agen lama, simpan file konfigurasi kustom untuk agen Cloud Monitoring dan file konfigurasi kustom untuk agen Cloud Logging, lalu selesaikan langkah-langkah uninstal untuk agen Cloud Monitoring dan langkah uninstal 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

Catatan: Pertama, pastikan semua kondisi terpenuhi di bagian Sebelum memulai.

Untuk menginstal agen menggunakan command line, gunakan petunjuk berikut.

Menginstal agen versi terbaru

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

Linux

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

2. Ubah ke direktori yang akses tulisnya Anda miliki, misalnya direktori home 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, lalu login ke Windows.

2. Buka terminal PowerShell yang memiliki 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 versi agen tertentu

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

Linux

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

2. Ubah ke direktori yang akses tulisnya Anda miliki, misalnya direktori home 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 panjang selama eksekusi skrip.
   • --also-install: Menginstal agen setelah menambahkan repositori paket agen.
   • --version: Menetapkan versi agen untuk skrip yang akan diinstal.
   • --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 informasi lebih lanjut dan contoh penggunaannya.

4. Tambahkan repositori paket agen dan instal agen:

   1. Untuk menampilkan daftar versi agen yang tersedia guna memilih versi yang akan diinstal, lihat Mencantumkan semua versi agen.

   2. Untuk lingkungan produksi, Anda dapat 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.*.*
      

   3. 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 agen bekerja seperti yang diharapkan, jalankan:

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

  Pastikan komponen "Agen Logging" dan "Agen Metrik" sedang berjalan.

Jika mengalami masalah saat penginstalan, lihat halaman Pemecahan masalah.

Windows

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

2. Buka terminal PowerShell yang memiliki 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 panjang selama eksekusi skrip.
   • -AlsoInstall: Menginstal agen setelah menambahkan repositori paket agen.
   • -Version: Menetapkan versi agen untuk skrip yang akan diinstal.
   • -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 informasi lebih lanjut dan contoh penggunaannya.

4. Tambahkan repositori paket agen dan instal agen:

   1. Untuk menampilkan daftar versi agen yang tersedia guna memilih versi yang akan diinstal, lihat Mencantumkan semua versi agen.

   2. Untuk lingkungan produksi, Anda dapat 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.*.*"
      

   3. 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 agen bekerja seperti yang diharapkan, jalankan:

  Get-Service google-cloud-ops-agent
  

  Status agen seharusnya Running.

Jika mengalami masalah saat penginstalan, lihat halaman Pemecahan masalah.

Menginstal agen menggunakan konsol Google Cloud

Catatan: Pertama, pastikan semua kondisi terpenuhi di bagian Sebelum memulai.

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

Pada panel navigasi Konsol Google Cloud, pilih Monitoring, pilih  Dashboards, lalu pilih VM instances:

Buka Dasbor Instance VM

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

Kolom Agen melaporkan nilai berikut:

• Tidak terdeteksi: Anda tidak memiliki agen yang diinstal atau agen tidak berjalan. Jika tidak yakin apakah Anda telah menginstal agen, Anda dapat melakukan kueri untuk versi yang diinstal. Jika sudah menginstal agen, Anda dapat memulai ulang agen. Jika Anda telah menginstal dan memulai Agen Operasional, tetapi statusnya tetap Tidak terdeteksi, agen mungkin tidak memulai 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 mungkin 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 yang terdeteksi pada VM Anda.

  Saat mengarahkan kursor ke indikator Agen Operasional di tabel, Anda akan melihat informasi tentang versi Agen Operasional. Jika menjalankan versi yang lebih 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 Agen Operasional atau memulai agen. Untuk mengetahui informasi pemecahan masalah, lihat Alat diagnostik agen untuk kebijakan penginstalan otomatis.

• Agen Lama: Anda menjalankan Monitoring atau agen 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.

• 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 VM Details untuk VM tertentu.

Jika memungkinkan, agen akan diinstal menggunakan kebijakan OS Agen Operasional. Untuk mengetahui informasi selengkapnya, baca artikel Mengelola VM yang dicakup oleh kebijakan OS Agen Operasional. Kebijakan OS Agen Operasional 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. Pada panel navigasi Konsol Google Cloud, pilih Compute Engine, lalu pilih VM instances:

   Buka instance VM

2. Klik nama VM tempat Anda ingin menginstal agen.

3. Klik tab Kemampuan observasi.

4. Klik Install Ops Agent.

   Jika memungkinkan, agen akan diinstal menggunakan kebijakan OS Agen Operasional. Untuk mengetahui informasi selengkapnya, baca artikel Mengelola VM yang dicakup oleh kebijakan OS Agen Operasional. Kebijakan OS Agen Operasional 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 Agen Operasional atau memulai agen. Untuk mengetahui informasi pemecahan masalah, lihat Alat diagnostik agen untuk kebijakan penginstalan otomatis.

Memverifikasi bahwa Agen Operasional berjalan

Ada dua cara untuk memverifikasi bahwa Agen Operasional berjalan dengan benar:

• Pastikan semua pemeriksaan kesehatan lulus.

• Pada panel navigasi Konsol Google Cloud, pilih Monitoring, pilih  Dashboards, lalu pilih VM instances:

  Buka Dasbor Instance VM

  Kemudian, pastikan kolom Agen untuk VM ini menunjukkan Agen Operasional.

Tugas opsional

Bagian ini menjelaskan cara melakukan tugas pemeliharaan umum.

Mengonfigurasi proxy HTTP

Jika Anda menggunakan proxy HTTP untuk permintaan proxy ke Logging and 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 agar 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 Operasional di sistem Anda, jalankan perintah berikut pada instance VM:

Konsol Google Cloud

Untuk melihat versi Agen Operasional di VM:

• Temukan entri untuk VM dalam tabel Instances di halaman Monitoring VM Instances. Untuk mengetahui informasi navigasi, lihat Menginstal agen menggunakan konsol Google Cloud.

• Arahkan kursor ke indikator Agen Operasional 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 Agen Operasional untuk mengambil perubahan di file konfigurasi. Untuk memulai ulang agen, gunakan petunjuk berikut.

LINUX

Jalankan perintah berikut pada instance Anda:

     sudo systemctl restart google-cloud-ops-agent

Windows

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

2. Buka terminal PowerShell yang memiliki 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:

Catatan: Jika Anda telah mengupgrade sistem operasi Linux instance ke rilis utama yang baru, Anda harus terlebih dahulu menghapus agen, lalu menginstal ulang menggunakan prosedur di halaman ini, bukan menyelesaikan prosedur upgrade ini.

Konsol Google Cloud

Anda dapat mengupgrade Agen Operasional 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:

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

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

   Catatan: Jika Anda mengupgrade agen dari versi sebelum 2.0.3 ke versi 2.0.3 atau yang lebih baru, upgrade akan menghapus file konfigurasi lama. Jika Anda menyesuaikan konfigurasi agen, pastikan untuk menyimpan cadangan file konfigurasi sebelum melakukan upgrade, lalu terapkan perubahan yang diperlukan pada file konfigurasi setelah upgrade.

   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 terinstal dan menjalankan perintah penginstalan:

   googet -noconfirm remove google-cloud-ops-agent
   googet -noconfirm install google-cloud-ops-agent
   

Mencantumkan semua versi agen

Untuk menampilkan daftar 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 Agen Operasional dan file konfigurasinya, gunakan petunjuk berikut.

Catatan: Jika Agen Operasional diinstal selama pembuatan VM, baca bagian Mengelola VM yang dicakup oleh kebijakan OS Agen Operasional.

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:

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

2. Buka terminal PowerShell yang memiliki 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

Menginstal Agen Operasional memerlukan akses ke repositori paket jarak jauh, untuk paket agen dan (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 petunjuk 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.

Langkah selanjutnya

• Pelajari log yang dikirim agen ke Cloud Logging menggunakan konfigurasi defaultnya.