Tentang Agen logging

Panduan ini memberikan informasi dasar tentang agen Logging, aplikasi berdasarkan 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 mengetahui detail tentang konfigurasi dan operasi agen.

Menjalankan agen Logging di semua instance VM Anda merupakan praktik terbaik. Agen ini berjalan di Linux dan Windows.

Untuk menginstal agen Logging, lihat 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:

  • CentOS 7 dan 8
  • Linux Rocky 8
  • Red Hat Enterprise Linux 7 dan 8
  • Debian 9 "Stretch", 10 "Buster", dan 11 "Bullseye"
  • Ubuntu LTS 20.04 (Fokal Fossa)
  • Ubuntu Minimal LTS 20.04 (Focal Fossa)
  • SUSE Linux Enterprise Server 12 dan 12 SP5 untuk SAP
  • SUSE Linux Enterprise Server 15, 15 SP2 untuk SAP, 15 S3 untuk SAP, 15 SP4 untuk SAP, dan 15 SP5 untuk SAP
  • OpenSUSE Leap 15, 15.2, 15.3, dan 15.4
  • Windows Server 2016, dan 2019
  • Windows Server Core 2016, dan 2019
  • Amazon Linux AMI (kecuali Amazon Linux 2.0 AMI)

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

Lingkungan yang didukung

Agen Logging kompatibel dengan lingkungan berikut:

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

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

  • Amazon Elastic Compute Cloud (Amazon EC2). Agen Logging akan mengirimkan log ke project AWS Connector yang menautkan akun AWS Anda ke layanan Google Cloud.

    Agar agen Logging berfungsi dengan benar, instance Amazon EC2 yang dijalankan 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 minimum 250 MiB dari memori penduduk (RSS) untuk menjalankan agen Logging, tetapi sebaiknya gunakan 1 GiB. Misalnya, dengan kecepatan 100 entri log berukuran 1 KB per detik, agen Logging dengan konfigurasi default menggunakan 5% CPU pada satu core dan memori 150 MiB.

Instance VM berikut mendukung Logging menggunakan software-nya sendiri, sehingga menginstal agen Logging secara manual pada 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 sebagai tambahan dari apa yang disertakan dalam 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 ada. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi logging dan pemantauan untuk GKE.

  • Untuk instance yang berjalan di GKE di VMware, agen mengumpulkan log sistem, tetapi tidak mengumpulkan log aplikasi.

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

  • Fungsi HTTP dan latar belakang Cloud Functions. Cloud Functions menyertakan dukungan bawaan untuk Logging. Untuk mengetahui informasi selengkapnya, buka Menulis, Melihat, dan Menanggapi Log.

Dukungan untuk cloud lokal dan hybrid cloud

Google Cloud berpartner dengan observIQ guna menyediakan layanan logging untuk platform hybrid cloud dan lokal dengan cara yang 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 dalam project Anda tanpa biaya tambahan.

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

Persyaratan akses agen

Menjalankan agen 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

Menginstal agen memerlukan akses ke nama DNS berikut:

  • Repositori paket Google Cloud (Linux): 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 memiliki kebutuhan khusus lainnya. Agen Logging diinstal oleh skrip yang dijelaskan dalam petunjuk penginstalan.

Agen Logging, google-fluentd, adalah versi modifikasi 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 paket kustom, dan plugin output untuk Cloud Logging API.
    • Plugin output dikemas sebagai gem Ruby dan disertakan dalam paket google-fluentd. Fitur ini juga tersedia secara terpisah di layanan hosting permata Ruby di fluent-plugin-google-cloud.
    • Konten yang terkait dengan Windows Installer dapat ditemukan di folder windows-installer.
  • Repositori GitHub bernama google-fluentd-catch-all-config yang mencakup 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, di mana tag rilis mengikuti format pembuatan versi semantik [Major].[Minor].[Patch].

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

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

Kebijakan penghentian penggunaan

Agen Logging tunduk pada kebijakan penghentian agen Kemampuan observasi Google Cloud.

Langkah berikutnya