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

Este documento descreve como os clusters anexados do GKE se integram com o Cloud Logging e mostra como aceder aos seus registos.

Vista geral

Os clusters anexados do GKE suportam o Cloud Logging para cargas de trabalho e para componentes do sistema executados em nós de trabalho.

Os clusters anexados do GKE incluem um agente de registo baseado no Fluentbit que é executado em nós de trabalho como um Daemonset. Os dados recolhidos pelos agentes de registo podem ser geridos e eliminados como quaisquer outros dados de registo e métricas, conforme descrito na documentação do Cloud Logging.

Antes de começar

  1. Cumpra os pré-requisitos para clusters anexados do GKE.

  2. Autorize o Cloud Logging e o Cloud Monitoring para configurar autorizações para a Google Cloud Observability.

Que dados são recolhidos

Pode configurar clusters anexados do GKE para capturar qualquer uma ou todas as seguintes informações:

  • Registos para cargas de trabalho

Ative o registo

Se não especificar um modo de registo quando associa o cluster, os clusters anexados do GKE ativam o registo do sistema por predefinição. Para o registo em registo de cargas de trabalho, o cluster tem de ter a versão 1.23 ou posterior do Kubernetes.

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

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

Para ativar o registo de cargas de trabalho num cluster já associado, siga as instruções para atualizar o cluster em conformidade com a CNCF e inclua a flag --logging opcional no comando gcloud container attached clusters update:

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

Substitua LOGGING_FLAG por uma flag que indique que tipo de registo quer ativar:

  • NONE: desativar registo.
  • SYSTEM: ative o registo de cargas de trabalho do sistema em espaços de nomes específicos.
  • SYSTEM,WORKLOAD: ative o registo da atividade do sistema e da carga de trabalho nos nós de trabalho do cluster.

Aceda aos seus registos

Existem várias formas de aceder aos registos dos clusters anexados do GKE no Cloud Logging:

  • Explorador de registos: pode ver os seus registos diretamente a partir do Explorador de registos usando os filtros de registo para selecionar os recursos do Kubernetes, como registos de clusters, nós, espaços de nomes, pods ou contentores.

  • CLI gcloud: use o comando gcloud logging read para selecionar os registos de cluster, nó, pod e contentor adequados.

Compreender os registos

Um registo no Cloud Logging é uma coleção de entradas de registo, e cada entrada de registo aplica-se a um determinado tipo de recurso de registo.

Tipos de recursos

Seguem-se os tipos de recursos específicos dos clusters anexados do GKE:

Tipo do recurso Nome a apresentar
k8s_container Registos de contentores de carga de trabalho

Quando os clusters anexados do GKE escrevem os registos do seu cluster, cada entrada do registo inclui o tipo de recurso. Compreender onde os registos são apresentados facilita a sua localização quando precisar deles.

Registos de apps do sistema

Os registos de apps do sistema pertencem ao tipo de recurso k8s_container. Estes incluem registos de pods instalados nos nós de trabalho por clusters anexados do GKE. Especificamente, estão incluídos os contentores executados nos seguintes espaços de nomes:

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

Encontre os seus registos na interface do utilizador do Cloud Logging

Pode ver os seus registos através do Explorador de registos na interface do utilizador do Cloud Logging.

Logs Explorer

Com o criador de consultas, pode criar uma consulta adicionando parâmetros de consulta manualmente. Por exemplo, se quiser explorar registos de cargas de trabalho do sistema, pode começar por selecionar ou pesquisar o tipo de recurso k8s_container e, em seguida, selecionar a localização e o nome do cluster. Em seguida, pode refinar a pesquisa filtrando os nomes dos contentores ou dos pods.

O Explorador de registos oferece uma forma adicional de criar as suas consultas de pesquisa através do explorador de campos de registos. Mostra a contagem de entradas do registo, ordenadas por contagem decrescente, para o campo de registo especificado. A utilização do explorador de campos de registos é particularmente útil para os registos de clusters anexados do GKE, uma vez que oferece uma forma fácil de selecionar os valores do Kubernetes para os seus recursos. Por exemplo, pode selecionar registos para um cluster, um espaço de nomes, um nome de pod e um nome de contentor específicos.

Para mais informações, consulte o artigo Usar o Explorador de registos.

Consultas de exemplo

Esta secção inclui exemplos de consultas que pode fazer no Explorador de registos.

Exemplo 1: obtenha os registos do contentor gke-connect-agent para um clusterGoogle Cloud CLUSTER_NAME:

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

O que se segue?