Menginstal agen Cloud Logging di setiap VM

Ini adalah agen lama. Meskipun agen ini masih didukung, sebaiknya jangan gunakan agen ini untuk beban kerja Google Cloud baru.

Sebagai gantinya, sebaiknya gunakan Agen Operasional untuk workload Google Cloud baru dan pada akhirnya transisikan VM Compute Engine yang ada untuk menggunakan Agen Operasional. Agen Operasional, yang menggabungkan pengumpulan metrik dan logging menjadi satu agen, adalah pengganti akhir untuk agen lama.

Ops Agent sedang dalam pengembangan aktif, tetapi mungkin ada beberapa kasus penggunaan yang tidak didukungnya. Jika Agen Ops tidak mendukung kasus penggunaan Anda, Anda masih dapat menggunakan Agen logging.

Tidak akan ada pengembangan fitur atau dukungan baru untuk sistem operasi baru untuk agen Logging lama.

Agen Logging melakukan streaming log dari instance VM Anda dan dari paket software pihak ketiga yang dipilih ke Cloud Logging. Praktik terbaiknya adalah menjalankan agen Logging di semua instance VM Anda.

Image VM untuk Compute Engine dan Amazon Elastic Compute Cloud (EC2) tidak menyertakan agen Logging, sehingga Anda harus menyelesaikan langkah-langkah ini untuk menginstalnya di instance tersebut. Agen berjalan di Linux dan Windows.

Jika VM Anda berjalan di Google Kubernetes Engine atau App Engine, agen sudah disertakan dalam image VM, sehingga Anda dapat melewati halaman ini.

Sebelum memulai

Untuk menginstal agen, pastikan Anda memiliki hal berikut:

• Instance VM yang didukung di project Google Cloud atau akun Amazon Web Services (AWS).

  • Saat menginstal agen Logging, diperlukan memori minimum 250 MiB, tetapi 1 GiB direkomendasikan.

  Pastikan juga VM Anda menjalankan sistem operasi yang didukung.

• Kredensial di instance VM yang mengizinkan komunikasi dengan Cloud Logging atau Cloud Monitoring. Instance VM Compute Engine umumnya memiliki kredensial yang benar secara default. Jika salah satu skenario berikut berlaku untuk Anda, Anda mungkin tidak memiliki kredensial yang tepat dan harus menyelesaikan prosedur Memberi otorisasi ke agen Logging:

  • Untuk menjalankan instance VM AWS EC2, Anda harus menginstal kredensial otorisasi di VM sebelum menginstal agen.

  • Menjalankan instance Compute Engine yang sangat lama atau instance Compute Engine yang dibuat tanpa kredensial default.

  Untuk memeriksa apakah Anda memiliki kredensial yang tepat, jalankan prosedur Memverifikasi kredensial Compute Engine.

• Untuk mengetahui informasi harga, buka Harga untuk Google Cloud Observability.

• Jika Anda menggunakan VM yang tidak memiliki akses ke repositori paket jarak jauh, baca bagian VM tanpa akses paket jarak jauh untuk mengetahui informasi selengkapnya.

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 versi terbaru agen, 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 utama Anda.

3. Download dan jalankan skrip penginstalan agen menggunakan perintah berikut:

   curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
   sudo bash add-logging-agent-repo.sh --also-install
   

   Setelah diinstal, agen akan otomatis dimulai.

Windows

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

2. Buka terminal PowerShell dengan hak istimewa administrator dengan mengklik kanan ikon PowerShell, lalu pilih Run as Administrator.

