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.

Observação: os registros de segurança, entre eles os registros de auditoria, estão disponíveis para GKE e a maioria dos outros serviços do Google Cloud sem passar por esse procedimento. Para mais informações, consulte Registros de auditoria do Cloud.

Observação: para clusters piloto do GKE Auto, não é possível desativar a integração com o Cloud Monitoring e o Cloud Logging. Além disso, o Logging and Monitoring legado não está disponível para clusters do piloto automático.

Antes de começar

• Determine qual opção de integração de monitoramento e geração de registros você quer usar.

• Determine se os registros do aplicativo devem ser coletados.

• Certifique-se de que você é um proprietário do projeto que contém o cluster. O projeto precisa estar associado a um espaço de trabalho.

Observação: se seu espaço de trabalho estiver configurado com um perímetro de serviço VPC Service Controls para a API do Monitoring, as operações do Cloud para o GKE não funcionam para clusters do GKE fora do perímetro. Para saber mais sobre perímetros de serviço, consulte Detalhes e configuração do perímetro de serviço.

Como controlar a coleta de registros do aplicativo

Beta

Este produto ou recurso é coberto pelos Termos de ofertas pré-disponibilidade geral dos Termos de Serviço do Google Cloud Platform. Os produtos e recursos pré-disponibilidade geral podem ter suporte limitado, e as mudanças realizadas podem não ser compatíveis com outras versões pré-GA. Para mais informações, consulte as descrições das fases de lançamento.

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.

Observação: se você desativou o suporte ao pacote de operações do Google Cloud, o suporte ao cliente é oferecido da melhor maneira possível e pode exigir mais esforço da sua equipe de engenharia.

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.

          Observação: o suporte ao Logging e Monitoring legados do Google Kubernetes Engine foi suspenso. É necessário migrar para o Cloud Operations para GKE antes de o suporte ao Logging e ao Monitoring legados ser removido.

   • 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
   
   Note: 
   Legacy Logging and Monitoring support for Google Kubernetes Engine is deprecated. You must
      migrate to Cloud Operations for GKE
     before support for Legacy Logging and Monitoring is removed.
   

   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.

Observação: alterar o suporte de monitoramento e geração de registros e alterar a versão do cluster do Kubernetes são ações distintas. Alterar a versão do cluster do Kubernetes não altera o suporte de monitoramento e geração de registros configurados.

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.

   

   Observação: você só verá o status do Monitoring legado e do Logging legado se os tiver ativado nos clusters.

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:

   

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.

        

        Observação: o suporte ao Logging e Monitoring legados do Google Kubernetes Engine foi suspenso. É necessário migrar para o Cloud Operations para GKE antes de o suporte ao Logging e ao Monitoring legados ser removido.

   • 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
     

   Observação: o suporte ao Logging e Monitoring legados do Google Kubernetes Engine foi suspenso. É necessário migrar para o Cloud Operations para GKE antes de o suporte ao Logging e ao Monitoring legados ser removido.
   Observação: a opção de geração de registros somente do sistema está disponível exclusivamente no gcloud Beta. Basta fornecer a sinalização --enable-logging-monitoring-system-only.

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

• Saiba mais sobre os custos associados ao Cloud Logging na página Preços.

• Saiba mais sobre Como usar o Prometheus, uma ferramenta de monitoramento que costuma ser usada com o Kubernetes.

• Se você estiver usando o Logging e o Monitoring legados, leia Como migrar para o Cloud Operations para GKE para conhecer as alterações no Cloud Operations para GKE.