Instalar o agente do Log Analytics em computadores Windows

As etapas a seguir instalam e configuram o agente do Log Analytics na nuvem do Azure e do Azure Governamental usando o assistente de instalação do agente em seu computador. Se você quiser saber como configurar o agente para também relatar a um grupo de gerenciamento do System Center Operations Manager, consulte implantar o agente do Operations Manager com o Assistente de Instalação do Agente.

1. Em seu workspace do Log Analytics, na página Windows Servers para a qual você navegou anteriormente, selecione a versão apropriada do Download Windows Agent para baixar, dependendo da arquitetura do processador do sistema operacional Windows.

2. Execute a Instalação para instalar o agente no seu computador.

3. Na página Bem-vindo, clique em Avançar.

4. Na página Termos de Licença , leia a licença e clique em Eu Concordo.

5. Na página Pasta de Destino , altere ou mantenha a pasta de instalação padrão e clique em Avançar.

6. Na página Opções de Instalação do Agente, escolha a opção de conectar o agente ao Azure Log Analytics e clique em Avançar.

7. Na página do Azure Log Analytics , execute o seguinte:

   1. Cole a ID do workspace e a chave do workspace (chave primária) copiadas anteriormente. Se o computador precisar se reportar a um workspace do Log Analytics na nuvem do Azure Government, selecione Azure US Government na lista suspensa da Nuvem do Azure.
   2. Se o computador precisar se comunicar por meio de um servidor proxy para o serviço do Log Analytics, clique em Avançado e forneça a URL e o número da porta do servidor proxy. Se o servidor proxy exigir autenticação, digite o nome de usuário e a senha para autenticar com o servidor proxy e clique em Avançar.

8. Clique em Avançar depois de concluir o fornecimento das configurações necessárias.

   

9. Na página Pronto para Instalar, revise suas escolhas e clique em Instalar.

10. Na página Configuração concluída com êxito, clique em Concluir.

Após concluir, o Microsoft Monitoring Agent aparecerá no Painel de Controle. Para confirmar se ele está relatando ao Log Analytics, revise Verificar a conectividade do agente com o Log Analytics.

O arquivo baixado para o agente é um pacote de instalação independente. O programa de instalação para o agente e os arquivos de suporte estão contidos no pacote e precisam ser extraídos para instalar corretamente usando a linha de comando mostrada nos exemplos a seguir.

A tabela a seguir realça os parâmetros específicos compatíveis com a configuração do agente, inclusive quando implantado usando o DSC de Automação.

1. Para extrair os arquivos de instalação do agente, de um prompt de comando com privilégios elevados, execute MMASetup-<platform>.exe /c. Você será solicitado a informar o caminho para extrair os arquivos. Como alternativa, você pode especificar o caminho passando os argumentos MMASetup-<platform>.exe /c /t:<Full Path>.

2. Para instalar silenciosamente o agente e configurá-lo para reportar a um workspace na nuvem comercial do Azure, da pasta onde você extraiu os arquivos de instalação, insira:

   setup.exe /qn NOAPM=1 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE=0 OPINSIGHTS_WORKSPACE_ID="<your workspace ID>" OPINSIGHTS_WORKSPACE_KEY="<your workspace key>" AcceptEndUserLicenseAgreement=1
   

   Ou para configurar o agente para relatar à nuvem do Azure US Government, insira:

   setup.exe /qn NOAPM=1 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE=1 OPINSIGHTS_WORKSPACE_ID="<your workspace ID>" OPINSIGHTS_WORKSPACE_KEY="<your workspace key>" AcceptEndUserLicenseAgreement=1
   

   Ou para configurar o agente para relatar ao Microsoft Azure operado pela nuvem 21Vianet, insira:

   setup.exe /qn NOAPM=1 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE=2 OPINSIGHTS_WORKSPACE_ID="<your workspace ID>" OPINSIGHTS_WORKSPACE_KEY="<your workspace key>" AcceptEndUserLicenseAgreement=1
   

   Observação

   Os valores de cadeia de caracteres para os parâmetros OPINSIGHTS_WORKSPACE_ID e OPINSIGHTS_WORKSPACE_KEY precisam ser colocados entre aspas duplas para instruir o Windows Installer a interpretar como opções válidas para o pacote.

