Instalar o Cloud Logging em clusters anexados em conformidade com a CNCF

Neste documento, descrevemos como os clusters anexados ao GKE se integram ao Cloud Logging e mostra como acessar seus registros.

Visão geral

Os clusters anexados ao GKE oferecem suporte ao Cloud Logging para cargas de trabalho e componentes do sistema em execução nos nós de trabalho.

Os clusters anexados do GKE incluem um agente de geração de registros baseado em Fluentbit que é executado em nós de trabalho como um Daemonset. Os dados coletados pelos agentes do Logging podem ser gerenciados e excluídos como qualquer outra métrica e dados de registro, conforme descrito na documentação do Cloud Logging.

Antes de começar

  1. Cumpra os pré-requisitos dos clusters anexados ao GKE.

  2. Autorize o Cloud Logging e o Cloud Monitoring a configurar permissões de observabilidade do Google Cloud.

Quais dados são coletados

É possível configurar clusters anexados ao GKE para capturar uma ou todas estas informações:

  • Registros para cargas de trabalho

Ativar a geração de registros

Se você não especificar um modo de geração de registros ao anexar seu cluster, os clusters anexados ao GKE ativarão a geração de registros do sistema por padrão. Para gerar registros de carga de trabalho, o cluster precisa estar na versão 1.23 ou posterior do Kubernetes.

Para ativar a geração de registros de carga de trabalho ao anexar um cluster, siga as instruções para anexar o cluster em conformidade com a CNCF e inclua a sinalização --logging opcional no comando gcloud container attached clusters register:

gcloud container attached clusters register CLUSTER_NAME
...
--logging=LOGGING_FLAG

Para ativar a geração de registros de carga de trabalho em um cluster que já está anexado, siga as instruções para atualizar seu cluster em conformidade com a CNCF e inclua a sinalização --logging opcional no comando gcloud container attached clusters update:

gcloud container attached clusters update CLUSTER_NAME
...
--logging=LOGGING_FLAG

Substitua LOGGING_FLAG por uma sinalização que indique o tipo de geração de registros que você quer ativar:

  • NONE: desativa a geração de registros.
  • SYSTEM: ativa a geração de registros de cargas de trabalho do sistema em execução em namespaces específicos.
  • SYSTEM,WORKLOAD: ativa a geração de registros das atividades do sistema e de carga de trabalho nos nós de trabalho do cluster.

Acessar os registros

Há várias maneiras de acessar os registros de clusters anexados ao GKE no Cloud Logging:

  • Explorador de registros: é possível ver seus registros diretamente do Explorador de registros usando os filtros de geração de registros para selecionar os recursos do Kubernetes, como cluster, nó, namespace, pod ou registros de contêiner.

  • Google Cloud CLI: use o comando gcloud logging read e selecione os registros de cluster, nó, pod e contêiner adequados.

Como entender seus registros

Um registro no Cloud Logging é um conjunto de entradas de registro e cada entrada de registro se aplica a um determinado tipo de recurso de geração de registros.

Tipos de recurso

Estes são os tipos de recursos específicos dos clusters anexados ao GKE:

Tipo de recurso Nome de exibição
k8s_container Registros de contêiner de carga de trabalho

Quando os clusters anexados ao GKE gravam os registros do cluster, cada entrada de registro inclui o tipo de recurso. Saber onde os registros são exibidos facilita a localização deles quando necessário.

Registros de apps do sistema

Os registros de apps do sistema se enquadram no tipo de recurso k8s_container. Isso inclui registros de pods instalados nos nós de trabalho por clusters anexados ao GKE. Especificamente, contêineres que estão sendo executados nos seguintes namespaces estão incluídos:

  • gke-connect
  • gke-system
  • gmp-system
  • asm-user-auth
  • cnrm-system
  • config-management-system
  • gatekeeper-system
  • gmp-public
  • istio-system
  • knative-serving

Encontrar seus registros na interface do usuário do Cloud Logging

Veja seus registros usando o Explorador de registros na interface do usuário do Cloud Logging.

Explorador de registros

Usando o Query Builder, você pode criar uma consulta adicionando parâmetros de consulta manualmente. Por exemplo, se você quiser explorar os registros das cargas de trabalho do sistema, comece selecionando ou procurando o tipo de recurso k8s_container e, em seguida, selecione o local e o nome do cluster. Em seguida, refine a pesquisa filtrando os nomes do contêiner ou do pod.

O Explorador de registros oferece uma outra maneira de criar suas consultas de pesquisa usando o Explorador de campo de registros. Ela mostra a contagem de entradas de registro, classificadas por contagem de diminuição, para o campo de registro fornecido. Usar o Explorador de campo de registros é especialmente útil para os registros de clusters anexados ao GKE, porque fornece uma maneira fácil de selecionar os valores do Kubernetes para seus recursos. Por exemplo, é possível selecionar registros para um cluster específico, namespace, nome do pod e nome do contêiner.

Para mais informações, consulte Como usar o Explorador de registros.

Amostras de consultas

Nesta seção, incluímos exemplos de consultas que podem ser feitas no Explorador de registros.

Exemplo 1: receba os registros do contêiner gke-connect-agent de um cluster do Google Cloud CLUSTER_NAME:

resource.type="k8s_container"
resource.labels.cluster_name="attachedClusters/CLUSTER_NAME"
resource.labels.container_name="gke-connect-agent"

A seguir