Permitir a monitorização de um novo cluster Azure Kubernetes Service (AKS)Enable monitoring of a new Azure Kubernetes Service (AKS) cluster

Este artigo descreve como configurar insights de Contentores para monitorizar o cluster gerido de Kubernetes hospedado no Serviço Azure Kubernetes que está a preparar-se para implementar na sua subscrição.This article describes how to set up Container insights to monitor managed Kubernetes cluster hosted on Azure Kubernetes Service that you are preparing to deploy in your subscription.

Pode ativar a monitorização de um cluster AKS utilizando um dos métodos suportados:You can enable monitoring of an AKS cluster using one of the supported methods:

  • CLI do AzureAzure CLI
  • TerraformTerraform

Ativar através do CLI do AzureEnable using Azure CLI

Para permitir a monitorização de um novo cluster AKS criado com O Azure CLI, siga o passo no artigo de arranque rápido na secção Criar cluster AKS.To enable monitoring of a new AKS cluster created with Azure CLI, follow the step in the quickstart article under the section Create AKS cluster.

Nota

Se optar por utilizar o Azure CLI, primeiro tem de instalar e utilizar o CLI localmente.If you choose to use the Azure CLI, you first need to install and use the CLI locally. Deve estar a executar a versão Azure CLI 2.0.74 ou posterior.You must be running the Azure CLI version 2.0.74 or later. Para identificar a sua versão, corra az --version .To identify your version, run az --version. Se necessitar de instalar ou atualizar o Azure CLI, consulte instalar o Azure CLI.If you need to install or upgrade the Azure CLI, see Install the Azure CLI. Se tiver instalado a versão de extensão CLI de pré-visualização aks 0.4.12 ou superior, remova quaisquer alterações que tenha feito para permitir uma extensão de pré-visualização, uma vez que pode sobrepor o comportamento padrão do Azure CLI uma vez que as funcionalidades de Pré-visualização AKS não estão disponíveis na cloudmnet do Azure US Governmnet.If you have installed the aks-preview CLI extension version 0.4.12 or higher, remove any changes you have made to enable a preview extension as it can override the default Azure CLI behavior since AKS Preview features aren't available in Azure US Governmnet cloud.

Ativar a utilização do TerraformEnable using Terraform

Se estiver a implementar um novo cluster AKS utilizando o Terraform,especifique os argumentos necessários no perfil para criar um espaço de trabalho Log Analytics se não optar por especificar um existente.If you are deploying a new AKS cluster using Terraform, you specify the arguments required in the profile to create a Log Analytics workspace if you do not chose to specify an existing one.

Nota

Se optar por utilizar o Terraform, deve estar a executar a versão 1.17.0 ou superior do Fornecedor Terraform Azure RM.If you choose to use Terraform, you must be running the Terraform Azure RM Provider version 1.17.0 or above.

Para adicionar informações do Recipiente ao espaço de trabalho, consulte azurerm_log_analytics_solution e complete o perfil, incluindo o addon_profile e especifique oms_agent.To add Container insights to the workspace, see azurerm_log_analytics_solution and complete the profile by including the addon_profile and specify oms_agent.

Depois de ter ativado a monitorização e todas as tarefas de configuração concluídas com sucesso, pode monitorizar o desempenho do seu cluster de duas formas:After you've enabled monitoring and all configuration tasks are completed successfully, you can monitor the performance of your cluster in either of two ways:

  • Diretamente no cluster AKS selecionando Health no painel esquerdo.Directly in the AKS cluster by selecting Health in the left pane.

  • Selecionando o azulejo do recipiente monitor na página de cluster AKS para o cluster selecionado.By selecting the Monitor Container insights tile in the AKS cluster page for the selected cluster. No Monitor Azure, no painel esquerdo, selecione Health.In Azure Monitor, in the left pane, select Health.

    Opções para selecionar insights de contentores em AKS

Depois de ter ativado a monitorização, pode demorar cerca de 15 minutos até poder ver as métricas de saúde para o cluster.After you've enabled monitoring, it might take about 15 minutes before you can view health metrics for the cluster.

Verificar a implementação do agente e da soluçãoVerify agent and solution deployment

Com a versão 06072018 ou posterior, pode verificar se tanto o agente como a solução foram implementados com sucesso.With agent version 06072018 or later, you can verify that both the agent and the solution were deployed successfully. Com versões anteriores do agente, só pode verificar a implementação do agente.With earlier versions of the agent, you can verify only agent deployment.

Agente versão 06072018 ou mais tardeAgent version 06072018 or later

Executar o seguinte comando para verificar se o agente é implantado com sucesso.Run the following command to verify that the agent is deployed successfully.

kubectl get ds omsagent --namespace=kube-system

A saída deve assemelhar-se ao seguinte, o que indica que foi corretamente implantado:The output should resemble the following, which indicates that it was deployed properly:

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, executar o seguinte comando:To verify deployment of the solution, run the following command:

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

A saída deve assemelhar-se ao seguinte, o que indica que foi corretamente implantado:The output should resemble the following, which indicates that it was deployed properly:

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 de agente antes de 06072018Agent version earlier than 06072018

Para verificar se a versão do agente Log Analytics lançada antes do 06072018 é devidamente implantada, execute o seguinte comando:To verify that the Log Analytics agent version released before 06072018 is deployed properly, run the following command:

kubectl get ds omsagent --namespace=kube-system

A saída deve assemelhar-se ao seguinte, o que indica que foi corretamente implantado:The output should resemble the following, which indicates that it was deployed properly:

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

Ver configuração com CLIView configuration with CLI

Utilize o aks show comando para obter detalhes como é a solução ativada ou não, o que é o log Analytics workspace resourceID, e detalhes sumários sobre o cluster.Use the aks show command to get details such as is the solution enabled or not, what is the Log Analytics workspace resourceID, and summary details about the cluster.

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

Após alguns minutos, o comando completa e devolve informações formatadas com JSON sobre solução.After a few minutes, the command completes and returns JSON-formatted information about solution. Os resultados do comando devem mostrar o perfil de acompanhamento e assemelhar-se à seguinte saída de exemplo:The results of the command should show the monitoring add-on profile and resembles the following example output:

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

Passos seguintesNext steps

  • Se sentir problemas ao tentar embarcar na solução, reveja o guia de resolução de problemasIf you experience issues while attempting to onboard the solution, review the troubleshooting guide

  • Com a monitorização habilitada a recolher a saúde e a utilização de recursos do seu cluster AKS e cargas de trabalho em execução sobre eles, aprenda a utilizar insights de contentores.With monitoring enabled to collect health and resource utilization of your AKS cluster and workloads running on them, learn how to use Container insights.