將工作區組設定換為 DCR 設定
Log Analytics 代理程式會從 Log Analytics 工作區繼承其設定,而 Azure 監視器代理程式則會依賴資料收集規則 (DCR) 來進行設定
「將工作區設定轉換為 DCR 設定產生器」是一個 PowerShell,它會從您的工作區讀取設定,並根據工作區上存在的 MMA 設定來產生多個 DCR ARM 範本。
必要條件
- 建議使用 PowerShell 7.1.3 版或更高版本 (最低版本 5.1)
- 用於提取工作區代理程式設定資訊的 Az PowerShell 模組的 Az PowerShell 模組。 若要安裝 Az PowerShell 模組,請參閱在 Windows 上安裝 Azure PowerShell
- 對指定工作區資源的讀取/寫入存取權
安裝和執行
從 GitHub 下載 PowerShell 指令碼。
此指令碼會從工作區擷取舊代理程式設定的設定,並在指定的輸出資料夾中為每個支援的 DCR 類型產生 DCR ARM 範本。 可以建立多個範本,每個範本對應一種 DCR 類型。
對於設定了資料收集的多個工作區,您必須為每個工作區執行該指令碼。 IIS 會記錄該指令碼,並建立一個額外的資料收集角色作為該設定的一部分。
該指令碼完成後,它會提示您在您的環境中測試範本的部署。 選擇讓它為您部署範本,或將範本儲存到指定的輸出資料夾
注意
該指令碼不會將 DCR 與工作區產生關聯。 您必須建立自己的資料收集規則關聯 (DCRA),以將 DCR 與相關的伺服器產生關聯。 這可讓您控制 DCR 到伺服器的部署,並在大規模部署之前先測試伺服器範例上的 DCR。
若要執行指令碼,請複製以下命令並將參數取代為您的值:
.\WorkspaceConfigToDCRMigrationTool.ps1 -SubscriptionId $subId -ResourceGroupName $rgName -WorkspaceName $workspaceName -DCRName $dcrName -OutputFolder $outputFolderPath
指令碼參數
名稱 | 必要 | 描述: |
---|---|---|
SubscriptionId |
是 | 工作區的訂用帳戶識別碼 |
ResourceGroupName |
是 | 工作區的資源群組 |
WorkspaceName |
是 | 工作區的名稱 (Azure 資源識別碼不區分大小寫) |
DCRName |
是 | 用於每個輸出 DCR 的基本名稱 |
OutputFolder |
否 | 輸出資料夾路徑。 如果未提供,則會使用工作目錄路徑 |
輸出:
- 對於每個受支援的
DCR type
,該指令碼都會為不需要 ARM 範本的使用者產生一個可供部署的 DCR ARM 範本和 DCR 承載。
目前支援的 DCR 類型:
- Windows 只包含
WindowsPerfCounters
和WindowsEventLogs
資料來源 - Linux 只包含
LinuxPerfCounters
和Syslog
資料來源 - 自訂記錄只包含
logFiles
資料來源 - IIS 記錄只包含
iisLogs
資料來源 - DependencyAgent 延伸模組
- 延伸模組只包含
extensions
資料來源以及任何相關聯的 perfCounters 資料來源VMInsights
部署
如需部署 DCR 的資訊,請參閱 Azure 監視器中的資料收集規則和在 Azure 監視器中建立和編輯資料收集規則 (DCR)
警告
您不應該使用 MMA 代理程式所使用的現有自訂記錄資料表。 第一個 AMA 代理程式寫入資料表後,就無法將 MMA 代理程式寫入資料表。 您應該為 AMA 建立新的資料表,以用於防止 MMA 資料遺失。
下一步
- Azure 監視器代理程式移轉協助程式活頁簿
- 資料收集規則結構
- 不同資料收集案例的範例 DCR 的範例資料收集規則 (DCR)。
- 請參閱 Azure 監視器服務限制,了解適用於各個 DCR 的限制。