Condividi tramite

Gestire e mantenere l'agente di Log Analytics per Windows e Linux

  • Articolo

Dopo la distribuzione iniziale dell'agente di Windows o Linux di Log Analytics in Monitoraggio di Azure potrebbe essere necessario riconfigurare l'agente, aggiornarlo o rimuoverlo dal computer se ha raggiunto la fase conclusiva del ciclo di vita. È possibile gestire facilmente queste attività di manutenzione di routine manualmente o tramite l'automazione, che riduce sia gli errori operativi che le spese.

Importante

L'agente di Log Analytics legacy è stato deprecato il 31 agosto 2024. Microsoft non fornirà più alcun supporto per l'agente di Log Analytics. Se si usa l'agente di Log Analytics per inserire dati in Monitoraggio di Azure, eseguire la migrazione adesso al nuovo agente di Monitoraggio di Azure.

Aggiornare l'agente

Eseguire l'aggiornamento alla versione più recente dell'agente di Log Analytics per Windows e Linux manualmente o automaticamente, in base allo scenario di distribuzione e all'ambiente in cui è in esecuzione la macchina virtuale.

Ambiente Metodo di installazione Metodo di aggiornamento
Macchina virtuale di Azure Estensione VM dell'agente di Log Analytics per Windows/Linux L'agente viene aggiornato automaticamente dopo la modifica del modello di VM a meno che il modello di Azure Resource Manager sia stato configurato per rifiutare esplicitamente impostando la proprietà autoUpgradeMinorVersion su false. Dopo la distribuzione, tuttavia, l'estensione non aggiornerà le versioni secondarie a meno che venga ridistribuita, anche con questa proprietà impostata su true. Solo l'agente di Linux supporta la distribuzione automatica post-distribuzione con la proprietà enableAutomaticUpgrade (consultare la sezione Abilitare l'aggiornamento automatico per l'agente di Linux). L'aggiornamento della versione principale è sempre manuale (consultare Proprietà VirtualMachineExtensionInner.AutoUpgradeMinorVersion).
Immagini di macchina virtuale personalizzata di Azure Installazione manuale dell'agente di Log Analytics per Windows/Linux L'aggiornamento delle VM alla versione più recente dell'agente deve essere eseguito tramite la riga di comando che esegue il pacchetto Windows Installer o il bundle di script della shell installabile e autoestraibile per Linux.
Macchine virtuali diverse da Azure Installazione manuale dell'agente di Log Analytics per Windows/Linux L'aggiornamento delle VM alla versione più recente dell'agente deve essere eseguito tramite la riga di comando che esegue il pacchetto Windows Installer o il bundle di script della shell installabile e autoestraibile per Linux.

Aggiornare l'agente di Windows

Per aggiornare l'agente in una macchina virtuale Windows alla versione più recente non installata usando l'estensione della macchina virtuale di Log Analytics, è necessaria l'esecuzione dal prompt dei comandi, dallo script o da un'altra soluzione di automazione, oppure si può usare l'installazione guidata MMASetup-<platform>.msi.

Per scaricare la versione più recente dell'agente per Windows dall'area di lavoro Log Analytics:

  1. Accedere al portale di Azure.

  2. Nel portale di Azure fare clic su Tutti i servizi. Nell'elenco delle risorse immettere Log Analytics. Quando si inizia a digitare, l'elenco viene filtrato in base all'input. Selezionare Aree di lavoro di Log Analytics.

  3. Nell'elenco di aree di lavoro di Log Analytics selezionare l'area di lavoro.

  4. Nell'area di lavoro Log Analytics selezionare il riquadro Agenti, quindi selezionare Server Windows.

  5. Nella schermata Server Windows selezionare la versione da scaricare in Scarica agente Windows a seconda dell'architettura del processore del sistema operativo Windows.

Nota

Durante l'aggiornamento dell'agente di Log Analytics per Windows non sono supportate la configurazione né la riconfigurazione di un'area di lavoro alla quale fare riferimento. Per configurare l'agente seguire uno dei metodi supportati elencati in Aggiungere o rimuovere un'area di lavoro.

