Instala la asistencia de las operaciones en la nube para GKE

Google Kubernetes Engine (GKE) incluye integración con Cloud Monitoring y Cloud Logging. Esta integración te permite supervisar tus clústeres de GKE en ejecución, administrar tu sistema y los registros de depuración y analizar el rendimiento del sistema mediante funciones avanzadas de perfilado y seguimiento.

En esta página, se describe cómo hacer lo siguiente:

• Crear un clúster nuevo y configurar las operaciones en la nube para GKE o Logging y Monitoring heredados

• Seleccionar si deseas o no recopilar registros de la aplicación

• Inhabilitar Cloud Monitoring y Cloud Logging para un clúster

Las operaciones en la nube para GKE proporcionan una opción única que permite una asistencia mejorada para Cloud Monitoring y Cloud Logging en los clústeres. Con Logging y Monitoring heredados, podrías habilitar Monitoring sin Logging, pero esta opción no es compatible con las operaciones en la nube para GKE.

Nota: Los registros de seguridad, incluidos los registros de auditoría básicos, están disponibles para GKE y la mayoría de los demás servicios de Google Cloud sin tener que pasar por este procedimiento. Para obtener más información, consulta Registros de auditoría de Cloud.

Antes de comenzar

• Determina qué opción de integración con Monitoring y Logging deseas usar.

• Determina si se deben recopilar los registros de la aplicación.

• Asegúrate de ser el propietario del proyecto que contiene el clúster. El proyecto debe estar asociado con un lugar de trabajo.

Nota: Si el lugar de trabajo está configurado con un perímetro de servicio de los Controles del servicio de VPC para la API de Monitoring, las operaciones en la nube para GKE no funcionarán en los clústeres de GKE fuera del perímetro. Para obtener más información sobre los perímetros de servicio, consulta Configuración y detalles del perímetro de servicio.

Controla la recopilación de registros de la aplicación

Beta

Este producto o función está cubierto por las Condiciones de las ofertas anteriores a la disponibilidad general de las Condiciones del Servicio de Google Cloud Platform. Los productos y las características anteriores a la disponibilidad general pueden tener asistencia limitada, y los cambios en estos productos y características podrían no ser compatibles con otras versiones anteriores a la disponibilidad general. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

De forma predeterminada, GKE recopila registros de las cargas de trabajo implementadas en el clúster. Esta es una herramienta potente para instrumentar tu aplicación. Sin embargo, es posible que no se prefiera esta recopilación automatizada. A partir de la versión 1.15.7 de GKE, puedes configurar las operaciones en la nube para GKE de modo que solo capturen registros del sistema y no recopilen registros de aplicaciones.

Cuando se selecciona la opción solo del sistema, se recopilan los siguientes registros:

• Todos los Pods que se ejecutan en los espacios de nombres kube-system, istio-system, knative-serving, gke-system y config-management-system

• Servicios clave que no están en contenedores, incluidos el entorno de ejecución docker/containerd, kubelet, kubelet-monitor, node-problem-detector y kube-container-runtime-monitor.

• La salida de los puertos en serie del nodo, si los metadatos de la instancia de VM serial-port-logging-enable se configuran como verdaderos

Configura la asistencia de Monitoring y Logging para un clúster nuevo

Cuando creas un clúster de GKE nuevo, el panel de operaciones en la nube para GKE está habilitado de forma predeterminada. Si usas la versión 1.17 o una anterior, puedes seleccionar la integración de Logging y Monitoring heredados. Para todas las opciones de configuración del clúster, puedes inhabilitar Google Cloud's operations suite en conjunto.

Nota: Si inhabilitaste la asistencia para Google Cloud's operations suite, la asistencia al cliente se ofrece según el criterio del mejor esfuerzo, y es posible que necesites un esfuerzo adicional del equipo de ingeniería.

Las instrucciones de creación de clústeres en esta sección solo abarcan las opciones pertinentes a las operaciones en la nube para GKE. Para obtener instrucciones completas sobre cómo crear un clúster de GKE, consulta Crea un clúster.

CONSOLE

1. Ve a la página de Clústeres de GKE para tu proyecto. El siguiente botón te lleva allí:

   Ir a Clústeres de Kubernetes

2. Haz clic en Crear clúster.

3. Selecciona una Versión principal para el clúster. La versión que selecciones cambiará las opciones de Cloud Monitoring y Cloud Logging disponibles.

4. En el panel de navegación, en Clúster, haz clic en Funciones.

5. En Operaciones, selecciona la asistencia de Logging y Monitoring para el clúster:

   • En los clústeres nuevos, las operaciones en la nube para GKE están habilitadas de forma predeterminada.

     • Si tu Versión principal es 1.14 o una posterior, puedes seleccionar una de las siguientes opciones de la lista desplegable:

       • Registros y supervisión del sistema y la carga de trabajo
       • Solo registro del sistema y cargas de trabajo (Monitoring inhabilitado)
       • Solo supervisión del sistema (Logging inhabilitado)

     • Además, si tu Versión principal es 1.15.7 o posterior, también puedes seleccionar la siguiente opción de la lista desplegable:

       • Solo registro y supervisión del sistema (Beta)

     • Si tu versión principal es 1.17 o una anterior, puedes habilitar la asistencia de Monitoring y Logging heredados:

       1. En la lista desplegable, selecciona Logging y Monitoring heredados.

       2. Selecciona Habilitar el servicio de supervisión heredado o Habilitar el servicio de registros heredado, o ambas opciones.

          Monitoring y Logging heredados se pueden habilitar o inhabilitar por separado.

          Nota: La asistencia de Logging y Monitoring heredados para Google Kubernetes Engine está obsoleta. Debes migrar a las operaciones en la nube para GKE antes de que se quite la asistencia de Logging y Monitoring heredados.

   • Si deseas inhabilitar las operaciones en la nube para GKE, desmarca la casilla de verificación Habilitar operaciones de Cloud para GKE.

6. Configura el clúster como desees.

7. Haz clic en Crear para crear el clúster.

GCLOUD

Usa gcloud para crear tu clúster:

1. Abre una ventana de la terminal con el SDK de Cloud y gcloud instalados. Una forma de hacerlo es mediante Cloud Shell.

2. En Cloud Console, activa Cloud Shell.

   Activar Cloud Shell

   En la parte inferior de Cloud Console, se inicia una sesión de Cloud Shell en la que se muestra una ventana de línea de comandos. Cloud Shell es un entorno de shell que tiene el SDK de Cloud preinstalado, incluida la herramienta de línea de comandos de gcloud, y valores ya establecidos para el proyecto actual. La inicialización de la sesión puede tomar unos minutos.

3. Para crear tu clúster, ejecuta el siguiente comando. En los clústeres nuevos, las operaciones en la nube para GKE están habilitadas de forma predeterminada:

   gcloud container clusters create [CLUSTER_NAME] \
     --zone=[ZONE] \
     --project=[PROJECT_ID] \
     --cluster-version=[CLUSTER_VERSION]
   

   En la expresión anterior, [CLUSTER_NAME] es el nombre del clúster, [ZONE] es la zona de procesamiento del clúster y [PROJECT_ID] es el ID del proyecto de Google Cloud, no el nombre del proyecto.

   [CLUSTER_VERSION] es la versión de GKE que se debe instalar en el clúster. Puedes ingresar la versión del parche específica que deseas instalar, por ejemplo, 1.16.13-gke.401. De lo contrario, puedes ingresar la menor versión de instalación, por ejemplo, 1.16, y tu clúster se creará con la versión del parche más reciente. Para obtener más información sobre el control de versiones de GKE, consulta Control de versiones y actualizaciones.

4. Como alternativa, para seleccionar Logging y Monitoring heredados en tus clústeres de GKE con la versión 1.17 o anterior, crea tu clúster e incluye las opciones --enable-cloud-logging o --enable-cloud-monitoring en el comando create. Por ejemplo, una creación de clúster simple podría verse de la siguiente manera:

       gcloud container clusters create [CLUSTER_NAME] \
         --zone=[ZONE] \
         --project=[PROJECT_ID] \
         --cluster-version=[CLUSTER_VERSION] \
         --enable-cloud-logging \
         --enable-cloud-monitoring
   
   Note: 
   Legacy Logging and Monitoring support for Google Kubernetes Engine is deprecated. You must
      migrate to Cloud Operations for GKE
     before support for Legacy Logging and Monitoring is removed.
   

   1. Como alternativa, puedes crear tu clúster sin habilitar las operaciones en la nube para GKE si agregas la marca --no-enable-stackdriver-kubernetes al comando create. Por ejemplo:

      gcloud container clusters create [CLUSTER_NAME] \
        --zone=[ZONE] \
        --project=[PROJECT_ID] \
        --cluster-version=[CLUSTER_VERSION] \
        --no-enable-stackdriver-kubernetes
      

Configura la asistencia de Monitoring y Logging para un clúster existente

En la siguiente sección, se detalla cómo modificar la integración con Monitoring y Logging para un clúster de GKE existente.

Nota: Cambiar la asistencia de Monitoring y Logging y la versión de Kubernetes del clúster son acciones distintas. Si cambias la versión de Kubernetes del clúster, no se modifica la asistencia configurada de Monitoring y Logging.

¿Qué tipo de asistencia de Monitoring y Logging usa mi clúster?

Para ver qué asistencia de Monitoring y Logging usa tu clúster, sigue estos pasos:

1. En Google Cloud Console, haz clic en el nombre de tu clúster:

   Ir a Clústeres de Kubernetes

2. En el panel Detalles (Detalles) de tu clúster, consulta el estado de Operaciones en la nube para GKE (Cloud Operations for GKE), Monitoring heredado (Legacy Monitoring) yLogging heredado (Legacy Logging).

   

   Nota: Solo verás el estado de Monitoring heredado y Logging heredado si los habilitaste en tus clústeres.

