Installera Log Analytics-agenten på Windows-datorer

Artikel
10/18/2023

Den här artikeln innehåller information om hur du installerar Log Analytics-agenten på Windows-datorer med hjälp av följande metoder:

Manuell installation med hjälp av installationsguiden eller kommandoraden.
Azure Automation Desired State Configuration (DSC).

Installationsmetoderna som beskrivs i den här artikeln används vanligtvis för virtuella datorer lokalt eller i andra moln. Mer effektiva alternativ som du kan använda för virtuella Azure-datorer finns i Installationsalternativ.

Viktigt!

Den äldre Log Analytics-agentenkommer att vara inaktuell i augusti 2024. Efter det här datumet kommer Microsoft inte längre att tillhandahålla någon support för Log Analytics-agenten. Migrera till Azure Monitor-agenten före augusti 2024 för att fortsätta mata in data.

Kommentar

Om du installerar Log Analytics-agenten behöver du vanligtvis inte starta om datorn.

Krav

Operativsystem som stöds

En lista över Windows-versioner som stöds av Log Analytics-agenten finns i Översikt över Azure Monitor-agenter.

Supportkrav för SHA-2-kodsignering

Windows-agenten började exklusivt använda SHA-2-signering den 17 augusti 2020. Den här ändringen påverkade kunder som använder Log Analytics-agenten i ett äldre operativsystem som en del av en Azure-tjänst, till exempel Azure Monitor, Azure Automation, Azure Update Management, Azure Ändringsspårning, Microsoft Defender för molnet, Microsoft Sentinel och Windows Defender Advanced Threat Protection.

Ändringen kräver ingen kundåtgärd om du inte kör agenten på en äldre operativsystemversion, till exempel Windows 7, Windows Server 2008 R2 och Windows Server 2008. Kunder som kör en äldre operativsystemversion var skyldiga att vidta följande åtgärder på sina datorer före den 17 augusti 2020, eller så slutade deras agenter att skicka data till sina Log Analytics-arbetsytor:

Installera det senaste Service Pack-paketet för operativsystemet. De nödvändiga service pack-versionerna är:
- Windows 7 SP1
- Windows Server 2008 SP2
- Windows Server 2008 R2 SP1
Installera SHA-2-signeringen av Windows-uppdateringar för ditt operativsystem enligt beskrivningen i 2019 SHA-2-kodsigneringsstödkrav för Windows och WSUS.
Uppdatera till den senaste versionen av Windows-agenten (version 10.20.18067).
Vi rekommenderar att du konfigurerar agenten så att den använder TLS 1.2.

Nätverkskrav

Se Översikt över Log Analytics-agenten för nätverkskraven för Windows-agenten.

Konfigurera agenten att använda TLS 1.2

TLS 1.2-protokollet säkerställer säkerheten för data under överföring för kommunikation mellan Windows-agenten och Log Analytics-tjänsten. Om du installerar på ett operativsystem utan TLS aktiverat som standard bör du konfigurera TLS 1.2 med hjälp av stegen nedan.

Leta upp följande registerundernyckel: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols.
Skapa en undernyckel under Protokoll för TLS 1.2: HKLM\System\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2.
Skapa en klientundernyckel under den undernyckel för TLS 1.2-protokollversionen som du skapade tidigare. Till exempel HKLM\System\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client.
Skapa följande DWORD-värden under HKLM\System\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client:
- Aktiverad [Värde = 1]
- DisabledByDefault [Värde = 0]

Konfigurera .NET Framework 4.6 eller senare för att stödja säker kryptografi eftersom det som standard är inaktiverat. Den starka kryptografi använder säkrare nätverksprotokoll som TLS 1.2 och blockerar protokoll som inte är säkra.

Leta upp följande registerundernyckel: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\. NETFramework\v4.0.30319.
Skapa DWORD-värdet SchUseStrongCrypto under den här undernyckeln med värdet 1.
Leta upp följande registerundernyckel: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\. NETFramework\v4.0.30319.
Skapa DWORD-värdet SchUseStrongCrypto under den här undernyckeln med värdet 1.
Starta om systemet för att inställningarna ska börja gälla.

Arbetsyte-ID och nyckel

Oavsett vilken installationsmetod som används behöver du arbetsytans ID och nyckel för Log Analytics-arbetsytan som agenten ska ansluta till. Välj arbetsytan på menyn Log Analytics-arbetsytor i Azure-portalen. Välj sedan Agenter i avsnittet Inställningar.

