Menginstal Cloud Logging di cluster terpasang yang sesuai dengan CNCF

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

  1. Memenuhi prasyarat untuk cluster terpasang GKE.

  2. 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