Eseguire l'aggiornamento mediante l'installazione guidata

  1. Accedere al computer con un account con diritti amministrativi.

  2. Eseguire MMASetup-<platform>.exe per avviare l'installazione guidata.

  3. Nella prima pagina dell'installazione guidataselezionare Avanti.

  4. Nella finestra di dialogo Installazione di Microsoft Monitoring Agent, selezionare Accetto per accettare il contratto di licenza.

  5. Nella finestra di dialogo Configurazione di Microsoft Monitoring Agent, selezionare Aggiornamento. Nella pagina di stato viene visualizzato l'avanzamento dell'aggiornamento.

  6. Quando viene visualizzata la pagina Configurazione di Microsoft Monitoring Agent completata, selezionare Fine.

Eseguire l'aggiornamento dalla riga di comando

  1. Accedere al computer con un account con diritti amministrativi.

  2. Per estrarre i file di installazione dell'agente, eseguire MMASetup-<platform>.exe /c da un prompt dei comandi con privilegi elevati; verrà chiesto in quale percorso estrarre i file. In alternativa, è possibile specificare il percorso passando gli argomenti MMASetup-<platform>.exe /c /t:<Full Path>.

  3. Eseguire questo comando, dove D:\ equivale al percorso del file del log dell'aggiornamento:

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

Aggiornare l'agente di Linux

È supportato l'aggiornamento dalle versioni precedenti (>1.0.0-47). L'esecuzione dell'installazione con il comando --upgrade comporta l'aggiornamento di tutti i componenti dell'agente alla versione più recente.

Per aggiornare l'agente, eseguire il seguente comando:

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

Abilitare l'aggiornamento automatico per l'agente di Linux

È consigliabile abilitare l'aggiornamento automatico delle estensioni usando questi comandi per aggiornare automaticamente l'agente.

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

Aggiungere o rimuovere un'area di lavoro

Aggiungere o rimuovere un'area di lavoro usando l'agente di Windows o l'agente di Linux.

Agente Windows

I passaggi di questa sezione sono necessari non solo per riconfigurare l'agente di Windows in modo che faccia riferimento a un'area di lavoro diversa o rimuovere un'area di lavoro dalla configurazione, ma anche per configurare l'agente in modo che faccia riferimento a più aree di lavoro. Questa pratica è comunemente definita multihoming. La configurazione dell'agente di Windows affinché faccia riferimento a più aree di lavoro può essere eseguita solo dopo la configurazione iniziale dell'agente, con i metodi descritti in questa sezione.

Aggiornare le impostazioni dal Pannello di controllo

  1. Accedere al computer con un account con diritti amministrativi.

  2. Aprire il Pannello di controllo.

  3. Selezionare Microsoft Monitoring Agent, quindi selezionare la scheda Azure Log Analytics.

  4. Se si sta rimuovendo un'area di lavoro, selezionarla, quindi selezionare Rimuovi. Ripetere questo passaggio per ogni altra area di lavoro per cui si vuole che l'agente interrompa l'invio di report.

  5. Se si sta aggiungendo un'area di lavoro, selezionare Aggiungi. Nella finestra di dialogo Aggiungi un'area di lavoro Log Analytics, incollare l'ID dell'area di lavoro e la chiave dell'area di lavoro (chiave primaria). Se il computer deve fare riferimento a un'area di lavoro Log Analytics nel cloud di Azure per enti pubblici, selezionare Azure US Government nell'elenco a discesa Cloud di Azure.

  6. Selezionare OK per salvare le modifiche.

Rimuovere un'area di lavoro usando PowerShell

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

Aggiungere un'area di lavoro in Azure Commercial usando PowerShell

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

Aggiungere un'area di lavoro in Azure per enti pubblici degli Stati Uniti 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 in precedenza si è scelto di usare la riga di comando o uno script per installare o configurare l'agente, EnableAzureOperationalInsights è stato sostituito da AddCloudWorkspace e RemoveCloudWorkspace.

Agente Linux

La seguente procedura illustra come riconfigurare l'agente di Linux se si decide di registrarlo in un'area di lavoro diversa o per rimuovere un'area di lavoro dalla sua configurazione.

  1. Per verificare che l'agente sia registrato in un'area di lavoro, eseguire il comando seguente:

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

    Dovrebbe essere restituito uno stato simile all'esempio seguente:

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

    È importante che nello stato dia indicato anche che l'agente è in esecuzione. In caso contrario la seguente procedura di riconfigurazione dell'agente non verrà completata correttamente.

  2. Se l'agente è già registrato in un'area di lavoro, rimuovere l'area di lavoro registrata eseguendo questo comando. Se non è ancora stato registrato, procedere con il passaggio successivo.

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

  3. Per registrare l'agente in un'altra area di lavoro, eseguire il comando seguente:

    /opt/microsoft/omsagent/bin/omsadmin.sh -w <workspace id> -s <shared key> [-d <top level domain>]

  4. Per verificare che le modifiche siano state applicate, eseguire questo comando:

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

    Dovrebbe essere restituito uno stato simile all'esempio seguente:

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

Non è necessario riavviare il servizio agente per far sì che le modifiche abbiano effetto.

Aggiornare le impostazioni proxy

L'agente di Log Analytics (MMA) non usa le impostazioni proxy di sistema. È quindi necessario passare le impostazioni del proxy durante l'installazione di MMA. Queste impostazioni verranno archiviate nella configurazione di MMA (registro di sistema) sulla macchina virtuale. Per configurare l'agente per comunicare con il servizio tramite un server proxy o il gateway Log Analytics dopo la distribuzione, usare uno dei modi seguenti per completare questa attività.

Agente Windows

Usare un agente di Windows.

Aggiornare le impostazioni usando il Pannello di controllo

  1. Accedere al computer con un account con diritti amministrativi.

  2. Aprire il Pannello di controllo.

  3. Selezionare Microsoft Monitoring Agent, quindi selezionare la scheda Impostazioni proxy.

  4. Selezionare Usa un server proxy e specificare URL e numero di porta del server proxy o del gateway. Se il server proxy o il gateway Log Analytics richiedono l'autenticazione, immettere il nome utente e la password per l'autenticazione quindi selezionare OK.

Aggiornare le impostazioni usando PowerShell

Copiare il codice di PowerShell di esempio seguente, aggiornarlo con le informazioni specifiche per l'ambiente e salvarlo con un'estensione PS1. Eseguire lo script su ogni computer che si connette direttamente all'area di lavoro Log Analytics in Monitoraggio di Azure.

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

Se i computer Linux devono comunicare tramite un server proxy o un gateway Log Analytics, eseguire la procedura seguente. Il valore di configurazione del proxy ha la seguente sintassi: [protocol://][user:password@]proxyhost[:port]. La proprietà proxyhost accetta un nome di dominio completo o l'indirizzo IP del server proxy.

  1. Modificare il file /etc/opt/microsoft/omsagent/proxy.conf eseguendo i seguenti comandi e modificare i valori nelle proprie impostazioni specifiche:

    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. Riavviare l'agente eseguendo il comando seguente:

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

    Se nel log viene visualizzato cURL failed to perform on this base url, è possibile provare a rimuovere '\n' nella EOF di proxy.conf per risolvere l'errore:

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

Disinstallare l'agente

Seguire una di queste procedure per disinstallare l'agente di Windows o Linux tramite la riga di comando o l'installazione guidata.

Agente Windows

Usare l'agente di Windows.

Eseguire la disinstallazione dal Pannello di controllo

  1. Accedere al computer con un account con diritti amministrativi.

  2. Nel Pannello di controllo, selezionare Programmi e funzionalità.

  3. In Programmi e funzionalità, selezionare Microsoft Monitoring Agent>Disinstalla>Sì.

Nota

È anche possibile eseguire la procedura Installazione guidata agente facendo doppio clic su MMASetup-\<platform\>.exe, disponibile per il download da un'area di lavoro nel portale di Azure.

Eseguire la disinstallazione dalla riga di comando

Il file scaricato per l'agente è un pacchetto di installazione autonomo creato con IExpress. Il programma di installazione dell'agente e i file di supporto sono nel pacchetto e devono essere estratti per eseguire correttamente la disinstallazione tramite la riga di comando mostrata nell'esempio seguente.

  1. Accedere al computer con un account con diritti amministrativi.

  2. Per estrarre i file di installazione dell'agente, da un prompt dei comandi con privilegi elevati eseguire extract MMASetup-<platform>.exe e verrà chiesto il percorso in cui estrarre i file. In alternativa, è possibile specificare il percorso passando gli argomenti extract MMASetup-<platform>.exe /c:<Path> /t:<Path>. Per altre informazioni sulle opzioni della riga di comando supportate da IExpress, vedere Opzioni della riga di comando per i pacchetti di aggiornamento software IExpress e aggiornare l'esempio in base alle esigenze.

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

Agente Linux

Per rimuovere l'agente, eseguire il comando seguente nel computer Linux. L'argomento --purge rimuove completamente l'agente e la sua configurazione.

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

Configurare l'agente per l'invio di report a un gruppo di gestione di Operations Manager

Usare l'agente di Windows.

Agente Windows

Seguire questa procedura per configurare l'agente di Log Analytics per Windows per l'invio di report a un gruppo di gestione di System Center Operations Manager.

Nota

Nel quadro della transizione in corso da Microsoft Operations Management Suite a Monitoraggio di Azure, l'agente di Operations Management Suite Agent per Windows o Linux verrà indicato come agente di Log Analytics per Windows e agente di Log Analytics per Linux.

  1. Accedere al computer con un account con diritti amministrativi.

  2. Aprire il Pannello di controllo.

  3. Selezionare Microsoft Monitoring Agent, quindi selezionare la scheda Operations Manager.

  4. Se i server di Operations Manager sono configurati per l'integrazione con Active Directory, selezionare Aggiorna automaticamente assegnazioni gruppi di gestione da Servizi di dominio Active Directory.

  5. Selezionare Aggiungi per aprire la finestra di dialogo Aggiungi gruppo di gestione.

  6. Nel campo Nome gruppo di gestione, immettere il nome del gruppo di gestione.

  7. Nel campo Server di gestione primario immettere il nome del computer del server di gestione primario.

  8. Nel campo Porta server di gestione immettere il numero di porta TCP.

  9. In Account azione agente, scegliere l'account di sistema locale o un account di dominio locale.

  10. Selezionare OK per chiudere la finestra di dialogo Aggiungi gruppo di gestione. Selezionare quindi OK per chiudere la finestra di dialogo Proprietà di Microsoft Monitoring Agent.

Agente Linux

Seguire questa procedura per configurare l'agente di Log Analytics per Linux per l'invio di report a un gruppo di gestione di System Center Operations Manager.

Nota

Nel quadro della transizione in corso da Microsoft Operations Management Suite a Monitoraggio di Azure, l'agente di Operations Management Suite Agent per Windows o Linux verrà indicato come agente di Log Analytics per Windows e agente di Log Analytics per Linux.

  1. Modificare il file /etc/opt/omi/conf/omiserver.conf.

  2. Verificare che la riga che inizia con httpsport= definisca la porta 1270, ad esempio, httpsport=1270.

  3. Riavviare il server OMI usando il seguente comando:

    sudo /opt/omi/bin/service_control restart

Domande frequenti

Questa sezione fornisce le risposte alle domande comuni.

Come si arresta la comunicazione tra l’agente di Log Analytics e Monitoraggio di Azure?

Per gli agenti connessi direttamente a Log Analytics, aprire il Pannello di controllo e selezionare Microsoft Monitoring Agent. Nella scheda Azure Log Analytics (OMS) rimuovere tutte le aree di lavoro elencate. In System Center Operations Manager, rimuovere il computer dall'elenco di computer gestiti da Log Analytics. Operations Manager aggiorna la configurazione dell'agente affinché non invii altri report a Log Analytics.

Passaggi successivi