Compartilhar via

Configurar a Observabilidade de Rede para o AKS (Serviço de Kubernetes do Azure) – Prometheus e Grafana gerenciados pelo Azure

  • Artigo

A Observabilidade da Rede do AKS é usada para coletar os dados do tráfego de rede do cluster do AKS. A Observabilidade da Rede permite uma plataforma centralizada para monitorar a integridade dos aplicativos e da rede. O Prometheus coleta métricas de Observabilidade da Rede do AKS e o Grafana as visualiza. Ambos os planos de dados Cilium e Não Cilium são suportados. Neste artigo, saiba como habilitar o complemento Observabilidade de Rede e usar o Prometheus e o Grafana gerenciados pelo Azure para visualizar as métricas extraídas.

Para obter mais informações sobre a Observabilidade de Rede do AKS, confira O que é a Observabilidade de Rede do Serviço Azure Kubernetes (AKS)?.

Pré-requisitos

  • A versão mínima do CLI do Azure necessária para as etapas deste artigo é 2.44.0. Execute az --version para encontrar a versão. Se você precisa instalar ou atualizar, consulte Instalar a CLI do Azure.

Criar cluster

Observação

Para a versão do Kubernetes >= 1.29, a Observabilidade de Rede é incluída em clusters com o Prometheus Gerenciado pelo Azure. A extração de métrica é definida por meio do perfil de métricas AMA.

Para versões mais baixas do Kubernetes, são necessárias etapas extras para habilitar a Observabilidade de Rede.

Criar um grupo de recursos

Um grupo de recursos é um contêiner lógico no qual os recursos do Azure são implantados e gerenciados. Crie um grupo de recursos com o comando az group create. O exemplo a seguir cria um grupo de recursos chamado myResourceGroup na localização eastus:

az group create \
    --name myResourceGroup \
    --location eastus

Criar cluster AKS

Criar um cluster do AKS com az aks create. Os exemplos a seguir criam, cada um, um cluster do AKS denominado myAKSCluster no grupo de recursos myResourceGroup:

Exemplo 1: Não-Cilium

Use az aks create no exemplo a seguir para criar um cluster AKS não-Cilium.

az aks create \
    --name myAKSCluster \
    --resource-group myResourceGroup \
    --location eastus \
    --generate-ssh-keys \
    --network-plugin azure \
    --network-plugin-mode overlay \
    --pod-cidr 192.168.0.0/16 \
    --kubernetes-version 1.29

Exemplo 2: Cilium

Use az aks create no exemplo a seguir para criar um cluster AKS Cilium.

az aks create \
    --name myAKSCluster \
    --resource-group myResourceGroup \
    --generate-ssh-keys \
    --location eastus \
    --max-pods 250 \
    --network-plugin azure \
    --network-plugin-mode overlay \
    --network-dataplane cilium \
    --node-count 2 \
    --pod-cidr 192.168.0.0/16

Prometheus e Grafana gerenciados pelo Azure

Use o exemplo a seguir para instalar e ativar o Prometheus e o Grafana em seu cluster do AKS.

Criar um recurso do Azure Monitor

az resource create \
    --resource-group myResourceGroup \
    --namespace microsoft.monitor \
    --resource-type accounts \
    --name myAzureMonitor \
    --location eastus \
    --properties '{}'

Criar uma instância do Grafana

Use az grafana create para criar uma instância do Grafana. O nome da instância do Grafana deve ser exclusivo. Substitua myGrafana por um nome exclusivo para sua instância Grafana.

az grafana create \
    --name myGrafana \
    --resource-group myResourceGroup

Coloque as IDs dos recursos do Grafana e do Azure Monitor em variáveis

Use az grafana show para colocar a ID do recurso Grafana em uma variável. Use az resource show para colocar a ID do recurso Azure Monitor em uma variável. Substitua myGrafana pelo nome da sua instância do Grafana.

grafanaId=$(az grafana show \
                --name myGrafana \
                --resource-group myResourceGroup \
                --query id \
                --output tsv)

azuremonitorId=$(az resource show \
                    --resource-group myResourceGroup \
                    --name myAzureMonitor \
                    --resource-type "Microsoft.Monitor/accounts" \
                    --query id \
                    --output tsv)

Use az aks update para vincular os recursos do Azure Monitor e do Grafana ao seu cluster do AKS.

az aks update \
    --name myAKSCluster \
    --resource-group myResourceGroup \
    --enable-azure-monitor-metrics \
    --azure-monitor-workspace-resource-id $azuremonitorId \
    --grafana-resource-id $grafanaId

Obter credenciais do cluster

az aks get-credentials --name myAKSCluster --resource-group myResourceGroup

Visualizar usando o Grafana

Observação

A seção a seguir requer implantações do Prometheus e do Grafana gerenciadas pelo Azure.

  1. Use o exemplo a seguir para verificar se os pods do Azure Monitor estão em execução.

    kubectl get po -owide -n kube-system | grep ama-

    ama-metrics-5bc6c6d948-zkgc9          2/2     Running   0 (21h ago)   26h
ama-metrics-ksm-556d86b5dc-2ndkv      1/1     Running   0 (26h ago)   26h
ama-metrics-node-lbwcj                2/2     Running   0 (21h ago)   26h
ama-metrics-node-rzkzn                2/2     Running   0 (21h ago)   26h
ama-metrics-win-node-gqnkw            2/2     Running   0 (26h ago)   26h
ama-metrics-win-node-tkrm8            2/2     Running   0 (26h ago)   26h

  2. Navegue até a instância do Grafana em um navegador da Web.

  3. Criamos um painel de amostra. Ele pode ser encontrado em Painéis > Prometheus gerenciado pelo Azure > Kubernetes / Rede / Clusters.

  4. Verifique se as métricas Kubernetes/Rede/Clusters no painel do Grafana estão visíveis. Se as métricas não forem mostradas, altere o intervalo de tempo para os últimos 15 minutos na caixa suspensa superior direita.

Limpar os recursos

Se você não pretende continuar utilizando esse aplicativo, exclua o cluster do AKS e os outros recursos criados neste artigo com o exemplo a seguir:

  az group delete \
    --name myResourceGroup

Próximas etapas

Nesse artigo de instruções, você aprendeu a instalar e ativar a Observabilidade de Rede do AKS para o cluster AKS.