Instalar Cloud Logging en clústeres vinculados conformes con CNCF

En este documento se describe cómo se integran los clústeres adjuntos de GKE con Cloud Logging y se explica cómo acceder a los registros.

Información general

Los clústeres adjuntos de GKE admiten Cloud Logging para las cargas de trabajo y los componentes del sistema que se ejecutan en los nodos de trabajador.

Los clústeres de GKE adjuntos incluyen un agente de registro basado en Fluentbit que se ejecuta en los nodos de trabajo como un DaemonSet. Los datos recogidos por los agentes de registro se pueden gestionar y eliminar como cualquier otro dato de métricas y registros, tal como se describe en la documentación de Cloud Logging.

Antes de empezar

  1. Cumple los requisitos previos de los clústeres de GKE adjuntos.

  2. Autoriza Cloud Logging y Cloud Monitoring para configurar los permisos de Google Cloud Observability.

Qué datos se recogen

Puedes configurar clústeres de GKE adjuntos para que registren toda la información siguiente o solo una parte:

  • Registros de cargas de trabajo

Activar el almacenamiento de registros

Si no especificas un modo de registro al adjuntar el clúster, los clústeres adjuntos de GKE habilitan el registro del sistema de forma predeterminada. Para el registro de cargas de trabajo, tu clúster debe tener la versión 1.23 de Kubernetes o una posterior.

Para habilitar el registro de cargas de trabajo al adjuntar un clúster, sigue las instrucciones para adjuntar tu clúster conforme a CNCF e incluye la marca opcional --logging en el comando gcloud container attached clusters register:

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

Para habilitar el registro de cargas de trabajo en un clúster que ya esté conectado, sigue las instrucciones para actualizar tu clúster conforme a CNCF e incluye la marca opcional --logging en el comando gcloud container attached clusters update:

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

Sustituye LOGGING_FLAG por una marca que indique el tipo de registro que quieras habilitar:

  • NONE: inhabilita el registro.
  • SYSTEM: habilita el registro de las cargas de trabajo del sistema que se ejecutan en espacios de nombres específicos.
  • SYSTEM,WORKLOAD: habilita el registro de la actividad del sistema y de las cargas de trabajo en los nodos de trabajo de tu clúster.

Acceder a tus registros

Hay varias formas de acceder a los registros de los clústeres de GKE adjuntos en Cloud Logging:

  • Explorador de registros: puedes ver tus registros directamente desde el Explorador de registros mediante los filtros de registro para seleccionar los recursos de Kubernetes, como los registros de clústeres, nodos, espacios de nombres, pods o contenedores.

  • CLI de Google Cloud: usa el comando gcloud logging read para seleccionar los registros del clúster, el nodo, el pod y el contenedor correspondientes.

Interpretar los registros

Un registro de Cloud Logging es una colección de entradas de registro, y cada entrada de registro se aplica a un tipo concreto de recurso de registro.

Tipos de recursos

Estos son los tipos de recursos específicos de los clústeres de GKE adjuntos:

Tipo de recurso Nombre visible
k8s_container Registros de contenedores de cargas de trabajo

Cuando los clústeres adjuntos de GKE escriben los registros de tu clúster, cada entrada de registro incluye el tipo de recurso. Si sabes dónde aparecen los registros, te resultará más fácil encontrarlos cuando los necesites.

Registros de aplicaciones del sistema

Los registros de aplicaciones del sistema se incluyen en el tipo de recurso k8s_container. Esto incluye los registros de los pods instalados en los nodos de trabajo por los clústeres de GKE vinculados. En concreto, se incluyen los contenedores que se ejecutan en los siguientes espacios de nombres:

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

Buscar registros en la interfaz de usuario de Cloud Logging

Puedes ver tus registros con el Explorador de registros de la interfaz de usuario de Cloud Logging.

Explorador de registros

Con Query Builder, puedes crear una consulta añadiendo parámetros de consulta manualmente. Por ejemplo, si quieres consultar los registros de las cargas de trabajo del sistema, puedes empezar seleccionando o buscando el tipo de recurso k8s_container y, a continuación, seleccionar la ubicación y el nombre del clúster. A continuación, puedes acotar la búsqueda filtrando los nombres de los contenedores o de los pods.

El explorador de registros ofrece otra forma de crear consultas de búsqueda mediante el explorador de campos de registro. Muestra el número de entradas de registro, ordenadas de mayor a menor, del campo de registro correspondiente. El explorador de campos de registro es especialmente útil para los registros de clústeres adjuntos de GKE, ya que proporciona una forma sencilla de seleccionar los valores de Kubernetes de tus recursos. Por ejemplo, puedes seleccionar los registros de un clúster, un espacio de nombres, un nombre de pod y un nombre de contenedor específicos.

Para obtener más información, consulta el artículo sobre cómo usar el Explorador de registros.

Consultas de ejemplo

En esta sección se incluyen consultas de ejemplo que puedes hacer en el explorador de registros.

Ejemplo 1: Obtener los registros del contenedor gke-connect-agent de un clústerGoogle Cloud CLUSTER_NAME:

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

Siguientes pasos