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

  • Artigo

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

Importante

O agente herdado do Log Analyticsserá preterido em agosto de 2024. Após essa data, a Microsoft não fornecerá mais suporte para o agente do Log Analytics. Migrar 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 do Windows e do Linux manualmente, ou, automaticamente com base no cenário de implantação e no ambiente em que a VM está em execução.

Ambiente Método de instalação Método de atualização
VM do Azure Extensão de VM do agente Log Analytics para Windows/Linux O agente será atualizado automaticamente depois que o modelo de VM for alterado, a menos que você tenha configurado o modelo do Azure Resource Manager para recusar definindo a propriedade autoUpgradeMinorVersion como falso. Após implantada, no entanto, a extensão não atualizará as versões secundárias, a menos que seja reimplantada, mesmo com essa propriedade definida como verdadeira. Somente o agente do Linux dá suporte à implantação automática de pós-atualização com a propriedade enableAutomaticUpgrade (consulte Habilitar a atualização automática para o agente Linux). A atualização da versão principal é sempre manual (consulte Propriedade VirtualMachineExtensionInner.AutoUpgradeMinorVersion).
Imagens de VM personalizadas 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 deverá executar a partir da linha de comando que executa o pacote do instalador do Windows ou o pacote de scripts do shell autoextraível e instalável 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 deverá executar a partir da linha de comando que executa o pacote do instalador do Windows ou o pacote de scripts do shell autoextraível e instalável 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 de prompt de comando, script ou outra solução de automação ou use o Assistente de Instalação MMASetup-<platform>.msi.

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

  1. Entre no portal do Azure.

  2. No portal do Azure, clique em Todos os serviços. Na lista de recursos, insira Log Analytics. Quando você começa a digitar, a lista é filtrada com base em sua entrada. Escolha workspaces do Log Analytics.

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

  4. No workspace do Log Analytics, selecione o bloco Agentes e, em seguida, selecione Servidores Windows.

  5. Na tela Servidores Windows, selecione a versão apropriada em Baixar Agente do Windows que será baixada dependendo da arquitetura do processador do sistema operacional Windows.

Observação

Durante a atualização do agente do Log Analytics para Windows, não terá suporte para configuração ou reconfiguração de um workspace para relatar. Para configurar o agente, siga um dos métodos com suporte listados em Adicionar ou remover um workspace.

Atualizar usando o Assistente de Instalação

  1. Faça logon no computador com uma conta que tenha direitos administrativos.

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

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

  4. Na caixa de diálogo Instalação do Microsoft Monitoring Agent, selecione Concordo para 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 aparecer, selecione Concluir.

Atualizar a partir da linha de comando

  1. Faça logon 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 isso solicitará o caminho para extrair os arquivos. Como alternativa, você poderá especificar o caminho ao passar os argumentos MMASetup-<platform>.exe /c /t:<Full Path>.

  3. Execute o seguinte comando, em que D:\ é o local do arquivo de log de atualização:

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

Atualizar o agente do Linux

Há suporte para a atualização de versões anteriores (>1.0.0-47). Executar a instalação com o comando --upgrade 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

Habilitar a atualização automática para o agente do Linux

É recomendável 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 workspace usando o agente do Windows ou o agente do Linux.

Agente do Windows

As etapas nesta seção serão necessárias não apenas para quando você quiser reconfigurar o agente do Windows a ser relatado a um workspace diferente ou remover um workspace da configuração, mas também para quando quiser configurar o agente a ser relatado a mais de um workspace. (Essa prática normalmente é referida como várias home pages.) A configuração do agente do Windows a ser relatado para vários workspaces somente poderá ser realizada após a configuração inicial do agente e usando os métodos descritos nesta seção.

Atualizar as configurações do painel de controle

  1. Faça logon no computador com uma conta que tenha direitos administrativos.

  2. Abra o Painel de Controle.

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

  4. Se você estiver removendo um workspace, selecione-o e, em seguida, selecione Remover. Repita essa etapa para qualquer outro workspace que você deseja que o agente interrompa a emissão de relatórios.

  5. Se estiver adicionando um workspace, selecione Adicionar. Na caixa de diálogo Adicionar um Workspace do Log Analytics, cole a ID do workspace e a chave do workspace (chave primária). Caso o computador deva se reportar a um workspace do Log Analytics na nuvem do Azure Government, selecione Azure US Government na lista suspensa da Nuvem do Azure.

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

