Cloud Logging

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

Ringkasan

GKE di Azure mendukung Cloud Logging untuk beban kerja dan untuk komponen sistem yang berjalan di node 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 kumpulan node, agen logging 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 on Azure 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

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 di Azure akan mengaktifkan logging sistem. Untuk mengaktifkan logging beban kerja, Anda harus membuat cluster dengan tanda --logging. Anda dapat memilih untuk mengaktifkan logging untuk komponen sistem, workload, atau keduanya.

Misalnya, untuk mengaktifkan logging sistem dan beban kerja di cluster baru, ikuti petunjuk untuk membuat cluster, tetapi sertakan tanda --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 di Azure di Cloud Logging:

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

  • Google Cloud CLI – Dengan 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 adalah jenis resource yang khusus untuk GKE di 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 di Azure menulis log cluster Anda, setiap entri log menyertakan jenis resource. Memahami tempat log muncul akan mempermudah Anda menemukan log saat Anda membutuhkannya.

Log Bidang Kontrol

Log bidang kontrol menggunakan jenis resource k8s_control_plane_component. Hal 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. Hal ini mencakup log dari komponen sistem penting yang berjalan di worker node, seperti kubelet dan containerd.

Log aplikasi sistem

Log aplikasi sistem termasuk dalam jenis resource k8s_container. Log ini mencakup log dari pod yang diinstal pada node pekerja oleh GKE di 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 menggunakan Pembuat Kueri, Anda dapat membuat kueri dengan menambahkan parameter kueri secara manual. Misalnya, jika Anda ingin menjelajahi log untuk beban kerja sistem, Anda dapat memulai dengan memilih atau menelusuri jenis resource k8s_container, lalu memilih lokasi dan nama cluster. Kemudian, Anda dapat menyaring penelusuran dengan memfilter nama container atau Pod.

Logs Explorer menawarkan cara tambahan untuk membuat kueri penelusuran menggunakan Penjelajah kolom log. Bagian ini menunjukkan jumlah entri log, yang diurutkan berdasarkan jumlah yang menurun, untuk kolom log tertentu. Penggunaan Penjelajah kolom log sangat berguna untuk log GKE di Azure karena memberikan cara mudah untuk memilih nilai Kubernetes bagi 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 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: Dapatkan 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: Dapatkan 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