Instala Kubernetes Monitoring

En esta página, se explica cómo instalar la versión Beta de Stackdriver Kubernetes Monitoring. Esta es una versión de participación que reemplaza la asistencia heredada de Stackdriver descrita en las guías de GKE, Monitoring y Logging. Esta versión Beta está destinada solo para Google Kubernetes Engine (GKE).

Puedes instalar esta versión nueva cuando crees un clúster de GKE nuevo o actualizar un clúster de GKE existente. Si no optas por esta versión, tus clústeres nuevos usarán la asistencia actual de Stackdriver, también llamada la asistencia heredada de GA.

Antes de comenzar

  • Debes ser propietario del proyecto que contiene tu clúster. El proyecto debe ser supervisado por un lugar de trabajo.

  • Se te pedirá que uses la versión 1.10.6 o 1.11.2 de Kubernetes (o posterior, si está disponible).

Crea un clúster nuevo:

Debes optar por esta versión Beta cuando crees un clúster nuevo mediante la consola de GKE o la herramienta de línea de comandos de gcloud del SDK de Cloud,

CONSOLA

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

    Visitar la página de clústeres de GKE

  2. Selecciona Crear clúster en la parte superior de la página.

  3. En el cuadro de diálogo, especifica los siguientes campos, además de las otras propiedades que desees en tu clúster. Para obtener más información, consulta Crea un clúster.

    • Versión de clúster: 1.10.6 o posterior, o 1.11.2 o posterior.

    • Prueba la nueva experiencia Beta de Monitoring y Logging: MARCADA.

      Si no ves esta opción, significa que no has seleccionado una versión de clúster 1.10.6 o 1.11.2 (o posterior, si está disponible). Si ves la opción, pero está inhabilitada, asegúrate de que las opciones Stackdriver Logging y Stackdriver Monitoring estén Enabled (lo predeterminado).

      Esta parte del panel de opciones debe verse de la siguiente manera:

      Versión Beta habilitada

  4. Haz clic en Crear para generar el clúster. Esto puede tardar un poco.

GCLOUD

Usa gcloud para crear tu clúster con Stackdriver Kubernetes Monitoring:

  1. Abre una ventana de la terminal con SDK de Cloud y gcloud beta instalados.

    Una forma de hacer esto es usar Cloud Shell:

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

      IR A CLÚSTERES DE KUBERNETES

    2. Haz clic en el ícono Activar Cloud Shell en la parte superior de la página.

  2. Crea tu clúster con Kubernetes 1.10.6 o 1.11.2 (o posterior, si está disponible) y la opción --enable-stackdriver-kubernetes:

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

Solución de problemas:

  • Si gcloud beta container no reconoce la marca --enable-stackdriver-kubernetes, actualiza tu instalación gcloud:

    gcloud components update
    

Siguiente paso: Ve a Verifica tu instalación en esta página.

Actualiza un clúster existente

La siguiente tabla te indica cómo actualizar tu clúster a la versión Beta administrada de Stackdriver Kubernetes Monitoring. Existen diferencias según la compatibilidad anterior de la asistencia de Stackdriver con la que se ejecuta el clúster, lo que puedes notar cuando haces clic en el nombre de tu clúster en la consola de GKE.

Asistencia actual de Stackdriver Estado de la lista de Stackdriver
en la consola
Cómo actualizar
Versión Beta administrada Habilitada, versión 2 (Beta) Solo tienes que actualizar tu versión de Kubernetes. Stackdriver se actualiza cuando Kubernetes está actualizado.
Heredada de GA Habilitada Usa las siguientes instrucciones de actualización.
Ninguna Inhabilitada Usa las siguientes instrucciones de actualización.
Sin administrar,
versión Beta manual1
Inhabilitada, y el clúster contiene un espacio de nombres stackdriver-agents. Borra los agentes actuales:
  kubectl delete ns stackdriver-agents
A continuación, usa las siguientes instrucciones de actualización.

Notas:
 1 Actualmente, esto solo puede suceder si instalaste manualmente los agentes actualizados. La instalación manual ya no es necesaria o recomendada.

Las siguientes instrucciones actualizan tu clúster de GKE a la versión Beta administrada de Stackdriver Kubernetes Monitoring. Verifica la tabla anterior que menciona algunos casos excepcionales.

