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 がスクリプトをログし、その構成の一部として追加のデータ収集の役割も作成します。
スクリプトが完了すると、環境でテンプレートのデプロイをテストするように求められます。 テンプレートを自動でデプロイするか、指定した出力フォルダーにテンプレートを格納するかを選択します
メモ
このスクリプトは、DCR をワークスペースに関連付けません。 独自のデータ収集ルールの関連付け (DCRA) を作成して、DCR を関連するサーバーに関連付ける必要があります。 これにより、大規模にデプロイする前に、サーバーへの DCR のデプロイを制御し、サーバーのサンプルで DCR をテストできます。
スクリプトを実行するには、次のコマンドをコピーし、パラメーターを実際の値に置き換えます。
.\WorkspaceConfigToDCRMigrationTool.ps1 -SubscriptionId $subId -ResourceGroupName $rgName -WorkspaceName $workspaceName -DCRName $dcrName -OutputFolder $outputFolderPath
スクリプト パラメーター
| 名前 | 必須 | 説明 |
|---|---|---|
SubscriptionId |
はい | ワークスペースのサブスクリプション ID |
ResourceGroupName |
はい | ワークスペースのリソース グループ |
WorkspaceName |
はい | ワークスペースの名前 (Azure リソース ID では大文字と小文字が区別されません) |
DCRName |
はい | 各出力 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 用の新しいテーブルを作成する必要があります。
次のステップ
- Azure Monitor エージェント Migration Helper ブック
- データ収集ルールの構造
- サンプルデータ収集ルール (DCR) は、さまざまなデータ収集シナリオのサンプル DCR です。
- 各 DCR に適用される制限については、「Azure Monitor サービスの制限」。