Modifica tu clúster

Para cambiar la configuración de Monitoring y Logging de un clúster existente, sigue estas instrucciones:

CONSOLE

1. Ve a la página de Clústeres de Kubernetes (Kubernetes clusters) de GKE de tu proyecto:

   Ir a Clústeres de Kubernetes

2. Actualiza tu clúster a la versión 1.12.7 o superior. Para obtener instrucciones, consulta Actualiza clústeres. Permite que la actualización se complete.

3. Haz clic en Editar en el clúster:

   

4. Selecciona la opción de integración adecuada para el clúster.

   • Para cambiar a Cloud Operations para GKE, selecciona cualquiera de las siguientes opciones en el cuadro desplegable Cloud Operations para GKE:

     • Registros y supervisión del sistema y la carga de trabajo
     • Solo registro y supervisión del sistema (beta) (requiere la versión 1.15.7 o posterior de GKE)
     • Solo registro del sistema y cargas de trabajo (Monitoring inhabilitado)
     • Solo supervisión del sistema (Logging inhabilitado)

   • Para cambiar a la asistencia de Logging y Monitoring heredados para la versión 1.17 o anterior de GKE, haz lo siguiente:

     1. En el cuadro desplegable Operaciones en la nube para GKE (Cloud Operations for GKE), selecciona Logging y Monitoring heredados (Legacy Logging and Monitoring).

     2. En el cuadro desplegable Logging heredado (Legacy Logging), selecciona Habilitado (Enabled).

     3. En el cuadro desplegable Monitoring heredado (Legacy Monitoring), selecciona Habilitado (Enabled).

        

        Nota: La asistencia de Logging y Monitoring heredados para Google Kubernetes Engine está obsoleta. Debes migrar a las operaciones en la nube para GKE antes de que se quite la asistencia de Logging y Monitoring heredados.

   • A fin de inhabilitar la integración con Google Cloud's operations suite por completo, selecciona Inhabilitado en el cuadro desplegable Operaciones en la nube para GKE.

5. Haz clic en Guardar.

GCLOUD

En las siguientes instrucciones de gcloud, se trata la actualización de la asistencia de Monitoring y Logging del clúster mediante el comando gcloud container clusters update. Ten en cuenta que usas el comando update, no el comando upgrade, aunque a veces este proceso se denomina “actualización”.

1. Abre una ventana de la terminal con el SDK de Cloud y gcloud instalados. Una forma de hacerlo es mediante Cloud Shell:

2. En Cloud Console, activa Cloud Shell.

   Activar Cloud Shell

   En la parte inferior de Cloud Console, se inicia una sesión de Cloud Shell en la que se muestra una ventana de línea de comandos. Cloud Shell es un entorno de shell que tiene el SDK de Cloud preinstalado, incluida la herramienta de línea de comandos de gcloud, y valores ya establecidos para el proyecto actual. La inicialización de la sesión puede tomar unos minutos.

3. Si aún no lo hiciste, configura los valores predeterminados para tu clúster en el SDK de Cloud:

   gcloud config set project [PROJECT_ID]
   

4. A fin de habilitar las operaciones en la nube para GKE, ejecuta el comando update con la marca --enable-stackdriver-kubernetes.

   gcloud container clusters update [CLUSTER_NAME] \
     --zone=[ZONE]  \
     --enable-stackdriver-kubernetes
     

5. Para habilitar Logging y Monitoring heredados, ejecuta el comando update con las marcas --logging-service logging.googleapis.com o --monitoring-service monitoring.googleapis.com. En el ejemplo que se muestra aquí, solo se muestran las opciones necesarias para Google Cloud's operations suite:

   gcloud container clusters update [CLUSTER_NAME] \
     --zone=[ZONE]  \
     --logging-service logging.googleapis.com \
     --monitoring-service monitoring.googleapis.com
     

   Nota: La asistencia de Logging y Monitoring heredados para Google Kubernetes Engine está obsoleta. Debes migrar a las operaciones en la nube para GKE antes de que se quite la asistencia de Logging y Monitoring heredados.
   Nota: La opción de solo registros del sistema está disponible solo en la versión beta de gcloud si se proporciona la marca --enable-logging-monitoring-system-only.

6. Como alternativa, ejecuta el comando update y configura la marca --no-enable-stackdriver-kubernetes a fin de quitar Cloud Operations para GKE o Logging y Monitoring heredados.

   gcloud container clusters update [CLUSTER_NAME] \
     --zone=[ZONE]  \
     --no-enable-stackdriver-kubernetes

¿Qué sigue?

• Para obtener más información sobre los costos asociados con Cloud Logging, consulta la página Precios.

• Obtén más información en Usa Prometheus, una herramienta de supervisión que se usa a menudo con Kubernetes.

• Si usas Logging y Monitoring heredados, familiarízate con los cambios en las operaciones en la nube para GKE; con este fin, consulta Migra a las operaciones en la nube para GKE.