Kommentar

Du kan inte konfigurera agenten att rapportera till mer än en arbetsyta under den inledande installationen. Lägg till eller ta bort en arbetsyta efter installationen genom att uppdatera inställningarna från Kontrollpanelen eller PowerShell.

Kommentar

Det är möjligt att återskapa delade Log Analytics-arbetsytor, men avsikten med detta är inte att omedelbart begränsa åtkomsten till agenter som använder dessa nycklar. Agenter använder nyckeln för att generera ett certifikat som upphör att gälla efter tre månader. Om du återskapar de delade nycklarna förhindrar det bara att agenter förnyar sina certifikat, inte fortsätter att använda dessa certifikat förrän de upphör att gälla.

Installera agenten

Viktigt!

Följande steg installerar och konfigurerar Log Analytics-agenten i Azure och Azure Government-molnet med hjälp av installationsguiden för agenten på datorn. Om du vill lära dig hur du konfigurerar agenten så att den även rapporterar till en System Center Operations Manager-hanteringsgrupp kan du läsa distribuera Operations Manager-agenten med guiden Konfigurera agent.

På Log Analytics-arbetsytan går du till sidan Windows-servrar som du navigerade till tidigare och väljer lämplig Version av Ladda ned Windows-agent för nedladdning beroende på processorarkitekturen i Windows-operativsystemet.
Kör installationsprogrammet för att installera agenten på datorn.
På sidan Välkommen klickar du på Nästa.
På sidan Licensvillkor läser du licensen och klickar sedan på Jag accepterar.
På sidan Målmapp ändrar du eller behåller standardinstallationsmappen och klickar sedan på Nästa.
På sidan Installationsalternativ för agent väljer du att ansluta agenten till Azure Log Analytics och klickar sedan på Nästa.
På sidan Azure Log Analytics utför du följande:
1. Klistra in Id för arbetsyta och Arbetsytenyckel (primär nyckel) som du kopierade tidigare. Om datorn ska rapportera till en Log Analytics-arbetsyta i Azure Government-molnet väljer du Azure US Government i listrutan Azure Cloud.
2. Om datorn behöver kommunicera via en proxyserver till Log Analytics-tjänsten klickar du på Avancerat och anger URL och portnummer för proxyservern. Om proxyservern kräver autentisering anger du användarnamn och lösenord för att autentisera hos proxyservern och klickar sedan på Nästa.
Klicka på Nästa när du har slutfört konfigurationsinställningarna.
På sidan Klar att installera kontrollerar du valen och klickar sedan på Installera.
På sidan Konfigurationen har slutförts klickar du på Slutför.

När detta är klart visas Microsoft övervakningsagent i kontroll panel. Om du vill bekräfta att den rapporterar till Log Analytics läser du Verifiera agentanslutningen till Log Analytics.

Den nedladdade filen för agenten är ett fristående installationspaket. Installationsprogrammet för agenten och stödfilerna finns i paketet och måste extraheras för att kunna installeras korrekt med hjälp av kommandoraden som visas i följande exempel.

Kommentar

Om du vill uppgradera en agent måste du använda Log Analytics-skript-API:et. Mer information finns i Hantera och underhålla Log Analytics-agenten för Windows och Linux.

I följande tabell visas de specifika parametrar som stöds av konfigurationen för agenten, inklusive när den distribueras med hjälp av Automation DSC.

MMA-specifika alternativ	Kommentar
NOAPM=1	Valfri parameter. Installerar agenten utan prestandaövervakning av .NET-program.
ADD_OPINSIGHTS_WORKSPACE	1 = Konfigurera agenten att rapportera till en arbetsyta.
OPINSIGHTS_WORKSPACE_ID	Arbetsyte-ID (guid) för arbetsytan som ska läggas till.
OPINSIGHTS_WORKSPACE_KEY	Arbetsytenyckeln som användes för att först autentisera med arbetsytan.
OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE	Ange den molnmiljö där arbetsytan finns. 0 = Kommersiellt Azure-moln (standard). 1 = Azure Government. 2 = Azure drivs av 21Vianet-molnet.
OPINSIGHTS_PROXY_URL	URI som proxyn ska använda. Exempel: OPINSIGHTS_PROXY_URL=IPAddress:Port eller OPINSIGHTS_PROXY_URL=FQDN:Port
OPINSIGHTS_PROXY_USERNAME	Användarnamn för åtkomst till en autentiserad proxy.
OPINSIGHTS_PROXY_PASSWORD	Lösenord för åtkomst till en autentiserad proxy.

Om du vill extrahera agentinstallationsfilerna från en upphöjd kommandotolk kör du MMASetup-<platform>.exe /c. Du uppmanas att ange sökvägen för att extrahera filer till. Du kan också ange sökvägen genom att skicka argumenten MMASetup-<platform>.exe /c /t:<Full Path>.

Om du vill installera agenten tyst och konfigurera den för att rapportera till en arbetsyta i det kommersiella Azure-molnet anger du följande från mappen som du extraherade installationsfilerna till:

setup.exe /qn NOAPM=1 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE=0 OPINSIGHTS_WORKSPACE_ID="<your workspace ID>" OPINSIGHTS_WORKSPACE_KEY="<your workspace key>" AcceptEndUserLicenseAgreement=1

Om du vill konfigurera agenten att rapportera till Azure US Government-molnet anger du:

setup.exe /qn NOAPM=1 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE=1 OPINSIGHTS_WORKSPACE_ID="<your workspace ID>" OPINSIGHTS_WORKSPACE_KEY="<your workspace key>" AcceptEndUserLicenseAgreement=1

Om du vill konfigurera agenten att rapportera till Microsoft Azure som drivs av 21Vianet-molnet anger du:

setup.exe /qn NOAPM=1 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE=2 OPINSIGHTS_WORKSPACE_ID="<your workspace ID>" OPINSIGHTS_WORKSPACE_KEY="<your workspace key>" AcceptEndUserLicenseAgreement=1

Kommentar

Strängvärdena för parametrarna OPINSIGHTS_WORKSPACE_ID och OPINSIGHTS_WORKSPACE_KEY måste omges av dubbla citattecken för att instruera Windows Installer att tolka som giltiga alternativ för paketet.

Du kan använda följande skriptexempel för att installera agenten med hjälp av Azure Automation DSC. Om du inte har något Automation-konto kan du läsa Komma igång med Azure Automation för att förstå krav och steg för att skapa ett Automation-konto som krävs innan du använder Automation DSC. Om du inte är bekant med Automation DSC kan du läsa Komma igång med Automation DSC.

I följande exempel installeras 64-bitarsagenten som identifieras av URI värdet. Du kan också använda 32-bitarsversionen genom att ersätta URI-värdet. URI:erna för båda versionerna är:

Windows 64-bitarsagent:https://go.microsoft.com/fwlink/?LinkId=828603
Windows 32-bitarsagent:https://go.microsoft.com/fwlink/?LinkId=828604

Kommentar

Den här proceduren och skriptexemplet stöder inte uppgradering av agenten som redan har distribuerats till en Windows-dator.

32-bitars- och 64-bitarsversionerna av agentpaketet har olika produktkoder och nya versioner har också ett unikt värde. Produktkoden är ett GUID som är huvudidentifieringen för ett program eller en produkt och som representeras av egenskapen Windows Installer ProductCode . Värdet ProductId i MMAgent.ps1-skriptet måste matcha produktkoden från 32-bitars- eller 64-bitars agentinstallationspaketet.

Om du vill hämta produktkoden direkt från agentinstallationspaketet kan du använda Orca.exe från Windows SDK-komponenterna för Windows Installer Developers, som är en komponent i Windows Software Development Kit, eller använda PowerShell genom att följa ett exempelskript skrivet av en Microsoft Valuable Professional (MVP). För endera metoden måste du först extrahera MOMagent.msi-filen från MMASetup-installationspaketet, enligt beskrivningen i det första steget i anvisningarna för att installera agenten med hjälp av kommandoraden.

Importera DSC-modulen xPSDesiredStateConfiguration från https://www.powershellgallery.com/packages/xPSDesiredStateConfiguration till Azure Automation.
Skapa Azure Automation-variabeltillgångar för OPSINSIGHTS_WS_ID och OPSINSIGHTS_WS_KEY. Ange OPSINSIGHTS_WS_ID till ditt Log Analytics-arbetsyte-ID och ange OPSINSIGHTS_WS_KEY till arbetsytans primära nyckel.

Kopiera skriptet och spara det som MMAgent.ps1.

