Ve registros de GKE

En esta página, se proporciona una descripción general de cómo encontrar y usar los registros de Google Kubernetes Engine (GKE).

Accede a tus registros

Puedes acceder a los registros de GKE de muchas maneras:

  • En la consola de Google Cloud, puedes ver los registros de las siguientes páginas:

    • Kubernetes Engine:

      • Selecciona un clúster en la página Clústeres y, luego, la pestaña Registros. En esta pestaña, también se ofrecen consultas sugeridas para los registros del clúster.
      • Selecciona una carga de trabajo en la página Carga de trabajo. Luego, puedes hacer clic en los vínculos Registros de contenedor o Registros de auditoría en la pestaña Descripción general para ver tus registros en el Explorador de registros o selecciona la pestaña Registros para ver tus registros en contexto.

    • Logging: selecciona Explorador de registros y, luego, usa filtros de registro para seleccionar los recursos de Kubernetes, como clústeres, nodos, espacio de nombres, Pod o registros de contenedores. Si quieres ver ejemplos de consultas que te ayudarán a comenzar, consulta Consultas relacionadas con Kubernetes.

    • Monitoring: los paneles de GKE muestran métricas y registros para los recursos de GKE, como clústeres, nodos y Pods. Para obtener más información, consulta Visualiza métricas de observabilidad.

  • En Google Cloud CLI: consulta los registros de los clústeres, los nodos, los Pods y los contenedores mediante el comando gcloud logging read.

Para la agregación de registros personalizados, las estadísticas de registros o la integración en sistemas de terceros, también puedes usar la función de receptores de registros a fin de exportar registros a BigQuery, Cloud Storage y Pub/Sub.

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 de GKE:

Tipo de recurso Nombre visible
k8s_cluster Registros de clústeres de Kubernetes
k8s_node Registros del grupo de nodos de GKE
k8s_pod Registros de los Pods de GKE
k8s_container Registros de contenedores de GKE
k8s_control_plane_component Componente del plano de control de Kubernetes

Cuando GKE escribe los registros de tu clúster, cada entrada de registro incluye el tipo de recurso. Comprender dónde aparecen tus registros facilita su búsqueda cuando los necesitas.

Registros del sistema

Estos registros incluyen registros de auditoría del clúster, incluidos el registro de actividad del administrador, el registro de acceso a los datos y el registro de acontecimientos.

Se capturan los registros del sistema de los siguientes tipos de recursos:

  • registros del clúster con k8s_cluster

  • registros del nodo con k8s_node

  • Pod con k8s_pod

  • apps del sistema con k8s_container

Los registros de auditoría del sistema aparecerán en Cloud Logging con los siguientes nombres:

  • projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fdata_access – Registros de acceso de datos

  • projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Factivity - Registros de actividad del administrador

  • projects/PROJECT_ID/logs/events – Registros de eventos

Para obtener más información sobre las entradas de registro que se aplican a los tipos de recursos de las operaciones con clústeres de Kubernetes y de GKE, consulta la documentación sobre registros de auditoría.

Existen registros del sistema adicionales, como los de kube-system, que se describen en Controla la recopilación de registros de la aplicación.

Registros de la aplicación

Los contenedores de Kubernetes recopilan registros para las cargas de trabajo escritas en STDOUT y STDERR. Puedes encontrar los registros de tu aplicación de carga de trabajo mediante los tipos de recursos k8s_container o gke_cluster. Los registros aparecerán en Logging con estos nombres:

  • projects/PROJECT_ID/logs/stderr – Registros escritos en el error estándar

  • projects/PROJECT_ID/logs/stdout – Registros escritos en el error estándar

Registros del plano de control

Si los registros del plano de control están habilitados para tu clúster de GKE, los registros emitidos por ciertos componentes del plano de control de Kubernetes (por ejemplo, el servidor de la API, el programador y el administrador de controladores) se exportan a Cloud Logging.

Estos registros usan el tipo de recurso k8s_control_plane_component y aparecen en Cloud Logging con los siguientes nombres:

  • projects/PROJECT_ID/logs/container.googleapis.com%2Fapiserver

  • projects/PROJECT_ID/logs/container.googleapis.com%2Fscheduler

  • projects/PROJECT_ID/logs/container.googleapis.com%2Fcontroller-manager

Busca tus registros en la interfaz de usuario de Logging

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

Explorador de registros

Con el compilador de consultas, puedes compilar una consulta a través de la selección de campos en un menú desplegable o a través del agregado de parámetros de consulta de forma manual. Por ejemplo, si revisas los registros de los clústeres de GKE, puedes comenzar a seleccionar o buscar el tipo de recursos del clúster de Kubernetes y, luego, seleccionar la ubicación y el nombre del clúster. Luego, puedes definir mejor la búsqueda si seleccionas los registros de actividad en el selector Nombre del registro.

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. Usar el Explorador del campo de registro es útil sobre todo para los registros de GKE, ya que el Explorador del campo de registro proporciona una manera fácil de seleccionar los valores de Kubernetes de tus recursos a fin de compilar una consulta. Por ejemplo, mediante el Explorador del campo de registro, puedes seleccionar los registros de un clúster específico, un espacio de nombres, un nombre de Pod y, luego, el nombre del contenedor.

Puedes obtener más detalles en la documentación de Logging sobre el uso del explorador de registros.

Consultas de muestra

Si buscas registros específicos, las siguientes consultas de muestra te ayudan a encontrar tus registros de GKE:

Soluciona problemas de registros

Si escribes un gran volumen de registros desde tu clúster de GKE, es posible que encuentres, de manera coherente, que muchos de esos registros no aparecen en Cloud Logging. Una posible causa es que el volumen de registro supera la capacidad de procesamiento de registro compatible con GKE.

Logging admite hasta 100 KB/s por nodo de capacidad de procesamiento de registro. Si alguno de los nodos de tu clúster de GKE requiere una capacidad de procesamiento de registro mayor que esta, te recomendamos aumentar la capacidad de procesamiento del agente de registro.