Cloud Logging

Dokumen ini menjelaskan cara GKE di AWS terintegrasi dengan Cloud Logging dan menunjukkan cara mengakses log Anda.

Ringkasan

GKE di AWS mendukung Cloud Logging untuk workload dan komponen sistem yang berjalan di node pool dan bidang kontrol.

GKE di AWS mencakup agen logging berbasis Fluentbit. Pada node bidang kontrol, agen logging dijalankan sebagai komponen sistem; sedangkan pada node kumpulan node, agen ini berjalan 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.

Data yang dikumpulkan

GKE di AWS mencatat informasi berikut:

  • Log untuk komponen sistem di setiap replika bidang kontrol.
  • Log untuk layanan sistem di setiap node kumpulan node.
  • Secara opsional, log untuk workload

Aktifkan logging workload

Untuk mengaktifkan logging beban kerja, Anda harus membuat cluster Kubernetes baru, versi 1.22 atau yang lebih baru.

Secara default, saat Anda membuat cluster GKE di AWS akan mengaktifkan logging sistem. Untuk mengaktifkan logging workload, Anda harus membuat cluster dengan flag --logging. Anda dapat memilih untuk mengaktifkan logging komponen sistem, beban kerja, atau keduanya.

Misalnya, untuk mengaktifkan logging sistem dan beban kerja di cluster baru, ikuti petunjuk untuk membuat cluster, tetapi sertakan flag --logging dalam perintah gcloud Anda:

gcloud container aws clusters create CLUSTER_NAME
...
--logging=SYSTEM,WORKLOAD

atau untuk mengupdate cluster yang ada:

gcloud container aws clusters update CLUSTER_NAME
...
--logging=SYSTEM,WORKLOAD

Mengakses log

Ada beberapa cara untuk mengakses GKE Anda di log AWS 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 adalah jenis resource khusus untuk GKE di AWS:

Jenis resource Nama tampilan
k8s_control_plane_component Log komponen bidang kontrol
k8s_node Log kumpulan node
k8s_container Log container workload

Saat GKE di AWS menulis log cluster Anda, setiap entri log akan menyertakan jenis resource. Memahami tempat log muncul akan memudahkan Anda menemukan log saat membutuhkannya.

Log Bidang Kontrol

Log bidang kontrol menggunakan jenis resource k8s_control_plane_component. Log ini mencakup log dari komponen sistem yang berjalan di replika bidang kontrol, seperti kube-apiserver.

Log node

Log node termasuk dalam jenis resource k8s_node. Daftar ini mencakup log dari komponen sistem penting yang berjalan pada node pekerja, seperti kubelet dan containerd.

Log aplikasi sistem

Log aplikasi sistem termasuk dalam jenis resource k8s_container. Daftar ini mencakup log dari pod yang diinstal pada worker node oleh GKE di AWS. Secara khusus, container yang berjalan di namespace berikut disertakan:

  • kube-system
  • 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 GKE pada log AWS 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 kube-apiserver pada node bidang kontrol untuk cluster AWS CLUSTER_NAME:

resource.type="k8s_control_plane_component"
resource.labels.cluster_name="awsClusters/CLUSTER_NAME"
resource.labels.component_name="apiserver"

Contoh 2: Dapatkan log kubelet pada node pekerja untuk cluster AWS CLUSTER_NAME:

resource.type="k8s_node"
resource.labels.cluster_name="awsClusters/CLUSTER_NAME"
log_name="projects/PROJECT_ID/logs/kubelet"

Contoh 3: Dapatkan log container cilium-agent untuk cluster AWS CLUSTER_NAME:

resource.type="k8s_container"
resource.labels.cluster_name="awsClusters/CLUSTER_NAME"
resource.labels.container_name="cilium-agent"

Langkah selanjutnya