Gerenciar e manter o agente do Log Analytics para Windows e Linux

Após a implantação inicial do agente Windows ou Linux do Log Analytics no Azure Monitor, talvez seja necessário reconfigurar o agente, atualizá-lo ou removê-lo do computador se ele tiver atingido o estágio de desativação em seu ciclo de vida. Você pode facilmente gerenciar essas tarefas de manutenção de rotina manualmente ou por meio de automação, o que reduz erros operacionais e despesas.

Atualizar o agente

Atualize para a versão mais recente do agente do Log Analytics para Windows e Linux manual ou automaticamente com base no cenário de implantação e no ambiente em que a VM está sendo executada.

Atualizar o agente do Windows

Para atualizar o agente em uma VM do Windows para a versão mais recente não instalada usando a extensão de VM do Log Analytics, execute a partir do prompt de comando, script ou outra solução de automação ou use o Assistente de Instalação .msi MMASetup-platform<>.

Para baixar a versão mais recente do agente do Windows do seu espaço de trabalho do Log Analytics:

1. Inicie sessão no portal do Azure.

2. No portal do Azure, selecione Todos os serviços. Na lista de recursos, introduza Log Analytics. À medida que começa a escrever, a lista filtra com base na sua entrada. Selecione Área de Trabalho do Log Analytics .

3. Na sua lista de espaços de trabalho do Log Analytics, selecione o espaço de trabalho.

4. No espaço de trabalho do Log Analytics, selecione o bloco Agentes e, em seguida, selecione Servidores Windows.

5. Na tela Servidores Windows, selecione a versão apropriada Baixar o Windows Agent para baixar, dependendo da arquitetura do processador do sistema operacional Windows.

Atualizar usando o Assistente de configuração

1. Inicie sessão no computador com uma conta que tenha direitos administrativos.

2. Execute MMASetup-platform<>.exe para iniciar o Assistente de Configuração.

3. Na primeira página do Assistente de Configuração, selecione Avançar.

4. Na caixa de diálogo Instalação do Microsoft Monitoring Agent, selecione Concordo em aceitar o contrato de licença.

5. Na caixa de diálogo Instalação do Microsoft Monitoring Agent, selecione Atualizar. A página de status exibe o progresso da atualização.

6. Quando a página Configuração do Microsoft Monitoring Agent concluída com êxito for exibida, selecione Concluir.

Atualizar a partir da linha de comando

1. Inicie sessão no computador com uma conta que tenha direitos administrativos.

2. Para extrair os arquivos de instalação do agente, execute MMASetup-<platform>.exe /c a partir de um prompt de comando elevado e ele solicitará o caminho para o qual extrair arquivos. Como alternativa, você pode especificar o caminho passando os argumentos MMASetup-<platform>.exe /c /t:<Full Path>.

3. Execute o seguinte comando, onde D:\ é o local para o arquivo de log de atualização:

   setup.exe /qn /l*v D:\logs\AgentUpgrade.log AcceptEndUserLicenseAgreement=1
   

Atualizar o agente Linux

A atualização de versões anteriores (>1.0.0-47) é suportada. Executar a instalação com o --upgrade comando atualizará todos os componentes do agente para a versão mais recente.

Execute o seguinte comando para atualizar o agente:

sudo sh ./omsagent-*.universal.x64.sh --upgrade

Ativar a atualização automática para o agente Linux

Recomendamos que você habilite a Atualização Automática de Extensão usando esses comandos para atualizar o agente automaticamente.

Set-AzVMExtension \
  -ResourceGroupName myResourceGroup \
  -VMName myVM \
  -ExtensionName OmsAgentForLinux \
  -ExtensionType OmsAgentForLinux \
  -Publisher Microsoft.EnterpriseCloud.Monitoring \
  -TypeHandlerVersion latestVersion \
  -ProtectedSettingString '{"workspaceKey":"myWorkspaceKey"}' \
  -SettingString '{"workspaceId":"myWorkspaceId","skipDockerProviderInstall": true}' \
  -EnableAutomaticUpgrade $true

