Visualiza los registros de GKE

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

Accede a tus registros

Existen varias formas de acceder a los registros de GKE en Logging:

  • Consola de Cloud Logging: Puedes ver tus registros directamente desde la consola de Cloud Logging mediante los filtros de registro para seleccionar los recursos de Kubernetes, como clústeres, nodos, espacio de nombres, Pod o registros del contenedor. Aquí encontrarás ejemplos de consultas relacionadas con Kubernetes que te ayudarán a comenzar.

  • Consola de GKE: En la sección Google Kubernetes Engine de Google Cloud Console, selecciona los recursos de Kubernetes que se enumeran en Cargas de trabajo y, luego, en los vínculos Contenedor o Registros de auditoría.

  • Consola de Cloud Monitoring: Si habilitaste un lugar de trabajo de Cloud Monitoring, en la sección Kubernetes Engine de la consola de Cloud Monitoring, selecciona los clústeres, nodos, Pod o contenedores para ver tus registros.

  • Herramienta de línea de comandos de gcloud: Con el comando gcloud logging read, selecciona el clúster, el nodo, el Pod y los registros del contenedor adecuados.

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 o gke_cluster (heredado) Registros de clústeres de Kubernetes
k8s_node o gke_nodepool (heredado) Registros del grupo de nodos de GKE
k8s_pod Registros de los Pods de GKE
k8s_container o container (heredado) Registros de contenedores de GKE

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 de clústeres con k8s_cluster o gke_cluster (heredado)

  • Registros de nodos con k8s_node o gke_nodepool (heredado)

  • Pod con k8s_pod

  • Apps del sistema con k8s_container o container (heredada)

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

  • projects/[YOUR_PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fdata_access: Registros de acceso a los datos

  • projects/[YOUR_PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity: Registros de actividad del administrador

  • projects/[YOUR_PROJECT_ID]/logs/events: Registros de acontecimientos

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/[YOUR_PROJECT_ID]/logs/stderr: Registros escritos en el error estándar

  • projects/[YOUR_PROJECT_ID]/logs/stdout: Registros escritos en la salida estándar

Busca tus registros en la interfaz de usuario de Logging

En la actualidad, existen dos versiones de la IU de Logging: el Explorador de registros y el Visor de registros heredado.

Visor de registros heredado

Con el visor de registros heredado, puedes usar los menús desplegables a fin de seleccionar los tipos de recursos de Kubernetes y los valores correspondientes para usarlos en la búsqueda. Por ejemplo, si usas las operaciones de Kubernetes Engine en tu clúster de GKE, puedes comenzar con la selección del tipo de recursos del clúster de Kubernetes y, luego, seleccionar la ubicación y el nombre del clúster. Puedes definir mejor la búsqueda si seleccionas los registros de actividad en el menú desplegable del nombre del Registro.

Puedes encontrar más detalles en la documentación de Logging sobre el uso del Visor de registros heredado.

Explorador de registros

Con el compilador de consultas, puedes compilar una consulta mediante la selección de campos en un menú desplegable o mediante el agregado de parámetros de consulta de forma manual. Por ejemplo, si usas las operaciones en la nube para GKE en tu clúster de GKE, puedes comenzar a seleccionar o buscar el tipo de recursos del clúster de Kubernetes y, luego, seleccionar de ubicación y 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, aquí tienes un conjunto detallado de consultas de muestra que te ayudará a encontrar los registros de GKE: