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

  • Articolo

Dopo la distribuzione iniziale dell'agente 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 di ritiro nel 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'agentedi Log Analytics legacy sarà deprecato entro agosto 2024. Dopo questa data, Microsoft non fornirà più supporto per l'agente di Log Analytics. Eseguire la migrazione all'agente di Monitoraggio di Azure prima di agosto 2024 per continuare l'inserimento dei dati.

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 macchina virtuale dell'agente di Log Analytics per Windows/Linux L'agente viene aggiornato automaticamente dopo la modifica del modello di macchina virtuale, a meno che il modello di Azure Resource Manager non 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 non venga ridistribuibile, anche con questa proprietà impostata su true. Solo l'agente Linux supporta la distribuzione automatica post-distribuzione con enableAutomaticUpgrade la proprietà (vedere Abilitare l'aggiornamento automatico per l'agente Linux). L'aggiornamento della versione principale è sempre manuale (vedere la proprietà VirtualMachineExtensionInner.AutoUpgradeMinorVersion).
Immagini di macchine virtuali di Azure personalizzate Installazione manuale dell'agente di Log Analytics per Windows/Linux L'aggiornamento delle macchine virtuali alla versione più recente dell'agente deve essere eseguito dalla riga di comando che esegue il pacchetto windows installer o il bundle di script della shell installabile e autoestraibile di Linux.
Macchine virtuali non di Azure Installazione manuale dell'agente di Log Analytics per Windows/Linux L'aggiornamento delle macchine virtuali alla versione più recente dell'agente deve essere eseguito dalla riga di comando che esegue il pacchetto windows installer o il bundle di script della shell installabile e autoestraibile di Linux.

Aggiornare l'agente di Windows

Per aggiornare l'agente in una macchina virtuale Windows alla versione più recente non installata tramite l'estensione vm di Log Analytics, eseguire dal prompt dei comandi, dallo script o da un'altra soluzione di automazione oppure usare l'Installazione guidata MMASetup-platform.msi<>.

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

  1. Accedi 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 Log Analytics selezionare l'area di lavoro.

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

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

Nota

Durante l'aggiornamento dell'agente di Log Analytics per Windows, non supporta la configurazione o la riconfigurazione di un'area di lavoro a cui creare report. Per configurare l'agente, seguire uno dei metodi supportati elencati in Aggiungere o rimuovere un'area di lavoro.

Eseguire l'aggiornamento tramite 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 guidata selezionare Avanti.

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

  5. Nella finestra di dialogo Installazione di Microsoft Monitoring Agent selezionare Aggiorna. Nella pagina di stato viene visualizzato l'avanzamento dell'aggiornamento.

  6. Quando viene visualizzata la pagina Configurazione di Microsoft Monitoring Agent completata correttamente , 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 e richiederà il percorso in cui estrarre i file. In alternativa, è possibile specificare il percorso passando gli argomenti MMASetup-<platform>.exe /c /t:<Full Path>.

  3. Eseguire il comando seguente, dove D:\ è il percorso del file di log di aggiornamento:

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

Aggiornare l'agente Linux

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

Eseguire il comando seguente per aggiornare l'agente:

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

Abilitare l'aggiornamento automatico per l'agente Linux

È consigliabile abilitare l'aggiornamento automatico dell'estensione 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 Windows o l'agente Linux.

Agente Windows

I passaggi di questa sezione sono necessari non solo quando si vuole riconfigurare l'agente di Windows per segnalare a un'area di lavoro diversa o rimuovere un'area di lavoro dalla configurazione, ma anche quando si vuole configurare l'agente per segnalare a più aree di lavoro. Questa pratica viene comunemente definita multihoming. La configurazione dell'agente di Windows per segnalare a più aree di lavoro può essere eseguita solo dopo la configurazione iniziale dell'agente e usando 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 e quindi selezionare la scheda Azure Log Analytics .

  4. Se si rimuove un'area di lavoro, selezionarla e 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 aggiunge un'area di lavoro, selezionare Aggiungi. Nella finestra di dialogo Aggiungi un'area di lavoro Log Analytics incollare l'ID 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

I passaggi seguenti illustrano come riconfigurare l'agente Linux se si decide di registrarlo in un'area di lavoro diversa o di rimuovere un'area di lavoro dalla 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 lo stato mostri anche che l'agente è in esecuzione. In caso contrario, la procedura seguente per riconfigurare l'agente non verrà completata correttamente.

  2. Se l'agente è già registrato con un'area di lavoro, rimuovere l'area di lavoro registrata eseguendo il comando seguente. In caso contrario, se non è 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 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)

Non è necessario riavviare il servizio agente per rendere effettive le modifiche.

Aggiornare le impostazioni proxy

L'agente di Log Analytics (MMA) non usa le impostazioni proxy di sistema. Di conseguenza, è necessario passare le impostazioni proxy durante l'installazione di MMA. Queste impostazioni verranno archiviate nella configurazione MMA (Registro di sistema) nella 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 e quindi la scheda Proxy Impostazioni.

  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 di Log Analytics richiede l'autenticazione, immettere il nome utente e la password per l'autenticazione e 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 in 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 proxy ha la sintassi seguente: [protocol://][user:password@]proxyhost[:port]. La proxyhost proprietà accetta un nome di dominio completo o un indirizzo IP del server proxy.

  1. Modificare il file /etc/opt/microsoft/omsagent/proxy.conf eseguendo i comandi seguenti e modificare i valori in 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' in proxy.conf EOF 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

Usare una delle procedure seguenti per disinstallare l'agente Windows o Linux usando 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. In Pannello di controllo selezionare Programmi e funzionalità.

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

Nota

È anche possibile eseguire l'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 per l'agente e i file di supporto sono contenuti nel pacchetto e devono essere estratti per disinstallare correttamente usando la riga di comando illustrata 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 relativa 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 e quindi selezionare la scheda Operations Manager .

  4. Se i server Operations Manager hanno l'integrazione con Active Directory, selezionare Aggiorna automaticamente le assegnazioni dei 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 del 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 un 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. Assicurarsi che la riga che inizia con httpsport= definisca la porta 1270, ad esempio . httpsport=1270

  3. Riavviare il server OMI usando il comando seguente:

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