Como instalar o suporte do Cloud Operations para GKE

O Google Kubernetes Engine (GKE) inclui a integração com o Cloud Monitoring e o Cloud Logging. Essa integração permite monitorar os clusters do GKE em execução, gerenciar o sistema e depurar registros, além de analisar o desempenho do sistema usando recursos avançados de criação de perfil e traces.

Esta página explica como fazer o seguinte:

  • Criar um novo cluster e configurar o Cloud Operations para GKE ou o Logging e o Monitoring legados.

  • Selecione se quer coletar os registros do aplicativo ou não.

  • Desativar o Cloud Monitoring e o Cloud Logging para um cluster.

O Cloud Operations para GKE oferece uma única opção que permite um suporte aprimorado para o Cloud Monitoring e o Cloud Logging nos clusters. Com o Logging e o Monitoring legados, é possível ativar o Monitoring sem o Logging, mas essa opção não é compatível com o Cloud Operations para GKE.

Antes de começar

Como controlar a coleta de registros do aplicativo

Por padrão, o GKE coleta registros de cargas de trabalho implantadas no cluster. Essa é uma ferramenta eficiente para a instrumentação do aplicativo. No entanto, essa coleta automatizada pode não ser preferencial. A partir da versão 1.15.7 do GKE, é possível configurar o Cloud Operations para GKE para capturar apenas registros do sistema, e não coletar registros de aplicativos.

Quando a opção somente do sistema é selecionada, os seguintes registros são coletados:

  • Todos os pods em execução nos namespaces kube-system, istio-system, knative-serving, gke-system e config-management-system.

  • Os principais serviços não conteinerizados, incluindo ambiente de execução docker/containerd, kubelet, kubelet-monitor, node-problem-detector e kube-container-runtime-monitor.

  • A saída das portas seriais do nó, se os metadados da instância de VM serial-port-logging-enable estiverem definidos como true.

Como configurar o suporte de monitoramento e geração de registros para um novo cluster

Quando você cria um novo cluster do GKE, o painel do Cloud Operations para GKE é ativado por padrão. Se você estiver usando a versão 1.17 ou anterior, poderá selecionar a integração do Logging e Monitoring legados. Em todas as configurações de cluster, é possível desativar todo o pacote de operações do Google Cloud.

Nas instruções de criação de cluster nesta seção, são abordadas apenas as opções relevantes para o Cloud Operations para GKE. Para ver instruções completas sobre a criação de um cluster do GKE, leia Como criar um cluster.

CONSOLE

  1. Acesse a página Clusters do GKE do seu projeto. Clique no botão a seguir para acessar:

    Acessar os clusters do Kubernetes

  2. Clique em Criar cluster.

  3. Selecione uma versão Mestre para seu cluster. A versão selecionada altera as opções do Cloud Monitoring e do Cloud Logging disponíveis para você.

  4. No painel de navegação, em Cluster, clique em Recursos.

  5. Em Operações, selecione o suporte de geração de registros e monitoramento para o cluster:

    • Para novos clusters, o Cloud Operations para GKE está selecionado por padrão.

      • Se a versão Mestre for 1.14 ou posterior, será possível selecionar uma das seguintes opções na lista suspensa:

        • Geração de registros e monitoramento do sistema e de cargas de trabalho
        • Somente sistema e registro de carga de trabalho (Monitoring desativado)
        • Somente monitoramento do sistema (Logging desativado)
      • Além disso, se a versão Mestre for 1.15.7 ou posterior, você também poderá selecionar a seguinte opção na lista suspensa:

        • Apenas monitoramento e geração de registros do sistema (Beta)
      • Se a sua versão Mestre for 1.17 ou anterior, ative o suporte ao Logging e o Monitoring legados:

        1. Na lista suspensa, selecione Logging e Monitoring legados.
        2. Selecione Ativar o serviço Monitoring legado, Ativar o serviço Logging legado ou as duas opções.

          O Monitoring e o Logging legados podem ser ativados ou desativados separadamente.

    • Para desativar o Cloud Operations para GKE, desmarque a caixa de seleção Ativar Cloud Operations para GKE.

  6. Configure o cluster como quiser.

  7. Clique em Criar para criar o cluster.

GCLOUD

