Como gerenciar o agente de informações de contêinerHow to manage the Container insights agent

O insights de contêiner usa uma versão em contêiner do agente de Log Analytics para Linux.Container insights uses a containerized version of the Log Analytics agent for Linux. Após a implantação inicial, há tarefas rotineiras ou opcionais que talvez precisem ser executadas durante o ciclo de vida.After initial deployment, there are routine or optional tasks you may need to perform during its lifecycle. Este artigo detalha como atualizar o agente manualmente e desabilitar a coleta de variáveis de ambiente de um contêiner específico.This article details on how to manually upgrade the agent and disable collection of environmental variables from a particular container.

Como atualizar o agente de informações de contêinerHow to upgrade the Container insights agent

O insights de contêiner usa uma versão em contêiner do agente de Log Analytics para Linux.Container insights uses a containerized version of the Log Analytics agent for Linux. Quando uma nova versão do agente é lançada, o agente é atualizado automaticamente nos clusters do Kubernetes gerenciado hospedado no AKS (Serviço de Kubernetes do Azure) e no Red Hat OpenShift no Azure versão 3.x.When a new version of the agent is released, the agent is automatically upgraded on your managed Kubernetes clusters hosted on Azure Kubernetes Service (AKS) and Azure Red Hat OpenShift version 3.x. Para um cluster híbrido do Kubernetes e o Red Hat OpenShift no Azure versão 4. x, o agente não é gerenciado e você precisa atualizá-lo manualmente.For a hybrid Kubernetes cluster and Azure Red Hat OpenShift version 4.x, the agent is not managed, and you need to manually upgrade the agent.

Se a atualização do agente falhar para um cluster hospedado no AKS ou no Red Hat OpenShift no Azure versão 3. x, este artigo também descreverá o processo para atualizar manualmente o agente.If the agent upgrade fails for a cluster hosted on AKS or Azure Red Hat OpenShift version 3.x, this article also describes the process to manually upgrade the agent. Para seguir as versões lançadas, consulte comunicados sobre lançamentos de agente.To follow the versions released, see agent release announcements.

Atualizar o agente no cluster do AKSUpgrade agent on AKS cluster

O processo para atualizar o agente nos clusters do AKS consiste em duas etapas diretas.The process to upgrade the agent on AKS clusters consists of two straight forward steps. A primeira etapa é desabilitar o monitoramento com informações de contêiner usando CLI do Azure.The first step is to disable monitoring with Container insights using Azure CLI. Siga as etapas descritas no artigo Desativar monitoramento.Follow the steps described in the Disable monitoring article. O uso da CLI do Azure nos permite remover o agente dos nós no cluster sem afetar a solução e os dados correspondentes armazenados no workspace.Using Azure CLI allows us to remove the agent from the nodes in the cluster without impacting the solution and the corresponding data that is stored in the workspace.

Observação

Enquanto você está executando esta atividade de manutenção, os nós no cluster não estão encaminhando dados coletados e as visualizações de desempenho não mostrarão dados entre o momento em que você remover o agente e instalar a nova versão.While you are performing this maintenance activity, the nodes in the cluster are not forwarding collected data, and performance views will not show data between the time you remove the agent and install the new version.

Para instalar a nova versão do agente, siga as etapas descritas em habilitar o monitoramento usando a CLI do Azure para concluir esse processo.To install the new version of the agent, follow the steps described in the enable monitoring using Azure CLI, to complete this process.

Depois de reabilitar o monitoramento, poderá levar cerca de 15 minutos até ser possível exibir as métricas de integridade atualizadas do cluster.After you've re-enabled monitoring, it might take about 15 minutes before you can view updated health metrics for the cluster. Para verificar se o agente foi atualizado com êxito, você pode:To verify the agent upgraded successfully, you can either:

  • Execute o comando: kubectl get pod <omsagent-pod-name> -n kube-system -o=jsonpath='{.spec.containers[0].image}' .Run the command: kubectl get pod <omsagent-pod-name> -n kube-system -o=jsonpath='{.spec.containers[0].image}'. No status retornado, observe o valor em imagem para omsagent na seção contêineres da saída.In the status returned, note the value under Image for omsagent in the Containers section of the output.
  • Na guia nós , selecione o nó de cluster e, no painel Propriedades à direita, observe o valor em marca de imagem do agente.On the Nodes tab, select the cluster node and on the Properties pane to the right, note the value under Agent Image Tag.

