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:
Consultas de registro relacionadas con Kubernetes de muestra
Consultas de registro de los planos de control de Kubernetes Engine de muestra
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.