Registro en la nube

Este documento describe cómo GKE en Azure se integra con Cloud Logging y le muestra cómo acceder a sus registros.

Descripción general

GKE en Azure admite el registro en la nube para cargas de trabajo y para componentes del sistema que se ejecutan en el plano de control y en los nodos del grupo de nodos.

GKE en Azure incluye un agente de registro basado en Fluentbit . En los nodos del plano de control, el agente de registro se ejecuta como un componente del sistema; en los nodos del grupo de nodos, como un Daemonset. Los datos recopilados por los agentes de registro se pueden administrar y eliminar como cualquier otra métrica o dato de registro, como se describe en la documentación de Cloud Logging .

¿Qué datos se recopilan?

GKE en Azure registra la siguiente información:

• Registros de los componentes del sistema en cada una de las réplicas del plano de control.
• Registros de los servicios del sistema en cada uno de los nodos del grupo de nodos.
• Opcionalmente, registros de cargas de trabajo

Habilitar el registro de carga de trabajo

Para habilitar el registro de carga de trabajo, debe crear un nuevo clúster de Kubernetes, versión 1.22 o posterior.

De forma predeterminada, al crear un clúster, GKE en Azure habilita el registro del sistema. Para habilitar el registro de cargas de trabajo, debe crear un clúster con la marca --logging . Puede habilitar el registro para los componentes del sistema, las cargas de trabajo o ambos.

Por ejemplo, para habilitar el registro del sistema y de la carga de trabajo en un nuevo clúster, siga las instrucciones para crear un clúster , pero incluya el indicador --logging en su comando gcloud :

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

o para actualizar un clúster existente :

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

Acceda a sus registros

Hay varias formas de acceder a sus registros de GKE en Azure en Cloud Logging:

• Explorador de registros : puede ver sus registros directamente desde el Explorador de registros utilizando los filtros de registro para seleccionar los recursos de Kubernetes, como registros de clúster, nodo, espacio de nombres, pod o contenedor.

• CLI de Google Cloud : con el comando gcloud logging read , seleccione los registros de clúster, nodo, pod y contenedor adecuados.

Entendiendo sus registros

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

Tipos de recursos

Estos son los tipos de recursos que son específicos de GKE en Azure:

Cuando GKE en Azure escribe los registros del clúster, cada entrada incluye el tipo de recurso. Comprender dónde aparecen los registros facilita encontrarlos cuando los necesita.

Registros del plano de control

Los registros del plano de control utilizan el tipo de recurso k8s_control_plane_component . Estos incluyen registros de los componentes del sistema que se ejecutan en las réplicas del plano de control, como kube-apiserver .

Registros de nodos

Los registros de nodo pertenecen al tipo de recurso k8s_node . Incluyen registros de componentes críticos del sistema que se ejecutan en los nodos de trabajo, como kubelet y containerd .

Registros de aplicaciones del sistema

Los registros de las aplicaciones del sistema pertenecen al tipo de recurso k8s_container . Incluyen los registros de los pods instalados por GKE en Azure en los nodos de trabajo. En concreto, se incluyen los contenedores que se ejecutan en los siguientes espacios de nombres:

• kube-system

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

Encuentre sus registros en la interfaz de usuario de Cloud Logging

Puede ver sus registros utilizando el Explorador de registros en la interfaz de usuario de Cloud Logging.

Explorador de registros

Con el Generador de consultas, puede crear una consulta añadiendo parámetros manualmente. Por ejemplo, si desea explorar los registros de las cargas de trabajo del sistema, puede empezar seleccionando o buscando el tipo de recurso k8s_container y, a continuación, seleccionar la ubicación y el nombre del clúster. Después, puede refinar la búsqueda filtrando los nombres de los contenedores o pods.

El Explorador de registros ofrece una forma adicional de crear consultas de búsqueda mediante el explorador de campos de registros . Muestra el número de entradas de registro, ordenadas de mayor a menor, para el campo de registro especificado. Usar el explorador de campos de registros es especialmente útil para GKE en registros de Azure, ya que facilita la selección de valores de Kubernetes para los recursos. Por ejemplo, puede 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, consulte Uso del Explorador de registros .

Consultas de muestra

Esta sección incluye consultas de muestra que puede realizar en el Explorador de registros.

Ejemplo 1: Obtener los registros de kube-apiserver en los nodos del plano de control para un clúster de Azure CLUSTER_NAME :

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

Ejemplo 2: Obtener los registros de kubelet en los nodos de trabajo para un clúster de Azure CLUSTER_NAME :

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

Ejemplo 3: Obtener los registros del contenedor cilium-agent para un clúster de Azure CLUSTER_NAME :

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

¿Qué sigue?

• Descripción general del registro en la nube
• Uso del explorador de registros
• Creación de consultas para Cloud Logging
• Crear métricas basadas en registros