A versão do agente mostrada deve corresponder à versão mais recente listada na página histórico de liberação .The version of the agent shown should match the latest version listed on the Release history page.

Atualizar o agente no cluster híbrido do KubernetesUpgrade agent on hybrid Kubernetes cluster

Execute as seguintes etapas para atualizar o agente em um cluster do Kubernetes em execução em:Perform the following steps to upgrade the agent on a Kubernetes cluster running on:

  • Clusters do Kubernetes autogerenciado hospedado no Azure usando o mecanismo do AKS.Self-managed Kubernetes clusters hosted on Azure using AKS Engine.
  • Clusters do Kubernetes autogerenciado hospedado no Azure Stack ou localmente usando o Mecanismo do AKS.Self-managed Kubernetes clusters hosted on Azure Stack or on-premises using AKS Engine.
  • Red Hat OpenShift versão 4.x.Red Hat OpenShift version 4.x.

Se o workspace do Log Analytics estiver no Azure comercial, execute o seguinte comando:If the Log Analytics workspace is in commercial Azure, run the following command:

$ helm upgrade --name myrelease-1 \
--set omsagent.secret.wsid=<your_workspace_id>,omsagent.secret.key=<your_workspace_key>,omsagent.env.clusterName=<my_prod_cluster> incubator/azuremonitor-containers

Se o espaço de trabalho Log Analytics estiver na 21Vianet do Azure na China, execute o seguinte comando:If the Log Analytics workspace is in Azure China 21Vianet, run the following command:

$ helm upgrade --name myrelease-1 \
--set omsagent.domain=opinsights.azure.cn,omsagent.secret.wsid=<your_workspace_id>,omsagent.secret.key=<your_workspace_key>,omsagent.env.clusterName=<your_cluster_name> incubator/azuremonitor-containers

Se o workspace do Log Analytics estiver no Azure US Government, execute o seguinte comando:If the Log Analytics workspace is in Azure US Government, run the following command:

$ helm upgrade --name myrelease-1 \
--set omsagent.domain=opinsights.azure.us,omsagent.secret.wsid=<your_workspace_id>,omsagent.secret.key=<your_workspace_key>,omsagent.env.clusterName=<your_cluster_name> incubator/azuremonitor-containers

Atualizar o agente no Red Hat OpenShift no Azure v4Upgrade agent on Azure Red Hat OpenShift v4

Execute as seguintes etapas para atualizar o agente em um cluster do Kubernetes em execução no Red Hat OpenShift no Azure versão 4.x.Perform the following steps to upgrade the agent on a Kubernetes cluster running on Azure Red Hat OpenShift version 4.x.

Observação

O Red Hat OpenShift no Azure versão 4.x dá suporte apenas à execução na nuvem comercial do Azure.Azure Red Hat OpenShift version 4.x only supports running in the Azure commercial cloud.

curl -o upgrade-monitoring.sh -L https://aka.ms/upgrade-monitoring-bash-script
export azureAroV4ClusterResourceId="/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.RedHatOpenShift/OpenShiftClusters/<clusterName>"
bash upgrade-monitoring.sh --resource-id $ azureAroV4ClusterResourceId

Consulte usando a entidade de serviço em habilitar o monitoramento do cluster kubernetes habilitado para Arc do Azure para obter detalhes sobre como usar uma entidade de serviço com esse comando.See Using service principal in Enable monitoring of Azure Arc enabled Kubernetes cluster for details on using a service principal with this command.

Atualizar o agente no Azure Arc habilitado kubernetesUpgrade agent on Azure Arc enabled Kubernetes

