Dokumen ini menjelaskan cara cluster terpasang GKE terintegrasi dengan Cloud Logging dan menunjukkan cara mengakses log Anda.
Ringkasan
Cluster terpasang GKE mendukung Cloud Logging untuk workload dan komponen sistem yang berjalan pada worker node.
Cluster terpasang GKE menyertakan agen logging berbasis Fluentbit yang berjalan pada node pekerja sebagai Daemonset. Data yang dikumpulkan oleh agen logging dapat dikelola dan dihapus seperti data log dan metrik lainnya, seperti yang dijelaskan dalam dokumentasi Cloud Logging.
Sebelum memulai
Memenuhi prasyarat untuk cluster terpasang GKE.
Izinkan Cloud Logging dan Cloud Monitoring untuk menyiapkan izin Kemampuan Observasi Google Cloud.
Data yang dikumpulkan
Anda dapat mengonfigurasi cluster terpasang GKE untuk mengambil salah satu atau semua informasi berikut:
- Log untuk workload
Aktifkan logging
Jika Anda tidak menentukan mode logging saat memasang cluster, cluster GKE yang terpasang akan mengaktifkan logging sistem secara default. Untuk logging workload, cluster Anda harus menggunakan Kubernetes versi 1.23 atau yang lebih baru.
Untuk mengaktifkan logging workload saat memasang cluster, ikuti petunjuk
untuk melampirkan cluster yang sesuai CNCF, dan
sertakan flag --logging
opsional dalam
perintah gcloud container attached clusters register
:
gcloud container attached clusters register CLUSTER_NAME ... --logging=LOGGING_FLAG
Untuk mengaktifkan logging workload pada cluster yang sudah terpasang, ikuti
petunjuk untuk
mengupdate cluster yang sesuai CNCF, dan
sertakan flag --logging
opsional dalam
perintah gcloud container attached clusters update
:
gcloud container attached clusters update CLUSTER_NAME ... --logging=LOGGING_FLAG
Ganti LOGGING_FLAG dengan tanda yang menunjukkan jenis logging yang ingin Anda aktifkan:
NONE
: menonaktifkan logging.SYSTEM
: mengaktifkan logging workload sistem yang berjalan di namespace tertentu.SYSTEM,WORKLOAD
: mengaktifkan logging aktivitas sistem dan workload pada node pekerja cluster Anda.
Mengakses log
Ada beberapa cara untuk mengakses log cluster terpasang GKE Anda di Cloud Logging:
Logs Explorer – Anda dapat melihat log langsung dari Logs Explorer menggunakan filter logging untuk memilih resource Kubernetes, seperti cluster, node, namespace, pod, atau log container.
Google Cloud CLI – Dengan menggunakan perintah
gcloud logging read
, pilih cluster, node, pod, dan log container yang sesuai.
Memahami log Anda
Log di Cloud Logging adalah kumpulan entri log, dan setiap entri log berlaku untuk jenis resource logging tertentu.
Jenis resource
Berikut ini adalah jenis resource khusus untuk cluster terpasang GKE:
Jenis resource | Nama tampilan |
---|---|
k8s_container |
Log container workload |
Saat cluster terpasang GKE menulis log cluster Anda, setiap entri log akan menyertakan jenis resource. Memahami tempat log muncul akan memudahkan Anda menemukan log saat membutuhkannya.
Log aplikasi sistem
Log aplikasi sistem termasuk dalam jenis resource k8s_container
. Ini termasuk
log dari pod yang diinstal pada worker node oleh cluster yang terpasang GKE.
Secara khusus, container yang berjalan di namespace berikut disertakan:
gke-connect
gke-system
gmp-system
asm-user-auth
cnrm-system
config-management-system
gatekeeper-system
gmp-public
istio-system
knative-serving
Menemukan log Anda di antarmuka pengguna Cloud Logging
Anda dapat melihat log menggunakan Logs Explorer di antarmuka pengguna Cloud Logging.
Logs Explorer
Dengan Pembuat Kueri, Anda dapat membuat kueri dengan menambahkan parameter kueri secara manual. Misalnya, jika Anda ingin mempelajari log untuk workload sistem, Anda dapat memulai dengan memilih atau menelusuri jenis resource k8s_container
, lalu memilih lokasi dan nama cluster. Selanjutnya, Anda dapat mempersempit pencarian dengan memfilter container atau nama Pod.
Logs Explorer menawarkan cara tambahan untuk membuat kueri penelusuran Anda menggunakan Logs field explorer. Hal ini menunjukkan jumlah entri log, yang diurutkan berdasarkan pengurangan jumlah, untuk kolom log tertentu. Menggunakan Logs field explorer sangat berguna untuk log cluster yang terpasang oleh GKE karena menyediakan cara mudah untuk memilih nilai Kubernetes untuk resource Anda. Misalnya, Anda dapat memilih log untuk cluster, Namespace, nama Pod, dan nama container tertentu.
Untuk mengetahui informasi selengkapnya, lihat Menggunakan Logs Explorer.
Sampel kueri
Bagian ini mencakup contoh kueri yang dapat Anda buat di Logs Explorer.
Contoh 1: Dapatkan log container gke-connect-agent
untuk cluster Google Cloud CLUSTER_NAME:
resource.type="k8s_container"
resource.labels.cluster_name="attachedClusters/CLUSTER_NAME"
resource.labels.container_name="gke-connect-agent"
Langkah selanjutnya
- Ringkasan Cloud Logging
- Menggunakan Logs Explorer
- Membuat kueri untuk Cloud Logging
- Membuat metrik berbasis log