Ringkasan agen Logging

Ini adalah agen lama. Meskipun agen ini masih didukung, sebaiknya jangan gunakan 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.

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

Dalam konfigurasi default-nya, 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.

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

Untuk menginstal agen Logging, lihat Menginstal agen Logging.

Sistem operasi yang didukung

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

• CentOS 7 dan 8
• Rocky Linux 8
• Red Hat Enterprise Linux 7 dan 8
• Debian 9 "Stretch", 10 "Buster", dan 11 "Bullseye"
• Ubuntu LTS 20.04 (Focal 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 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 mengirim 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.

  Catatan:

  Penggunaan metrik AWS CloudWatch dalam project Konektor di Cloud Monitoring tidak digunakan lagi pada 21 Agustus 2023 dan tidak lagi didukung. Pada 21 Agustus 2024, project AWS Connector yang ada dinonaktifkan dan penyerapan metrik dihentikan. Untuk informasi selengkapnya tentang perubahan ini, lihat Penghentian: Metrik AWS CloudWatch dalam project Connector.

  Agen Pemantauan lama dan agen Logging lama di Amazon Elastic Compute Cloud (Amazon EC2) masih didukung dan tidak tidak digunakan lagi.

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

Catatan: Agen Logging standar tidak didukung di mesin on-premise. Namun, Google Distributed Cloud dilengkapi dengan versi agen yang sudah diinstal dan siap digunakan.

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

Instance VM berikut mendukung Logging menggunakan software sendiri, sehingga menginstal agen Logging secara manual di VM 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 merupakan tambahan dari yang disertakan dalam lingkungan standar App Engine. Untuk 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 informasinya, 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 Mencatat dan melihat log.

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

Dukungan untuk cloud lokal dan hybrid

Google Cloud berpartner dengan observIQ untuk menyediakan layanan logging bagi platform cloud lokal dan hybrid dengan cara yang konsisten dan dapat diprediksi. Dengan BindPlane, Anda dapat mengumpulkan data sendiri dan mengirimnya ke Logging untuk dianalisis. BindPlane terintegrasi dengan Cloud Logging untuk mengambil data dari infrastruktur Anda dan disertakan dengan project Anda tanpa biaya tambahan.

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

Persyaratan akses agen

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

• Server token OAuth2: oauth2.googleapis.com

  Agen versi 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 ke versi terbaru.

• Logging API: logging.googleapis.com

Untuk menginstal agen, Anda 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 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 yang dimodifikasi 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 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 berawalan Windows.

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

Kebijakan penghentian layanan

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

Langkah berikutnya

• Menginstal agen Logging

• Mengonfigurasi agen Logging

• Memberi otorisasi pada agen Logging

• Mengupgrade agen Logging

• Setelah menginstal agen, lihat log Anda di Logs Explorer.