Dela via

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. 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. Som en del av den konfigurationen skapar skriptet även ytterligare en roll för datainsamling i IIS-loggarna.

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

Anteckning

Skriptet associerar inte DCR:erna med arbetsytan. Du måste skapa egna associationer för datainsamlingsregler (DCRA) för att associera DCR:erna med de relevanta servrarna. 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änsligt)
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 arbetskatalogens sökväg

Utgångar:

  • För varje DCR type som stöds skapar skriptet en DCR ARM-mall, klar att distribueras, 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 och WindowsEventLogs endast datakällor
  • Linux innehåller LinuxPerfCounters och Syslog endast datakällor
  • Anpassade loggar innehåller logFiles endast datakällor
  • IIS-loggar innehåller iisLogs endast datakällor
  • DependencyAgent-tillägg
  • Tillägg innehåller datakällor endast tillsammans med associerade perfCounters-datakällor
    • VMInsights

Driftsättning

Information om hur du distribuerar DCR:er 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 kommer inte kunna skriva till tabellen när den första AMA-agenten har skrivit 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