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
Cumpra os pré-requisitos dos clusters anexados ao GKE.
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 cargas de trabalho ao anexar um cluster, siga as instruções
para anexar o cluster do AKS 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 o cluster do AKS e
inclua a sinalização opcional --logging
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
- Visão geral do Cloud Logging
- Como usar o Explorador de registros
- Como criar consultas para o Cloud Logging
- Criar métricas com base em registros