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

Após a implantação inicial do Log Analytics Windows ou agente do Linux 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 aposentadoria em seu 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.

Atualizando o agente

O agente de Log Analytics para Windows e Linux pode ser atualizado para a versão mais recente manualmente ou automaticamente, dependendo do cenário de implantação e do ambiente em que a VM está sendo executada. Os métodos a seguir podem ser usados para atualizar o agente.

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 é atualizado automaticamente depois que o modelo de VM é alterado, a menos que você tenha configurado seu modelo do Azure Resource Manager para recusar, definindo a propriedade autoUpgradeMinorVersion como false. Após a implantação, 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. A atualização da versão principal é sempre manual. Confira a propriedade VirtualMachineExtensionInner.AutoUpgradeMinorVersion.
Imagens de VM personalizadas do Azure instalação Manual do agente de Log Analytics para Windows/Linux A atualização de VMs para a versão mais recente do agente precisa ser executada na linha de comando que executa o pacote do instalador do Windows ou o grupo de script de shell instalável e autoextraível do Linux.
VMs que não são do Azure instalação Manual do agente de Log Analytics para Windows/Linux A atualização de VMs para a versão mais recente do agente precisa ser executada na linha de comando que executa o pacote do instalador do Windows ou o grupo de script de shell instalável e autoextraí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 Log Analytics, você pode executar no prompt de comando, script ou outra solução de automação ou usando o Assistente de Instalação MMASetup-<platform>.msi.

Você pode baixar a versão mais recente do agente de Windows de seu espaço de trabalho do Log Analytics, executando as etapas a seguir.

  1. Entre no portal do Azure.

  2. No portal do Azure, clique em Todos os serviços. Na lista de recursos, digite 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 Gerenciamento de agentes e, em seguida, Servidores Windows.

  5. Na página Servidores Windows, selecione a versão apropriada de Baixar Agente do Windows a ser baixada com base na arquitetura do processador do sistema operacional Windows.

Observação

Durante a atualização do agente de Log Analytics para Windows, ele não oferece suporte à configuração ou reconfiguração de um espaço de trabalho para relatar. Para configurar o agente, você precisa seguir um dos métodos com suporte listados em adicionando ou removendo um espaço de trabalho.

Para atualizar com 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, clique em Avançar.

  4. Na caixa de Microsoft Monitoring Agent instalação, clique em Concordo em aceitar o contrato de licença.

  5. Na caixa de diálogo Configuração do Agente de Monitoramento da Microsoft , clique em 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, clique em Concluir.

Para atualizar na 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 de um prompt de comando com privilégios elevados, execute MMASetup-<platform>.exe /c e será solicitado que você especifique 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 para o 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 comando a seguir para atualizar o agente.

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

Adicionando ou removendo workspace

Agente do Windows

As etapas nesta seção são necessárias quando você deseja não apenas reconfigurar o agente de Windows para reportar 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 reportar para mais de um espaço de trabalho (normalmente conhecido como hospedagem múltipla). A configuração do agente de Windows para relatar para vários espaços de trabalho só pode ser executada após a configuração inicial do agente e o uso dos métodos descritos abaixo.

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. Abra o Microsoft Monitoring Agent e clique na guia Azure Log Analytics.

  4. Se remover um workspace, selecione-o e, em seguida, clique em 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 espaço de trabalho, clique em Adicionar e na caixa de diálogo Adicionar um espaço de trabalho do Log Analytics, cole a ID do espaço de trabalho e chave do espaço de trabalho (chave primária). Caso o computador deva se reportar a um espaço de trabalho do Log Analytics na nuvem do Azure Governamental, selecione Azure US Government na lista suspensa do Azure Cloud.

  6. Clique em 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 ele está registrado em um workspace, execute o comando a seguir:

    /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 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)

O serviço do agente não precisa ser reiniciado 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. Portanto, o usuário precisa passar a configuração de proxy durante a instalação do MMA e 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

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. Abra o Microsoft Monitoring Agent e clique na 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. Caso seu servidor proxy ou Gateway do Log Analytics exija autenticação, digite o nome de usuário e a senha para se autenticar e clique em 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 comandos a seguir 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>]
    

Desinstalar o agente

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

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, clique em Programas e Recursos.

  3. Em Programas e Recursos, clique em Microsoft Monitoring Agent e clique em Desinstalar e, em seguida clique em Sim.

Observação

O assistente de instalação do agente também pode ser executado clicando duas vezes em MMASetup-<platform>.exe, que está disponível para download no 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 precisa ser extraído para desinstalar adequadamente 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, digite %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

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. Abra o Microsoft Monitoring Agent e clique na guia Operations Manager.

  4. Se seus servidores do Operations Manager tiverem integração com o Active Directory, clique em Atualizar automaticamente as atribuições de grupo de gerenciamento do AD DS.

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

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

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

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

  9. Na página Conta de Ação de Agente, escolha a conta Sistema Local ou uma conta de domínio local.

  10. Clique em OK para fechar a caixa de diálogo Adicionar um Grupo de Gerenciamento e clique em 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 OMI: sudo /opt/omi/bin/service_control restart

Próximas etapas