az vm extension set \
  --resource-group myResourceGroup \
  --vm-name myVM \
  --name OmsAgentForLinux \
  --publisher Microsoft.EnterpriseCloud.Monitoring \
  --protected-settings '{"workspaceKey":"myWorkspaceKey"}' \
  --settings '{"workspaceId":"myWorkspaceId","skipDockerProviderInstall": true}' \
  --version latestVersion \
  --enable-auto-upgrade true

Adicionar ou remover um espaço de trabalho

Adicione ou remova um espaço de trabalho usando o agente Windows ou o agente Linux.

Agente Windows

As etapas nesta seção são necessárias não apenas quando você deseja reconfigurar o agente do Windows para relatar para um espaço de trabalho diferente ou remover um espaço de trabalho de sua configuração, mas também quando você deseja configurar o agente para relatar para mais de um espaço de trabalho. (Esta prática é comumente referida como multihoming.) A configuração do agente do Windows para relatar a vários espaços de trabalho só pode ser executada após a configuração inicial do agente e usando os métodos descritos nesta seção.

Atualizar configurações do Painel de Controle

1. Inicie sessão no computador com uma conta que tenha direitos administrativos.

2. Abra o Painel de Controlo.

3. Selecione Microsoft Monitoring Agent e, em seguida, selecione a guia Azure Log Analytics .

4. Se estiver a remover uma área de trabalho, selecione-a e, em seguida, selecione Remover. Repita esta etapa para qualquer outro espaço de trabalho para o qual você deseja que o agente pare de relatar relatórios.

5. Se estiver adicionando um espaço de trabalho, selecione Adicionar. Na caixa de diálogo Adicionar um espaço de trabalho do Log Analytics, cole o ID e a chave do espaço de trabalho (chave primária). Se o computador deve relatar para um espaço de trabalho do Log Analytics na nuvem do Azure Government, selecione Azure US Government na lista suspensa Azure Cloud .

6. Selecione OK para salvar as alterações.

Remover um espaço de trabalho usando o PowerShell

$workspaceId = "<Your workspace Id>"
$mma = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'
$mma.RemoveCloudWorkspace($workspaceId)
$mma.ReloadConfiguration()

Adicionar um espaço de trabalho no Azure comercial usando o PowerShell

$workspaceId = "<Your workspace Id>"
$workspaceKey = "<Your workspace Key>"
$mma = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'
$mma.AddCloudWorkspace($workspaceId, $workspaceKey)
$mma.ReloadConfiguration()

Adicionar um espaço de trabalho no Azure para o governo dos EUA usando o PowerShell

$workspaceId = "<Your workspace Id>"
$workspaceKey = "<Your workspace Key>"
$mma = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'
$mma.AddCloudWorkspace($workspaceId, $workspaceKey, 1)
$mma.ReloadConfiguration()

Agente Linux

As etapas a seguir demonstram como reconfigurar o agente Linux se você decidir registrá-lo em um espaço de trabalho diferente ou remover um espaço de trabalho de sua configuração.

1. Para verificar se o agente está registrado em um espaço de trabalho, execute o seguinte comando:

   /opt/microsoft/omsagent/bin/omsadmin.sh -l

   Ele deve retornar um status semelhante ao exemplo a seguir:

   Primary Workspace: <workspaceId> Status: Onboarded(OMSAgent Running)

   É importante que o status também mostre que o agente está em execução. Caso contrário, as etapas a seguir para reconfigurar o agente não serão concluídas com êxito.

2. Se o agente já estiver registrado em um espaço de trabalho, remova o espaço de trabalho registrado executando o seguinte comando. Caso contrário, se não estiver registado, avance para o passo seguinte.

   /opt/microsoft/omsagent/bin/omsadmin.sh -X

3. Para se registrar em um espaço de trabalho diferente, execute o seguinte comando:

   /opt/microsoft/omsagent/bin/omsadmin.sh -w <workspace id> -s <shared key> [-d <top level domain>]

4. Para verificar se as alterações entraram em vigor, execute o seguinte comando:

   /opt/microsoft/omsagent/bin/omsadmin.sh -l

   Ele deve retornar um status semelhante ao exemplo a seguir:

   Primary Workspace: <workspaceId> Status: Onboarded(OMSAgent Running)

O serviço de agente não precisa ser reiniciado para que as alterações entrem em vigor.

