Visualiza tus registros de GKE

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

Accede a tus registros

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

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

  • Consola de GKE: En la sección Google Kubernetes Engine de Google Cloud Console, selecciona los recursos de Kubernetes enumerados 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 tu clúster, 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 de contenedor adecuados.

Para la agregación personalizada de registros, estadísticas de registros o la integración con sistemas de terceros, también puedes usar la función de receptores de registros para exportar registros a BigQuery, Cloud Storage y Pub/Sub

Información sobre tus registros

Un registro en Cloud Logging es una colección de entradas de registro, y cada entrada de registro 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 Display name
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 del pod de GKE
k8s_container o container (heredado) Registros del contenedor 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 la búsqueda de tus registros cuando los necesitas.

Registros del sistema

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

Los registros del sistema se capturan para los siguientes tipos de recursos:

  • Registros del clúster 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 (heredado)

Tus 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 log Registro 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 Registro de auditoría.

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

Registros de aplicaciones

Los contenedores de Kubernetes recopilan registros para tus cargas de trabajo escritas en STDOUT y STDERR. Puedes encontrar los registros de tu aplicación de carga de trabajo con los tipos de recursos k8s_container o gke_cluster. Tus registros aparecerán en Logging con los siguientes 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

Encuentra tus registros en el visor de registros

En este momento, hay 2 versiones del visor de registros: Visor de registros (vista previa) y Visor de registros (clásico).

Visor de registros (clásico)

Con la versión clásica del visor de registros, puedes usar los menús desplegables para seleccionar los tipos de recursos de Kubernetes y los valores correspondientes para usar en la búsqueda. Por ejemplo, si usas Operaciones de Kubernetes Engine en tu clúster de GKE, puedes comenzar por seleccionar el tipo de recurso del clúster de Kubernetes y, luego, seleccionar la ubicación y el nombre del clúster. Luego, puedes definir mejor tu búsqueda si seleccionas los registros de actividad en el menú desplegable Registro.

Puedes obtener más detalles en la documentación de Logging sobre el uso del Visor de registros (Classic).

Visor de registros (vista previa)

Con el compilador de consultas, puedes compilar una consulta mediante la selección de campos de un menú desplegable o si agregas parámetros de consulta de forma manual. Por ejemplo, si usas Operaciones de Kubernetes Engine en tu clúster de GKE, puedes comenzar por seleccionar o buscar el tipo de recurso del clúster de Kubernetes y, luego, seleccionar la ubicación y el nombre del clúster. Luego, puedes definir mejor tu búsqueda seleccionando los registros de actividad en el selector Nombre del registro.

El visor de registros (vista previa) ofrece una forma adicional de compilar tus consultas de búsqueda con el Explorador de campos de registros. Muestra el recuento de entradas de registro, ordenadas por recuento descendente, para el campo de registro dado. Usar el Explorador de campos de registros es particularmente útil para los registros de GKE, ya que el Explorador de campos de registros proporciona una manera fácil de seleccionar los valores de Kubernetes para tu recursos para compilar una consulta. Por ejemplo, con el Explorador de campos de registros, puedes seleccionar registros para un clúster, espacio de nombres, nombre de pod y, luego, nombre de contenedor específicos.

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

Consultas de muestra

Si buscas registros específicos, puedes encontrar un conjunto detallado de consultas de muestra para ayudarte a encontrar tus registros de GKE a continuación: