Gerir e manter o agente Log Analytics para Windows e Linux

Artigo
09/24/2022
12 minutos para ler

Após a colocação inicial do agente Log Analytics Windows ou Linux no Azure Monitor, poderá ter de reconfigurar o agente, atualizá-lo ou removê-lo do computador se tiver atingido a fase de reforma no seu ciclo de vida. Pode gerir facilmente estas tarefas de manutenção de rotina manualmente ou através da automatização, o que reduz tanto os erros operacionais como as despesas.

Importante

O agente do Histórico Log Analyticsserá depreciado até agosto de 2024. Migrar para o agente do Azure Monitor antes de agosto de 2024 para continuar a ingerir dados.

Atualizar o agente

Upgrade para a versão mais recente do agente Log Analytics para Windows e Linux manualmente ou automaticamente com base no seu cenário de implementação e no ambiente em que o VM está em execução:

Ambiente	Método de instalação	Método de atualização
VM do Azure	Extensão VM do agente de log analytics para Windows/Linux	O agente é automaticamente atualizado após as alterações do modelo VM, a menos que tenha configurado o seu modelo de Resource Manager Azure para excluir definindo a propriedade autoUpgradeMinorVersion a falsa. Uma vez implementada, no entanto, a extensão não irá atualizar versões menores a menos que seja redistribuída, mesmo com esta propriedade definida como verdadeira. Apenas o agente Linux suporta a implementação automática de posts de atualização com a propriedade activarAutomaticUpgrade (Ver Ativar a atualização automática para o agente Linux). A atualização da versão principal é sempre manual (Ver VirtualMachineExtensionInner.AutoUpgradeMinorVersion Property).
Imagens VM personalizadas do Azure	Instalação manual do agente Log Analytics para Windows/Linux	A atualização dos VMs para a versão mais recente do agente tem de ser executada a partir da linha de comando que executa o pacote instalador do Windows ou do pacote de scripts de concha auto-extrator e instalador do Linux.
VMs não-azure	Instalação manual do agente Log Analytics para Windows/Linux	A atualização dos VMs para a versão mais recente do agente tem de ser executada a partir da linha de comando que executa o pacote instalador do Windows ou do pacote de scripts de concha auto-extrator e instalador do Linux.

Atualizar o agente windows

Para atualizar o agente num VM do Windows para a versão mais recente não instalada utilizando a extensão VM do Log Analytics, ou corre a partir do Pedido de Comando, script ou outra solução de automação, ou utilizando a plataforma> MMASetup<.msi's'.

Pode baixar a versão mais recente do agente Windows a partir do seu espaço de trabalho Log Analytics, executando os seguintes passos.

Inicie sessão no portal do Azure.
No portal do Azure, clique em Todos os serviços. Na lista de recursos, escreva Log Analytics. À medida que começa a escrever, a lista filtra com base na sua entrada. Selecione log analytics espaços de trabalho.
Na sua lista de espaços de trabalho Log Analytics, selecione o espaço de trabalho.
No seu espaço de trabalho Log Analytics, selecione o azulejo de Gestão de Agentes e, em seguida, o Windows Servers.
Na página do Windows Servers , selecione a versão adequada do Download Windows Agent para descarregar dependendo da arquitetura do processador do sistema operativo Windows.

Nota

Durante a atualização do agente Log Analytics para windows, não suporta configurar ou reconfigurar um espaço de trabalho para reportar. Para configurar o agente, é necessário seguir um dos métodos suportados listados no Add ou remover um espaço de trabalho.

Para atualizar usando o Assistente de Configuração

Inscreva-se no computador com uma conta que tenha direitos administrativos.
Execute a plataforma> MMASetup<.exe para iniciar o Assistente de Configuração.
Na primeira página do Assistente de Configuração, clique em Seguinte.
Na caixa de diálogo de configuração do agente de monitorização da Microsoft , clique em aceitar o contrato de licença.
Na caixa de diálogo Configuração do Microsoft Monitoring Agent, clique em Atualizar. A página de estado apresenta o progresso da atualização.
Quando a configuração do Agente de Monitorização da Microsoft tiver sido concluída com sucesso.

Para atualizar a partir da linha de comando

Inscreva-se no computador com uma conta que tenha direitos administrativos.
Para extrair os ficheiros de instalação do agente, a partir de uma pronta MMASetup-<platform>.exe /c de comando elevada, o caminho irá pedir-lhe que o caminho seja extraída para. Em alternativa, pode especificar o caminho passando os argumentos MMASetup-<platform>.exe /c /t:<Full Path>.
Execute o seguinte comando, onde D:\ é a localização do ficheiro de registo de atualização.
```
setup.exe /qn /l*v D:\logs\AgentUpgrade.log AcceptEndUserLicenseAgreement=1
```

Atualizar agente Linux

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

Executar o seguinte comando para atualizar o agente.

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

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

Recomendamos que se permita a atualização automática da extensão utilizando estes comandos para atualizar o agente automaticamente:

PowerShell
CLI do Azure

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

Agente do Windows

Os passos nesta secção são necessários quando pretende não só reconfigurar o agente Windows para reportar a um espaço de trabalho diferente ou remover um espaço de trabalho da sua configuração, mas também quando pretende configurar o agente para reportar a mais de um espaço de trabalho (vulgarmente designado por multi-homing). Configurar o agente Windows para reportar a vários espaços de trabalho só pode ser realizado após a configuração inicial do agente e utilizando os métodos descritos abaixo.

Atualizar as definições a partir de Painel de Controlo

Inscreva-se no computador com uma conta que tenha direitos administrativos.
Abra Painel de Controlo.
Selecione o Agente de Monitorização do Microsoft e, em seguida, clique no separador Azure Log Analytics .
Se remover um espaço de trabalho, selecione-o e clique em Remover. Repita este passo para qualquer outro espaço de trabalho a que o agente deixe de reportar.
Se adicionar um espaço de trabalho, clique em Adicionar e na caixa de diálogo do Log Analytics Workspace , cole o ID do Espaço de Trabalho e a Chave do Espaço de Trabalho (Chave Primária). Caso o computador deva reportar a uma área de trabalho do Log Analytics na cloud do Azure Government, selecione Azure US Government, na lista pendente Cloud do Azure.
Clique em OK para guardar as alterações.

Remova um espaço de trabalho usando PowerShell

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

Adicione um espaço de trabalho em Azure comercial usando PowerShell

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

Adicione um espaço de trabalho em Azure para o governo dos EUA usando PowerShell

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

Nota

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

Agente Linux

Os seguintes passos demonstram como reconfigurar o agente Linux se decidir registá-lo com um espaço de trabalho diferente ou remover um espaço de trabalho da sua configuração.

Para verificar se está registado num espaço de trabalho, execute o seguinte comando:

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

Deve devolver um estatuto semelhante ao seguinte exemplo:

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

É importante que o estado também mostre que o agente está em execução, caso contrário os seguintes passos para reconfigurar o agente não serão concluídos com sucesso.
Se já estiver registado num espaço de trabalho, retire o espaço de trabalho registado executando o seguinte comando. Caso contrário, se não estiver registado, proceda ao passo seguinte.

/opt/microsoft/omsagent/bin/omsadmin.sh -X
Para se registar com um espaço de trabalho diferente, executar o seguinte comando:

/opt/microsoft/omsagent/bin/omsadmin.sh -w <workspace id> -s <shared key> [-d <top level domain>]
Para verificar se as alterações produziram efeitos, executar o seguinte comando:

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

Deve devolver um estatuto semelhante ao seguinte exemplo:

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

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

Atualizar definições de procuração

O Log Analytics Agent (MMA) não utiliza as definições de procuração do sistema. Assim, o utilizador tem de passar a definição de procuração durante a instalação do MMA e estas definições serão armazenadas sob a configuração de MMA (registo) em VM. Para configurar o agente para comunicar ao serviço através de um servidor proxy ou gateway Log Analytics após a implementação, utilize um dos seguintes métodos para completar esta tarefa.

Agente do Windows

Atualizar definições utilizando Painel de Controlo

Inscreva-se no computador com uma conta que tenha direitos administrativos.
Abra Painel de Controlo.
Selecione o Agente de Monitorização da Microsoft e, em seguida, clique no separador Definições de Procuração .
Clique em 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 seu servidor proxy ou o Log Analytics precisarem de autenticação, escreva o nome de utilizador e a palavra-passe para autenticar e clique em OK.

Atualizar definições usando PowerShell

