Nesta página, mostramos como configurar clusters do Google Kubernetes Engine (GKE) com a observabilidade do GKE Dataplane V2, a partir das versões 1.28 ou mais recentes do GKE. Para mais informações sobre os benefícios e os requisitos da observabilidade do GKE Dataplane V2, consulte Sobre a observabilidade do GKE Dataplane V2.
Antes de começar
Antes de começar, verifique se você realizou as tarefas a seguir:
- Ativar a API Google Kubernetes Engine. Ativar a API Google Kubernetes Engine
- Se você quiser usar a Google Cloud CLI para essa tarefa,
instale e, em seguida,
inicialize a
CLI gcloud. Se você instalou a CLI gcloud anteriormente, instale a versão
mais recente executando
gcloud components update
.
Configurar métricas do GKE Dataplane V2
Para coletar métricas, configure as métricas do GKE Dataplane V2. É possível configurar métricas do GKE Dataplane V2 ao criar um cluster ou atualizar um cluster em execução com o GKE Dataplane V2. É possível ativar ou desativar as métricas do GKE Dataplane V2 usando a CLI gcloud.
Recomendamos ativar as métricas do GKE Dataplane V2 e o Google Cloud Managed Service para Prometheus no cluster do GKE. Depois que ambos são ativados, as métricas do GKE Dataplane V2 são enviadas para o Google Cloud Managed Service para Prometheus.
Criar um cluster do Autopilot com as métricas do GKE Dataplane V2 ativadas
Quando você cria novos clusters do Autopilot do GKE, o GKE ativa as métricas do GKE Dataplane V2 por padrão no cluster sem exigir uma sinalização específica.
Para usar as métricas do cluster do GKE Autopilot do GKE Dataplane V2
com o Google Cloud Managed Service para Prometheus, configure o recurso ClusterPodMonitoring
para extrair as métricas e enviá-las ao Google Cloud Managed Service para Prometheus
Crie um manifesto
ClusterPodMonitoring
:Aplique o manifesto
ClusterPodMonitoring
:kubectl apply -f ClusterPodMonitoring.yaml
Criar um cluster padrão com métricas do GKE Dataplane V2 ativadas
Para ativar as métricas do GKE Dataplane V2, crie um cluster com a flag --enable-dataplane-v2-metrics
:
gcloud container clusters create CLUSTER_NAME \
--enable-dataplane-v2 \
--enable-ip-alias \
--enable-managed-prometheus \
--enable-dataplane-v2-metrics
Substitua:
CLUSTER_NAME
: o nome do cluster.
A flag --enable-managed-prometheus
instrui o GKE a usar as
métricas com o Google Cloud Managed Service para Prometheus.
Ativar métricas do GKE Dataplane V2 em um cluster
Para ativar as métricas do GKE Dataplane V2 em um cluster, execute o seguinte comando:
gcloud container clusters update CLUSTER_NAME \
--enable-dataplane-v2-metrics
Substitua CLUSTER_NAME
pelo nome do cluster.
Desativar métricas do GKE Dataplane V2
Para desativar as métricas do GKE Dataplane V2:
gcloud container clusters update CLUSTER_NAME \
--disable-dataplane-v2-metrics
Substitua CLUSTER_NAME
pelo nome do cluster.
Configurar as ferramentas de observabilidade do GKE Dataplane V2
É possível usar um endpoint particular para acessar as ferramentas de solução de problemas de observabilidade do GKE Dataplane V2. Para ativar as ferramentas de observabilidade do GKE Dataplane V2, você precisa ter um cluster configurado com o GKE Dataplane V2. É possível ativar as ferramentas de observação do GKE Dataplane V2 em um novo cluster ou em um cluster atual.
Criar um cluster do Autopilot com observabilidade ativada
Para criar um cluster do GKE Autopilot com a observabilidade do GKE Dataplane V2 ativada:
gcloud container clusters create-auto CLUSTER_NAME \
--enable-dataplane-v2-flow-observability
Substitua CLUSTER_NAME
pelo nome do cluster.
Criar um cluster padrão com observabilidade ativada
Para criar um cluster do GKE Standard com a observabilidade do GKE Dataplane V2 ativada:
gcloud container clusters create CLUSTER_NAME \
--enable-dataplane-v2 \
--enable-ip-alias \
--enable-dataplane-v2-flow-observability
Substitua CLUSTER_NAME
pelo nome do cluster.
Ativar as ferramentas de observabilidade do GKE Dataplane V2 em um cluster
Para ativar a observabilidade do GKE Dataplane V2 em um cluster, execute o seguinte comando:
gcloud container clusters update CLUSTER_NAME \
--enable-dataplane-v2-flow-observability
Substitua CLUSTER_NAME
pelo nome do cluster.
Desativar ferramentas de observabilidade do GKE Dataplane V2
Para desativar as ferramentas de observabilidade do GKE Dataplane V2 em um cluster, execute o seguinte comando:
gcloud container clusters update CLUSTER_NAME \
--disable-dataplane-v2-flow-observability
Substitua CLUSTER_NAME
pelo nome do cluster.
Como usar a CLI do Hubble
Use a ferramenta CLI do Hubble no cluster depois de ativar o recurso de observabilidade do GKE Dataplane V2.
Defina o alias para o binário
hubble-cli
:alias hubble="kubectl exec -it -n gke-managed-dpv2-observability deployment/hubble-relay -c hubble-cli -- hubble"
Para verificar o status do Hubble, com o recurso de observabilidade do GKE Dataplane V2 ativado, use a CLI Hubble em todos os clusters do Autopilot:
hubble status
Para ver o tráfego atual, use a CLI Hubble da seguinte maneira:
hubble observe
Como implantar a distribuição binária da interface do Hubble
Depois que a observabilidade do GKE Dataplane V2 for ativada, será possível implantar a interface do Hubble de código aberto.
Ative a observabilidade no cluster do GKE:
Crie um cluster do GKE com observabilidade ativada:
gcloud container clusters create-auto hubble-rc-auto \ --location COMPUTE_LOCATION \ --cluster-version VERSION \ --enable-dataplane-v2-flow-observability
Substitua:
VERSION
: a versão do cluster.COMPUTE_LOCATION
: a região do Compute Engine para o cluster.
Como alternativa, ative a observabilidade em um cluster:
gcloud container clusters update CLUSTER_NAME \ --location COMPUTE_LOCATION \ --enable-dataplane-v2-flow-observability
Substitua:
CLUSTER_NAME
: o nome do cluster.COMPUTE_LOCATION
: a região do Compute Engine para o cluster.
Configure
kubectl
para se conectar ao cluster:gcloud container clusters get-credentials CLUSTER_NAME \ --location COMPUTE_LOCATION
Substituir
CLUSTER_NAME
: o nome do cluster.COMPUTE_LOCATION
: a região do Compute Engine para o cluster.
Implante a interface do Hubble:
Aplique o manifesto
hubble-ui-128.yaml
:kubectl apply -f hubble-ui-128.yaml
Exponha o serviço com o encaminhamento de portas:
kubectl -n gke-managed-dpv2-observability port-forward service/hubble-ui 16100:80 --address='0.0.0.0'
Acesse a interface do Hubble no seu navegador da Web: