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 mostramos como acessar seus registros.

Visão geral

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

Os clusters anexados ao GKE incluem um Agente do Logging baseado no 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. Atenda ao pré-requisitos para clusters anexados ao GKE.

  2. Autorize o Cloud Logging/Cloud Monitoring a configurar permissões do Google Cloud Observability.

Quais dados são coletados

É possível configurar os clusters anexados ao GKE para capturar qualquer uma ou todas as informações a seguir:

  • 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 o cluster, os clusters anexados ao GKE vão ativar 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 cargas de trabalho ao anexar um cluster, siga as instruções para anexar seu cluster em conformidade com a CNCF e inclua a sinalização opcional --logging na Comando gcloud container attached clusters register:

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

Para ativar a geração de registros de cargas de trabalho em um cluster já anexado, siga as instruções para atualize seu cluster em conformidade com a CNCF e inclua a sinalização opcional --logging na 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 a geração de registros que você quer ativar:

  • NONE: desative a geração de registros.
  • SYSTEM: ativa a geração de registros das cargas de trabalho do sistema em execução em namespaces específicos.
  • SYSTEM,WORKLOAD: ative a geração de registros das atividades do sistema e da carga de trabalho em seu 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:

  • Análise de registros: é possível ver seus registros diretamente da Análise 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

Localizar registros na interface do usuário do Cloud Logging

Veja seus registros usando a Análise de registros na interface do usuário do Cloud Logging.

Análise 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.

A Análise 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 a Análise de registros.

Amostras de consultas

Nesta seção, incluímos exemplos de consultas que podem ser feitas na Análise 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