Instala la asistencia de operaciones de Kubernetes Engine

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 depurar registros, y analizar el rendimiento de tu sistema con funciones avanzadas de generación de perfiles y seguimiento.

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

  • Crea un clúster nuevo y configura las operaciones de Kubernetes Engine o el registro y Monitoring de Kubernetes Engine heredados.

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

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

Las operaciones de Kubernetes Engine proporcionan una única opción que permite una mejor asistencia con Cloud Monitoring y Cloud Logging en tus clústeres. Con Logging y Monitoring heredados, puedes habilitar Monitoring sin Logging, pero esta opción no es compatible con las operaciones de Kubernetes Engine.

Antes de comenzar

  • Determina qué opción de integración de Monitoring y Logging 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.

Controla la colección de registros de la aplicación

De forma predeterminada, GKE recopila registros para las cargas de trabajo implementadas en el clúster. Esta es una herramienta poderosa para instrumentar tu aplicación. Sin embargo, es posible que no se prefiera esta colección automatizada. A partir de la versión 1.15.7 de GKE, puedes configurar las operaciones de Kubernetes Engine para capturar solo registros del sistema y no recopilar registros de la aplicación.

Cuando se selecciona la opción de solo 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

  • El resultado de los puertos en serie del nodo, si los metadatos de la instancia de VM serial-port-logging-enable están configurados 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 de Kubernetes Engine está habilitado de forma predeterminada. Como alternativa, puedes seleccionar la integración de Logging y Monitoring heredados para los clústeres que ejecutan la versión 1.14 de GKE o versiones anteriores, o puedes inhabilitar el conjunto de operaciones de Google Cloud de manera conjunta.

Las instrucciones de creación de clústeres en esta sección solo abarcan las opciones relevantes para Monitoring y Logging. 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, haz clic en Funciones.

  5. En Telemetría, selecciona la asistencia de Logging y Monitoring para tu clúster:

    • Para los clústeres nuevos, las operaciones de Kubernetes Engine están habilitadas de forma predeterminada.

      • Si tu versión principal es 1.15.7 o posterior, puedes 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 asistencia de Monitoring y Logging heredados:

        1. En la lista desplegable, selecciona Stackdriver heredado.
        2. Selecciona Habilitar Stackdriver Logging heredado o Habilitar Stackdriver Monitoring heredado, o ambas opciones. Monitoring y Logging heredados se pueden habilitar o inhabilitar por separado.
    • Para inhabilitar las operaciones de Kubernetes Engine, desmarca 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 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 seleccionar la compatibilidad con operaciones de Kubernetes Engine para tu clúster nuevo, 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, para seleccionar Logging y Monitoringheredados para tu clúster de GKE 1.14 y versiones anteriores, incluye tu clúster y, luego, incluye las opciones --enable-cloud-logging o --enable-cloud-monitoring en el comando create. Por ejemplo, una creación simple para un clúster podría verse de la siguiente manera:

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

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 de Monitoring y Logging para un clúster de GKE existente.

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

    Pantalla de detalles del clúster

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 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 las operaciones de Kubernetes Engine, en el cuadro desplegable Stackdriver Kubernetes Engine Monitoring, selecciona Registro y carga de trabajo del sistema y carga de trabajo (recomendado).

      Elige la asistencia de operaciones de Kubernetes Engine.

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

      Elige la asistencia de operaciones de Kubernetes Engine.

    • Para cambiar a la asistencia de Logging y Monitoring heredados (para la versión 1.14 de GKE y versiones anteriores), haz lo siguiente:

      1. En el cuadro desplegable Operaciones de Kubernetes Engine, selecciona Stackdriver heredado.

      2. En el cuadro desplegable Stackdriver Logging heredado, selecciona Habilitado.

      3. En el cuadro desplegable Stackdriver Monitoring heredado, selecciona Habilitado.

        Elige la asistencia de Logging y Monitoring heredados.

    • Para inhabilitar por completo la integración del paquete de operaciones de Google Cloud, selecciona Inhabilitado en el cuadro desplegable Operaciones de Kubernetes.

  5. Haga clic en Save.

GCLOUD

Las siguientes instrucciones de gcloud abarcan la actualización de la asistencia de Monitoring y Logging del 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 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]
    gcloud config set compute/zone [ZONE]
    
  4. Actualiza tu clúster a la versión de Kubernetes deseada y selecciona la asistencia de supervisión y registro que deseas en el clúster. Las operaciones de Kubernetes Engine son compatibles con todas las versiones de GKE. El registro y la supervisión heredados son compatibles con GKE 1.14 y versiones anteriores.

  5. El siguiente comando de actualización que habilita las operaciones de Kubernetes Engine solo muestra las opciones necesarias para el conjunto 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 Logging y Monitoring heredados solo muestra las opciones necesarias para Google Cloud's operations suite:

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

Qué sigue