Atualizar configurações de proxy

O Log Analytics Agent (MMA) não usa as configurações de proxy do sistema. Como resultado, você tem que passar as configurações de proxy enquanto instala o MMA. Essas configurações serão armazenadas na configuração do MMA (registro) na VM. Para configurar o agente para se comunicar com o serviço por meio de um servidor proxy ou gateway do Log Analytics após a implantação, use um dos seguintes métodos para concluir essa tarefa.

Agente Windows

Use um agente do Windows.

Atualizar configurações usando o Painel de Controle

1. Inicie sessão no computador com uma conta que tenha direitos administrativos.

2. Abra o Painel de Controlo.

3. Selecione Microsoft Monitoring Agent e, em seguida, selecione a guia Configurações de proxy .

4. Selecione Use a proxy server (Utilizar um servidor proxy) e indique o URL e o número de porta do servidor proxy ou do gateway. Se o servidor proxy ou o gateway do Log Analytics exigir autenticação, digite o nome de usuário e a senha para autenticar e selecione OK.

Atualizar configurações usando o PowerShell

Copie o código PowerShell de exemplo a seguir, atualize-o com informações específicas do seu ambiente e salve-o com uma extensão de nome de arquivo PS1. Execute o script em cada computador que se conecta diretamente ao espaço de trabalho do Log Analytics no Azure Monitor.

param($ProxyDomainName="https://proxy.contoso.com:30443", $cred=(Get-Credential))

# First we get the Health Service configuration object. We need to determine if we
#have the right update rollup with the API we need. If not, no need to run the rest of the script.
$healthServiceSettings = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'

$proxyMethod = $healthServiceSettings | Get-Member -Name 'SetProxyInfo'

if (!$proxyMethod)
{
    Write-Output 'Health Service proxy API not present, will not update settings.'
    return
}

Write-Output "Clearing proxy settings."
$healthServiceSettings.SetProxyInfo('', '', '')

$ProxyUserName = $cred.username

Write-Output "Setting proxy to $ProxyDomainName with proxy username $ProxyUserName."
$healthServiceSettings.SetProxyInfo($ProxyDomainName, $ProxyUserName, $cred.GetNetworkCredential().password)

Agente Linux