Configuration MMAgent
{
    $OIPackageLocalPath = "C:\Deploy\MMASetup-AMD64.exe"
    $OPSINSIGHTS_WS_ID = Get-AutomationVariable -Name "OPSINSIGHTS_WS_ID"
    $OPSINSIGHTS_WS_KEY = Get-AutomationVariable -Name "OPSINSIGHTS_WS_KEY"

    Import-DscResource -ModuleName xPSDesiredStateConfiguration
    Import-DscResource -ModuleName PSDesiredStateConfiguration

    Node OMSnode {
        Service OIService
        {
            Name = "HealthService"
            State = "Running"
            DependsOn = "[Package]OI"
        }

        xRemoteFile OIPackage {
            Uri = "https://go.microsoft.com/fwlink/?LinkId=828603"
            DestinationPath = $OIPackageLocalPath
        }

        Package OI {
            Ensure = "Present"
            Path  = $OIPackageLocalPath
            Name = "Microsoft Monitoring Agent"
            ProductId = "8A7F2C51-4C7D-4BFD-9014-91D11F24AAE2"
            Arguments = '/C:"setup.exe /qn NOAPM=1 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_ID=' + $OPSINSIGHTS_WS_ID + ' OPINSIGHTS_WORKSPACE_KEY=' + $OPSINSIGHTS_WS_KEY + ' AcceptEndUserLicenseAgreement=1"'
            DependsOn = "[xRemoteFile]OIPackage"
        }
    }
}

ProductId Uppdatera värdet i skriptet med produktkoden som extraherats från den senaste versionen av agentinstallationspaketet med hjälp av de metoder som rekommenderades tidigare.
Importera konfigurationsskriptet MMAgent.ps1 till ditt Automation-konto.
Tilldela en Windows-dator eller -nod till konfigurationen. Inom 15 minuter kontrollerar noden dess konfiguration och agenten skickas till noden.

Verifiera agentanslutningen till Azure Monitor

När installationen av agenten är klar kan du kontrollera att den har anslutits och rapporterar på två sätt.

Från System och säkerhet i Kontrollpanelen hittar du objektet Microsoft Monitoring Agent. Välj det, och på fliken Azure Log Analytics bör agenten visa ett meddelande om att Microsoft Monitoring Agent har anslutit till Microsoft Operations Management Suite-tjänsten.

Du kan också utföra en loggfråga i Azure-portalen:

I Azure-portalen söker du efter och väljer Övervaka.
Välj Loggar på menyn.

I fönstret Loggar i frågefältet anger du:

Heartbeat 
| where Category == "Direct Agent" 
| where TimeGenerated > ago(30m)

I sökresultaten som returneras bör du se pulsslagsposter för datorn som anger att den är ansluten och rapporterar till tjänsten.

Cacheinformation

Data från Log Analytics-agenten cachelagras på den lokala datorn på C:\Program Files\Microsoft Monitoring Agent\Agent\Hälsotjänst State innan de skickas till Azure Monitor. Agenten försöker ladda upp var 20:e sekund. Om den misslyckas väntar den exponentiellt ökande tid tills den lyckas. Den väntar 30 sekunder före det andra försöket, 60 sekunder före nästa, 120 sekunder, och så vidare till högst 8,5 timmar mellan återförsöken tills den ansluter igen. Den här väntetiden är något slumpmässig för att undvika att alla agenter försöker ansluta samtidigt. Äldsta data ignoreras när den maximala bufferten nås.

Standardstorleken för cachen är 50 MB, men den kan konfigureras mellan minst 5 MB och högst 1,5 GB. Den lagras i registernyckeln HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HealthService\Parameters\Persistence Cache Maximum. Värdet representerar antalet sidor med 8 kB per sida.

Nästa steg

Läs Hantera och underhålla Log Analytics-agenten för Windows och Linux för att lära dig hur du konfigurerar om, uppgraderar eller tar bort agenten från den virtuella datorn.
Läs Felsöka Windows-agenten om du stöter på problem när du installerar eller hanterar agenten.

Installera Log Analytics-agenten på Windows-datorer

Krav

Operativsystem som stöds

Supportkrav för SHA-2-kodsignering

Nätverkskrav

Konfigurera agenten att använda TLS 1.2

Arbetsyte-ID och nyckel

Installera agenten

Verifiera agentanslutningen till Azure Monitor

Cacheinformation

Nästa steg

Ytterligare resurser