3. Jalankan perintah PowerShell berikut:

   (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-21.exe", "${env:UserProfile}\StackdriverLogging-v1-21.exe")
   & "${env:UserProfile}\StackdriverLogging-v1-21.exe"
   

Menginstal agen versi tertentu

Untuk menginstal versi agen 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 utama Anda.

3. Download skrip penginstalan agen:

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

   Saat menjalankan skrip add-logging-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.

   Lihat komentar skrip untuk 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, 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-logging-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.*.*
      

      Misalnya, untuk menyematkan ke 1.x.x agen, jalankan:

      sudo bash add-logging-agent-repo.sh --also-install \
        --version=1.*.*
      

   3. Untuk menginstal versi agen tertentu, jalankan:

      sudo bash add-logging-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION
      

5. Memulai ulang layanan agen

   Mulai ulang diperlukan agar konfigurasi yang diinstal oleh paket generik di atas diterapkan.

   sudo service google-fluentd restart
   

Anda dapat menghapus skrip penginstalan setelah berhasil dijalankan.

• Untuk memastikan bahwa agen berfungsi seperti yang diharapkan, jalankan:

  sudo service google-fluentd status
  

  Status agen harus Oke.

• Anda juga dapat memeriksa log dan memastikan tidak ada error:

  tail /var/log/google-fluentd/google-fluentd.log
  

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

Windows

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

2. Buka terminal PowerShell dengan hak istimewa administrator dengan mengklik kanan ikon PowerShell, lalu pilih Run as Administrator.

   Catatan: Hanya agen versi terbaru yang didukung di instance VM yang menjalankan Windows. Sebaiknya jangan menginstal versi sebelumnya.

   1. Jalankan perintah PowerShell berikut:

      (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-21.exe", "${env:UserProfile}\StackdriverLogging-v1-21.exe")
      & "${env:UserProfile}\StackdriverLogging-v1-21.exe"
      

   Atau, Anda dapat membuka URL berikut untuk mendownload dan menjalankan penginstal agen:

   https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-21.exe

   Perhatian: Anda harus mendownload penginstal ke direktori non-sistem, seperti C:\Users\[USERNAME]. Untuk alasan keamanan, penginstal tidak berjalan dari direktori sistem, termasuk direktori C:\.
   Jika Anda mendownload penginstal ke direktori sistem, pindahkan ke direktori lain sebelum menjalankannya.
   Catatan: Penginstal agen juga mendukung opsi "senyap", /S, yang dapat digunakan dalam membuat skrip penginstalan.

   Untuk menginstal agen secara senyap, tambahkan opsi /S ke pemanggilan penginstal:

   & "${env:UserProfile}\StackdriverLogging-v1-21.exe" /S
   

   Perhatian: Penginstalan senyap adalah operasi asinkron. Saat perintah penginstalan keluar, agen belum diinstal. Anda dapat memeriksa apakah penginstalan berhasil dengan mencari layanan StackdriverLogging.
   Catatan: Penginstal menempatkan agen di direktori `C:\Program Files (x86)\Stackdriver\LoggingAgent` secara default. Anda dapat mengubah direktori tersebut selama penginstalan.

   Dalam mode “senyap”, gunakan opsi /D untuk menentukan direktori penginstalan, misalnya:

   & "${env:UserProfile}\StackdriverLogging-v1-21.exe" /S /D="C:\Stackdriver\Logging\"
   

   Anda dapat menghapus penginstal setelah berhasil selesai.

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

Melihat informasi agen menggunakan konsol Google Cloud

Anda dapat menemukan informasi status tentang agen di dasbor Instance VM Pemantauan yang telah dikonfigurasi sebelumnya. Untuk membuka dasbor ini, lakukan tindakan berikut:

Di konsol Google Cloud, buka halaman Dasbor Instance VM:

Buka 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.

• 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.

• 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.

Tugas opsional

Bagian ini menjelaskan cara melakukan tugas pemeliharaan umum.

Mengaktifkan logging terstruktur

Saat Anda menjalankan skrip penginstalan di VM Linux, skrip secara default akan menginstal paket google-fluentd-catch-all saat flag --also-install ada. Untuk beralih ke logging terstruktur, selesaikan langkah-langkah berikut.

1. Cadangkan perubahan lokal apa pun ke /etc/google-fluentd/config.d/.

2. Jalankan salah satu perintah berikut, bergantung pada distribusi Linux Anda:

   • YUM:

     sudo yum remove -y google-fluentd-catch-all-config
     sudo yum install -y google-fluentd-catch-all-config-structured
     sudo service google-fluentd restart
     

   • APT:

     sudo apt-get remove -y google-fluentd-catch-all-config
     sudo apt-get install -y google-fluentd-catch-all-config-structured
     sudo service google-fluentd restart
     

Untuk informasi tentang logging terstruktur, lihat panduan logging terstruktur.

Mengonfigurasi agen Logging

Agen ini telah dikonfigurasi sebelumnya untuk memantau lokasi log tertentu yang diketahui. Di Linux, lokasi tersebut dijelaskan dalam paket google-fluentd-catch-all-config, yang otomatis diambil oleh skrip penginstalan. Di Windows, agen memantau Log Aktivitas Windows secara default.

Untuk menyesuaikan konfigurasi agen, lihat Mengonfigurasi agen Logging.

Mengonfigurasi Proxy HTTP

Jika Anda menggunakan proxy HTTP untuk melakukan proxy permintaan ke Logging dan Monitoring API, lakukan tindakan berikut:

Linux

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

    /etc/default/google-fluentd
   

2. Tambahkan kode berikut ke file:

    export http_proxy="http://proxy-ip:proxy-port"
    export https_proxy="http://proxy-ip:proxy-port"
    export no_proxy=169.254.169.254  # Skip proxy for the local Metadata Server.
   

3. Mulai ulang agen dengan menjalankan perintah berikut di instance VM Anda:

    sudo service google-fluentd restart
   

Windows

1. Jika Anda menggunakan proxy HTTP, jalankan perintah berikut dari command prompt administrator. Tindakan ini akan 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 169.254.169.254 /m
   

Menentukan versi agen

Untuk menentukan versi agen Logging di sistem Anda, jalankan perintah berikut di instance VM Anda:

AMAZON LINUX AMI / CENTOS / RHEL

Jalankan perintah berikut di Amazon Linux, Red Hat, atau CentOS Linux:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' google-fluentd google-fluentd-catch-all-config google-fluentd-catch-all-config-structured

DEBIAN / UBUNTU

Jalankan perintah berikut di Debian atau Ubuntu:

dpkg-query --show --showformat '${Package} ${Version} ${Architecture} ${Status}\n' google-fluentd google-fluentd-catch-all-config google-fluentd-catch-all-config-structured

SLES / SUSE

Jalankan perintah berikut di SUSE:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' google-fluentd google-fluentd-catch-all-config google-fluentd-catch-all-config-structured

WINDOWS

1. Hubungkan ke instance Anda menggunakan RDP atau alat serupa, lalu 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:

    reg query HKLM\Software\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\GoogleStackdriverLoggingAgent\ /v Version
   

Memulai ulang agen

Anda harus memulai ulang agen Logging untuk mengambil perubahan dalam file konfigurasi. Untuk memulai ulang agen, gunakan petunjuk berikut.

LINUX

Jalankan perintah berikut di instance Anda:

     sudo service google-fluentd restart

Setelah memulai ulang agen Logging, sebaiknya kirim pesan pengujian.

Windows

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

2. Buka terminal PowerShell dengan hak istimewa administrator dengan mengklik kanan ikon PowerShell, lalu pilih Run as Administrator.

3. Jalankan perintah PowerShell berikut:

Restart-Service -Name StackdriverLogging

Mengupgrade agen

Untuk mengupgrade agen Logging ke rilis terbaru, gunakan petunjuk berikut:

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

Linux

Untuk mengupgrade agen ke versi terbaru, jalankan perintah berikut:

sudo bash add-logging-agent-repo.sh --also-install

Untuk mengupgrade agen ke rilis titik terbaru dari versi utama tertentu, jalankan perintah berikut:

sudo bash add-logging-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*

Windows

Untuk mengupgrade ke rilis agen terbaru, instal agen terbaru seperti yang dijelaskan dalam Menginstal di Windows di halaman ini. Penginstal akan meminta Anda untuk meng-uninstal agen versi sebelumnya.

Mencantumkan semua versi agen

Untuk menampilkan versi agen yang tersedia, jalankan perintah berikut:

AMAZON LINUX AMI / CENTOS / RHEL

Cantumkan versi agen yang tersedia:

sudo yum list --showduplicates google-fluentd

DEBIAN / UBUNTU

Cantumkan versi agen yang tersedia:

sudo apt-cache madison google-fluentd

SLES / SUSE

Cantumkan versi agen yang tersedia:

sudo zypper search -s google-fluentd

WINDOWS

Menginstal agen versi sebelumnya di Windows tidak didukung.

Meng-uninstal agen

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

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

Catatan: Jika Anda menambahkan file konfigurasi fluentd Anda sendiri, salin file tersebut dari direktori konfigurasi agen untuk disimpan.

Linux

Jalankan perintah berikut:

sudo bash add-logging-agent-repo.sh --uninstall

Secara opsional, untuk menghapus repositori selain meng-uninstal agen, tambahkan --remove-repo ke perintah sebelumnya.

Windows

Di Control Panel Windows, pilih Uninstall a program. Anda akan melihat agen Logging dalam daftar program yang dapat di-uninstal. Anda juga dapat menjalankan uninstall.exe dari direktori tempat Anda menginstal Agen logging.

VM tanpa akses paket jarak jauh

Menginstal agen Logging 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.

Langkah selanjutnya

• Pelajari log yang dikirim agen ke Cloud Logging menggunakan konfigurasi default-nya.

• Untuk mengetahui informasi tentang cara melihat log, lihat Menggunakan Logs Explorer.