Installa Cloud Logging su cluster collegati conformi a CNCF

Questo documento descrive come i cluster collegati a GKE si integrano con Cloud Logging e mostra come accedere ai log.

Panoramica

I cluster collegati a GKE supportano Cloud Logging per carichi di lavoro e componenti di sistema in esecuzione sui nodi worker.

I cluster collegati a GKE includono un agente di logging basato su Fluentbit che viene eseguito sui nodi worker come Daemonset. I dati raccolti dagli agenti Logging possono essere gestiti ed eliminati come qualsiasi altra metrica e dato di log, come descritto nella documentazione di Cloud Logging.

Prima di iniziare

  1. Soddisfa i prerequisiti per i cluster collegati a GKE.

  2. Autorizza Cloud Logging e Cloud Monitoring per configurare le autorizzazioni per l'osservabilità di Google Cloud.

Quali dati vengono raccolti

Puoi configurare i cluster collegati a GKE per acquisire una o tutte le seguenti informazioni:

  • Log per i carichi di lavoro

Abilita il logging

Se non specifichi una modalità di logging quando colleghi il cluster, i cluster collegati a GKE abilita il logging di sistema per impostazione predefinita. Per il logging dei carichi di lavoro, nel cluster deve essere in Kubernetes la versione 1.23 o successiva.

Per abilitare il logging dei carichi di lavoro quando colleghi un cluster, segui le istruzioni per collegare il cluster conforme a CNCF e includi il flag --logging facoltativo nel comando gcloud container attached clusters register:

gcloud container attached clusters register CLUSTER_NAME
...
--logging=LOGGING_FLAG

Per abilitare il logging dei carichi di lavoro su un cluster già collegato, segui le istruzioni per aggiornare il cluster conforme a CNCF e includi il flag --logging facoltativo nel comando gcloud container attached clusters update:

gcloud container attached clusters update CLUSTER_NAME
...
--logging=LOGGING_FLAG

Sostituisci LOGGING_FLAG con un flag che indica il tipo di logging che vuoi attivare:

  • NONE: disabilita il logging.
  • SYSTEM: abilita il logging dei carichi di lavoro di sistema in esecuzione in spazi dei nomi specifici.
  • SYSTEM,WORKLOAD: abilita il logging delle attività del sistema e dei carichi di lavoro sui nodi worker del tuo cluster.

Accedi ai tuoi log

Esistono diversi modi per accedere ai log dei cluster collegati a GKE in Cloud Logging:

  • Esplora log: puoi visualizzare i log direttamente da Esplora log utilizzando i filtri di logging per selezionare le risorse Kubernetes, come i log di cluster, nodo, spazio dei nomi, pod o container.

  • Google Cloud CLI: utilizzando il comando gcloud logging read, seleziona i log appropriati per cluster, nodo, pod e container.

Interpretazione dei log

Un log in Cloud Logging è una raccolta di voci di log e ogni voce di log si applica a un determinato tipo di risorsa di log.

Tipi di risorse

Questi sono i tipi di risorse specifici dei cluster collegati a GKE:

Tipo di risorsa Nome visualizzato
k8s_container Log dei container per carichi di lavoro

Quando i cluster collegati a GKE scrivono i log del tuo cluster, ogni voce di log include il tipo di risorsa. Capire dove vengono visualizzati i log semplifica il reperimento dei log quando ne hai bisogno.

Log delle app di sistema

I log delle app di sistema rientrano nel tipo di risorsa k8s_container. Questi includono i log dei pod installati sui nodi worker dai cluster collegati a GKE. In particolare, sono inclusi i container in esecuzione nei seguenti spazi dei nomi:

  • gke-connect
  • gke-system
  • gmp-system
  • asm-user-auth
  • cnrm-system
  • config-management-system
  • gatekeeper-system
  • gmp-public
  • istio-system
  • knative-serving

Trova i log nell'interfaccia utente di Cloud Logging

Puoi visualizzare i log utilizzando Esplora log nell'interfaccia utente di Cloud Logging.

Esplora log

Utilizzando Query Builder, puoi creare una query aggiungendo manualmente parametri di ricerca. Ad esempio, se vuoi esplorare i log per i carichi di lavoro di sistema, puoi iniziare selezionando o cercando il tipo di risorsa k8s_container, per poi selezionare la località e il nome del cluster. Puoi quindi perfezionare la ricerca filtrando i nomi dei container o dei pod.

Esplora log offre un modo aggiuntivo per creare le query di ricerca utilizzando l'esplorazione campi Log. Mostra il numero delle voci di log, ordinate in base al numero decrescente, per il campo di log specificato. L'utilizzo dell'Explorer campi dei log è particolarmente utile per i log dei cluster collegati a GKE, in quanto fornisce un modo semplice per selezionare i valori Kubernetes per le tue risorse. Ad esempio, puoi selezionare i log per un cluster specifico, lo spazio dei nomi, il nome del pod e il nome del container.

Per ulteriori informazioni, consulta Utilizzo di Esplora log.

Query di esempio

Questa sezione include query di esempio che puoi eseguire in Esplora log.

Esempio 1: recupera i log del container gke-connect-agent per un cluster Google Cloud CLUSTER_NAME:

resource.type="k8s_container"
resource.labels.cluster_name="attachedClusters/CLUSTER_NAME"
resource.labels.container_name="gke-connect-agent"

Passaggi successivi