Panduan ini memberikan informasi dasar tentang agen Logging, yaitu aplikasi berbasis fluentd yang berjalan di instance virtual machine (VM) Anda.
Dalam konfigurasi defaultnya, agen Logging mengalirkan log dari aplikasi pihak ketiga dan software sistem umum 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.
Praktik terbaiknya adalah menjalankan 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:
- Rocky Linux 8
- RHEL 8: rhel-8-6-sap-ha, rhel-8-8-sap-ha
- 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.
Untuk instance VM ini, diperlukan memori residen (RSS) minimal 250 MiB untuk menjalankan agen Logging, tetapi direkomendasikan 1 GiB. Misalnya, pada kecepatan 100 entri log berukuran 1 KB per detik, agen Logging dengan konfigurasi default menggunakan 5% CPU pada satu core dan memori 150 MiB.
Dukungan untuk cloud lokal dan hybrid
Google Cloud bermitra dengan Bindplane untuk menyediakan layanan logging bagi platform cloud lokal dan hybrid secara konsisten dan dapat diprediksi. Dengan Bindplane, Anda dapat mengumpulkan data 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 mengetahui informasi selengkapnya tentang Bindplane dan Bindplane, lihat Tentang Bindplane dan Bindplane.
Persyaratan akses agen
Menjalankan agen memerlukan akses ke nama DNS berikut:
Server token OAuth2:
oauth2.googleapis.comVersi 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.comServer download Google:
dl.google.com
Lingkungan terkelola yang tidak didukung
Instance VM berikut mendukung Logging menggunakan software-nya sendiri, sehingga penginstalan 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 selain 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 container 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 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 Melakukan logging dan melihat log.
Fungsi HTTP dan latar belakang Cloud Run Functions. Cloud Run Functions menyertakan dukungan bawaan untuk Logging.
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-fluentdyang mencakup programfluentdinti, skrip pengemasan kustom, dan plugin output untuk Cloud Logging API.- Plugin output dipaketkan sebagai Ruby gem dan disertakan dalam paket
google-fluentd. Plugin ini juga tersedia secara terpisah di layanan hosting Ruby gem di fluent-plugin-google-cloud. - Konten yang terkait dengan penginstal Windows dapat ditemukan di folder windows-installer.
- Plugin output dipaketkan sebagai Ruby gem dan disertakan dalam paket
- Repositori GitHub bernama
google-fluentd-catch-all-configyang menyertakan file konfigurasi untuk agen Logging guna menyerap log dari berbagai paket software pihak ketiga.
Catatan rilis agen Logging
Catatan rilis untuk paket Linux
google-fluentddapat ditemukan digoogle-fluentd/releases, dengan tag rilis mengikuti format pembuatan versi semantik[Major].[Minor].[Patch].Catatan rilis untuk penginstal Windows dapat ditemukan di lokasi yang sama:
google-fluentd/releases. Namun, tag rilis diawali denganWindows.Catatan rilis untuk gem mandiri
fluent-plugin-google-clouddapat ditemukan difluent-plugin-google-cloud/releases, dengan tag rilis mengikuti format pembuatan versi semantik[Major].[Minor].[Patch].
Kebijakan penghentian layanan
Agen Logging tunduk pada kebijakan penghentian layanan agen Google Cloud Observability.
Langkah berikutnya
Setelah menginstal agen, lihat log Anda di Logs Explorer.