Habilitar o monitoramento de um novo cluster do AKS (Serviço de Kubernetes do Azure)

Este artigo descreve como configurar insights de Contêiner para monitorar o cluster de Kubernetes gerenciado hospedado no Serviço de Kubernetes do Azure que você está preparando para implantar em sua assinatura.

Habilitar usando a CLI do Azure

Para habilitar o monitoramento de um novo cluster do AKS criado com a CLI do Azure, siga a etapa no artigo de início rápido na seção Criar cluster do AKS.

Observação

Se você optar por usar a CLI do Azure, primeiro precisará instalar e usar a CLI localmente. Você deve estar executando a CLI do Azure versão 2.39.0 ou posterior. Para identificar sua versão, execute az --version. Caso precise instalar ou atualizar a CLI do Azure, veja Instalar a CLI do Azure. Se você tiver instalado a extensão da CLI de versão prévia aks versão 0.4.12 ou superior, remova as alterações feitas para habilitar uma extensão de versão prévia, pois ela pode substituir o comportamento da CLI do Azure padrão, já que a versão prévia do recurso de AKS não está disponível na nuvem Azure US Government.

Habilitar usando Terraform

Se estiver implantando um novo cluster do AKS usando o Terraform, especifique os argumentos necessários no perfil para criar um espaço de trabalho do Log Analytics se não optar por especificar um existente. Para adicionar insights do Contêiner ao workspace, consulte azurerm_log_analytics_solution e preencha o perfil incluindo o addon_profile e especifique oms_agent.

Verificar a implantação do agente e solução

Com a versão do agente 06072018 ou posterior, você pode verificar se tanto o agente quanto a solução foram implantados com êxito. Com versões anteriores do agente, você pode verificar somente a implantação do agente.

Agente versão 06072018 ou posterior

Execute o seguinte comando para verificar se o agente foi implantado com êxito.

kubectl get ds omsagent --namespace=kube-system

A saída deve ser semelhante à seguinte, que indica que ela foi implantada corretamente:

User@aksuser:~$ kubectl get ds omsagent --namespace=kube-system 
NAME       DESIRED   CURRENT   READY     UP-TO-DATE   AVAILABLE   NODE SELECTOR                 AGE
omsagent   2         2         2         2            2           beta.kubernetes.io/os=linux   1d

Para verificar a implantação da solução, execute o seguinte comando:

kubectl get deployment omsagent-rs -n=kube-system

A saída deve ser semelhante à seguinte, que indica que ela foi implantada corretamente:

User@aksuser:~$ kubectl get deployment omsagent-rs -n=kube-system 
NAME       DESIRED   CURRENT   UP-TO-DATE   AVAILABLE    AGE
omsagent   1         1         1            1            3h

Versão do agente anterior a 06072018

Para verificar se a versão do agente do Log Analytics liberada antes de 06072018 está implementada corretamente, execute o seguinte comando:

kubectl get ds omsagent --namespace=kube-system

A saída deve ser semelhante à seguinte, que indica que ela foi implantada corretamente:

User@aksuser:~$ kubectl get ds omsagent --namespace=kube-system 
NAME       DESIRED   CURRENT   READY     UP-TO-DATE   AVAILABLE   NODE SELECTOR                 AGE
omsagent   2         2         2         2            2           beta.kubernetes.io/os=linux   1d

Exibir configuração com CLI

Use o comando aks show para obter detalhes, como se a solução estivesse habilitada ou não, o que é o resourceID do espaço de trabalho do Log Analytics e detalhes de resumo sobre o cluster.

az aks show -g <resourceGroupofAKSCluster> -n <nameofAksCluster>

Após alguns minutos, o comando concluirá e retornará informações no formato JSON sobre a solução. Os resultados do comando deverão mostrar o perfil do complemento de monitoramento e serem semelhantes à seguinte saída de exemplo:

"addonProfiles": {
    "omsagent": {
      "config": {
        "logAnalyticsWorkspaceResourceID": "/subscriptions/<WorkspaceSubscription>/resourceGroups/<DefaultWorkspaceRG>/providers/Microsoft.OperationalInsights/workspaces/<defaultWorkspaceName>"
      },
      "enabled": true
    }
  }

Próximas etapas

  • Se enfrentar problemas ao tentar carregar a solução, examine o guia de solução de problemas

  • Com o monitoramento habilitado para coletar a integridade e a utilização de recursos do seu cluster AKS e cargas de trabalho em execução neles, saiba como usar insights do Contêiner.