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
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.
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
econfig-management-system
.Os principais serviços não conteinerizados, incluindo ambiente de execução
docker
/containerd
,kubelet
,kubelet-monitor
,node-problem-detector
ekube-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
Acesse a página Clusters do GKE do seu projeto. Clique no botão a seguir para acessar:
Clique em Criar cluster.
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ê.
No painel de navegação, em Cluster, clique em Recursos.
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:
- Na lista suspensa, selecione Logging e Monitoring legados.
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.
Configure o cluster como quiser.
Clique em Criar para criar o cluster.
GCLOUD
Use gcloud
para criar seu cluster:
Abra uma janela de terminal com o SDK do Cloud e
gcloud
instalados. Uma maneira de fazer isso é usando o Cloud Shell.-
No Console do Cloud, ative 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. 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.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 comandocreate
. 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
Também é possível criar seu cluster sem ativar o Cloud Operations para o GKE adicionando a sinalização
--no-enable-stackdriver-kubernetes
ao comandocreate
. 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:
No Console do Google Cloud, clique no nome do cluster:
No painel Detalhes do cluster, consulte o status de Cloud Operations para GKE, Monitoring legado e Logging legado.
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
Acesse a página de clusters do Kubernetes do GKE relacionada ao projeto:
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.
Clique em Editar edit para o cluster:
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:
Na caixa suspensa Cloud Operations para GKE, selecione Logging e Monitoring legados.
Na caixa suspensa Logging legado, selecione Ativado.
Na caixa suspensa Monitoring legado, selecione Ativado.
Para desativar completamente a integração do pacote de operações do Google Cloud, selecione Desativado na caixa suspensa do Cloud Operations para GKE.
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".
Abra uma janela de terminal com o SDK do Cloud e
gcloud
instalados. Uma maneira de fazer isso é usando o Cloud Shell.-
No Console do Cloud, ative 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. Se ainda não tiver feito isso, configure valores padrão para o cluster no SDK do Cloud:
gcloud config set project [PROJECT_ID]
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
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
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.