Cloud Logging

Ce document décrit l'intégration de GKE sur AWS à Cloud Logging et vous explique comment accéder à vos journaux.

Présentation

GKE sur AWS est compatible avec Cloud Logging pour les charges de travail et pour les composants système exécutés sur des nœuds de plan de contrôle et de pool de nœuds.

GKE sur AWS inclut un agent de journalisation basé sur Fluentbit. Sur les nœuds du plan de contrôle, l'agent de journalisation s'exécute en tant que composant système. Sur les nœuds du pool de nœuds, il s'exécute en tant que Daemonset. Les données collectées par les agents de journalisation peuvent être gérées et supprimées comme toute autre donnée de métrique et de journal, comme décrit dans la documentation de Cloud Logging.

Quelles sont les données recueillies ?

GKE sur AWS enregistre les informations suivantes:

  • Les journaux des composants système sur chacune des instances dupliquées du plan de contrôle.
  • Les journaux des services système sur chacun des nœuds du pool de nœuds.
  • Les journaux des charges de travail (facultatif).

Activer la journalisation de la charge de travail

Pour activer la journalisation des charges de travail, vous devez créer un cluster Kubernetes version 1.22 ou ultérieure.

Par défaut, lorsque vous créez un cluster, GKE sur AWS active la journalisation du système. Pour activer la journalisation des charges de travail, vous devez créer un cluster avec l'option --logging. Vous pouvez choisir d'activer la journalisation pour les composants système, les charges de travail, ou les deux.

Par exemple, pour activer la journalisation du système et de la charge de travail sur un nouveau cluster, suivez les instructions pour créer un cluster, mais incluez l'option --logging dans votre commande gcloud:

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

ou pour mettre à jour un cluster existant:

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

Accéder à vos journaux

Il existe plusieurs façons d'accéder à vos journaux GKE sur AWS dans Cloud Logging:

  • Explorateur de journaux : vous pouvez afficher vos journaux directement à partir de l'explorateur de journaux en utilisant les filtres de journalisation pour sélectionner les ressources Kubernetes telles que le cluster, le nœud, l'espace de noms, le pod ou le conteneur.

  • Google Cloud CLI : à l'aide de la commande gcloud logging read, sélectionnez les journaux de cluster, de nœud, de pod et de conteneur appropriés.

Comprendre vos journaux

Un journal Cloud Logging est un ensemble d'entrées de journal. Chaque entrée de journal s'applique à un certain type de ressource de journalisation.

Types de ressources

Voici les types de ressources propres à GKE sur AWS:

Type de ressource Nom à afficher
k8s_control_plane_component Journaux des composants du plan de contrôle
k8s_node Journaux du pool de nœuds
k8s_container Journaux des conteneurs de charge de travail

Lorsque GKE sur AWS écrit les journaux de votre cluster, chaque entrée de journal inclut le type de ressource. Comprendre où les journaux apparaissent permet de les retrouver plus facilement lorsque vous en avez besoin.

Journaux du plan de contrôle

Les journaux du plan de contrôle utilisent le type de ressource k8s_control_plane_component. Il s'agit, entre autres, des journaux des composants système exécutés sur les instances dupliquées du plan de contrôle, tels que kube-apiserver.

Journaux de nœuds

Les journaux de nœuds appartiennent au type de ressource k8s_node. Il s'agit, entre autres, des journaux des composants système critiques exécutés sur les nœuds de calcul, tels que kubelet et containerd.

Journaux d'applications système

Les journaux des applications système appartiennent au type de ressource k8s_container. Ceux-ci incluent les journaux des pods installés sur les nœuds de calcul par GKE sur AWS. Plus précisément, les conteneurs s'exécutant dans les espaces de noms suivants sont inclus :

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

Rechercher vos journaux dans l'interface utilisateur Cloud Logging

Vous pouvez afficher vos journaux à l'aide de l'explorateur de journaux de l'interface utilisateur de Cloud Logging.

Explorateur de journaux

À l'aide du générateur de requêtes, vous pouvez créer une requête en ajoutant manuellement des paramètres de requête. Par exemple, si vous souhaitez explorer les journaux des charges de travail du système, vous pouvez commencer par sélectionner ou rechercher le type de ressource k8s_container, puis sélectionner l'emplacement et le nom du cluster. Vous pouvez ensuite affiner votre recherche en filtrant les noms des conteneurs ou des pods.

L'explorateur de journaux constitue un moyen supplémentaire de créer des requêtes de recherche à l'aide de l'explorateur de champs de journaux. Celui-ci indique le nombre d'entrées de journal, triées par nombre décroissant, pour le champ de journal donné. L'explorateur de champs de journaux est particulièrement utile pour les journaux GKE sur AWS, car il permet de sélectionner facilement les valeurs Kubernetes pour vos ressources. Par exemple, vous pouvez sélectionner les journaux pour un cluster, un espace de noms, un nom de pod et un nom de conteneur spécifiques.

Pour en savoir plus, consultez la page Utiliser l'explorateur de journaux.

Exemples de requêtes

Cette section inclut des exemples de requêtes que vous pouvez effectuer dans l'explorateur de journaux.

Exemple 1 : Obtenir les journaux de kube-apiserver sur les nœuds du plan de contrôle pour un cluster AWS CLUSTER_NAME :

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

Exemple 2 : Obtenir les journaux de kubelet sur les nœuds de calcul pour un cluster AWS CLUSTER_NAME :

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

Exemple 3 : Obtenir les journaux du conteneur cilium-agent pour un cluster AWS CLUSTER_NAME :

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

Étapes suivantes