CONSOLA

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

    Visitar la página de clústeres de GKE

  2. Actualiza tu clúster a la versión 1.10.6 o 1.11.2 de Kubernetes (o posterior, si está disponible). Para obtener instrucciones, consulta Actualiza clústeres. Permite que la actualización se complete.

  3. Haz clic en el ícono Editar (edit) de tu clúster:

    Edita el clúster de GKE

  4. Desplázate hacia abajo a la sección Stackdriver y marca la casilla Probar la experiencia Beta nueva de Monitoring y Logging. Es posible que también tengas que habilitar las opciones de Stackdriver Monitoring y Logging:

    Clúster de GKE habilitado

    Si no has actualizado a la versión de Kubernetes requerida, no verás la opción Probar la experiencia Beta nueva de Monitoring y Logging.

  5. Haz clic en Guardar en la parte inferior de la página.

GCLOUD

  1. Abre una ventana de Cloud Shell en el proyecto que contiene tu clúster. Como alternativa, usa tu propia ventana de la terminal con SDK de Cloud instalado.

  2. Si no lo has hecho, configura los valores predeterminados para tu clúster en el SDK de Cloud:

    gcloud config set project [PROJECT_ID]
    gcloud config set compute/zone [COMPUTE_ZONE]
    
  3. Actualiza tu clúster a la versión 1.10.6 o 1.11.2 de Kubernetes (o posterior, si está disponible). Para obtener instrucciones, consulta Actualiza clústeres en la documentación de GKE.

    Espera a que se complete la actualización.

  4. Opta por la versión Beta administrada de Stackdriver:

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

    En el comando anterior, usa --zone para clústeres zonales y --region para clústeres regionales. Además, --logging-service y --monitoring-service deben estar presentes en el mismo comando de gcloud.

    1. Para verificar tu instalación, consulta Verifica tu instalación.

Siguiente paso: Ve a Verifica tu instalación en esta página.

Verifica tu instalación

Para verificar que Stackdriver Monitoring se ejecute correctamente, espera unos minutos y luego examina tu clúster. Usa la consola o gcloud para verificar que los pods de Stackdriver se estén ejecutando:

CONSOLA

  1. Desde GCP Console, ve a Stackdriver > Monitoring:

    Ir a la consola de Stackdriver Monitoring

  2. En Monitoring, ve a Recursos > Kubernetes BETA para el Área lugar de trabajo que contiene tu proyecto de GCP.

    Puedes ver todos los clústeres en tu área lugar de trabajo que estén usando Stackdriver Kubernetes Monitoring.

  3. Selecciona la pestaña Carga de trabajo.

  4. Expande tu clúster y el espacio de nombres de kube-system. Deberías ver pods en ejecución en el espacio de nombres de kube-system con los siguientes nombres:

    • fluentd-gcp-...: El agente de Stackdriver Logging
    • heapster-...: El agente de Monitoring
    • metadata-...: El agente de metadatos de Stackdriver

GCLOUD

  1. En GCP Console, con tu proyecto seleccionado, abre una ventana de Cloud Shell. Como alternativa, usa tu propia ventana de la terminal con SDK de Cloud instalado.

  2. Ejecuta el siguiente comando para conectarte a tu clúster:

    gcloud container clusters get-credentials [CLUSTER_ID] --zone [ZONE] --project [PROJECT_ID]
    
  3. Ejecuta el siguiente comando para consultar el espacio de nombres de Stackdriver Kubernetes Monitoring:

    kubectl get pods --namespace=kube-system
    
  4. Deberías ver los pods con los siguientes nombres (entre otros):

    • fluentd-gcp-...: El agente de Stackdriver Logging
    • heapster-...: El agente de Monitoring
    • metadata-agent-...: El agente de metadatos de Stackdriver.

Próximos pasos

  • Puedes implementar tu software de aplicación en tu clúster como de costumbre. Para obtener más información, consulta Descripción general de la implementación de cargas de trabajo.

  • Si estás familiarizado con la asistencia actual de Stackdriver, revisa las diferencias en Stackdriver Kubernetes Monitoring. Por ejemplo, esta versión usa diferentes tipos de recursos supervisados para tus registros, gráficos, métricas y políticas de alertas de Stackdriver.

  • Para usar Prometheus con este lanzamiento en versión Beta de Stackdriver Kubernetes Monitoring, consulta Usa Prometheus.

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Stackdriver Monitoring
Si necesitas ayuda, visita nuestra página de asistencia.