Execute o comando a seguir para atualizar o agente em um cluster kubernetes habilitado para o Azure Arc.Perform the following command to upgrade the agent on an Azure Arc enabled Kubernetes cluster.

curl -o upgrade-monitoring.sh -L https://aka.ms/upgrade-monitoring-bash-script
export azureArcClusterResourceId="/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Kubernetes/connectedClusters/<clusterName>"
bash upgrade-monitoring.sh --resource-id $azureArcClusterResourceId

Consulte usando a entidade de serviço em habilitar o monitoramento do cluster kubernetes habilitado para Arc do Azure para obter detalhes sobre como usar uma entidade de serviço com esse comando.See Using service principal in Enable monitoring of Azure Arc enabled Kubernetes cluster for details on using a service principal with this command.

Como desabilitar a coleção de variáveis de ambiente em um contêinerHow to disable environment variable collection on a container

As informações de contêiner coletam variáveis ambientais dos contêineres em execução em um pod e as apresentam no painel de propriedades do contêiner selecionado na exibição contêineres .Container insights collects environmental variables from the containers running in a pod and presents them in the property pane of the selected container in the Containers view. Você pode controlar esse comportamento desabilitando a coleção de um contêiner específico durante a implantação do cluster do Kubernetes ou depois definindo a variável de ambiente AZMON_COLLECT_ENV.You can control this behavior by disabling collection for a specific container either during deployment of the Kubernetes cluster, or after by setting the environment variable AZMON_COLLECT_ENV. Esse recurso está disponível começando na versão do agente – ciprod11292018 e superior.This feature is available from the agent version – ciprod11292018 and higher.

Para desabilitar a coleção de variáveis de ambiente em um contêiner novo ou existente, defina a variável AZMON_COLLECT_ENV com um valor False em seu arquivo de configuração yaml de implantação do Kubernetes.To disable collection of environmental variables on a new or existing container, set the variable AZMON_COLLECT_ENV with a value of False in your Kubernetes deployment yaml configuration file.

- name: AZMON_COLLECT_ENV  
  value: "False"  

Execute o seguinte comando para aplicar a alteração em clusters do Kubernetes diferentes do Red Hat OpenShift no Azure: kubectl apply -f <path to yaml file>.Run the following command to apply the change to Kubernetes clusters other than Azure Red Hat OpenShift): kubectl apply -f <path to yaml file>. Para editar ConfigMap e aplicar essa alteração para os clusters do Red Hat OpenShift no Azure, execute o comando:To edit ConfigMap and apply this change for Azure Red Hat OpenShift clusters, run the command:

oc edit configmaps container-azm-ms-agentconfig -n openshift-azure-logging

Isso abre o editor de texto padrão.This opens your default text editor. Depois de definir a variável, salve o arquivo no editor.After setting the variable, save the file in the editor.

Para verificar se as alterações de configuração entraram em vigor, selecione um contêiner no modo de exibição contêineres em informações de contêiner e, no painel de propriedades, expanda variáveis de ambiente.To verify the configuration change took effect, select a container in the Containers view in Container insights, and in the property panel, expand Environment Variables. A seção deve mostrar apenas a variável que já foi criada – AZMON_COLLECT_ENV=FALSE.The section should show only the variable created earlier - AZMON_COLLECT_ENV=FALSE. Para todos os outros contêineres, a seção Variáveis de Ambiente deverá listar todas as variáveis de ambiente descobertas.For all other containers, the Environment Variables section should list all the environment variables discovered.

Para reabilitar a descoberta das variáveis ambientais, aplique o mesmo processo anterior alterando o valor de False para True e, em seguida, execute novamente o comando kubectl para atualizar o contêiner.To re-enable discovery of the environmental variables, apply the same process earlier and change the value from False to True, and then rerun the kubectl command to update the container.

- name: AZMON_COLLECT_ENV  
  value: "True"  

Próximas etapasNext steps

Se você tiver problemas ao atualizar o agente, revise o guia de solução de problemas para obter suporte.If you experience issues while upgrading the agent, review the troubleshooting guide for support.