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

  • Artigo

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.

Importante

O agenteherdado do Log Analytics será preterido até agosto de 2024. Após essa data, a Microsoft não fornecerá mais suporte para o agente do Log Analytics. Migre para o agente do Azure Monitor antes de agosto de 2024 para continuar a ingestão de dados.

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.

Ambiente Método de instalação Método de atualização
VM do Azure Extensão de VM do agente do Log Analytics para Windows/Linux O agente é atualizado automaticamente após as alterações no modelo de VM, a menos que você tenha configurado seu modelo do Azure Resource Manager para desativar definindo a propriedade autoUpgradeMinorVersion como false. Uma vez implantada, no entanto, a extensão não atualizará versões secundárias, a menos que seja reimplantada, mesmo com essa propriedade definida como true. Somente o agente Linux suporta a atualização automática pós-implantação com enableAutomaticUpgrade propriedade (consulte Ativar atualização automática para o agente Linux). A atualização da versão principal é sempre manual (consulte VirtualMachineExtensionInner.AutoUpgradeMinorVersion Property).
Imagens personalizadas da VM do Azure Instalação manual do agente do Log Analytics para Windows/Linux A atualização de VMs para a versão mais recente do agente deve ser executada a partir da linha de comando que executa o pacote do instalador do Windows ou o pacote de shell script instalável e de extração automática do Linux.
VMs que não são do Azure Instalação manual do agente do Log Analytics para Windows/Linux A atualização de VMs para a versão mais recente do agente deve ser executada a partir da linha de comando que executa o pacote do instalador do Windows ou o pacote de shell script instalável e de extração automática do Linux.

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, insira 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.

Nota

Durante a atualização do agente do Log Analytics para Windows, ele não oferece suporte à configuração ou reconfiguração de um espaço de trabalho para relatório. Para configurar o agente, siga um dos métodos suportados listados em Adicionar ou remover um espaço de trabalho.

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 os 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

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 do 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 para 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 se reportar a 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()

Nota

Se você usou a linha de comando ou script anteriormente para instalar ou configurar o agente, EnableAzureOperationalInsights foi substituído por AddCloudWorkspace e RemoveCloudWorkspace.

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 do 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 Instalação.

Agente do 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.

Nota

O Assistente de Configuração do Agente também pode ser executado clicando duas vezes em MMASetup-\<platform\>.exe, que está disponível para download em um espaço de trabalho no portal do Azure.

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 do 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.

Nota

Como parte da transição em curso do Microsoft Operations Management Suite para o Azure Monitor, o Agente Operations Management Suite para Windows ou Linux será referido como o agente Log Analytics para Windows e agente Log Analytics para Linux.

  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.

Nota

Como parte da transição em curso do Microsoft Operations Management Suite para o Azure Monitor, o Agente Operations Management Suite para Windows ou Linux será referido como o agente Log Analytics para Windows e agente Log Analytics para Linux.

  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