Konvertera konfiguration av arbetsytor till DCR-konfigurationer
Medan Log Analytics-agenten ärver sin konfiguration från Log Analytics-arbetsytor förlitar sig Azure Monitor-agenten på datainsamlingsregler (DCR) för konfiguration
Konfigurationen av arbetsytan till DCR-konfigurationsgeneratorn är en PowerShell som läser konfigurationen från din arbetsyta och skapar flera DCR ARM-mallar baserat på de MMA-konfigurationer som finns på arbetsytan.
Förutsättningar
- PowerShell version 7.1.3 eller senare rekommenderas (lägsta version 5.1)
- Az PowerShell-modul för att hämta konfigurationsinformation för arbetsytans agent Az PowerShell-modul. Information om hur du installerar Az PowerShell-modulen finns i Installera Azure PowerShell i Windows
- Läs-/skrivåtkomst till den angivna arbetsytans resurs
Installation och körning
Ladda ned PowerShell-skriptet från Git Hub.
Skriptet hämtar konfigurationen av de äldre agentkonfigurationerna från arbetsytan och genererar DCR ARM-mallar för varje DCR-typ som stöds i den angivna utdatamappen. Fler än en mall kan skapas, en för varje DCR-typ.
För flera arbetsytor med konfigurerade datasamlingar måste du köra skriptet för varje arbetsyta. IIS loggar skriptet skapar också ytterligare en roll för datainsamling som en del av den konfigurationen.
När skriptet är klart uppmanas du att testa distributionen av mallen i din miljö. Välj att antingen låta den distribuera mallen åt dig eller lagra mallens angivna utdatamapp
Kommentar
Skriptet associerar inte DCR:erna med arbetsytan. Du måste skapa egna datainsamlingsregelassociationer (DCRA) för att associera domänkontrollanterna med relevanta servrar. På så sätt kan du styra distributionen av domänkontrollanter till servrarna och testa DCR:erna på ett exempel på servrar innan du distribuerar i stor skala.
Om du vill köra skriptet kopierar du följande kommando och ersätter parametrarna med dina värden:
.\WorkspaceConfigToDCRMigrationTool.ps1 -SubscriptionId $subId -ResourceGroupName $rgName -WorkspaceName $workspaceName -DCRName $dcrName -OutputFolder $outputFolderPath
Skriptparametrar
Namn | Obligatoriskt | Beskrivning |
---|---|---|
SubscriptionId |
JA | Arbetsytans prenumerations-ID |
ResourceGroupName |
JA | Arbetsytans resursgrupp |
WorkspaceName |
JA | Namnet på arbetsytan (Azure-resurs-ID:t är skiftlägesokänsliga) |
DCRName |
JA | Basnamnet som används för var och en av utdata-DCR:erna |
OutputFolder |
NEJ | Sökvägen till utdatamappen. Om det inte anges används arbetskatalogsökvägen |
Utgångar:
- För varje som stöds
DCR type
skapar skriptet en DCR ARM-mall och en DCR-nyttolast för användare som inte behöver ARM-mallen.
DCR-typer som stöds för närvarande:
- Windows innehåller
WindowsPerfCounters
ochWindowsEventLogs
endast datakällor - Linux innehåller
LinuxPerfCounters
ochSyslog
endast datakällor - Anpassade loggar innehåller
logFiles
endast datakällor - IIS-loggar innehåller
iisLogs
endast datakällor - DependencyAgent-tillägget
- Tillägg innehåller
extensions
endast datakällor tillsammans med associerade perfCounters-datakällorVMInsights
Distribution
Information om hur du distribuerar domänkontrollanter finns i Regler för datainsamling i Azure Monitor och Skapa och redigera regler för datainsamling (DCR) i Azure Monitor
Varning
Du bör inte använda en befintlig anpassad loggtabell som används av MMA-agenter. Dina MMA-agenter kan inte skriva till tabellen när den första AMA-agenten skriver till tabellen. Du bör skapa en ny tabell för AMA som ska användas för att förhindra MMA-dataförlust.
Nästa steg
- Azure Monitor Agent Migration Helper-arbetsbok
- Regelstruktur för datainsamling
- Exempel på regler för datainsamling (DCR) för dcr-exempel för olika scenarier för datainsamling.
- Azure Monitor-tjänstbegränsningar för gränser som gäller för varje domänkontrollant.