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.

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.

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

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. De manera alternativa, puedes seleccionar la integración con Logging y Monitoring heredados para clústeres que ejecutan la versión 1.14 de GKE o versiones anteriores, o puedes inhabilitar Google Cloud's operations suite por completo.

En las instrucciones de creación de clústeres de esta sección, solo se 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 Clústeres de Kubernetes de GKE del 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 Telemetría, 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.15.7 o una 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 una anterior, puedes habilitar la asistencia de Monitoring y Logging heredados:

        1. En la lista desplegable, selecciona Stackdriver heredado.
        2. Selecciona Enable legacy Stackdriver Logging o Enable legacy Stackdriver Monitoring, o ambas opciones. Monitoring y Logging heredados se pueden habilitar o inhabilitar por separado.
    • Si deseas inhabilitar las operaciones en la nube para GKE, desactiva la casilla de verificación Habilitar Stackdriver Kubernetes Engine Monitoring.

  6. Configura el clúster como quieras.

  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. A fin de seleccionar la asistencia de las operaciones en la nube para GKE para el 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 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 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 Monitoring heredados en los clústeres de GKE con versión 1.14 y anteriores, crea el clúster y, luego, 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
    

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.

¿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) del clúster, consulta el estado de Stackdriver Monitoring heredado (Legacy Stackdriver Monitoring), Stackdriver Logging heredado(Legacy Stackdriver Logging) y las operaciones en la nube para GKE (Cloud Operations for GKE).

    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 (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:

    Edita un clúster de GKE.

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

    • A fin de cambiar a las operaciones en la nube para GKE, en el cuadro desplegable Stackdriver Kubernetes Engine Monitoring, selecciona Registros y supervisión del sistema y la carga de trabajo (recomendado) [System and workload logging and monitoring (recommended)].

      Elige asistencia de las operaciones en la nube para GKE.

    • A fin de cambiar a las operaciones en la nube para GKE solo con registros del sistema, en el cuadro desplegable Stackdriver Kubernetes Engine Monitoring, selecciona Solo registro y supervisión del sistema (System logging and monitoring only).

      Elige asistencia de las operaciones en la nube para GKE.

    • A fin de 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 en la nube para GKE, selecciona Stackdriver heredado (Legacy Stackdriver).

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

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

        Elige la asistencia de Logging y Monitoring heredados.

    • A fin de inhabilitar la integración de Google Cloud's operations suite por completo, selecciona Inhabilitado en el cuadro desplegable de 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]
    gcloud config set compute/zone [ZONE]
    
  4. Actualiza tu clúster a la versión deseada de Kubernetes y selecciona la asistencia de Monitoring y Logging que deseas. Las operaciones en la nube para GKE son compatibles con todas las versiones de GKE. Logging y Monitoring heredados son compatibles con GKE 1.14 y versiones anteriores.

  5. Con el siguiente comando de actualización que habilita las operaciones en la nube para GKE, solo se muestran las opciones necesarias para Google Cloud's operations suite:

    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, con el siguiente comando de actualización que habilita Logging y Monitoring heredados, solo se muestran 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
      

Próximos pasos

  • 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.