Copie o seguinte código PowerShell, atualize-o com informações específicas para o seu ambiente e guarde-o com uma extensão de nome de ficheiro 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 os seguintes passos se os seus computadores Linux precisarem de comunicar através de um servidor proxy ou gateway Log Analytics. O valor de configuração do proxy tem a seguinte sintaxe [protocol://][user:password@]proxyhost[:port]. A propriedade proxyhost aceita um nome de domínio completamente qualificado ou o endereço IP do servidor proxy.

Edite o ficheiro /etc/opt/microsoft/omsagent/proxy.conf ao executar os comandos seguintes e altere os valores para as definiçõ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

Reinicie o agente ao executar o seguinte comando:

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

Se vir "cURL não executou neste url base" no registo, pode tentar remover '\n' em 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>]

Agente desinstalação

Utilize um dos seguintes procedimentos para desinstalar o windows ou o agente Linux utilizando a linha de comando ou o assistente de configuração.

Agente do Windows

Desinstalar a partir de Painel de Controlo

Inscreva-se no computador com uma conta que tenha direitos administrativos.
Em Painel de Controlo, clique em Programas e Funcionalidades.
Em Programas e Funcionalidades, clique no Agente de Monitorização do Microsoft, clique em Desinstalar e, em seguida, clique em Sim.

Nota

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

Desinstalar da linha de comando

O ficheiro descarregado para o agente é um pacote de instalação independente criado com o IExpress. O programa de configuração do agente e dos ficheiros de suporte estão contidos na embalagem e precisam de ser extraídos para desinstalar corretamente utilizando a linha de comando mostrada no exemplo seguinte.

Inscreva-se no computador com uma conta que tenha direitos administrativos.
Para extrair os ficheiros de instalação do agente, a partir de uma pronta extract MMASetup-<platform>.exe de comando elevada, o caminho irá pedir-lhe que o caminho seja extraída para. Em alternativa, pode especificar o caminho passando os argumentos extract MMASetup-<platform>.exe /c:<Path> /t:<Path>. Para obter mais informações sobre os comutadores da linha de comando suportados pelo IExpress, consulte comutadores de linha de comando para iExpress e, em seguida, atualize o exemplo de acordo com as suas necessidades.
Na origem, escreva %WinDir%\System32\msiexec.exe /x <Path>:\MOMAgent.msi /qb.

Agente Linux

Para remover o agente, execute o seguinte comando no computador Linux. O argumento --purge remove por completo o agente e a respetiva configuração.

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

Configure agente para apresentar-se a um grupo de gestão de gestores de operações

Agente do Windows

Execute os seguintes passos para configurar o agente Log Analytics para que o Windows reporte a um grupo de gestão de Gestor de Operações do System Center.

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.

Inscreva-se no computador com uma conta que tenha direitos administrativos.
Abra Painel de Controlo.
Clique no Agente de Monitorização da Microsoft e, em seguida, clique no separador Gestor de Operações .
Se os servidores do Gestor de Operações tiverem integração com o Ative Directory, clique em atualizar automaticamente as atribuições do grupo de gestão a partir de DS AD.
Clique em Adicionar para abrir a caixa de diálogo Do Grupo de Gestão .
No campo de nome de grupo de Gestão , escreva o nome do seu grupo de gestão.
No campo do servidor de gestão primária , digite o nome do computador do servidor de gestão primária.
No campo de portas do servidor Management , digite o número da porta TCP.
Na Conta de Ação do Agente, escolha a conta do Sistema Local ou uma conta de domínio local.
Clique em OK para fechar a caixa de diálogo Add a Management Group e, em seguida, clique em OK para fechar a caixa de diálogo do Agente de Monitorização da Microsoft .

Agente Linux

Execute os seguintes passos para configurar o agente Log Analytics para que o Linux se reporte a um grupo de gestão de Gestor de Operações do System Center.

Nota

Editar o ficheiro /etc/opt/omi/conf/omiserver.conf
Certifique-se de que a linha começa com httpsport= a porta 1270. Tais como: httpsport=1270
Reiniciar o servidor OMI: sudo /opt/omi/bin/service_control restart

Passos seguintes

Reveja a resolução de problemas do agente Linux se encontrar problemas durante a instalação ou gestão do agente Linux.
Reveja a resolução de problemas do agente Windows se encontrar problemas durante a instalação ou gestão do agente Windows.