Ringkasan agen Logging

Panduan ini memberikan informasi dasar tentang agen Logging, aplikasi berbasis fluentd yang berjalan di instance virtual machine (VM) Anda.

Dalam konfigurasi defaultnya, agen Logging melakukan streaming log dari aplikasi pihak ketiga umum dan software sistem ke Logging; tinjau daftar log default. Anda dapat mengonfigurasi agen untuk melakukan streaming log tambahan; buka Mengonfigurasi agen Logging untuk detail tentang konfigurasi dan operasi agen.

Sebaiknya jalankan agen Logging di semua instance VM Anda. Agen berjalan di Linux dan Windows.

Untuk menginstal agen Logging, lihat bagian Menginstal agen Logging.

Cara kerja Agen logging

Sistem operasi yang didukung

Anda dapat menjalankan agen Logging di sistem operasi berikut pada instance virtual machine (VM) yang kompatibel:

  • Rocky Linux 8
  • RHEL 8: rhel-8-6-sap-ha, rhel-8-8-sap-ha
  • Debian 11 (Bullseye)
  • SLES 12: sles-12-sp5-sap
  • SLES 15: sles-15-sp6, sles-15-sp3-sap, sles-15-sp4-sap, sles-15-sp5-sap
  • Windows Server 2016, dan 2019
  • Windows Server Core 2016 dan 2019

Jika Anda menjalankan VM Container-Optimized OS, ikuti petunjuk Container-Optimized OS untuk mengumpulkan log dari VM Anda.

Lingkungan yang didukung

Agen Logging kompatibel dengan lingkungan berikut:

  • Instance Compute Engine. Agen Logging mengirimkan log ke project yang terkait dengan setiap instance VM.

    Untuk instance tanpa alamat IP eksternal, Anda harus mengaktifkan Akses Google Pribadi agar agen Logging dapat mengirim log.

  • Instance Amazon Elastic Compute Cloud (Amazon EC2). Agen Logging mengirimkan log dari AWS ke project Google Cloud .

    Agar berfungsi dengan benar, agen Logging yang berjalan di instance Amazon EC2 harus dapat berkomunikasi dengan Google Cloud API, terutama Logging API. Hal ini memerlukan alamat IP eksternal atau gateway internet VPC.

Untuk instance VM ini, diperlukan memori residen (RSS) minimal 250 MiB untuk menjalankan agen Logging, tetapi sebaiknya 1 GiB. Misalnya, pada kecepatan 100 entri log berukuran 1 KB per detik, agen Logging dengan konfigurasi default menggunakan CPU 5% pada satu core dan memori 150 MiB.

Instance VM berikut mendukung Logging menggunakan softwarenya sendiri, sehingga menginstal agen Logging secara manual di instance tersebut tidak didukung:

  • Instance lingkungan standar App Engine. App Engine menyertakan dukungan bawaan untuk Logging. Untuk mengetahui informasi selengkapnya, buka Menulis log aplikasi.

  • Instance lingkungan fleksibel App Engine. Aplikasi yang berjalan di lingkungan fleksibel App Engine dapat menulis log yang selain yang disertakan di lingkungan standar App Engine. Untuk mengetahui informasi selengkapnya, buka Menulis log aplikasi.

  • Instance node Google Kubernetes Engine. Pengumpulan log dengan Logging diaktifkan secara default untuk cluster penampung baru, atau Anda dapat mengaktifkannya untuk cluster yang sudah ada. Untuk informasi, lihat Mengonfigurasi logging dan pemantauan untuk GKE.

  • Untuk instance yang berjalan di Google Distributed Cloud, agen mengumpulkan log sistem, tetapi tidak mengumpulkan log aplikasi.

  • Instance container Cloud Run. Cloud Run menyertakan dukungan bawaan untuk Logging. Untuk mengetahui informasi selengkapnya, buka Logging dan melihat log.

  • Cloud Run functions adalah fungsi HTTP dan latar belakang. Fungsi Cloud Run menyertakan dukungan bawaan untuk Logging.

Dukungan untuk cloud lokal dan hybrid

Google Cloud bermitra dengan Bindplane untuk menyediakan layanan logging bagi platform on-premise dan hybrid cloudsecara konsisten dan dapat diprediksi. Dengan BindPlane, Anda dapat mengumpulkan data Anda sendiri dan mengirimkannya ke Logging untuk dianalisis. Bindplane terintegrasi dengan Cloud Logging untuk mengambil data dari infrastruktur Anda dan disertakan dengan project Anda tanpa biaya tambahan.

Untuk mengetahui informasi selengkapnya tentang BindPlane dan BindPlane, lihat Tentang BindPlane dan BindPlane.

Persyaratan akses agen

Untuk menjalankan agen, Anda memerlukan akses ke nama DNS berikut:

  • Server token OAuth2: oauth2.googleapis.com

    Versi agen yang lebih lama mungkin memerlukan akses ke www.googleapis.com (URL lengkap: https://www.googleapis.com/oauth2/v3/token).

    Jika Anda menggunakan agen versi lama, sebaiknya upgrade agen Anda ke versi terbaru.

  • Logging API: logging.googleapis.com

Penginstalan agen memerlukan akses ke nama DNS berikut:

  • (Linux) Repositori paket Google Cloud: packages.cloud.google.com

  • Server download Google: dl.google.com

Kode sumber agen logging

Anda tidak memerlukan informasi di bagian ini, kecuali jika Anda ingin memahami kode sumber atau Anda memiliki kebutuhan khusus lainnya. Agen Logging diinstal oleh skrip yang dijelaskan dalam petunjuk penginstalan.

Agen Logging, google-fluentd, adalah versi yang diubah dari pengumpul data log fluentd. google-fluentd didistribusikan dalam dua paket terpisah. Kode sumber tersedia dari repositori GitHub terkait:

  • Repositori GitHub bernama google-fluentd yang mencakup program fluentd inti, skrip pengemasan kustom, dan plugin output untuk Cloud Logging API.
    • Plugin output dikemas sebagai gem Ruby dan disertakan dalam paket google-fluentd. Plugin ini juga tersedia secara terpisah di layanan hosting gem Ruby di fluent-plugin-google-cloud.
    • Konten yang terkait dengan penginstal Windows dapat ditemukan di folder windows-installer.
  • Repositori GitHub bernama google-fluentd-catch-all-config yang menyertakan file konfigurasi untuk agen Logging untuk menyerap log dari berbagai paket software pihak ketiga.

Catatan rilis agen logging

  • Catatan rilis untuk paket Linux google-fluentd dapat ditemukan di google-fluentd/releases, dengan tag rilis mengikuti format versi semantik [Major].[Minor].[Patch].

  • Catatan rilis untuk penginstal Windows dapat ditemukan di lokasi yang sama: google-fluentd/releases. Namun, tag rilis diawali dengan Windows.

  • Catatan rilis untuk gem mandiri fluent-plugin-google-cloud dapat ditemukan di fluent-plugin-google-cloud/releases, dengan tag rilis mengikuti format versi semantik [Major].[Minor].[Patch].

Kebijakan penghentian penggunaan

Agen Logging tunduk pada kebijakan penghentian penggunaan agen Google Cloud Observability.

Langkah berikutnya