Use gcloud para criar seu cluster:

  1. Abra uma janela de terminal com o SDK do Cloud e gcloud instalados. Uma maneira de fazer isso é usando o Cloud Shell.

  2. No Console do Cloud, ative o Cloud Shell.

    Ativar o Cloud Shell

    Na parte inferior do Console do Cloud, uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente com o SDK do Cloud pré-instalado com a ferramenta de linha de comando gcloud e os valores já definidos para seu projeto atual. A inicialização da sessão pode levar alguns segundos.

  3. Para criar o cluster, execute o comando a seguir. No caso de novos clusters, o Cloud Operations para GKE está ativado por padrão:

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

    Na expressão anterior, [CLUSTER_NAME] é o nome dos seus clusters, [ZONE] é a zona do Compute e [PROJECT_ID] é o ID do projeto do Google Cloud, não o nome do projeto.

    [CLUSTER_VERSION] é a versão do GKE a ser instalada no cluster. Insira a versão específica do patch para instalação, por exemplo, 1.16.13-gke.401. Como alternativa, insira a versão menor a ser instalada, por exemplo, 1.16. Assim, seu cluster será criado com a versão mais recente do patch. Para ver informações sobre o controle de versões do GKE, leia Controle de versões e upgrades.

  4. Como alternativa, para selecionar o Logging e o Monitoring legados para seus clusters do GKE com a versão 1.17 ou anterior, crie o cluster e inclua as opções --enable-cloud-logging e/ou --enable-cloud-monitoring no comando create. Por exemplo, uma simples criação de cluster pode ter a seguinte aparência:

        gcloud container clusters create [CLUSTER_NAME] \
          --zone=[ZONE] \
          --project=[PROJECT_ID] \
          --cluster-version=[CLUSTER_VERSION] \
          --enable-cloud-logging \
          --enable-cloud-monitoring
    
    
    
    1. Também é possível criar seu cluster sem ativar o Cloud Operations para o GKE adicionando a sinalização --no-enable-stackdriver-kubernetes ao comando create. Por exemplo:

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

Como configurar o suporte de monitoramento e geração de registros para um cluster existente

A seção a seguir detalha como modificar a integração de monitoramento e geração de registros para um cluster existente do GKE.

Qual suporte de monitoramento e geração de registros meu cluster usa?

Para ver qual suporte de monitoramento e geração de registros seu cluster está usando, siga as etapas a seguir:

  1. No Console do Google Cloud, clique no nome do cluster:

    Acessar os clusters do Kubernetes

  2. No painel Detalhes do cluster, consulte o status de Cloud Operations para GKE, Monitoring legado e Logging legado.

    Tela de detalhes do cluster.

Modificar seu cluster

Para alterar a configuração de monitoramento e geração de registros de um cluster existente, siga as instruções abaixo:

CONSOLE

  1. Acesse a página de clusters do Kubernetes do GKE relacionada ao projeto:

    Acessar os clusters do Kubernetes

  2. Atualize o cluster para a versão 1.12.7 ou posterior. Para receber instruções, veja Como fazer upgrade de clusters. Aguarde a conclusão do upgrade.

  3. Clique em Editar para o cluster:

    Edite um cluster do GKE.

  4. Selecione a opção de integração apropriada para seu cluster.

    • Para alterar para "Operações do Cloud para GKE" na caixa suspensa do Cloud Operations for GKE, selecione uma das seguintes opções:

      • Geração de registros e monitoramento do sistema e de cargas de trabalho
      • Geração de registros e monitoramento do sistema apenas (Beta) (requer a versão 1.15.7 ou superior do GKE)
      • Somente sistema e registro de carga de trabalho (Monitoring desativado)
      • Somente monitoramento do sistema (Logging desativado)
    • Para mudar para o suporte ao Logging e Monitoring legados para a versão 1.17 ou anterior do GKE, faça o seguinte:

      1. Na caixa suspensa Cloud Operations para GKE, selecione Logging e Monitoring legados.

      2. Na caixa suspensa Logging legado, selecione Ativado.

      3. Na caixa suspensa Monitoring legado, selecione Ativado.

        Escolha os suportes ao Logging e Monitoring legados.

    • Para desativar completamente a integração do pacote de operações do Google Cloud, selecione Desativado na caixa suspensa do Cloud Operations para GKE.

  5. Clique em Save.

GCLOUD

As seguintes instruções do gcloud abrangem o upgrade do suporte a monitoramento e registro do cluster usando o comando gcloud container clusters update. Veja se você usa o comando update, não o upgrade, mesmo que às vezes façamos referência a esse processo como "upgrade".

  1. Abra uma janela de terminal com o SDK do Cloud e gcloud instalados. Uma maneira de fazer isso é usando o Cloud Shell.

  2. No Console do Cloud, ative o Cloud Shell.

    Ativar o Cloud Shell

    Na parte inferior do Console do Cloud, uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente com o SDK do Cloud pré-instalado com a ferramenta de linha de comando gcloud e os valores já definidos para seu projeto atual. A inicialização da sessão pode levar alguns segundos.

  3. Se ainda não tiver feito isso, configure valores padrão para o cluster no SDK do Cloud:

    gcloud config set project [PROJECT_ID]
    
  4. Se quiser ativar as operações do Cloud para o GKE, execute o comando update com a sinalização --enable-stackdriver-kubernetes.

    gcloud container clusters update [CLUSTER_NAME] \
      --zone=[ZONE]  \
      --enable-stackdriver-kubernetes
      
  5. Para ativar o Logging e o Monitoring legados, execute o comando update com as sinalizações --logging-service logging.googleapis.com e\ou --monitoring-service monitoring.googleapis.com. Neste exemplo, mostramos apenas as opções necessárias para o pacote de operações do Google Cloud:

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

  6. Como alternativa, para remover as operações do Cloud para GKE ou Logging e Monitoring legados, execute o comando update e defina a sinalização --no-enable-stackdriver-kubernetes.

    gcloud container clusters update [CLUSTER_NAME] \
      --zone=[ZONE]  \
      --no-enable-stackdriver-kubernetes

A seguir