Como instalar o suporte do Stackdriver

O GKE já inclui suporte gerenciado para o Stackdriver. A instalação ou a atualização do suporte do Stackdriver acontece automaticamente quando você seleciona uma versão do GKE para o cluster. Esta página descreve os seguintes processos:

  • Instalar ou atualizar para o suporte do Stackdriver legado.
  • Instalar ou atualizar para o Stackdriver Kubernetes Engine Monitoring.
  • Remover todo o suporte do Stackdriver de um cluster.

A instalação do suporte do Stackdriver 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 perfis e traces. Um único procedimento de instalação oferece acesso ao conjunto completo de aplicativos do Stackdriver, inclusive o Stackdriver Monitoring, o Stackdriver Log, o Stackdriver Error Reporting e o Stackdriver APM.

Antes de começar

Como criar um novo cluster

Ao criar um novo cluster do GKE, você recebe o suporte do Stackdriver legado por padrão. Como alternativa, também é possível selecionar o suporte mais recente ao Stackdriver Kubernetes Engine Monitoring ou remover todo o suporte do Stackdriver.

As instruções nesta seção abrangem apenas as opções relevantes para o Stackdriver. Para instruções completas, consulte Como criar um cluster.

CONSOLE

  1. Acesse a página Kubernetes Clusters do GKE relacionada ao projeto. Clique no botão a seguir para acessá-la:

    Acessar a página "GKE Clusters"

  2. Selecione Create Cluster na parte superior da página.

  3. Na caixa de diálogo, especifique os campos a seguir e qualquer outra propriedade que quiser incluir no cluster. Para mais informações, consulte Como criar um cluster.

    1. Master version: escolha a versão 1.12.7.

    2. Na seção Advanced options em Additional features, há três opções para escolher o suporte do Stackdriver no novo cluster.

      Para suporte ao Stackdriver legado no novo cluster, verifique se estas duas opções estão selecionadas:

      Suporte do Stackdriver legado

      Para suporte ao Stackdriver Kubernetes Engine Monitoring, marque também a caixa de seleção Try the new Stackdriver beta Monitoring and Logging experience:

      Ativação da versão Beta

  4. Clique em Create para criar o cluster.

GCLOUD

Use a gcloud para criar o cluster:

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

    1. Acesse a página Kubernetes Clusters do projeto:

      ACESSAR KUBERNETES CLUSTERS

    2. Clique no ícone Activate Cloud Shell na parte superior da página.

  2. Crie o cluster normalmente. Você recebe suporte do Stackdriver legado por padrão. Por exemplo, uma criação simples com opções padrão pode ser semelhante a esta:

    gcloud container clusters create [CLUSTER_NAME] \
      --zone=[ZONE] \
      --project=[PROJECT_ID] \
      --cluster-version=1.10
    
  3. Como alternativa, para selecionar o suporte do Stackdriver Kubernetes Engine Monitoring para o novo cluster, adicione a opção --enable-stackdriver-kubernetes:

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

Como atualizar um cluster atual

As instruções a seguir explicam como realizar estes procedimentos:

  • Atualizar um cluster sem suporte do Stackdriver para o Stackdriver legado.
  • Atualizar um cluster sem suporte do Stackdriver para o Stackdriver Kubernetes Engine Monitoring.
  • Atualizar um cluster do Stackdriver legado para o Stackdriver Kubernetes Engine Monitoring. Também convém alterar as configurações do Stackdriver. Consulte Como migrar para o Stackdriver Kubernetes Engine Monitoring.
  • Remova o suporte do Stackdriver do cluster.

Qual suporte do Stackdriver o cluster usa?

Veja como é possível dizer que tipo de suporte do Stackdriver você tem no cluster:

  1. Clique no nome do cluster no console do GKE:

    ACESSAR KUBERNETES CLUSTERS

  2. No painel Details do cluster, consulte o status do Stackdriver Monitoring e do Stackdriver Logging, que tem o seguinte significado:

    • Ativado: o cluster está usando o suporte do Stackdriver legado.
    • Ativado v2(beta): o cluster está usando a versão Beta do Stackdriver Kubernetes Engine Monitoring.
    • Desativado: o cluster não tem suporte do Stackdriver.

Como alterar o suporte do Stackdriver

Para alterar o suporte do Stackdriver de um cluster atual, siga as instruções abaixo:

CONSOLE

  1. Acesse a página Kubernetes Clusters do GKE relacionada ao projeto. Clique no botão a seguir para acessá-la:

    Acessar a página "GKE Clusters"

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

  3. Clique no ícone Edit (editar) do cluster:

    Cluster de edição do GKE

  4. Role a tela para baixo até a seção Advanced options. Em Additional features, há três opções para escolher o suporte do Stackdriver no novo cluster.

    Para alterar para o suporte do Stackdriver Kubernetes Engine Monitoring, verifique se todas as três opções estão selecionadas:

    Escolher suporte do Stackdriver Kubernetes Engine Monitoring

    Para alterar para o suporte do Stackdriver legado, verifique se apenas as duas primeiras opções estão selecionadas. Se a terceira opção estiver selecionada, Try the new Stackdriver beta Monitoring and Logging experience, desmarque-a:

    Suporte do Stackdriver legado

  5. Clique em Save na parte inferior da página.

GCLOUD

A seguir, as instruções da gcloud abrangem o upgrade do suporte do Stackdriver do cluster usando o comando gcloud container clusters update. Use o comando update, e não o comando upgrade, mesmo que às vezes acabemos nos referindo a esse processo como "upgrade".

  1. Abra uma janela do Cloud Shell no projeto que contém o cluster.

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

    gcloud config set project [PROJECT_ID]
    gcloud config set compute/zone [COMPUTE_ZONE]
    
  3. Atualize o cluster para a versão desejada do Kubernetes e selecione o suporte do Stackdriver que você queira no cluster. Todas as versões aprovadas do GKE oferecem suporte ao Stackdriver legado e ao Stackdriver Kubernetes Engine Monitoring.

    Um comando de atualização mínima é mostrado abaixo, abrangendo apenas as opções necessárias para o Stackdriver:

    gcloud beta container clusters update [CLUSTER_ID] \
      --zone=[ZONE]  --region=[REGION]  \
      --logging-service=[LOGGING_SERVICE] \
      --monitoring-service=[MONITORING_SERVICE]
      

    Use os seguintes valores para [LOGGING_SERVICE] e [MONITORING_SERVICE]:

    Tipo de suporte [LOGGING_SERVICE] [MONITORING_SERVICE]
    Stackdriver legado "logging.googleapis.com" "monitoring.googleapis.com"
    Stackdriver Kubernetes Engine Monitoring "logging.googleapis.com/kubernetes"1 "monitoring.googleapis.com/kubernetes"1
    Nenhum "none" "none"

    Observação: essa opção só é exibida em gcloud beta container clusters update.
    Observação: para ativar o Stackdriver Kubernetes Engine Monitoring, você precisa especificar os serviços de geração de registros de monitoramento.

A seguir

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Stackdriver Monitoring
Precisa de ajuda? Acesse nossa página de suporte.