Condividi tramite

Convertire la configurazione dell'area di lavoro in configurazioni di regole di raccolta dati

  • Articolo

Mentre l'agente di Log Analytics eredita la configurazione dalle aree di lavoro Log Analytics, l'agente di Monitoraggio di Azure si basa sulle regole di raccolta dati per la configurazione

Il convertitore da configurazione dell'area di lavoro a configurazione di regole di raccolta dati è un modulo di PowerShell che legge la configurazione dall'area di lavoro e genera più modelli di ARM di regole di raccolta dati, in base alle configurazioni MMA presenti nell'area di lavoro.

Prerequisiti

  • È consigliabile usare PowerShell versione 7.1.3 o successiva (versione minima 5.1)
  • Modulo Az PowerShell per eseguire il pull delle informazioni di configurazione dell'agente dell'area di lavoro. Per installare il modulo Az PowerShell, vedere Installare Azure PowerShell in Windows
  • Accesso in lettura/scrittura alla risorsa area di lavoro specificata

Installazione ed esecuzione

Scaricare lo script di PowerShell da GitHub.

Lo script recupera le configurazioni dell'agente legacy dall'area di lavoro e genera modelli di ARM di regole di raccolta dati per ogni tipo di regola di raccolta dati supportato nella cartella di output specificata. È possibile che vengano creati più modelli, uno per ogni tipo di regola di raccolta dati.

Per più aree di lavoro con raccolte dati configurate, è necessario eseguire lo script per ogni area di lavoro. IIS registra lo script e crea anche un ruolo di raccolta dati aggiuntivo come parte di tale configurazione.

Al termine dello script, viene richiesto di testare la distribuzione del modello nell'ambiente in uso. Consentire la distribuzione automatica del modello oppure scegliere di archiviare la cartella di output specificata del modello

Nota

Lo script non associa le regole di raccolta dati all'area di lavoro. È necessario creare associazioni di regole di raccolta dati personalizzate per associare le regole di raccolta dati ai server pertinenti. In questo modo è possibile controllare la distribuzione delle regole di raccolta dati nei server e testare le regole di raccolta dati in un campione di server prima di eseguire la distribuzione su larga scala.

Per eseguire lo script, copiare il comando seguente e sostituire i parametri con i valori personalizzati:

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

Parametri di script

Nome Obbligatorio Descrizione
SubscriptionId SÌ ID sottoscrizione dell'area di lavoro
ResourceGroupName SÌ Gruppo di risorse dell'area di lavoro
WorkspaceName SÌ Nome dell'area di lavoro (gli ID risorsa di Azure non fanno distinzione tra maiuscole e minuscole)
DCRName SÌ Nome di base usato per ogni regola di raccolta dati di output
OutputFolder NO Percorso della cartella di output. Se non specificato, viene utilizzato il percorso della directory di lavoro

Output:

  • Per ogni DCR type supportato, lo script produce un modello di ARM di regola di raccolta dati pronto per la distribuzione e un payload di regola di raccolta dati, per gli utenti a cui non serve ilo modello di ARM.

Tipi di regole di raccolta dati attualmente supportati:

  • Windows contiene solo origini dati WindowsPerfCounters e WindowsEventLogs
  • Linux contiene solo origini dati LinuxPerfCounters e Syslog
  • Log personalizzati contiene solo origini dati logFiles
  • Log IIS contiene solo origini dati iisLogs
  • Estensione DependencyAgent
  • Estensioni contiene solo origini dati extensions insieme a tutte le origini dati perfCounters associate
    • VMInsights

Distribuzione

Per informazioni sulla distribuzione delle regole di raccolta dati, vedere Regole di raccolta dati in Monitoraggio di Azure e Creare e modificare regole di raccolta dati in Monitoraggio di Azure

Avviso

Non è consigliabile usare una tabella log personalizzata esistente usata dagli agenti di Microsoft Monitoring Agent. Gli agenti di Microsoft Monitoring Agent non saranno in grado di scrivere nella tabella dopo che il primo agente di Monitoraggio di Azure scrive nella tabella. È consigliabile creare una nuova tabella che deve essere usata dall'agente di Monitoraggio di Azure per evitare la perdita di dati di Microsoft Monitoring Agent.

Passaggi successivi