Partilhar via

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.

Importante

O agente herdado do Log Analytics foi descontinuado a partir de 31 de agosto de 2024. A Microsoft não fornecerá mais suporte para o agente do Log Analytics. Se você usar o agente do Log Analytics para ingerir dados para o Azure Monitor, migre agora para o agente do Azure Monitor.

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 que não tenha sido instalada usando a extensão de VM do Log Analytics, pode executar a operação a partir do prompt de comando, utilizando um script ou uma solução de automação, ou pode usar o Assistente de Instalação MMASetup-platform.msi.

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.

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 ficheiros de instalação do agente, execute MMASetup-<platform>.exe /c a partir de um prompt de comando elevado e ele solicitará o caminho onde pretende extrair os ficheiros. 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 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 o separador 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 deverá reportar a um espaço de trabalho do Log Analytics na nuvem do Governo dos EUA do Azure, 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 o 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 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>>

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 ficheiros de instalação do agente, a partir de um prompt de comando elevado, execute extract MMASetup-<platform>.exe e ele solicitará o caminho para onde extrair os ficheiros. 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. Na linha de comandos, escreva %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 para um grupo de gestão 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.

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 o Windows e o agente Log Analytics para o 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 o separador 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 os passos seguintes para configurar o agente do Log Analytics para Linux para reportar a um grupo de gestão 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 o Windows e o agente Log Analytics para o 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