Instala la asistencia de Monitoring y Logging

Google Kubernetes Engine (GKE) incluye integración con Cloud Monitoring y Cloud Logging. Esta integración le permite supervisar sus clústeres de GKE en ejecución, administrar su sistema y depurar registros, y analizar el rendimiento de su sistema mediante funciones avanzadas de seguimiento y creación de perfiles.

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

  • Crea un clúster nuevo y configura Kubernetes Engine Monitoring o Legacy Logging y Monitoring.

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

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

Kubernetes Engine Monitoring ofrece una única opción que permite mejorar la compatibilidad con Cloud Monitoring y Cloud Logging en tus clústeres. Con Legacy Logging y Monitoring, puede habilitar Monitoring sin Logging, pero esta opción no es compatible con Kubernetes Engine Monitoring.

Antes de comenzar

  • Determina la opción de integración de supervisión y registro que deseas usar.

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

  • Asegúrate de ser un propietario del proyecto que contiene tu clúster. Tu proyecto debe estar asociado con un Lugar de trabajo.

Cómo controlar la recopilación de registros de la aplicación

De forma predeterminada, GKE recopila los registros de las cargas de trabajo implementadas en el clúster. Esta es una herramienta eficaz para instrumentar tu aplicación. Sin embargo, es posible que esta colección automatizada no sea la preferida. A partir de la versión 1.15.7 de GKE, puedes configurar Kubernetes Engine Monitoring para que solo capture los registros del sistema y no recopile los registros de la aplicación.

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

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

  • Servicios clave que no están organizados 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.

Configurar la compatibilidad de supervisión y registro para un clúster nuevo

Cuando crea un nuevo clúster de GKE, Kubernetes Engine Monitoring está habilitado de forma predeterminada. Como alternativa, puede seleccionar la integración de Legacy Logging y Monitoring para los clústeres que ejecutan la versión 1.14 de GKE o una versión anterior, o puede inhabilitar el conjunto de operaciones de Google Cloud.

Las instrucciones de creación de clústeres de esta sección solo abarcan las opciones relevantes para la supervisión y el registro. 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 Kubernetes de GKE de 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 tu 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, haga clic en Funciones.

  5. En Telemetría, selecciona la compatibilidad de registro y supervisión para tu clúster:

    • Para los clústeres nuevos, Kubernetes Engine Monitoring está habilitado de forma predeterminada.

      • Si su versión principal es 1.15.7 o posterior, puede seleccionar una de las siguientes opciones de la lista desplegable:

        • Registro y supervisión del sistema y de las cargas de trabajo (recomendado)
        • Solo registro y supervisión del sistema (Beta)
      • Si tu versión principal es 1.14 o anterior, puedes habilitar la compatibilidad con Legacy Logging y Monitoring:

        1. En la lista desplegable, selecciona Legacy Stackdriver.
        2. Selecciona Habilitar Stackdriver Logging heredado o Habilitar Stackdriver Monitoring heredado, o ambos. Legacy Monitoring y Legacy Logging se pueden habilitar o inhabilitar por separado.
    • Para inhabilitar Kubernetes Engine Monitoring, desmarque la casilla de verificación Habilitar Stackdriver Kubernetes Engine Monitoring.

  6. Configura el clúster como desees.

  7. Haga clic en Create para generar 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 instalado. Una forma de hacerlo es a través de 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 emergente con una línea de comandos. Cloud Shell es un entorno de shell con el SDK de Cloud ya instalado, incluida la herramienta de línea de comandos de gcloud, y con valores ya establecidos para tu proyecto actual. La sesión puede tardar unos segundos en inicializarse.

  3. Para seleccionar la compatibilidad de Kubernetes Engine Monitoring para su nuevo clúster, incluya la opción --enable-stackdriver-kubernetes en el comando create:

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

    En la expresión anterior, [CLUSTER_NAME] es el nombre de tu 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 para instalar, por ejemplo, 1.12.8-gke.10. De lo contrario, puedes ingresar la menor versión de instalación, por ejemplo, 1.12.8, 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 Legacy Logging y Monitoring para tu clúster GKE 1.14 y versiones anteriores, crea tu clúster e incluye las opciones --enable-cloud-logging y/o --enable-cloud-monitoring en el comando create. Por ejemplo, una creación de clúster simple podría tener el siguiente aspecto:

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

Configurar la compatibilidad de supervisión y registro para un clúster existente

La siguiente sección detalla cómo modificar la integración de supervisión y registro para un clúster de GKE existente.

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

Para ver qué asistencia de supervisión y registro 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 de su clúster, consulte el estado de Legacy Stackdriver Monitoring, Legacy Stackdriver Logging y Kubernetes Engine Monitoring.

    Pantalla de detalles del clúster

Modifica tu clúster

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

CONSOLE

  1. Ve a la página de Clústeres de Kubernetes 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 para tu clúster:

    Edita un clúster de GKE.

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

    • Para cambiar a Kubernetes Engine Monitoring, en el cuadro desplegable Stackdriver Kubernetes Engine Monitoring, seleccione Registros y supervisión del sistema y la carga de trabajo (recomendado).

      Elija la compatibilidad con Kubernetes Engine Monitoring.

    • Para cambiar a Kubernetes Engine Monitoring solo con registros del sistema, en el cuadro desplegable Stackdriver Kubernetes Engine Monitoring, seleccione Registro y supervisión del sistema únicamente.

      Elija la compatibilidad con Kubernetes Engine Monitoring.

    • Para cambiar a la compatibilidad con Legacy Logging y Monitoring (para GKE versión 1.14 y versiones anteriores, haz lo siguiente:

      1. En el cuadro desplegable Kubernetes Engine Monitoring, seleccione Legacy Stackdriver.

      2. En el cuadro desplegable Legacy Stackdriver Logging, selecciona Habilitar.

      3. En el cuadro desplegable Legacy Stackdriver Monitoring, selecciona Habilitar.

        Elija las opciones Legacy Logging y Monitoring.

    • Para inhabilitar completamente la integración del paquete de operaciones de Google Cloud, selecciona Inhabilitado en el cuadro desplegable de Kubernetes Engine Monitoring.

  5. Haga clic en Save.

GCLOUD

Las siguientes instrucciones gcloud incluyen la actualización del soporte de supervisión y registro de tu clúster con 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 instalado. Una forma de hacerlo es a través de 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 emergente con una línea de comandos. Cloud Shell es un entorno de shell con el SDK de Cloud ya instalado, incluida la herramienta de línea de comandos de gcloud, y con valores ya establecidos para tu proyecto actual. La sesión puede tardar unos segundos en inicializarse.

  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]
        gcloud config set compute/zone [ZONE]
        
  4. Actualiza tu clúster a la versión de Kubernetes deseada y selecciona la compatibilidad de supervisión y registro que deseas en el clúster. Kubernetes Engine Monitoring es compatible con todas las versiones de GKE. Legacy Logging and Monitoring es compatible con GKE 1.14 y versiones anteriores.

  5. El siguiente comando de actualización que habilita Kubernetes Engine Monitoring solo muestra las opciones necesarias para el paquete de operaciones de Google Cloud:

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

    El campo [REGION] es la región de procesamiento del clúster.

  6. Como alternativa, el siguiente comando de actualización que habilita el registro y la supervisión heredados solo muestra las opciones necesarias para el paquete de operaciones de Google Cloud:

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

Qué sigue