Você pode usar o exemplo de script a seguir para instalar o agente usando o DSC de Automação do Azure. Se você não tiver uma conta de Automação, consulte Introdução à Automação do Azure para entender os requisitos e as etapas para criar uma conta de Automação necessária antes de usar o DSC de Automação. Se você não estiver familiarizado com o DSC de Automação, examine Introdução ao DSC de Automação.

O exemplo a seguir instala o agente de 64 bits, identificado pelo URI valor. Você também pode usar a versão de 32 bits substituindo o valor de URI. As URIs para ambas as versões são:

• Agente do Windows de 64 bits:https://go.microsoft.com/fwlink/?LinkId=828603
• Agente do Windows de 32 bits:https://go.microsoft.com/fwlink/?LinkId=828604

As versões de 32 bits e 64 bits do pacote do agente têm códigos de produto diferentes e as novas versões lançadas também têm um valor exclusivo. O código do produto é um GUID que é a principal identificação de um aplicativo ou produto e é representado pela propriedade ProductCode do Windows Installer. O valor ProductId no script MMAgent.ps1 precisa corresponder ao código do produto do pacote de instalação do agente de 32 bits ou de 64 bits.

Para recuperar o código do produto diretamente do pacote de instalação do agente, você pode usar Orca.exe dos Componentes do SDK do Windows para Desenvolvedores do Windows Installer, que é um componente do Kit de Desenvolvimento de Software do Windows ou usando o PowerShell seguindo um script de exemplo escrito por um MVP (Microsoft Valuable Professional). Para qualquer abordagem, primeiro você precisa extrair o arquivo MOMagent.msi do pacote de instalação MMASetup, conforme explicado na primeira etapa das instruções para instalar o agente usando a linha de comando.

1. Importe o módulo DSC xPSDesiredStateConfiguration para a Automação do https://www.powershellgallery.com/packages/xPSDesiredStateConfiguration Azure.

2. Crie ativos de variável de Automação do Azure para OPSINSIGHTS_WS_ID e OPSINSIGHTS_WS_KEY. Defina OPSINSIGHTS_WS_ID para sua ID do workspace do Log Analytics e defina OPSINSIGHTS_WS_KEY como a chave primária do seu workspace.

3. Copie o script e salve-o como MMAgent.ps1.

   Configuration MMAgent
   {
       $OIPackageLocalPath = "C:\Deploy\MMASetup-AMD64.exe"
       $OPSINSIGHTS_WS_ID = Get-AutomationVariable -Name "OPSINSIGHTS_WS_ID"
       $OPSINSIGHTS_WS_KEY = Get-AutomationVariable -Name "OPSINSIGHTS_WS_KEY"
   
       Import-DscResource -ModuleName xPSDesiredStateConfiguration
       Import-DscResource -ModuleName PSDesiredStateConfiguration
   
       Node OMSnode {
           Service OIService
           {
               Name = "HealthService"
               State = "Running"
               DependsOn = "[Package]OI"
           }
   
           xRemoteFile OIPackage {
               Uri = "https://go.microsoft.com/fwlink/?LinkId=828603"
               DestinationPath = $OIPackageLocalPath
           }
   
           Package OI {
               Ensure = "Present"
               Path = $OIPackageLocalPath
               Name = "Microsoft Monitoring Agent"
               ProductId = "8A7F2C51-4C7D-4BFD-9014-91D11F24AAE2"
               Arguments = '/C:"setup.exe /qn NOAPM=1 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_ID=' + $OPSINSIGHTS_WS_ID + ' OPINSIGHTS_WORKSPACE_KEY=' + $OPSINSIGHTS_WS_KEY + ' AcceptEndUserLicenseAgreement=1"'
               DependsOn = "[xRemoteFile]OIPackage"
           }
       }
   }
   
   

4. Atualize o valor ProductId no script com o código do produto extraído da última versão do pacote de instalação do agente usando os métodos recomendados anteriormente.

5. Importe o script de configuração de MMAgent.ps1 para sua conta de Automação.

6. Atribua um computador ou nó do Windows à configuração. Dentro de 15 minutos, o nó verifica sua configuração e o agente é transferido ao nó.