Konvertieren der Arbeitsbereichkonfiguration in DCR-Konfigurationen

  • Artikel

Der Azure Monitor-Agent basiert nur auf Datensammlungsregeln (DCRs) für die Konfiguration, während der Log Analytics-Agent seine Konfiguration von Log Analytics-Arbeitsbereichen erbt.

Die Arbeitsbereichskonfiguration für den DCR-Konfigurationsgenerator ist eine PowerShell, welche die Konfiguration aus Ihrem Arbeitsbereich liest, sodass mehrere DCR ARM-Vorlagen erstellt werden, basierend auf den MMA-Konfigurationen, die im Arbeitsbereich vorhanden sind.

Voraussetzungen

  • PowerShell Version 7.1.3 oder höher wird empfohlen (Mindestversion 5.1)
  • Az PowerShell-Modul zum Abrufen von Konfigurationsinformationen des Arbeitsbereich-Agents Az PowerShell. Informationen zum Installieren des Az PowerShell-Moduls finden Sie unter Installieren von Azure PowerShell unter Windows
  • Lese-/Schreibzugriff auf die angegebene Arbeitsbereichsressource

Installation und Ausführung

Laden Sie das PowerShell-Skript von GitHub herunter.

Das Skript ruft die Konfiguration der Legacy-Agent-Konfigurationen aus dem Arbeitsbereich ab und generiert DCR ARM-Vorlagen für jeden unterstützten DCR-Typ im angegebenen Ausgabeordner. Es können mehrere Vorlagen erstellt werden, eine für jeden DCR-Typ.

Für mehrere Arbeitsbereiche mit konfigurierten Datensammlungen müssen Sie das Skript für jeden Arbeitsbereich ausführen. IIS protokolliert außerdem, dass das Skript eine zusätzliche Datensammlungsrolle als Teil dieser Konfiguration erstellt.

Nach Abschluss des Skripts werden Sie aufgefordert, die Bereitstellung der Vorlage in Ihrer Umgebung zu testen. Wählen Sie aus, ob die Vorlage für Sie bereitgestellt werden soll, oder speichern Sie den angegebenen Ausgabeordner der Vorlage.

Hinweis

Das Skript ordnet die DCRs nicht dem Arbeitsbereich zu. Sie müssen eigene Regelzuordnungen für die Datensammlung (Data Collection Rule Associations, DCRAs) erstellen, um die DCRs den relevanten Servern zuzuordnen. Auf diese Weise können Sie die Bereitstellung der DCRs auf den Servern steuern und die DCRs auf einem Beispiel von Servern testen, bevor Sie die Bereitstellung im großen Maßstab durchführen.

Kopieren Sie zum Ausführen des Skripts den folgenden Befehl, und ersetzen Sie die Parameter durch Ihre Werte:

	.\WorkspaceConfigToDCRMigrationTool.ps1 -SubscriptionId $subId -ResourceGroupName $rgName -WorkspaceName $workspaceName -DCRName $dcrName -OutputFolder $outputFolderPath

Skriptparameter

Name Erforderlich Beschreibung
SubscriptionId YES Die ID des Abonnements des Arbeitsbereichs
ResourceGroupName YES Die Ressourcengruppe des Arbeitsbereichs
WorkspaceName YES Der Name des Arbeitsbereichs (bei Azure-Ressourcen-IDs wird die Groß-/Kleinschreibung nicht beachtet)
DCRName YES Der Basisname, der für jeden der Ausgabe-DCRs verwendet wird
OutputFolder NO Der Pfad des Ausgabeordners. Falls nicht angegeben, wird der Pfad des Arbeitsverzeichnisses verwendet

Ausgaben:

  • Für jede unterstützte DCR type erzeugt das Skript eine DCR ARM-Vorlage bereit für die Bereitstellung und einen DCR-Payload für Benutzer, die die ARM-Vorlage nicht benötigen.

Derzeit unterstützte DCR-Typen:

  • Windows enthält nur WindowsPerfCounters- und WindowsEventLogs-Datenquellen
  • Linux enthält nur LinuxPerfCounters- und Syslog-Datenquellen
  • Benutzerdefinierte Protokolle enthalten nur logFiles-Datenquellen
  • IIS-Protokolle enthalten nur iisLogs-Datenquellen
  • DependencyAgent-Erweiterung
  • Erweiterungen enthalten nur extensions-Datenquellen einschließlich aller zugeordneten perfCounters-Datenquellen
    • VMInsights

Bereitstellung

Informationen zur Bereitstellung der DCRs finden Sie unter Datensammlungsregeln in Azure Monitor und Erstellen und Bearbeiten von Datensammlungsregeln (DCRs) in Azure Monitor

Warnung

Sie sollten keine vorhandene benutzerdefinierte Protokolltabelle verwenden, die von MMA-Agents verwendet wird. Ihre MMA-Agents können nicht mehr in die Tabelle schreiben, sobald der erste AMA-Agent in die Tabelle schreibt. Sie sollten eine neue Tabelle für AMA erstellen, um MMA-Datenverluste zu verhindern.

Nächste Schritte