Remova um workspace usando o PowerShell

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

Adicione um workspace no Azure commercial usando o PowerShell

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

Adicione um workspace no Azure for US Government usando o PowerShell

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

Observação

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

Agente do Linux

As etapas a seguir demonstram como reconfigurar o agente do 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 workspace, execute o seguinte comando:

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

    Um status semelhante ao exemplo a seguir deve ser retornado:

    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 workspace, remova o workspace registrado executando o comando a seguir. Caso contrário, se não estiver registrado, prossiga para a próxima etapa.

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

  3. Para registrar em um workspace diferente, execute o comando a seguir:

    /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

    Um status semelhante ao exemplo a seguir deve ser retornado:

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

Não é necessário reiniciar o serviço do agente para que as alterações entrem em vigor.

Atualize as configurações de proxy

O Agente do Log Analytics (MMA) não usa as configurações de proxy do sistema. Como resultado, será necessário passar as configurações de proxy enquanto instalar 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 métodos a seguir para concluir esta tarefa.

Agente do Windows

Use um agente do Windows.

Configurações de atualização usando o painel de controle

  1. Faça logon no computador com uma conta que tenha direitos administrativos.

  2. Abra o Painel de Controle.

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

  4. Clique em Usar um servidor proxy e forneça a URL e o número de porta do servidor proxy ou gateway. Se o servidor proxy ou o gateway do Log Analytics exigir autenticação, insira o nome de usuário e a senha para autenticar e selecione OK.

Configurações de atualização usando o PowerShell

Copie o seguinte código de exemplo do PowerShell, atualize-o com informações específicas para 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 do Linux

Execute as etapas a seguir se os computadores Linux precisarem se comunicar por meio de um servidor proxy ou gateway do Log Analytics. O valor de configuração de proxy tem a seguinte sintaxe: [protocol://][user:password@]proxyhost[:port]. A propriedade proxyhost aceita um nome de domínio totalmente qualificado ou o 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 as 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 executando o seguinte comando:

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

    Se você visualizar cURL failed to perform on this base url no log, você poderá 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 o agente

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

Agente do Windows

Use o agente do Windows.

Desinstalar usando o painel de controle

  1. Faça logon 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>Desinstalar>Sim.

Observação

Também é possível executar o Assistente de Instalação do Agente clicando duas vezes em MMASetup-\<platform\>.exe, que está disponível para download em um workspace no portal do Azure.

Desinstalar usando a linha de comando

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

  1. Faça logon no computador com uma conta que tenha direitos administrativos.

  2. Para extrair os arquivos de instalação do agente de um prompt de comando com privilégios elevados, execute extract MMASetup-<platform>.exe e será solicitado que você especifique o caminho para extrair os arquivos. Como alternativa, você poderá especificar o caminho ao passar os argumentos extract MMASetup-<platform>.exe /c:<Path> /t:<Path>. Para obter mais informações sobre as opções de linha de comando com suporte do IExpress, confira Opções de linha de comando do IExpress e, em seguida, atualize o exemplo para atender às suas necessidades.

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

Agente do Linux

Para remover o agente, execute o comando a seguir no computador Linux. O argumento --purge 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

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

Use o agente do Windows.

Agente do Windows

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

Observação

Como parte da transição contínua do Microsoft Operations Management Suite para o Azure Monitor, o Agente do OMS para Windows ou Linux será chamado de agente do Log Analytics para Windows e agente do Log Analytics para Linux.

  1. Faça logon no computador com uma conta que tenha direitos administrativos.

  2. Abra o Painel de Controle.

  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 Active Directory, selecione Atualizar automaticamente atribuições de 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 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 do Linux

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

Observação

Como parte da transição contínua do Microsoft Operations Management Suite para o Azure Monitor, o Agente do OMS para Windows ou Linux será chamado de agente do Log Analytics para Windows e agente do Log Analytics para Linux.

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

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

  3. Reinicie o servidor de OMI usando o seguinte comando:

    sudo /opt/omi/bin/service_control restart

Perguntas frequentes

Esta seção fornece respostas para perguntas comuns.

Como faço para que o agente do Log Analytics pare de se comunicar com o Azure Monitor?

Para agentes conectados diretamente ao Log Analytics, abra o Painel de controle e selecione Microsoft Monitoring Agent. Na guia Log Analytics do Azure (OMS) , remova todos os workspaces 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 relatar mais para o Log Analytics.

Próximas etapas