次の方法で共有

ワークスペース構成を 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 データ ソースのみが含まれています
  • DependencyAgent 拡張機能
  • 拡張機能には、関連する perfCounters データ ソースと共に extensions データ ソースのみが含まれています
    • VMInsights

展開

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

警告

MMA エージェントが使用する既存のカスタム ログ テーブルを使用するべきではありません。 最初の AMA エージェントがテーブルに書き込むと、MMA エージェントはテーブルに書き込むことができなくなります。 MMA データ損失を防ぐために使用する AMA 用の新しいテーブルを作成する必要があります。

次のステップ