En este documento, se describe cómo los clústeres conectados de GKE se integran en Cloud Logging y se muestra cómo acceder a tus registros.
Descripción general
Los clústeres conectados de GKE admiten Cloud Logging para las cargas de trabajo y los componentes del sistema que se ejecutan en nodos trabajadores.
Los clústeres conectados de GKE incluyen un agente de Logging basado en Fluentbit que se ejecuta en los nodos trabajadores como un Daemonset. Los datos recopilados por los agentes de registro se pueden administrar y borrar como cualquier otra métrica y datos de registro, como se describe en la documentación de Cloud Logging.
Antes de comenzar
Cumple con los requisitos previos para los clústeres conectados de GKE.
Autoriza Cloud Logging y Cloud Monitoring para configurar los permisos de observabilidad de Google Cloud.
Qué datos se recopilan
Puedes configurar clústeres conectados de GKE para capturar parte o la totalidad de la siguiente información:
- Registros para cargas de trabajo
Habilitar registro
Si no especificas un modo de registro cuando conectas tu clúster, los clústeres conectados a 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 o posterior de Kubernetes.
Si quieres habilitar el registro de cargas de trabajo cuando conectas un clúster, sigue las instrucciones para conectar el clúster de AKS y, luego, incluye la marca opcional --logging
en el comando gcloud container attached clusters register
:
gcloud container attached clusters register CLUSTER_NAME ... --logging=LOGGING_FLAG
Si quieres habilitar el registro de cargas de trabajo en un clúster que ya está conectado, sigue las instrucciones para actualizar el clúster de AKS y, luego, incluye la marca opcional --logging
en el comando gcloud container attached clusters update
:
gcloud container attached clusters update CLUSTER_NAME ... --logging=LOGGING_FLAG
Reemplaza LOGGING_FLAG por una marca que indique qué tipo de registro deseas 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 la carga de trabajo en los nodos trabajadores del clúster.
Accede a tus registros
Hay varias formas de acceder a los registros de los clústeres conectados de GKE en Cloud Logging:
Explorador de registros: Puedes ver tus registros directamente desde el Explorador de registros. Para ello, usa los filtros de registro para seleccionar los recursos de Kubernetes, como los registros de clústeres, nodos, espacios de nombres, pods o registros de contenedores.
Google Cloud CLI: con el comando
gcloud logging read
, selecciona el clúster, el nodo, el Pod y los registros del contenedor adecuados.
Obtén información sobre tus registros
Un registro en Cloud Logging es una colección de entradas de registro y cada una se aplica a un tipo determinado de recurso de registro.
Tipos de recursos
Estos son los tipos de recursos específicos de los clústeres conectados a GKE:
Tipo de recurso | Nombre visible |
---|---|
k8s_container |
Registros de contenedores de cargas de trabajo |
Cuando los clústeres conectados de GKE escriben los registros de tu clúster, cada entrada de registro incluye el tipo de recurso. Saber dónde aparecen los registros facilita su búsqueda cuando los necesitas.
Registros de apps del sistema
Los registros de las apps del sistema corresponden al tipo de recurso k8s_container
. Estas incluyen registros de Pods que los clústeres conectados de GKE instalaron en los nodos trabajadores.
En particular, 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
Busca tus registros en la interfaz de usuario de Cloud Logging
Puedes ver tus registros con el Explorador de registros en la interfaz de usuario de Cloud Logging.
Explorador de registros
Con el compilador de consultas, puedes compilar una consulta si agregas parámetros de consulta de forma manual. Por ejemplo, si deseas explorar los registros de las cargas de trabajo del sistema, puedes comenzar a seleccionar o buscar el tipo de recurso de k8s_container
y, luego, seleccionar la ubicación y el nombre del clúster. Luego, puedes definir mejor la búsqueda si filtras los nombres del contenedor o del Pod.
El explorador de registros ofrece una forma adicional de compilar consultas de búsqueda mediante el Explorador del campo de registro. Muestra el recuento de entradas de registro, ordenadas de forma descendente, para el campo de registro dado. El uso del explorador del campo de registro es particularmente útil para los registros de clústeres conectados de GKE, ya que proporciona una manera fácil de seleccionar los valores de Kubernetes para tus recursos. Por ejemplo, puedes seleccionar registros para 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 Usa el Explorador de registros.
Consultas de muestra
En esta sección, se incluyen consultas de muestra que puedes realizar en el Explorador de registros.
Ejemplo 1: Obtén los registros del contenedor gke-connect-agent
para un clúster de Google Cloud CLUSTER_NAME:
resource.type="k8s_container"
resource.labels.cluster_name="attachedClusters/CLUSTER_NAME"
resource.labels.container_name="gke-connect-agent"
¿Qué sigue?
- Descripción general de Cloud Logging
- Usar el Explorador de registros
- Cómo compilar consultas para Cloud Logging
- Crea métricas basadas en registros