ワークスペース構成を DCR 構成に変換する

Log Analytics エージェントは Log Analytics ワークスペースからその構成を継承しますが、Azure Monitor エージェントは構成についてデータ収集ルール (DCR) に依存します

ワークスペース構成から DCR 構成を生成するジェネレーターは、ワークスペースから構成を読み取り、ワークスペースに存在する MMA 構成に基づいて複数の DCR ARM テンプレートを生成する PowerShell です。

前提条件

• PowerShell バージョン 7.1.3 以降が推奨されます (最小バージョン 5.1)
• ワークスペース エージェント構成情報を取得するための Az PowerShell モジュール。 Az PowerShell モジュールをインストールするには、「Windows に Azure PowerShell をインストールする」を参照してください
• 指定されたワークスペース リソースへの読み取り/書き込みアクセス権

インストールと実行

GitHub から PowerShell スクリプトをダウンロードします。

このスクリプトは、ワークスペースからエージェントのレガシ構成を取得し、サポートされている DCR の種類ごとに DCR ARM テンプレートを指定された出力フォルダーに生成します。 DCR の種類ごとに 1 つずつ、複数のテンプレートが作成される可能性があります。

データ収集が構成されている複数のワークスペースがある場合は、ワークスペースごとにスクリプトを実行する必要があります。 IIS がスクリプトをログし、その構成の一部として追加のデータ収集の役割も作成します。

スクリプトが完了すると、環境でテンプレートのデプロイをテストするように求められます。 テンプレートを自動でデプロイするか、指定した出力フォルダーにテンプレートを格納するかを選択します

Note

このスクリプトは、DCR をワークスペースに関連付けません。 独自のデータ収集ルールの関連付け (DCRA) を作成して、DCR を関連するサーバーに関連付ける必要があります。 これにより、大規模にデプロイする前に、サーバーへの DCR のデプロイを制御し、サーバーのサンプルで DCR をテストできます。

スクリプトを実行するには、次のコマンドをコピーし、パラメーターを実際の値に置き換えます。

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

スクリプト パラメーター

名前	必須	Description
SubscriptionId	YES	ワークスペースのサブスクリプション ID
ResourceGroupName	YES	ワークスペースのリソース グループ
WorkspaceName	YES	ワークスペースの名前 (Azure リソース ID では大文字と小文字が区別されません)
DCRName	YES	出力 DCR ごとに使用されるベース名
OutputFolder	使用不可	出力フォルダーのパス。 指定しない場合は、作業ディレクトリ パスが使用されます

出力:

• スクリプトは、サポートされている DCR type ごとに、デプロイの準備が整った DCR ARM テンプレートと DCR ペイロード (ARM テンプレートを必要としないユーザー向け) を生成します。

現在サポートされている DCR の種類:

• Windows には、WindowsPerfCounters と WindowsEventLogs のデータ ソースのみが含まれています
• Linux には、LinuxPerfCounters と Syslog のデータ ソースのみが含まれています
• カスタム ログに logFiles データ ソースのみが含まれている場合
• IIS ログには iisLogs データ ソースのみが含まれています
• 拡張機能には、関連する perfCounters データ ソースと共に extensions データ ソースのみが含まれています
  • VMInsights

展開

DCR のデプロイについて詳しくは、「Azure Monitor でのデータ収集ルール」と「Azure Monitor でデータ収集規則 (DCR) を作成および編集する」を参照してください

次のステップ

• Azure Monitor エージェント Migration Helper ブック
• データ収集ルールの構造
• さまざまなデータ収集シナリオのサンプル DCR については、「Azure Monitor でのデータ収集ルール (DCR) のサンプル」。
• 各 DCR に適用される制限については、「Azure Monitor サービスの制限」。