Execute as etapas a seguir se seus computadores Linux precisarem se comunicar por meio de um servidor proxy ou gateway do Log Analytics. O valor da configuração do proxy tem a seguinte sintaxe: [protocol://][user:password@]proxyhost[:port]. A proxyhost propriedade aceita um nome de domínio totalmente qualificado ou endereço IP do servidor proxy.

1. Edite o arquivo /etc/opt/microsoft/omsagent/proxy.conf executando os seguintes comandos e altere os valores para suas configurações específicas:

   proxyconf="https://proxyuser:proxypassword@proxyserver01:30443"
   sudo echo $proxyconf >>/etc/opt/microsoft/omsagent/proxy.conf
   sudo chown omsagent:omiusers /etc/opt/microsoft/omsagent/proxy.conf
   

2. Reinicie o agente ao executar o seguinte comando:

   sudo /opt/microsoft/omsagent/bin/service_control restart [<workspace id>]
   

   Se você vir cURL failed to perform on this base url no log, você pode tentar remover '\n' no proxy.conf EOF para resolver a falha:

   od -c /etc/opt/microsoft/omsagent/proxy.conf
   cat /etc/opt/microsoft/omsagent/proxy.conf | tr -d '\n' > /etc/opt/microsoft/omsagent/proxy2.conf
   rm /etc/opt/microsoft/omsagent/proxy.conf
   mv /etc/opt/microsoft/omsagent/proxy2.conf /etc/opt/microsoft/omsagent/proxy.conf
   sudo chown omsagent:omiusers /etc/opt/microsoft/omsagent/proxy.conf
   sudo /opt/microsoft/omsagent/bin/service_control restart [<workspace id>]
   

Desinstalar agente

Use um dos procedimentos a seguir para desinstalar o agente Windows ou Linux usando a linha de comando ou o Assistente de Configuração.

Agente Windows

Use o agente do Windows.

Desinstalar a partir do Painel de Controlo

1. Inicie sessão no computador com uma conta que tenha direitos administrativos.

2. No Painel de Controle, selecione Programas e Recursos.

3. Em Programas e Recursos, selecione Microsoft Monitoring Agent>Uninstall>Yes.

Desinstalar a partir da linha de comando

O arquivo baixado para o agente é um pacote de instalação independente criado com o IExpress. O programa de instalação para o agente e os arquivos de suporte estão contidos no pacote e devem ser extraídos para serem desinstalados corretamente usando a linha de comando mostrada no exemplo a seguir.

1. Inicie sessão no computador com uma conta que tenha direitos administrativos.

2. Para extrair os arquivos de instalação do agente, a partir de um prompt de comando elevado, execute extract MMASetup-<platform>.exe e ele solicitará o caminho para o qual extrair arquivos. Como alternativa, você pode especificar o caminho passando os argumentos extract MMASetup-<platform>.exe /c:<Path> /t:<Path>. Para obter mais informações sobre as opções de linha de comando suportadas pelo IExpress, consulte Opções de linha de comando para IExpress e atualize o exemplo para atender às suas necessidades.

3. No prompt, digite %WinDir%\System32\msiexec.exe /x <Path>:\MOMAgent.msi /qb.

Agente Linux

Para remover o agente, execute o seguinte comando no computador Linux. O --purge argumento remove completamente o agente e sua configuração.

wget https://raw.githubusercontent.com/Microsoft/OMS-Agent-for-Linux/master/installer/scripts/onboard_agent.sh && sh onboard_agent.sh --purge

Configurar o agente para relatar a um grupo de gerenciamento do Operations Manager

Use o agente do Windows.

Agente Windows

Execute as etapas a seguir para configurar o agente do Log Analytics para Windows para relatar a um grupo de gerenciamento do System Center Operations Manager.

1. Inicie sessão no computador com uma conta que tenha direitos administrativos.

2. Abra o Painel de Controlo.

3. Selecione Microsoft Monitoring Agent e, em seguida, selecione a guia Operations Manager .

4. Se os servidores do Operations Manager tiverem integração com o Ative Directory, selecione Atualizar automaticamente as atribuições do grupo de gerenciamento do AD DS.

5. Selecione Adicionar para abrir a caixa de diálogo Adicionar um Grupo de Gerenciamento.

6. No campo Nome do grupo de gerenciamento, insira o nome do seu grupo de gerenciamento.

7. No campo Servidor de gerenciamento primário, insira o nome do computador do servidor de gerenciamento primário.

8. No campo Porta do servidor de gerenciamento, insira o número da porta TCP.

9. Em Conta de ação do agente, escolha a conta do sistema local ou uma conta de domínio local.

10. Selecione OK para fechar a caixa de diálogo Adicionar um Grupo de Gerenciamento. Em seguida, selecione OK para fechar a caixa de diálogo Propriedades do Microsoft Monitoring Agent.

Agente Linux

Execute as etapas a seguir para configurar o agente do Log Analytics para Linux para relatar a um grupo de gerenciamento do System Center Operations Manager.

1. Edite o ficheiro /etc/opt/omi/conf/omiserver.conf.

2. Certifique-se de que a linha que começa com httpsport= define a porta 1270, como, httpsport=1270.

3. Reinicie o servidor OMI usando o seguinte comando:

   sudo /opt/omi/bin/service_control restart

Perguntas mais frequentes

Esta secção fornece respostas a perguntas comuns.

Como faço para impedir que o agente do Log Analytics se comunique com o Azure Monitor?

Para agentes conectados diretamente ao Log Analytics, abra o Painel de Controle e selecione Microsoft Monitoring Agent. Na guia OMS (Azure Log Analytics), remova todos os espaços de trabalho listados. No System Center Operations Manager, remova o computador da lista de computadores gerenciados do Log Analytics. O Operations Manager atualiza a configuração do agente para não reportar mais ao Log Analytics.

Próximos passos

• Consulte Solução de problemas do agente Linux se encontrar problemas ao instalar ou gerenciar o agente Linux.
• Consulte Solução de problemas do agente do Windows se encontrar problemas ao instalar ou gerenciar o agente do Windows.