Azure Monitor Agent (AMA) 導入時におけるプロビジョニング失敗の対処法(Windows イメージ展開環境)

大西です。

Azure virtual Desktop(AVD)を用いてシンクライアント環境を構築している際に、
各セッションホストへAzure Monitor Agent(AMA)の導入が正常に完了せず、
WindowsOSのパフォーマンスカウンターをAzureへ取得できないため監視ができないといった事態が発生しました。

原因を探ってみると、マスターイメージをベースに展開されたWindows仮想マシンに対して誤った操作をしていたことが分かりましたので、
本記事にて共有させていただきます。

原因

本事象の原因は、仮想マシンを「AMAを導入した既存のイメージから展開」して作成したことでした。
仮想マシンを新規作成した場合は成功し、イメージから展開した場合は失敗したことから、これが原因だと特定しました。

プロビジョニングに失敗する原因ですが、一度AMAを導入した仮想マシンにはAMAのインストールフォルダが作成されています。
そのデフォルトフォルダが『C:\WindowsAzure\Resource\AMADatastore.仮想マシン名』です。(画像黒枠部分)

AMAのバージョン1.60以降では、AMAが正常に動作するために、ホスト名と内部データストアのパスに含まれる仮想マシン名が厳密に一致している必要があります。
イメージ展開された新しい仮想マシンには、展開前のマスターイメージに残存していた古い(元イメージの)仮想マシン名が付与されたデータストアフォルダが引き継がれてしまいます。
展開した仮想マシンにAMAをAzureポータルからインストールを実施しても、「C:\WindowsAzure\Resource」配下に空のデータストアフォルダが作成されるだけでした。
そのため、既存のインストールフォルダを削除する必要があります。具体的に次の項目で対応手順をご説明します。

対応

AMAをプロビジョニングしていない仮想マシンを複数台展開する前のベースマシンに対応しておくのが最も負荷が少ないです。
既に展開済みの場合、各仮想マシンに対して作業を実施する必要があります。

1.AMAをアンインストール
※AMA導入前の場合は不要です。
①[Azureポータル]-[モニター](「監視」で検索)-[設定]-[データ収集ルール]を開き、対象仮想マシンに設定しているルールを開く。
②[構成]-[リソース]にて対象の仮想マシンにチェックを入れ、「関連付けの削除」を実施する。
③[Azure ポータル]-[Virtual Machines]-[対象の仮想マシン]-[拡張機能とアプリケーション]を開く。
④「AzureMonitorWindowsAgent」を選択し、[アンインストール] を選択する。

2.AMAインストールフォルダの削除
①仮想マシンにログインする。
②「C:\WindowsAzure」をエクスプローラーで開き、「Resources」フォルダを削除する。

3.レジストリの削除
※レジストリの操作を誤ると、システムが不安定になる可能性があります。
①レジストリエディター(Windows + R 後、「regedit」を実行)を開く
②「コンピューター\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\AzureMonitorAgent」の「Secrets」キーを選択し、削除する。

4.AMAをインストール
①[Azureポータル]-[モニター](「監視」で検索)-[設定]-[データ収集ルール]を開き、対象仮想マシンに設定するルールを開く。
②[構成]-[リソース]を開き、「追加」からAMAをインストールする仮想マシンを選択し、適用する。

上記手順を実施すると、AMAのプロビジョニングが正常に終了し、OS内のリソース情報などが転送されます。

最後に

仮想マシン監視のためAMAを導入すること、イメージから展開して構築期間を短くすることどちらも多くの方が行っていると思います。
プリインストールされているAMAがイメージから展開時に問題になるとは思い至りませんでした。
今後も皆様のインフラ運用の一助となるよう、予期せぬ事象に遭遇した際には原因を究明し、本ブログにて情報を共有してまいります。

著者について

2024年からクラウドを触り始めた初心者エンジニアで、日々勉強中です。

大西をフォローする

クラウドに強いによるエンジニアブログです。

SCSKクラウドサービス(Azure)は、Azureを最大限活用するためのオールインワンサービスです。40年以上の様々なシステム構築・運用実績で得た業界理解と、Azure構築ナレッジを強みに、クラウドへの移行から運用までトータルでサポートし、お客様のAzure活用を実現します。

Azureクラウドソリューション運用・監視
シェアする
タイトルとURLをコピーしました