Instala la asistencia de Monitoring y Logging

Google Kubernetes Engine (GKE) ahora incluye asistencia administrada para Stackdriver Monitoring y Stackdriver Logging. Instalar esta asistencia te permite supervisar tus clústeres de GKE en ejecución, administrar tu sistema y 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 realizar las siguientes acciones:

  • Crear un clúster nuevo y configurar Stackdriver Kubernetes Engine Monitoring o Stackdriver heredado
  • Seleccionar si deseas o no recopilar registros de la aplicación
  • Inhabilitar Stackdriver Monitoring y Stackdriver Logging para un clúster

Stackdriver Kubernetes Engine Monitoring proporciona una única opción que permite una mejor asistencia con Stackdriver Monitoring y Stackdriver Logging en tus clústeres. Con Stackdriver heredado, puedes habilitar Monitoring sin Logging, pero esta opción no es compatible con Stackdriver Kubernetes Engine Monitoring.

Antes de comenzar

Selecciona la asistencia de Stackdriver para un clúster nuevo

Cuando creas un nuevo clúster de GKE, obtienes la asistencia de Stackdriver Kubernetes Engine Monitoring de forma predeterminada. Como alternativa, puedes seleccionar la asistencia de Stackdriver heredado o quitar la asistencia de Stackdriver Monitoring y Stackdriver Logging por completo.

Las instrucciones de creación de clústeres en 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. En el cuadro de diálogo, especifica los siguientes campos además de cualquier otra propiedad que deseas en tu clúster. Para obtener más información, consulta Crea un clúster.

    1. Versión principal: recomendamos la versión 1.12.7 o superior.

    2. Desplázate hacia abajo hasta la sección Opciones avanzadas en Funciones adicionales para seleccionar la asistencia de Stackdriver que deseas en tu nuevo clúster.

      • Para obtener la asistencia de Stackdriver Kubernetes Engine Monitoring, selecciona Habilitar Stackdriver Kubernetes Engine Monitoring (Enable Stackdriver Kubernetes Engine Monitoring):

        Selecciona la asistencia de Stackdriver Kubernetes Engine Monitoring.

      • Para obtener la asistencia de Stackdriver heredado, selecciona las opciones de Características de Stackdriver heredado (Stackdriver legacy features):

        Selecciona la asistencia de Stackdriver heredado.

      • Para quitar la asistencia de Stackdriver, vacía todas las casillas de verificación.

  4. Haz clic en Crear 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 Google Cloud Platform Console, ve a Cloud Shell.

    Ir a Cloud Shell

    En la parte inferior de GCP Console, se abre una sesión de Cloud Shell que muestra una ventana de 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. A fin de seleccionar la asistencia de Stackdriver Kubernetes Engine Monitoring para tu nuevo clúster, incluye 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, a fin de seleccionar Stackdriver heredado para tu clúster nuevo, crea el clúster sin opciones especiales de supervisión o registro. Obtén la asistencia de Stackdriver heredado de forma predeterminada. Por ejemplo, una creación simple con opciones predeterminadas podría tener el siguiente aspecto:

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

Actualiza un clúster existente

En las instrucciones a continuación, se explica cómo hacer las siguientes acciones:

  • Actualizar un clúster sin asistencia de Logging y Monitoring a Stackdriver heredado
  • Actualizar un clúster sin asistencia de Monitoring y Logging a Stackdriver Kubernetes Engine Monitoring
  • Actualizar un clúster desde Stackdriver heredado a Stackdriver Kubernetes Engine Monitoring. Es posible que también debas cambiar las opciones de configuración de Monitoring o Logging. Consulta Migra a Stackdriver Kubernetes Engine Monitoring
  • Quitar la asistencia de Monitoring y Logging de tu clúster

¿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 (Details) de tu clúster, consulta el estado de Stackdriver Monitoring heredado (Legacy Stackdriver Monitoring), Stackdriver Logging heredado(Legacy Stackdriver Logging), y Stackdriver Kubernetes Engine Monitoring.

    Pantalla de detalles del clúster

Cambia la asistencia de Monitoring y Logging

Para cambiar la compatibilidad 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 (Edit) para tu clúster:

    Edita un clúster de GKE.

  4. Selecciona la asistencia de Stackdriver que deseas para tu clúster.

    • Para cambiar la asistencia de Stackdriver Kubernetes Engine Monitoring, haz lo siguiente:

      1. En el menú desplegable Stackdriver Kubernetes Engine Monitoring, selecciona Habilitado (Enabled).

      2. En los menús desplegables Stackdriver Logging heredado (Legacy Stackdriver Logging) y Stackdriver Monitoring heredado (Legacy Stackdriver Monitoring), selecciona Inhabilitado (Disabled).

        Elige la asistencia de Stackdriver Kubernetes Engine Monitoring.

    • Para cambiar a la asistencia de Stackdriver heredado, haz lo siguiente:

      1. En los menús desplegables Stackdriver Logging heredado (Legacy Stackdriver Logging) y Stackdriver Monitoring heredado (Legacy Stackdriver Monitoring), selecciona Inhabilitado (Disabled).

      2. En el menú desplegable Stackdriver Kubernetes Engine Monitoring, selecciona Habilitado (Enabled).

        Elige la asistencia de Stackdriver heredado.

    • Para quitar la asistencia de Stackdriver, selecciona Inhabilitado (Disabled) en cada uno de estos menús desplegables.

  5. Haz clic en Guardar.

GCLOUD

Las siguientes instrucciones de gcloud se refieren a la actualización de la compatibilidad de tu clúster con Stackdriver a través del 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. En Google Cloud Platform Console, ve a Cloud Shell.

    Ir a Cloud Shell

    En la parte inferior de GCP Console, se abre una sesión de Cloud Shell que muestra una ventana de 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.

  2. 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]
    
  3. Actualiza tu clúster a la versión de Kubernetes deseada y selecciona la asistencia de Stackdriver que deseas en el clúster. Todas las versiones de GKE aprobadas son compatibles con Stackdriver heredado y con Stackdriver Kubernetes Engine Monitoring.

  4. El siguiente comando de actualización que habilita Stackdriver Kubernetes Engine Monitoring solo muestra las opciones necesarias para Stackdriver:

    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.

  5. Como alternativa, el siguiente comando de actualización que habilita Stackdriver heredado solo muestra las opciones necesarias para Stackdriver:

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

Próximos pasos