Cloud Logging

Dokumen ini menjelaskan cara GKE on Azure terintegrasi dengan Cloud Logging dan menunjukkan cara mengakses log Anda.

Ringkasan

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

GKE on Azure menyertakan agen logging berbasis Fluentbit. Di node bidang kontrol, agen logging berjalan sebagai komponen sistem; di node pool, agen logging berjalan sebagai Daemonset. Data yang dikumpulkan oleh agen logging dapat dikelola dan dihapus seperti data metrik dan log lainnya, seperti yang dijelaskan dalam dokumentasi Cloud Logging.

Data yang dikumpulkan

GKE on Azure mencatat informasi berikut:

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

Mengaktifkan logging workload

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

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

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

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

atau untuk mengupdate cluster yang ada:

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

Mengakses log Anda

Ada beberapa cara untuk mengakses log GKE on Azure Anda di Cloud Logging:

  • Logs Explorer – Anda dapat melihat log langsung dari Logs Explorer menggunakan filter logging untuk memilih resource Kubernetes, seperti log cluster, node, namespace, pod, atau container.

  • Google Cloud CLI – Menggunakan perintah gcloud logging read, pilih log cluster, node, pod, dan 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 jenis resource yang khusus untuk GKE on Azure:

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

Saat GKE on Azure menulis log cluster Anda, setiap entri log akan menyertakan jenis resource. Memahami tempat log muncul akan memudahkan Anda menemukan log saat diperlukan.

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 berada di bawah jenis resource k8s_node. Log ini mencakup log dari komponen sistem penting yang berjalan di node pekerja, seperti kubelet dan containerd.

Log aplikasi sistem

Log aplikasi sistem berada di bawah jenis resource k8s_container. Log ini mencakup log dari pod yang diinstal di node pekerja oleh GKE on Azure. 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 Query Builder, Anda dapat membuat kueri dengan menambahkan parameter kueri secara manual. Misalnya, jika ingin menjelajahi log untuk workload sistem, Anda dapat mulai dengan memilih atau menelusuri jenis resource k8s_container, lalu memilih lokasi dan nama cluster. Kemudian, Anda dapat mempersempit penelusuran dengan memfilter nama container atau Pod.

Logs Explorer menawarkan cara tambahan untuk membuat kueri penelusuran menggunakan Logs field explorer. Logs Explorer menampilkan jumlah entri log, yang diurutkan berdasarkan jumlah yang menurun, untuk kolom log tertentu. Menggunakan Logs field explorer sangat berguna untuk log GKE on Azure karena memberikan 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.

Contoh kueri

Bagian ini mencakup contoh kueri yang dapat Anda buat di Logs Explorer.

Contoh 1: Mendapatkan log kube-apiserver di node bidang kontrol untuk cluster Azure CLUSTER_NAME:

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

Contoh 2: Mendapatkan log kubelet di node pekerja untuk cluster Azure CLUSTER_NAME:

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

Contoh 3: Mendapatkan log container cilium-agent untuk cluster Azure CLUSTER_NAME:

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

Langkah berikutnya